PHPackages                             vershub/laraveltranslations - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. vershub/laraveltranslations

ActiveLibrary[Localization & i18n](/categories/localization)

vershub/laraveltranslations
===========================

laravel package for translatable models

v1.0.1(1y ago)064MITPHPPHP >=8.2

Since Dec 26Pushed 1y agoCompare

[ Source](https://github.com/Vershub/laraveltranslations)[ Packagist](https://packagist.org/packages/vershub/laraveltranslations)[ RSS](/packages/vershub-laraveltranslations/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (3)Used By (0)

Laravel Translations
====================

[](#laravel-translations)

 **This lightweight Laravel package enables you to eager load models along with their translations in the specified language, efficiently preventing the N+1 query problem. Additionally, it allows you to retrieve a single translation (instead of an array) without unnecessarily loading extra models into memory..**

 [ ![Latest Stable Version](https://camo.githubusercontent.com/449618d9a61df7bc455b261bf73ab7547136b24c86dc05dc1c9d3f70df055a1a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766572736875622f6c61726176656c7472616e736c6174696f6e732e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/vershub/laraveltranslations) [ ![Total Downloads](https://camo.githubusercontent.com/0eff5de28f928f11d7be3af0ea8e2483750eb0531ef77fd989a346c64184d618/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766572736875622f6c61726176656c7472616e736c6174696f6e732e7376673f7374796c653d666c61742d737175617265) ](https://packagist.org/packages/vershub/laraveltranslations) [ ![License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265) ](LICENSE.md)

🚀 Installation
--------------

[](#-installation)

Install the package via Composer:

```
composer require vershub/laraveltranslations
```

🛠️ Usage
--------

[](#️-usage)

### 1. Create a Translatable Model

[](#1-create-a-translatable-model)

Extend the `TranslatableModel` class and implement the required abstract methods:

```
namespace App\Models;

use Vershub\LaravelTranslations\TranslatableModel;

class CarBrand extends TranslatableModel
{
    protected $fillable = ['name'];

    protected function getTranslationModel(): string
    {
        return CarBrandTranslation::class;
    }

    protected function getForeignKeyForTranslation(): string
    {
        return 'car_brand_id';
    }
}
```

### 2. Create a Translation Model

[](#2-create-a-translation-model)

The translation model should be a standard Eloquent model:

```
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class CarBrandTranslation extends Model
{
    protected $fillable = ['locale_code', 'name', 'description'];
}
```

Example of translation table migration:

```
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateCarBrandTranslationsTable extends Migration
{
    public function up()
    {
        Schema::create('car_brand_translations', function (Blueprint $table) {
            $table->id();
            $table->foreignId('car_brand_id')->constrained()->cascadeOnDelete();
            $table->string('locale_code');
            $table->string('name');
            $table->text('description')->nullable();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('car_brand_translations');
    }
}
```

### 3. Use the `withTranslation` Scope

[](#3-use-the-withtranslation-scope)

#### Retrieve translations for the current locale

[](#retrieve-translations-for-the-current-locale)

```
use App\Models\CarBrand;

$carBrands = CarBrand::withTranslation()->get();

foreach ($carBrands as $carBrand) {
    echo $carBrand->translation->name;
}
```

#### Retrieve translations for a specific locale

[](#retrieve-translations-for-a-specific-locale)

```
use App\Models\CarBrand;

$carBrands = CarBrand::withTranslation('fr')->get();

foreach ($carBrands as $carBrand) {
    echo $carBrand->translation->name;
}
```

#### Select specific columns from translations table

[](#select-specific-columns-from-translations-table)

```
use App\Models\CarBrand;

$carBrands = CarBrand::withTranslation('fr:id,locale_code,name,description')->get();
```

⚙️ Customization
----------------

[](#️-customization)

### Override the Locale Code Column

[](#override-the-locale-code-column)

By default, the package uses `locale_code`. You can change this by publishing the config file and change the value of `locale_code_column` key:

```
return [
    'locale_code_column' => 'locale_code'
];

```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance41

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~16 days

Total

2

Last Release

531d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/71bdd5537593c570811c9f9dda99db318821e374abac844cb8be528cdae149e2?d=identicon)[Vershub](/maintainers/Vershub)

---

Top Contributors

[![Vershub](https://avatars.githubusercontent.com/u/39310986?v=4)](https://github.com/Vershub "Vershub (5 commits)")

### Embed Badge

![Health badge](/badges/vershub-laraveltranslations/health.svg)

```
[![Health](https://phpackages.com/badges/vershub-laraveltranslations/health.svg)](https://phpackages.com/packages/vershub-laraveltranslations)
```

###  Alternatives

[php-translation/translator

Translator services

25224.8k5](/packages/php-translation-translator)[smmoosavi/php-gettext

Wrapper for php-gettext by danilo segan. This library provides PHP functions to read MO files even when gettext is not compiled in or when appropriate locale is not present on the system.

1926.6k1](/packages/smmoosavi-php-gettext)[laradevs/spanish

labels translated to spanish

166.7k](/packages/laradevs-spanish)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)