webthings/translationhelper

Translation Helper for Magento 2, enhanced for broad version compatibility

1.0.3 2025-03-29 10:01 UTC

Requires

• php: ~7.1.3 || ~7.2.0 || ~7.3.0 || ~7.4.0 || ^8.0 || ^8.1 || ^8.2
• magento/framework: ^101.0 || ^102.0 || ^103.0
• magento/magento2-base: ^2.2.0 || ^2.3.0 || ^2.4.0

Requires (Dev)

• magento/magento-coding-standard: ^4.0
• phpunit/phpunit: ^7.5

OSL-3.0, AFL-3.0

• Roman Sliusar
• Marc Schenk

README

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.