karabinse/translatable-revisions

Translatable revisions for Laravel

2.0.1 2026-03-17 12:15 UTC

Requires

• php: ^7.3|^8.0
• illuminate/database: ^7.0|^8.40.0|^9.0|^10|^11|^12
• illuminate/support: ^7.0.5|^8.0|^9.0|^10|^11|^12

Requires (Dev)

• nunomaduro/collision: ^8.1
• orchestra/testbench: ^10.0
• phpunit/phpunit: ^11.0

MIT

• Albin Nilsson
• Daniel Källstrand Modig

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.