Skip to content

About

Supertext AI translation for Magento 2 and Mage-OS: translate products, categories, CMS pages and blocks into your store views.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

48 Commits

Folders and files

Repository files navigation

Supertext Translation for Magento

Translate Magento products, categories, CMS pages and blocks into your store views' languages with Supertext AI, straight from the admin lists and edit pages. Works with Magento Open Source, Adobe Commerce and Mage-OS.

Demo: in the Magento admin, an editor opens the English product “Dark chocolate praline box”, clicks Translate with Supertext, keeps the German and French store views, clicks Translate and opens the product in the store view Deutsch (Schweiz), now named “Pralinenbox mit dunkler Schokolade”

Select products in Catalog → Products (or pages and blocks in Content), choose Translate with Supertext in the Actions menu, pick the store views and click Translate. Product and category texts are saved as each store view's own values, so they show up in that store view right away; pages and blocks get a translated copy per store view.

  • Works with Magento's own store views and locales: no extra multilingual extension needed
  • Translates names, descriptions, SEO fields and page/block content; formatting, links, Page Builder layouts and {{…}} directives are kept
  • URL keys follow the translated name, with URL rewrites and a redirect from the old URL
  • Fills only untranslated store-view values unless you tick Overwrite existing translations, with a clear warning first
  • A Supertext language per store view (a select of Supertext's own codes; obvious defaults such as es_ES → es, nothing else guessed) and a formal or informal tone where Supertext offers one
  • Automatic API key check and optional version information for Supertext support (on by default, SUPERTEXT_VERSION_REPORTS=0 turns it off)
  • Export for translation (XLIFF 1.2 or HTML) and Import translation of translated files, for translation tools, translators or Supertext's web app, on the same page
  • Also on the command line: bin/magento supertext:translate product 1 2 --store=de_ch

The Translate with Supertext page after translating two products into German, French and Italian store views

Export for translation and import (XLIFF and HTML)

Besides translating with Supertext AI, you can export a product, category, CMS page or block as a file, have it translated elsewhere and import the result.

  • Where: the export and import sections at the bottom of the Translate with Supertext page.
  • Formats: XLIFF 1.2 for translation tools such as Trados, memoQ or Phrase (formatting travels as protected tags; several target languages in one file), or HTML (one language per file) for translators or Supertext's web app, which keeps the file's head and data-st-id attributes, so the translated file imports as it is.
  • Import: the file says what it was exported from and for which language. The translations are written with the same rules as a Supertext AI translation, and a summary shows what was imported and what was skipped: source changed since the export (import those anyway with Also import texts whose source changed since the export), not translated, formatting changed, not in the file.
  • Safe: files over 10 MB, files from another system and translations that add markup the source doesn't have are refused; uploaded files aren't stored.

Details: user guide.

Documentation

Guide For
Installation guide Administrators: requirements, install, API key, store views, settings, troubleshooting
User guide Editors: translating, reviewing, what gets translated
Developer guide Architecture, API protocol, local development, tests, demo deployment, releases

Quick start:

composer config repositories.supertext vcs https://github.com/Supertext/Magento-Supertext-Translation
composer require supertext/magento-supertext-translation:^0.1
bin/magento module:enable Supertext_Translation && bin/magento setup:upgrade

Then enter your API key in Stores → Configuration → Supertext → Translation. No Supertext account yet? Create one at supertext.com. Generate your API key at supertext.com → Integrations → API (requires the Admin role).

Demo

demo/ is a Mage-OS 4.0 shop with English sample products, a category, a CMS page and a block, plus store views for German (Switzerland), French (Switzerland) and Italian (Switzerland), deployed to Railway from this repository. See the developer guide.

Changelog and roadmap

See CHANGELOG.md and the roadmap.

Supertext plugins for other systems

Supertext offers AI and professional translation plugins for these systems:

Content management systems (CMS)

System Plugin Type of integration What it does
Adobe Experience Manager supertext-aem-connector Translation connector: two AEM content packages for AEM's Translation Integration Framework. Sends AEM translation projects to Supertext and imports the results
ApostropheCMS Apostrophe-Supertext-Translation Apostrophe module (npm): a translation provider for Apostrophe's own Localize… step. Translates pages and pieces as editors localize them, widgets and rich text included
Contao Contao-Supertext-Translation Contao bundle (Composer) that adds a back-end action. Translate with Supertext in the site structure: pages or whole websites into other languages
Craft CMS CraftCms-Supertext-Translation Craft plugin (Composer) with a panel on the entry page. Translates entries into your other sites, Matrix and rich text included
Directus Directus-Supertext-Translation Directus extension bundle (npm): interface, endpoint, Flow operation and module. Translate with Supertext box on the item form, fills the Translations field
django CMS djangoCMS-Supertext-Translation Django app (Python package) that adds a toolbar entry. Translates pages and their plugins from the toolbar
Drupal tmgmt_supertext_ai Drupal module: a translator provider for the Translation Management Tool (TMGMT), by MD Systems. Translates TMGMT jobs with Supertext AI
Ghost Ghost-Supertext-Translation Separate connector service (Ghost has no admin plugins): works through internal tags, webhooks and the Admin API. Tag a post #translate-… and a translated draft appears
Grav Grav-Supertext-Translation Grav 2 plugin with an Admin2 panel. Supertext panel in the page editor, Markdown kept intact
HubSpot HubSpot-Supertext-Translation Hosted app connected to HubSpot with OAuth, working through HubSpot's multi-language content. Translates website and landing pages, blog posts, marketing emails and knowledge base articles into draft language versions
Joomla Joomla-Supertext-Translation Joomla system plugin (installable package). Translates articles into linked, unpublished language versions
Magnolia Magnolia-Supertext-Translation Magnolia module with a Translate with Supertext action in the Pages app. Translates pages, areas and components into the site's other languages
Neos Neos-Supertext-Translation Neos package (Composer) that hooks into the content repository, with a Supertext backend module for translation files. Translates automatically when an editor creates a page in another language
Orchard Core OrchardCore-Supertext-Translation Orchard Core module (.NET) with an admin page and a localization hook. Translates content items into other cultures, on demand or on localization
Payload CMS Payload-Supertext-Translation Payload plugin (npm) added to payload.config. Translate button for localized collections and globals
Silverstripe Silverstripe-Supertext-Translation Silverstripe module (Composer) on top of Fluent. Supertext tab translates pages and Elemental blocks into Fluent locales
Strapi Strapi-Supertext-Translation Strapi 5 plugin (npm) with a Content Manager panel. Translates entries into other locales from the Content Manager
TYPO3 Typo3-Supertext-Translation TYPO3 extension (Composer) that hooks into TYPO3's own localization, with a Supertext backend module for translation files. Translates pages and content elements as editors localize them
Umbraco Umbraco-Supertext-Translation Umbraco package (NuGet) with a backoffice extension. Translate with Supertext for pages, block lists and grids included
Wagtail Wagtail-Supertext-Translation Python package: a machine translator for wagtail-localize. Translates pages and snippets inside wagtail-localize's editor
WordPress (Polylang) Wordpress-Polylang-Supertext-Translation WordPress plugin: a machine-translation service for Polylang Pro, plus professional translation orders. AI translation next to DeepL in Polylang, and human translation orders
WordPress (WPML) Wordpress-WPML-Supertext-Translation WordPress plugin for WPML, with bulk actions in the posts and pages lists and a Supertext box in the editor. AI translation into your WPML languages, professional translation orders and XLIFF/HTML translation files

Product information management (PIM)

System Plugin Type of integration What it does
Akeneo PIM Akeneo-Supertext-Translation Akeneo PIM bundle with a Translate with Supertext action on the product page. Translates products and product models into your other locales
AtroPIM AtroPIM-Supertext-Translation AtroCore module with a button on the product and a mass action in the list. Translates products and other AtroCore records into your other languages
Pimcore Pimcore-Supertext-Translation Pimcore bundle (Composer) with a Translate with Supertext button in Pimcore Studio. Translates documents into linked language versions and data objects' localized fields

E-commerce

System Plugin Type of integration What it does
Magento Magento-Supertext-Translation Magento 2 module (also Mage-OS) with a mass action in the admin lists and a button on the edit pages. Translates products, categories, CMS pages and blocks into your store views' languages
PrestaShop PrestaShop-Supertext-Translation PrestaShop module with a bulk action in the back-office lists. Translates products, categories and CMS pages into your shop's other languages
Shopify Shopify-Supertext-Translation Shopify app in the Shopify admin. Translates products, collections, pages and blog posts into all your shop's languages
Wix Wix-Supertext-Translation Wix app with a dashboard page (hosted service), working through Wix Multilingual. In development: translates Wix Stores products and other Wix Multilingual content into your site's languages

Email marketing

System Plugin Type of integration What it does
Mailchimp Mailchimp-Supertext-Translation Hosted app connected to Mailchimp with OAuth: Supertext folders in Mailchimp and a translate page. In development: turns a campaign into one draft per language, each sent to the subscribers with that language

Design files (XLIFF round trip)

Application Plugin Type of integration What it does
Adobe InDesign Adobe-InDesign-Translation InDesign scripts (ExtendScript). Exports all text to XLIFF 1.2 for any CAT tool and imports the translations with formatting intact
Adobe Illustrator Adobe-Illustrator-Translation Illustrator scripts (ExtendScript). Exports all text to XLIFF 1.2 for any CAT tool and imports the translations with formatting intact
CorelDRAW CorelDRAW-Supertext-Translation CorelDRAW VBA macro. Exports all text to XLIFF 1.2 for any CAT tool and imports the translations with formatting intact

Support

Questions, problems or ideas? Use the Supertext support form: describe what happened and you get an answer by email, in your language. Requests are tracked as issues in this repository, without your name and email address. Developers are welcome to open issues and pull requests here directly. Security issues: see SECURITY.md.

License

MIT. © Supertext AG

About

Supertext AI translation for Magento 2 and Mage-OS: translate products, categories, CMS pages and blocks into your store views.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages