Hyva i18n CSV Diff
hyva-themes/magento2-i18n-csv-diff
Adds CLI commands to compare Magento translation CSV files and automatically translate missing strings using the DeepL API. Useful for maintaining Hyva and custom theme translations.
Build Tests
Code Quality
Tested on Magento 2.4.8-p4
Recent Test History
Each release is tested against the latest Magento version at that time.
Top Contributors
View LeaderboardShare This Module's Status
README
Loaded from GitHubHyvä Themes - Magento translation CSV comparison command
hyva-themes/magento2-i18n-csv-diff
This module adds the bin/magento i18n:diff-csv and i18n:translate-csv commands.
i18n:diff-csv
The command takes two CSV files as arguments.
It displays all translations that are present in the first CSV file but not in the second, based on the first colum in the files.
i18n:translate
The command takes a target language 2-letter ISO code as the argument.
It reads a Magento localization CSV dictionary from stdin, translates it using the DeepL API, and writes it to stdout.
Be sure to check the automatic translations afterwards!
Usage Examples:
-
Collect all Magento and Hyvä strings:
bin/magento i18n:collect-phrases vendor/magento/ > magento-strings.csv bin/magento i18n:collect-phrases vendor/hyva-themes/magento2-default-theme/ > hyva-strings.csv bin/magento i18n:collect-phrases vendor/hyva-themes/magento2-theme-module/ >> hyva-strings.csv -
Find all Hyvä specific translations that are not part of native Magento:
bin/magento i18n:diff-csv hyva-strings.csv magento-strings.csv -
Find all translations that are missing in a Hyvä translation file:
bin/magento i18n:diff-csv hyva-strings.csv i18n/de_DE.csv -
Find all translations that are in a translation file but are not used in Hyvä:
bin/magento i18n:diff-csv i18n/de_DE.csv hyva-strings.csv -
Add new translations to an existing dictionary file.
bin/magento i18n:diff-csv hyva-strings.csv i18n/de_DE.csv | bin/magento i18n:translate-csv DE >> i18n/de_DE.csv
Installation
- Install via composer
composer require hyva-themes/magento2-i18n-csv-diff - Enable module
bin/magento setup:upgrade
Configuration
To use the Deepi18n:translate-csv command, configure your API key in the system configuration at Hyva Themes > Localization CLI > Translation > DeepL API Key.
License
This package is licensed under the Open Software License (OSL 3.0).
- Copyright: Copyright © 2020-present Hyvä Themes. All rights reserved.
- License Text (OSL 3.0): The full text of the OSL 3.0 license can be found in the
LICENSE.txtfile within this package, and is also available online at http://opensource.org/licenses/osl-3.0.php.
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.