https://github.com/mguinea/laravel-translatable

Make Eloquent model attributes translatables using Translations table
https://github.com/mguinea/laravel-translatable

languages laravel locale translation

Last synced: 3 months ago
JSON representation

Make Eloquent model attributes translatables using Translations table

• Host: GitHub
• URL: https://github.com/mguinea/laravel-translatable
• Owner: mguinea
• License: mit
• Created: 2024-07-21T20:35:20.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-07-30T09:29:13.000Z (11 months ago)
• Last Synced: 2025-02-08T22:50:28.465Z (5 months ago)
• Topics: languages, laravel, locale, translation
• Language: PHP
• Homepage:
• Size: 54.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Laravel Translatable

Make Eloquent model attributes translatables using Translations table

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Laravel 11.x](https://img.shields.io/badge/Laravel-11.x-orange.svg)](http://laravel.com)

This package contains a trait to make Eloquent attributes translatable. Translations are stored in Translations database table.

Once the trait is installed on the model you can do these things:

```php

$customer = new Customer; // An Eloquent model

$customer

   ->setTranslation('greeting', 'en', 'Hello')

   ->setTranslation('greeting', 'es', 'Hola')

   ->save();

$customer->greeting; // Returns 'Hello' given that the current app locale is 'en'

$customer->getTranslation('greeting', 'es'); // returns 'Hola'

app()->setLocale('es');

$customer->greeting; // Returns 'Hola'

```

## Installation

You can install the package via composer:

```bash

composer require mguinea/laravel-translatable

```

If you want to change the default model or the default tables names, you could publish the config file:

```bash

php artisan vendor:publish --tag=translatable-config

```

You must publish the migration file to create polymorphic and main translations tables:

```bash

php artisan vendor:publish --tag=translatable-migrations

```

## Making a model translatable

The required steps to make a model translatable are:

- First, you need to add the `Mguinea\Translatable\Traits\Translatable`-trait.

- Next, you should create a public static property `$translatable` which holds an array with all the names of attributes you wish to make translatable.

- You have to create a field in the migration of your model type `string` and `nullable`.

Here's an example of a prepared model:

```php

use Illuminate\Database\Eloquent\Model;

use Mguinea\Translatable\Traits\Translatable;

class NewsItem extends Model

{

    use Translatable;

    protected $fillable = ['greeting'];

    public static $translatable = ['greeting'];

}

```