Skip to content

About

Supertext AI translation for AtroPIM: translate products and other AtroCore records into your other languages.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Supertext Translation for AtroPIM

Translate AtroPIM products, and any other AtroCore record, into your other languages with Supertext AI: a Translate with Supertext button on the product and a mass action in the product list.

The record's multilingual texts go to Supertext in one request per language and come back into that language's fields, saved through AtroCore's own permissions, validation and history. Editors review and adjust the translation in AtroPIM as usual.

  • Translates multilingual text, Markdown and rich text fields and attribute values (bold text, links and lists are kept; whole sentences are translated)
  • Products, categories, brands or any other entity: an AtroCore action of the new type Translate with Supertext per entity, as a button, in the More menu and as a mass action, optionally in the background
  • Fields that already have text in a language are kept unless the action overwrites them
  • The API key lives in an AtroCore connection of type Supertext (encrypted, Test connection), or in SUPERTEXT_API_KEY
  • Source and target languages, form of address and the language mapping (a combo box per AtroPIM language with Supertext's languages, preselected with the obvious one) are configurable
  • Translation review per language: translations into a language with it ticked go through Supertext's review service, where reviewers correct them on your website; the corrections come back with the next translation
  • Checks the API key automatically and, unless switched off, sends version information (site URL, module, AtroPIM and PHP versions; no content, no key) to Supertext
  • Export for translation (XLIFF 1.2 or HTML) and Import translation of translated files, for translation tools, translators or Supertext's web app (two more action types)
  • Console commands supertext translate, supertext export, supertext import and supertext check; English, German, French and Italian interface

A product translated into German, French and Italian with Translate with Supertext

Export for translation and import (XLIFF and HTML)

Besides translating with Supertext AI, you can export a product or another record as a file, have it translated elsewhere and import the result.

  • Where: the action types Export for translation and Import translation (an admin adds them as actions), plus REST endpoints and console commands.
  • 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, the action, languages, permissions, settings, troubleshooting
User guide Editors: translating one or several products, reviewing, translating again, what gets translated
Developer guide Architecture, API protocol, local development, tests, demo deployment, releases

Quick start for AtroCore 2.4 / AtroPIM 1.16 (you need a Supertext account and an API key from supertext.com → Integrations → API, which requires the Admin role): add {"type": "vcs", "url": "https://github.com/Supertext/AtroPIM-Supertext-Translation"} to the repositories in your AtroCore project's composer.json, then

php atrocore-installer.phar require supertext/atropim-supertext-translation:dev-main

Create a connection of type Supertext with the key under Administration → Connections, and an action of type Translate with Supertext for Product under Administration → Actions.

Demo

demo/ is an AtroPIM with English sample products, a multilingual attribute and German, French and Italian (Switzerland) as additional languages, deployed to Railway from this repository: https://atropim-production.up.railway.app/. See the developer guide.

Changelog and roadmap

See CHANGELOG.md and Known limitations / 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) supertext-wordpress-polylang WordPress plugin: a machine-translation service for Polylang Pro, plus professional translation orders. AI translation next to DeepL in Polylang, and human translation orders

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

License

MIT. © Supertext AG

About

Supertext AI translation for AtroPIM: translate products and other AtroCore records into your other languages.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages