Laravel Larex: Crowdin Plugin

A Laravel Larex plugin to import/export localization strings from/to Crowdin

📋 Requirements

• PHP 7.4 | 8.0
• Laravel ≥ 7
• Laravel Larex ≥ v3.5
• Crowdin API Token v2
• Crowdin Project ID Crowdin > Project > Settings > API & Webhooks > Project Id [API v2]

🚀 Installation

You can install the package using composer:

composer require lukasss93/laravel-larex-crowdin --dev

Then add the service provider to config/app.php.
This step can be skipped if package auto-discovery is enabled.

'providers' => [
    Lukasss93\LarexCrowdin\LarexCrowdinServiceProvider::class
];

⚙ Publishing the config file

Publishing the config file is optional:

php artisan vendor:publish --provider="Lukasss93\LarexCrowdin\LarexCrowdinServiceProvider" --tag="larex-crowdin-config"

🔧 Configuration

1. Install Laravel Larex ≥ v3.5
2. Publish (if you haven't already) and edit your larex.php config
3. Append the Crowdin importer in the importers.list array:

   //...
   'importers' => [
       //...
       'list' => [
           //...
           'crowdin' => Lukasss93\LarexCrowdin\Importers\CrowdinImporter::class,
       ],
   ],
   //...

4. Append the Crowdin exporter in the exporters.list array:

   //...
   'exporters' => [
       //...
       'list' => [
           //...
           'crowdin' => Lukasss93\LarexCrowdin\Exporters\CrowdinExporter::class,
       ],
   ],
   //...

5. Edit your .env file and append the following strings:

   # You can generate your token here: https://crowdin.com/settings#api-key
   # Please note: this library supports only the Crowdin API v2
   LAREX_CROWDIN_TOKEN=
        
         
   
   # You can get your project id (API v2) here: 
   # https://crowdin.com/project/your-project/settings#api
   LAREX_CROWDIN_PROJECT_ID=
         
   
         
        

👓 Usage

• Run php artisan larex:import crowdin to import strings from your Crowdin Project into your Larex CSV
• Run php artisan larex:export crowdin to export strings from your Larex CSV into your Crowdin Project
• You can still use the --include and --exclude options to select specific languages to import/export

⚗️ Testing

composer test

📃 Changelog

Please see the CHANGELOG.md for more information on what has changed recently.

🏅 Credits

• Luca Patera
• All Contributors

📖 License

Please see the LICENSE.md file for more information.