forxer/generic-term-translations-for-laravel

A plugin for Laravel Lang that provides generic term translations for Laravel.

1.9.1 2024-10-14 06:45 UTC

Requires

• php: ^8.1
• ext-json: *
• laravel-lang/publisher: ^14.1 || ^15.0 || ^16.0

Requires (Dev)

• illuminate/filesystem: ^10.46 || ^11.27.2
• illuminate/support: ^10.46 || ^11.27.2
• laravel-lang/status-generator: ^1.19 || ^2.11.3
• laravel/pint: ^1.18.1
• phpunit/phpunit: ^10.5.36
• symfony/var-dumper: ^6.4.11

MIT

• Vincent Garnier

• laravel
• languages
• lang

README

A plugin for Laravel Lang that provides generic term translations for Laravel project.

Consult the glossary to see all the terms available for translation.

Installation

Require the project using Composer:

composer require forxer/generic-term-translations-for-laravel --dev

Then use the locales publisher of Laravel Lang to add/update/reset or remove translations of this package:

• If you have never used Laravel Lang: add locales.
• If you are already using Laravel Lang: just update the locales.

Usage

This package provides translations for terms regularly used in projects.

You will find all the terms provided by this package in the glossary.

Terms are categorized into different sections by source files. For example there is an action.php source file that defines the add_something key, you can use it like this:

// "en" locale
trans('action.add_something', [
    'something' => 'a post',
]);

// return: "add a post"

// "fr" locale
trans('action.add_something', [
    'something' => 'un article',
]);

// return: "ajouter un article"

Be careful to escape the data that you do not control:

trans('action.delete_something', [
    'something' => e($post->title),
]);

Feminine and masculine gender

Some languages distinguish between feminine and masculine genders, for the same term the feminine key will then be suffixed by _fem. For example:

In English we use "all", while in French we use "toutes" in the feminine and "tous" in the masculine (see it on Google Translate).

// "en" locale
trans('misc.all'); // return: "all"

trans('misc.all_fem'); // return: "all"

// "fr" locale
trans('misc.all'); // return: "tous"

trans('misc.all_fem'); // return: "toutes"

Development steps

1. From the package directory, run php composer update
2. Update the sources as needed in src/source files
3. Run the console command php vendor/bin/lang sync
4. Translate modifications in src/locales/{locale}/php.json
5. Run php generate-glossary
6. Commit changes