Download the PHP package twister3x/laravel-nova-translation-manager without Composer
On this page you can find all versions of the php package twister3x/laravel-nova-translation-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-nova-translation-manager
Laravel Nova Chained Translation Manager
NOTE: If you are looking for nova 3 check out branch 3.0
The Laravel Nova Chained Translation Manager allows you to easily edit the translations of your current Laravel environment. This translation manager uses the Laravel Chained Translator, that enables you to override the default translations with translations for a specific environment, e.g. a content manager can independently edit and override the translation files on the production environment from the translations provided by the developers.
Typically at some point during the development phase, a content manager wants to translate or finetune the translation strings added by developers. This often results in merge and versioning issues, when developers and content managers are working on the translation files at the same time.
The Chained Translator package allows translations created by developers to exist separately from translations edited by
the content manager in separate lang
directories. The library merges the translations of both language directories,
where the translations of the content manager (the custom translations) override those of the developer (the default
translations). Check the documentation of the Laravel Chained Translator
for more info.
Features
- Save translations of the current environment to separate translation files in a separte language directory to avoid version conflicts.
- Immediately save translations
- Search for translations and translation keys
- Filter translations for specific groups and languages
- Only show keys with missing translations
- Support for Nova 4
Currently, this tool does not provide features to add new translation keys, because our target users are translators and content managers and we want to avoid that they add unnecessary translation keys.
Installation
The package can be installed through Composer.
Nova 4 support starts from version v3.0.0. If you are still using Nova 3, please use the v2 version.
Next enable the tool in Nova.
Go to app/Providers/NovaServiceProvider.php
and add the TranslationManager to the tools.
Configuration
You can configure the custom language directory name and extend or finetune the service provider of the Laravel Chained Translator. Have a look at the configuration options of the Laravel Chained Translator library.
Supported locales
There are two ways to change the supported locales.
Option 1
Publish the config file with the command below and configure it with your supported locales and editor preferences.
E.g.
Option 2
If your application already has a config that declares your locales than you are able to set the supported locales in
any service provider. Create a new one or use the app/Providers/AppServiceProvider.php
and set the supported locales
as an array in the boot function as follows:
Changing your Editor
Its possible also to change your editor, sometimes the translations values can get big and its good if you have a larger area
to edit them or even add some bold/underline effects on the fly. You can use 3 supported values: input
, textarea
, trix
. Their names are
self-explanatory.
NOTE: We do not recommend Trix as an editor, because if you use variables in your translations within HTML, e.g. for the url of an anchor tag, Trix will remove it :-(. Please, keep in mind while using Trix you should also configure your allowed HTML tags.
Don't forget to clear the cache after changing these settings and refresh your page to see the results :-)
E.g.
Ignoring Groups
You may also ignore certain groups of translations to be shown in the Nova UI. Create an array with keys that you want to ignore:
E.g.
Merging translations
You can combine the custom translations of the current environment with the default translation files, by running the command provided by the Laravel Chained Translator library package.
Credits
We used Joe Dixon's translation libraries as a source of technical expertise and inspiration:
@nelumoraru and @FrittenKeeZ upgraded the library for Nova 4.
Thanks a lot for the great work!
License
The MIT License (MIT). Please see license file for more information.
Screenshots
All versions of laravel-nova-translation-manager with dependencies
statikbe/laravel-chained-translator Version ^2.0
illuminate/validation Version ^9.0