vemcogroup/laravel-translation

Translation package for Laravel to scan for localisations and up/download to poeditor

3.0.13 2024-03-29 14:26 UTC

Requires

• php: ^7.3|^8.0
• ext-json: *
• guzzlehttp/guzzle: ^6.3|^7.0
• laravel/framework: ^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
• symfony/finder: ^4.3|^5.0|^6.0|^7.0

MIT

• Henrik B Hansen

• i18n
• translations
• laravel
• Poeditor

README

Description

This package allows you to scan your app for translations and create your *.json file.

It also allows you to upload your base translation to poeditor.

Installation

You can install the package via composer:

composer require vemcogroup/laravel-translation

The package will automatically register its service provider.

To publish the config file to config/translation.php run:

php artisan vendor:publish --provider="Vemcogroup\Translation\TranslationServiceProvider"

This is the default contents of the configuration:

return [

    /*
    |--------------------------------------------------------------------------
    | Base Language
    |--------------------------------------------------------------------------
    |
    | Here you may specify which of language is your base language.
    | The base language select will be created as json file when scanning.
    | It will also be the file it reads and uploads to POEditor.
    |
    */

    'base_language' => 'en',

    /*
    |--------------------------------------------------------------------------
    | Functions
    |--------------------------------------------------------------------------
    |
    | Here you define an array describing all the function names to scan files for.
    |
    */

    'functions' => ['__'],
    
    /*
    |--------------------------------------------------------------------------
    | Excluded directories
    |--------------------------------------------------------------------------
    | 
    | Here you define which directories are excluded from scan.
    |
    */
	
    'excluded_directories' => ['vendor', 'storage', 'public', 'node_modules'],
    
    /*
    |--------------------------------------------------------------------------
    | Extensions
    |--------------------------------------------------------------------------
    |
    | Here you define an array describing all the file extensions to scan through.
    |
    */

    'extensions' => ['*.php', '*.vue'],

    /*
    |--------------------------------------------------------------------------
    | API Key
    |--------------------------------------------------------------------------
    |
    | Here you define your API Key for POEditor.
    |
    | More info: https://poeditor.com/account/api
    |
    */

    'api_key' => env('POEDITOR_API_KEY'),

    /*
    |--------------------------------------------------------------------------
    | Project Id
    |--------------------------------------------------------------------------
    |
    | Here you define the project Id to upload / download from.
    |
    */

    'project_id' => env('POEDITOR_PROJECT_ID'),
];

If you want to use upload / download to poeditor features, you need to create a your base_language in poeditor.

Usage

You are now able to use the translation commands scan/upload/download or create-js

Scan files

To scan your project for translations run this command:

php artisan translation:scan {--merge : Whether the job should overwrite or merge new translations keys}

The command creates your base_language .json file in /resources/lang

Add terms

To only add your terms run this command:

php artisan translation:add-terms {--scan : Whether the job should scan before uploading}

This command doesn't remove unsused terms, so remember NOT to run upload command afterward.

Upload translations

To upload your translation terms to poeditor run this command:

php artisan translation:upload {--scan : Whether the job should scan before uploading}

You are also able to upload your local translations if you have locale changes

php artisan translation:upload {--translations=all : Upload translations for language sv,da,...}

Download translation languages

To download languages from poeditor run this command:

php artisan translation:download

Create JS language files

To create public JS files run this command:

php artisan translation:create-js {--download : Download language files before creating js}

You are now able to access all your languages as window.i18n from /public/lang when you include the .js file

<script src="/build/lang/en.js"></script>

System translations

If you want to translate system translations change the terms in eg /resources/lang/en/auth.php

From:

'throttle' => 'Too many login attempts. Please try again in :seconds seconds.',

To

'throttle' => __('Too many login attempts. Please try again in :seconds seconds.'),

Then it will be scanned and included in the synced terms.