README

Translatable revisions for Laravel

$ composer require karabin/translatable-revisions

Upgrading

After upgrading, publish and run the package migrations:

php artisan vendor:publish --provider="Karabin\\TranslatableRevisions\\TranslatableRevisionsServiceProvider" --tag=migrations
php artisan migrate

New upgrade migrations include:

• lookup indexes for revision meta and template fields
• unique constraint for i18n definitions by (term_id, locale)
• structured lookup columns and index on i18n terms
• optional snapshot table for read-model acceleration

Snapshot Read Model

The package now supports an optional snapshot read model to speed up repeated field reads.

Enable it in config:

'use_snapshot_read_model' => true,

When enabled:

• getSimpleFieldContent() and getFieldContent() read from snapshots when available
• snapshots are rebuilt on first miss
• snapshots are invalidated on updates, purges, publish, and deletes

Backfilling Snapshots

To warm snapshots for existing content, run:

php artisan translatable-revisions:snapshot-backfill --model="App\\Models\\Page"

You can pass --model multiple times for several models.

The command resolves revisions/locales from existing terms/meta rows and warms snapshots through each model's getSimpleFieldContent() method so model-specific getters remain respected.