v1.0.0

Install and setup: installation guide.

What's in 1.0.0

First stable release. Every plugin release is now tested end to end against the live Supertext API (.github/workflows/e2e.yml).

• Fixed: the Status block in the extension configuration (Settings → Extension Configuration) showed only The Supertext status is not available here. TYPO3 builds that form in the install tool's failsafe mode, where the extension's services aren't available; the block now builds what it needs itself and reads the sites from their configuration files.
• Docs: demo movie in the README (docs/images/demo.gif): an editor localizes a page into German with TYPO3's Translate wizard and Supertext translates it. Recorded by Tests/Docs/movie.mjs against the demo and the stand-in API; the MP4 version (not committed) has an English voice (Piper voice “alba”, CC BY 4.0), and Tests/Docs/movie-install.mjs records an install and configuration movie (MP4 only).
• Added: the Supertext support form is linked in the README, the user guide and GitHub's "New issue" page.
• Added: Translation review on/off per site language (Sites → Setup → edit the site → Languages → (language) → Supertext → Translation review, supertext_review in the site configuration): translations into a language with review on go through Supertext's review service (Supertext Localization Review), where customers and Supertext linguists correct them on the website with a Chrome extension; corrections come back into TYPO3 with the next translation, and texts translated before keep their (reviewed) wording. Same API key, billing, languages and messages; other languages keep going directly to Supertext. New setting reviewUrl (defaults to Supertext's review service; empty turns review off everywhere; SUPERTEXT_REVIEW_URL wins). Off for existing sites; nothing to migrate. All four interface languages.
• Added: backend module Content → Supertext (Web → Supertext in TYPO3 13) with Export for translation (select a page in the page tree, tick the languages, choose XLIFF 1.2 or HTML, Download file) and Import translation (upload a translated file, optionally Also import texts whose source changed since the export, result per page and language). It works as the logged-in user: only pages they may see and languages they may edit, and the import respects their permissions. Editors need access to the module in their backend group. In English, German, French and Italian.
• Added: Export for translation (XLIFF 1.2 or HTML) and import of translated files; Supertext SDK 0.5.0. vendor/bin/typo3 supertext:export <page> <language…> [--format=xliff|html] [--output=<file>] writes a page with its content elements and file references as a file for a translation tool, a translator or Supertext's web app; vendor/bin/typo3 supertext:import <file> [--include-changed] writes the translated texts into the page's translation (localizing what doesn't exist yet, hidden for review) and prints a summary: imported, skipped because the source changed since the export, not translated, formatting changed, not in the file. Messages in English, German, French and Italian.
• Changed: Supertext SDK 0.4.0 (6aaad33): a site language without a Supertext language uses the usual default instead of stopping: de → de-DE, en → en-US, fr → fr-FR, it → it-IT, pt → pt-PT, zh/zh_CN → zh-Hans, zh_TW → zh-Hant, sr → sr-Latn, es_ES → es, nl_NL → nl. Only locales without an obvious one (en_IE, de_LI, fr_BE, gsw, …) still need a choice; the Status block marks only those and shows default next to defaulted codes.
• Changed: the Supertext language select in the site language form shows Default (de-DE) (the code the language is sent as) or — choose — where there is no default, lists the Supertext languages with their names in the backend user's language, keeps a custom code set in the YAML, and saving accepts only codes from the list. The Supertext tone field appears only for languages that offer formal/informal address.
• Added: upgrade wizard Supertext: language codes of the site languages (supertextTranslation_languageCodes): rewrites free-text supertext_code values of 0.1 to the list's codes (de_ch → de-CH, de → de-DE, de_DE_formal → de-DE with formal tone).
• Changed: version reports, the API key check result and the reachability ping now use Supertext Plugin Health 0.1.0 (bundled in lib/supertext-plugin-health); Supertext SDK updated to 0.3.0. No change for sites: settings and stored state stay as they are.
• Added: support for PHP 8.5 (now tested in CI next to 8.2, 8.3 and 8.4).
• Changed: only Supertext's own language codes. Supertext accepts only its own codes (regional for German, English, French, Italian and Portuguese, e.g. de-CH; bare for most others, e.g. es, nl, sl; zh-Hans, sr-Latn). A site language is sent with its supertext_code, else its locale if that is a Supertext code, else the default described above; a language with none of them stops with The language … has no Supertext language yet and nothing is sent. The old default regions are gone (es → es-ES, sl → sl-SI, zh → zh-CN were rejected by Supertext).
• Added: a Supertext palette in the site language form (Sites → Setup → Languages) to choose the Supertext language from the list of Supertext languages and the tone; stored as supertext_code / supertext_politeness as before.
• Added: a Status block at the top of the extension configuration: the latest API key check with its time, whether version information is sent (with the ping address), and every site language with the Supertext code it is sent as (unmapped languages and a tone a language doesn't offer are marked).
• Added: automatic API key check (Supertext's cost-free features call) after the configuration was saved, when the key changes and when Supertext rejects the key during a translation; the result shows in the Status block, with the links to create a Supertext account and to generate a key.
• Added: setting Send version information to Supertext (on by default; SUPERTEXT_VERSION_REPORTS=0 turns it off): sends the site URL and the extension, TYPO3, PHP and SDK versions, whether a key is set and the key check result to the Supertext Commando Center after a configuration save and an update. No content, no API key, no personal data. Never slows down or breaks a save or a translation.
• Added: public ping endpoint GET /supertext/ping?challenge=… (answers 404 while version information is off), so Supertext can see that the site is reachable.
• Added: messages for a language without Supertext language and for a tone Supertext doesn't offer for a language, in English, German, French and Italian.
• Fixed: bundled Supertext SDK 0.2.1 (eeba8fa): one supertext_code serves both directions; the default language is sent as the source in its source form (de-CH → de), so English as the source no longer fails with an en-US Supertext language.
• Changed: bundled Supertext SDK 0.2.0 (c66cb4d, API classes in the V1 namespace). The User-Agent now carries the version from ext_emconf.php.
• Changed: the extension now talks to Supertext through the official Supertext SDK for PHP instead of its own API client, HTML packer and language code rules. The SDK is bundled in the extension (lib/supertext-sdk), so there is nothing extra to install. Same behaviour; requests go through TYPO3's HTTP client as before.
• Added: clear messages when Supertext rejects a language pair or returns an incomplete translation (in English, German, French and Italian).
• Demo: TYPO3 14.3.10.
• Fixed: target languages whose locale has no region (e.g. de) are now sent to Supertext as a regional code (de-DE, fr-FR, en-US, …), which Supertext requires; a supertext_code override is normalized (de_ch → de-CH). The source is always sent without region.
• Fixed: a target language Supertext doesn't know is now reported as an unsupported language pair (was: file not found).
• Fixed: locale variants such as de_DE_formal (in a supertext_code) are sent to Supertext as de-DE.
• Added: French and Italian interface (and German where it was missing): the extension configuration and the messages after a translation follow the backend user's language. The authentication-failed message now also links to Supertext account signup.