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).

• Changed: the minimum Umbraco 17 version is now 17.8.0 (earlier 17.x pulled in MessagePack and System.Security.Cryptography versions with known vulnerabilities).

• Changed: the demo runs Umbraco 18.3 with the Clean 8 starter kit (was Umbraco 17.8 with Clean 7). Umbraco 17 LTS stays supported: CI now runs the package as published in a fresh site on both Umbraco 17.8 and 18.3 and translates through the backoffice on each.

• Fixed: on Umbraco 18 the Translate with Supertext dialog failed to load (Umbraco 18 removed a method the package used; HTTP 500, MissingMethodException in the log). Now tested on Umbraco 18.3 and 17.8.

• Docs: demo movie in the README (docs/images/demo.gif, recorded from the demo against the stand-in with npm run movie in Tests/Docs; the MP4 version, not committed, is narrated with the Piper voice “alba”), and an install and configuration movie (npm run movie:install: the install commands, SUPERTEXT_API_KEY, Settings › Languages, Settings › Supertext with Check API key and the language mapping, and where editors find Translate with Supertext; narrated MP4, not committed).

• Added: the Supertext support form is linked in the README, the user guide and GitHub's "New issue" page.

• Added: Translation review per language (Settings › Supertext, box Languages, checkbox Translation review; Supertext:Languages:<culture>:Review in appsettings.json wins): translations into a language with it ticked 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 Umbraco 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 Supertext:ReviewUrl / SUPERTEXT_REVIEW_URL (defaults to Supertext's review service; "" turns review off everywhere). Existing sites start with review off. English, German, French, Italian.

• Added: language mapping on Settings › Supertext: a combo box with Supertext's languages per Umbraco language (names in the backoffice language, codes next to them), preselected with the matching or usual Supertext language (de → de-DE; — choose — where there is none, e.g. en-IE, gsw), and Formal/informal where Supertext offers it, saved with Save (stored in umbracoKeyValue; no restart). Supertext:Languages:<culture>:Code / Politeness in appsettings.json still work and win over the screen (shown as set in appsettings.json), so existing configurations keep working unchanged. The has no Supertext language yet and no formal or informal tone messages now point to Settings › Supertext. The demo sets its formal address this way instead of in appsettings.json. English, German, French, Italian.

• Added: Export for translation (XLIFF 1.2 or HTML) and import of translated files; Supertext SDK 0.5.0. In the Translate with Supertext dialog: download a page's texts for the ticked languages (HTML: one), have them translated elsewhere, upload the file again; the texts are saved as drafts like translations with Supertext, with a summary (imported, skipped because the source changed, untranslated, formatting changed, not in the file). Texts whose source changed since the export are only imported on request. English, German, French, Italian.

• Changed: a culture nobody mapped now uses Supertext's obvious default language (Supertext SDK 0.4.0): de → de-DE, en → en-US, fr → fr-FR, it → it-IT, pt → pt-PT, zh-CN → zh-Hans, es-ES → es; Settings › Supertext shows it as Supertext default. Cultures without an obvious default (en-IE, gsw …) still need a mapping.

• Changed: languages are no longer guessed. An Umbraco culture that is a Supertext code (de-CH, fr-CH, es, nl, zh-Hans, apart from case and _/-) is used as it is; every other culture needs Supertext:Languages:<culture>:Code (the same setting as before, now the language mapping, used for source and target). The default regions are gone: they were wrong for most languages (Supertext wants es, sl, nl without region and zh-Hans instead of zh-CN). An unmapped language is marked not mapped in the dialog, and translating into it says has no Supertext language yet; nothing is sent for it. New message for no formal or informal tone for this language (English, German, French, Italian).

• Added: Settings › Supertext dashboard: package version, API endpoint, whether a key is set, the latest automatic API key check with its time and a Check API key button, the version reports setting, and every Umbraco language with its Supertext code (Not mapped where one is missing) and tone (with a warning where Supertext offers none). English, German, French, Italian.

• Added: automatic API key check (no cost) when the key changes, on Check API key and after Supertext rejects a translation's key.

• Added: Send version information to Supertext (Supertext:SendVersionReports, on by default; SUPERTEXT_VERSION_REPORTS=0 turns it off): after an update and when the key check result changes, the site URL, the versions of the package, Umbraco, .NET and the Supertext SDK and the key check result are sent to Supertext, never content, the API key or personal data. Public ping route GET /umbraco/supertext/ping (404 while reports are off). See the installation guide.

• Changed: bundled Supertext SDK 0.3.0 (commit f7bd414, V1 namespace): the API's language list and the key check.

• 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.

• Changed: the package now talks to Supertext through the official Supertext SDK for .NET instead of its own API client, HTML packer and language code rules. The SDK is compiled into the package, so there is nothing extra to install; HtmlAgilityPack is no longer referenced. Same behaviour.

• Added: clear messages when Supertext rejects a language pair or returns an incomplete translation (English, German, French, Italian).

• Fixed: a target language Supertext doesn't know is now reported as an unsupported language pair (was: The requested Supertext resource was not found).

• Added: French and Italian interface (and German where it was missing). The button, dialog, notifications and error messages follow the backoffice user's UI culture (English, German, French, Italian); server errors are sent with a code so the dialog can show them in the user's language. The "Authentication failed" message now also links to Supertext account signup and API key generation.

v0.1.0

Pre-release. Install and setup: installation guide.

What's in 0.1.0

• First version for Umbraco 17/18: Translate with Supertext in the document workspace and actions menu, with a dialog to choose source and target languages.
• Translates the page name, text boxes, text areas, rich text (incl. its blocks) and text inside block list / block grid blocks; copies all other culture-variant values; saves target languages as drafts.
• One Supertext request per target language; confirmation before replacing languages that already have content; per-language results and notifications.
• Settings: API key (SUPERTEXT_API_KEY), endpoint, per-language code / formality / visibility, editors, excluded properties. Retries on rate limiting; bare URLs, e-mails and numbers are never sent.
• Demo container (demo/): Umbraco 17 LTS + Clean starter kit made multilingual (de-CH, fr-CH, it-CH), accounts from DEMO_ADMIN_* / DEMO_EDITOR_*.
• Installation, user and developer guides with screenshots generated from the demo (Tests/Docs/screenshots.mjs).
• The "No Supertext API key" warning in the dialog, the missing-key error, the config comments and the docs now link to Supertext account signup and API key generation (supertext.com → Integrations → API, Admin role required).