Repository navigation
v0.1.0
Pre-release
Pre-release
Pre-release. Install and setup: installation guide.
What's in 0.1.0
- First version: Magento 2 module
Supertext_Translation(Mage-OS 3.5 / Magento 2.4.9 tested; Magento Open Source and Adobe Commerce 2.4.7+ supported; PHP 8.2+). - Translate with Supertext as a mass action in Catalog → Products, Content → Pages and Content → Blocks, and as a button on the edit pages of products, categories, pages and blocks.
- Translate page: the store views to translate into (other languages ticked), the current state per item and store view, and an explicit Overwrite existing translations option with a warning. Translations run one item and store view at a time, with the result shown per cell.
- Products and categories: name, descriptions, meta title, keywords and description are saved as store-view values; the URL key follows the translated name, with URL rewrites (the old URL redirects).
- CMS pages and blocks: a translated copy per store view with the same URL key or identifier, linked to the original; the original page is removed from that store view. New copies keep the original's status, or are created disabled (setting).
- Rich text keeps its formatting, Page Builder markup and Magento directives (
{{widget}},{{media}},{{store}},{{config}}). - Fills only fields that are empty or still show the default value, unless Overwrite is ticked.
- Configuration: API key (encrypted; with or without the
Supertext-Auth-Keyprefix;SUPERTEXT_API_KEYwins), links to create a Supertext account and generate the key, Test connection, API environment, custom endpoint (SUPERTEXT_API_ENDPOINTwins), timeout, per-store-view Supertext language code and tone, status of new CMS copies, module version linked to its release. - ACL resources Translate with Supertext and Supertext Translation (configuration).
- Requests that hit Supertext's per-second rate limit are retried automatically.
- CLI:
bin/magento supertext:translate <product|category|cms_page|cms_block> <ids> [--store=<code>] [--overwrite]. - Demo for Railway (
demo/): Mage-OS 3.5 on MySQL and Elasticsearch with German (CH), French (CH) and Italian (CH) store views, sample products, category, Page Builder page and block, a Supertext editor role, andDEMO_ADMIN_*/DEMO_EDITOR_*accounts created on every start. - Docs with screenshots, regenerated by
tests/docs/screenshots.mjsagainst a stand-in API.