README

A Laravel package to add translation capabilities to any Eloquent model by storing translations in a separate table with a polymorphic relationship. Easily manage translations for specified fields in multiple locales.

Features

• Translates specified model fields
• Stores translations in a separate translations table
• Polymorphic relationship to support multiple models
• Easy to use with a simple trait

Installation

Step 1. Install the package via Composer:

composer require secretwebmaster/wncms-translatable

Step 2. Publish the migration file:

php artisan vendor:publish --provider="Wncms\Translatable\TranslatableServiceProvider" --tag="translatable-migrations"

Step 3. Run the migration to create the translations table:

php artisan migrate

Step 4. Setup your model

Add the HasTranslations trait to your model To make any model translatable, simply add the HasTranslations trait to your Eloquent model and define the $translatable property with the list of fields that should be translatable.

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Wncms\Translatable\Traits\HasTranslations;

class Post extends Model
{
    use HasTranslations;

    // Define the fields that can be translated
    public $translatable = ['title', 'description'];

    protected $fillable = ['title', 'description'];
}

Usage

Setting Translations

Create your model and call setTranslation()

$post = Post::find(1);

// Set translations for 'title' and 'description'
$post = Post::create([
    'title' => 'Hello World',
    'description' => 'Description in English',
]);

$post->setTranslation('title', 'fr', 'Bonjour le monde');
$post->setTranslation('description', 'fr', 'Description en Français');

Getting Translations

When retrieving translatable fields, the package automatically returns the value based on the current locale of the application:

// Get the 'title' based on the app's current locale
echo $post->title; // Outputs 'Hello World' or 'Bonjour le monde' depending on the locale

You can also retrieve translations for a specific locale:

// Get the 'title' in French
echo $post->getTranslation('title', 'fr'); // Outputs 'Bonjour le monde'

// Get the 'description' in English
echo $post->getTranslation('description', 'en'); // Outputs 'Description in English'

You can get available translation field of a model:

$post->getTranslatable() // Outputs an array of translatable fields

Table Structure

The package will create a translations table with the following structure:

Update log

v1.4.0 2026-04-08

• Laravel 13 baseline (illuminate/database / illuminate/support ^13.0)
• PHP 8.4 baseline
• Testbench 11 / PHPUnit 12 compatibility
• fix default-locale skip logic so model save/update is not blocked

v1.2.8 2025-08-20

• fix typo in Feature test
• add save_empty_translations option in config file