hi-folks / jet-translations
Jetstream Livewire translations (for blade template)
Requires
- php: ^7.1|^8.0
- ext-json: *
- illuminate/support: ^6.0|^7.0|^8.0
Requires (Dev)
- orchestra/testbench: 4.*|5.*|6.*
- phpstan/phpstan: ^0.12.64
- phpunit/phpunit: ^8.0|^9.3
- squizlabs/php_codesniffer: ^3.5
README
This package includes:
- translation strings (in json format) for Jetstream auth view and components
- translation template file (in json format) for Jetstream auth view and components (useful for who wants starting to translate strings in a new language)
- command for extracting translation strings from view templates (Blade files)
Installation
You can install the package via composer:
composer require hi-folks/jet-translations
Publish the languages
php artisan vendor:publish --provider="HiFolks\JetTranslations\JetTranslationsServiceProvider" --tag="lang" --force
Usage
Install this package in your Laravel Jetstream application and enable a language in your config/app.php via locale configuration:
// config/app.php file
'locale' => 'it',
About translation strings
Json files is located in this package in the directory:
- resources/lang/lang.json
Translations available
Currently, just italian language is supported.
About translations template file
If you don't find translations in your native language, you could contribute to Jetstream, translating strings in your native language.
Do you want to contribute translating strings ?
To help you I created a "template" json file to start the translation process. You can find resources/lang/template-lang.json with all untranslated strings. My suggestion is to copy this file in _resource/lang/xy.lang, where xy is the code of your language (de, en, fr, etc...).
About Command line usage
The JetTranslations package is shipped with an artisan command:
php artisan jet-trans:extract
This command:
- it parses all blade files in vendor/laravel/jetstream/stubs/livewire/resources/views
- it extracts strings defined in __("");
- it checks if there is some missing keys in ./resources/lang/vendor/jet-translations/it.json (ot the json of the specified language via --language option)
This command could save the json file using --save-json options. For example using:
php artisan jet-trans:extract --language=de --save-json
It saves de.json file in resources/lang/vendor/jet-translations/ directory of your Laravel app.
About Jetstream
Laravel Jetstream includes login, registration, email verification, two-factor authentication, session management, API support via Laravel Sanctum, and optional team management. With Livewire, Jetstream provides Blade templates with Translation Strings. Blade templates provided by Jetstream are ready to be translated, they use the __() helper :
__("Dashboard");
Testing
composer test
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please see CONTRIBUTING for details.
Credits
License
The MIT License (MIT). Please see License File for more information.
Laravel Package Boilerplate
This package was generated using the Laravel Package Boilerplate.