README

EAV-based per-locale translations for Eloquent models. Stores translated field values in a shared translations table with a HasTranslations trait for get/set/bulk-write operations.

Installation

composer require candeno/laravel-translations

Publish and run the migration:

php artisan vendor:publish --tag=candeno-translations-migrations
php artisan migrate

Usage

Add the trait to any Eloquent model:

use Candeno\LaravelTranslations\Concerns\HasTranslations;

class Activity extends Model
{
    use HasTranslations;

    protected array $translatable = ['title', 'subtitle', 'why_text'];
}

Get a translation

// Falls back: requested locale → fallback locale → raw model attribute
$activity->getTranslation('title', 'uk', 'da');

Set a translation

$activity->setTranslation('title', 'uk', 'Назва');

Set all locales for a field

$activity->setTranslations('title', [
    'da' => 'Titel',
    'uk' => 'Назва',
]);

Bulk-write from a localizedContent map

Useful when consuming the automation form payload directly:

// $localizedContent = ['da' => ['title' => '...', 'description' => '...'], 'uk' => [...]]
$activity->setLocalizedContent($localizedContent, [
    'title'       => 'title',
    'description' => 'subtitle',
    'buttonText'  => 'action_label',
]);

Schema

A unique index on (table_name, row_id, locale, field) ensures upserts are safe.