Translation Helper for Magento 2
webthings/translationhelper
Adds a CLI command to extract translation strings into locale files with the option to exclude already-translated entries, streamlining i18n work. Maintained fork with PHP 8.2 support.
Build Tests
Code Quality
Tested on Magento 2.4.9
Recent Test History
Each release is tested against the latest Magento version at that time.
Top Contributors
View Leaderboard
Share This Module's Status
README
Loaded from GitHub
WebThings_TranslationHelper Magento 2 module
This module will allow you to grab translation files with the ability to exclude already translated ones.
About
This module is a fork of underser/module-translation-helper, originally developed by Roman Sliusar. It has been enhanced to support PHP 8.2 and Magento versions 2.2.x through 2.4.x.
Requirements
Magento 2 platform:
Tested on Magento v2.4.7 and v2.2.10 (will require at least v2.2 from you)
How to install
Run
composer require webthings/translationhelper
./bin/magento setup:upgrade
How to use
This module will provide you i18n:translationhelper command, run
./bin/magento i18n:translationhelper --help
to see possible params and their meaning
Examples of usage
./bin/magento i18n:translationhelper --locale fr_FR --output ./var/fr_FR.csv --all
will scan whole magento directory, and create fr_FR.csv file inside var folder. This file will contain all phrases that not translated for fr_FR locale
./bin/magento i18n:translationhelper --locale fr_FR --output ./var/fr_FR.csv ./app/code/Vendor/Module
will scan only app/code/Vendor/Module, and create fr_FR.csv file inside var folder. This file will contain all phrases that not translated for fr_FR locale
Common errors
Missed phrase
Most often, the "Missed phrase" error is caused by the third-party extensions when the system tries to translate an empty string like __(''). Correspondingly to learn what module is causing the issues you have to run the following command:
grep -rnw . -e "__('')" -e '__("")'
Once you track down those files you have to change __('') to '' and __("") to "" in the file's code.
After you made the required changes in the corresponding files, you can to regenerate the translation dictionary. The error should be eliminated.
This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.