PHPackages mage-os/module-automatic-translation - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. mage-os/module-automatic-translation ActiveMagento2-module[Localization & i18n](/categories/localization) mage-os/module-automatic-translation ==================================== Automatic AI content translation for Mage-OS. 2.1.0(2mo ago)277.1k↑26.6%8[8 issues](https://github.com/mage-os/module-automatic-translation/issues)[1 PRs](https://github.com/mage-os/module-automatic-translation/pulls)MITPHPPHP >=8.2CI passing Since Nov 15Pushed 2mo ago3 watchersCompare [ Source](https://github.com/mage-os/module-automatic-translation)[ Packagist](https://packagist.org/packages/mage-os/module-automatic-translation)[ RSS](/packages/mage-os-module-automatic-translation/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (12)Versions (31)Used By (0) MageOS Automatic Translation Module for Magento =============================================== [](#mageos-automatic-translation-module-for-magento) Overview -------- [](#overview) The **MageOS Automatic Translation** module allows you to automatically translate content in your Magento store, such as products, categories, pages, and static blocks, using AI-based translation engines. The module is natively integrated with DeepL, OpenAI and Google Gemini, but it can be easily extended to support other translation engines. Installation ------------ [](#installation) 1. Install the module via Composer: ``` composer require mage-os/module-automatic-translation ``` 2. Enable the module: ``` bin/magento module:enable MageOS_AutomaticTranslation ``` 3. Run the setup upgrade command: ``` bin/magento setup:upgrade ``` Features -------- [](#features) ### Product Translation [](#product-translation) The product translation process is divided into two parts: 1. **Textual attributes** – The translated value is directly set in the product entity. 2. **Select and Multiselect attributes** – The translation of these attributes involves translating the labels of the options, not the option IDs, as option IDs remain consistent across languages. The module automatically translates products via scheduled cron jobs for both textual and select/multiselect attributes. You can also manually translate products through a backoffice button available in the product editing page. **Cron Jobs for Product Translation**: - The product translation process runs according to a cron schedule, which can be configured via the `Product translation cron expression` in the configuration. - For select/multiselect attribute options, another cron job is scheduled, configurable via the `Select attributes translation cron expression`. ### Category Translation [](#category-translation) Categories are translated only manually via a backoffice button. This is because the number of categories is usually much smaller than the number of products, and thus the manual translation process is more efficient. For categories, only the following fields are translated: - Name - Description - URL Key - Meta information **Note**: If you add custom attributes to categories programmatically, it is the developer’s responsibility to decide whether to translate these attributes and add them to the translation list programmatically. ### Pages and Static Blocks Translation [](#pages-and-static-blocks-translation) Similar to categories, pages and static blocks can only be translated manually via a backoffice button. However, because Magento does not support multiple language versions for pages and static blocks, translation will overwrite the original content when saving. To prevent losing the original content, it is recommended to use the "Save & Duplicate" feature in the backoffice to create a copy of the page or block before translating it. ### Retranslation of Products [](#retranslation-of-products) When the module translates a product for a storeview, it values two attributes specific to that product and that storeview: "skip translation" set to "yes" and "last translation date" with the date of the translation. These attributes are automatically created by the module during installation and are updated each time the product is translated. This process is used to "flag" the product as "already translated" preventing it from being translated again in future executions, thus improving performance. However, if the merchant changes the basic content of the product after translation, it may need to be retranslated. The merchant can do this manually by using the button in the backoffice or by setting the "skip translation" attribute to "no" and saving the product. These operations are feasible if there are few products to be edited. If, however, there are many products to be retranslated or the underlying content changes frequently, it may be useful to enable automatic retranslation. When enabled, this feature also includes products with the "skip translation" attribute set to "yes" in the translation process if the date in the "last translation date" attribute is older than a specified number of days, which can be configured in the settings. ### Translation Engines [](#translation-engines) - **DeepL**, **OpenAI** and **Google Gemini** are the supported engines by default. You can easily extend the module to support additional translation engines by creating a class that implements the `MageOS\AutomaticTranslation\Api\TranslatorInterface`. - The engine is selected under **Stores > Configuration > MageOS > Automatic translation with AI > Translation engine**. ### Configuration Options [](#configuration-options) The module provides several configuration options under **Stores > Configuration > Services > AI Integration > Automatic translation with AI**: #### General Configuration [](#general-configuration) - **Enable**: Enables or disables the module. This setting is configurable per store view, allowing you to translate only certain languages. - **Source Language**: Defines the source language of your content. This is typically set to the language in which your products were initially created. - **Destination Language**: This is the target language for translation, which corresponds to the store view's language. #### Catalog Translation Options [](#catalog-translation-options) - **Product Text Attributes to Translate**: Select the textual attributes you want to translate (e.g., name, description). - **Product Select/Multiselect Attributes to Translate**: Select which select/multiselect attributes to translate. - **Translate Disabled Products**: Skips disabled products during translation to improve performance. - **Product Translation Cron Expression**: Schedules the product translation process. - **Select Attributes Translation Cron Expression**: Schedules the translation of select/multiselect attributes. - **Enable Periodic Retranslation & Retranslation Period (in days)**: Enables automatic retranslation for products if their translation is outdated (older than a set number of days). #### Translation Engine Configuration [](#translation-engine-configuration) - **Engine**: Choose the translation engine (DeepL or OpenAI or Google Gemini). - **API Credentials**: Configure API credentials for the selected engine. - **Model Language** (for OpenAI & Google Gemini): This field is dynamic and will be populated once valid API credentials are entered. ### Adding Additional Translation Engines [](#adding-additional-translation-engines) To add a new translation engine, you need to: 1. Create a class implementing `MageOS\AutomaticTranslation\Api\TranslatorInterface`. 2. Extend the module to add the new engine's API configuration in `system.xml`. 3. Add an after plugin to modify the list of selectable engines in `\MageOS\AutomaticTranslation\Model\Config\Source\TranslationEngineList::toOptionArray`. ### Health Score 53 — FairBetter than 97% of packages Maintenance82 Actively maintained with recent releases Popularity37 Limited adoption so far Community18 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 60.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~18 days Recently: every ~1 days Total 28 Last Release 60d ago Major Versions 1.11.2 → 2.0.02026-03-12 PHP version history (3 changes)1.11.2PHP >=7.4 2.0.0PHP >=8.3 2.1.0PHP >=8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/100189073?v=4)[Mage-OS](/maintainers/mage-os-ci)[@mage-os-ci](https://github.com/mage-os-ci) --- Top Contributors [![SamueleMartini](https://avatars.githubusercontent.com/u/40766441?v=4)](https://github.com/SamueleMartini "SamueleMartini (46 commits)")[![dadolun95](https://avatars.githubusercontent.com/u/8927461?v=4)](https://github.com/dadolun95 "dadolun95 (19 commits)")[![mage-os-ci](https://avatars.githubusercontent.com/u/100189073?v=4)](https://github.com/mage-os-ci "mage-os-ci (5 commits)")[![WaPoNe](https://avatars.githubusercontent.com/u/11091926?v=4)](https://github.com/WaPoNe "WaPoNe (2 commits)")[![rikwillems](https://avatars.githubusercontent.com/u/5927342?v=4)](https://github.com/rikwillems "rikwillems (2 commits)")[![rhoerr](https://avatars.githubusercontent.com/u/13335952?v=4)](https://github.com/rhoerr "rhoerr (1 commits)")[![peterjaap](https://avatars.githubusercontent.com/u/431360?v=4)](https://github.com/peterjaap "peterjaap (1 commits)") --- Tags adobecommerceaiecommerceextensioni18nmage-osmage-os-labmagentomagento2 ### Embed Badge ![Health badge](/badges/mage-os-module-automatic-translation/health.svg) ``` [![Health](https://phpackages.com/badges/mage-os-module-automatic-translation/health.svg)](https://phpackages.com/packages/mage-os-module-automatic-translation) ``` ### Alternatives [kargnas/laravel-ai-translator AI-powered translation tool for Laravel language files 24838.8k1](/packages/kargnas-laravel-ai-translator)[splendidinternet/mage2-locale-de-de German (Germany) language 861.0M2](/packages/splendidinternet-mage2-locale-de-de)[acclaro/translations Easily launch and manage multilingual Craft websites without having to copy/paste content or manually track updates. 1229.5k](/packages/acclaro-translations) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)