Download the PHP package givanov95/laravel-translations without Composer

givanov95/laravel-translations

Multi-locale translation infrastructure for Laravel + Inertia + Vue projects.

What's included

• Translation polymorphic Eloquent model — store any model's translatable text per locale
• HasTranslation trait — setTranslation(), loadTranslations(), withTranslations() scope
• Translator service — cached JSON loader, getAllLocales(), model relation key mapping
• InitAppLocale + InitLocalePrefix middlewares
• MultiSelectService — load select options from any Eloquent model, with optional translation lookup
• MultiSelectDataConversion trait — turn a PHP enum into select option arrays
• TranslationPlugin.ts — Vue plugin exposing __('key', { name: 'value' })

The package is enum-agnostic — your project keeps its own Locale enum and passes either Locale::en or the plain 'en' string. Internally everything works with strings.

Install

Setup

1. Locale enum (project-side)

Create app/Enums/Locale.php in your project (the package doesn't ship one — locales differ per project):

2. Lang files

Create lang/en.json, lang/bg.json etc. with your translations:

3. Register middlewares (bootstrap/app.php)

4. Share with Inertia

In app/Http/Middleware/HandleInertiaRequests.php:

5. Install the Vue plugin (resources/js/app.ts)

Usage

On models

Select options from a model

Enum to options

In Vue templates

Development

Pre-commit hook

composer install / composer update symlinks the repo's pre-commit script into .git/hooks/pre-commit. It runs composer test + composer analyse before any commit that touches .php files — replacement for CI since the repo is private.

Bypass with git commit --no-verify when you genuinely need to (WIP commit, doc-only change you've already validated).

License

MIT