🐞 Bug Fixes

• Plain text keeps its special characters: Text and tags fields, code blocks, and Markdown no longer come back with ', < and > where the source had ', < and >. DeepL's HTML tag handling is now sent only for text that actually carries markup, such as Writer fields and blocks. See the documentation.

🚀 Features

• Full DeepL language catalogue: Languages such as Catalan, Serbian, Swahili, Cantonese, and Welsh now translate instead of failing with an unsupported-language error. See the DeepL documentation.
• Language code overrides: The new targetLanguageOverrides config option maps a Kirby language code to any DeepL target code – including codes DeepL releases after this version. See the DeepL documentation.

🐞 Bug Fixes

• Regional variants follow the language code: A de-ch language now translates to Swiss German and zh-tw to Traditional Chinese, even when the server locale disagrees. Previously the locale won, so sites with both a Simplified and a Traditional language received identical translations for the two. Thanks to @gutschik for the report.

🚀 Features

• AI translations via Copilot's plugin API: Content Translator now talks to Kirby Copilot through its versioned plugin API, keeping both plugins compatible as they evolve independently. Requires Kirby Copilot v3.9.0+ – older versions show an update notice when an AI translation is started. See the AI translation documentation.

🐞 Bug Fixes

• Translation Coverage on large sites: Opening the coverage view no longer hits max_execution_time on sites with thousands of pages. Field keys are now resolved once per blueprint instead of once per page.
• Translation Coverage with Staticache: The coverage view now displays reliably when Staticache is active. Coverage results moved to the plugin's own cache, so they're no longer evicted on every page render or content change.

🐞 Bug Fixes

• AI translation reliability: Provider artifacts no longer leak into stored content. Previously, some providers (most notably Mistral) could echo batch wrappers (<item index="N">…</item>), HTML entities, or refusal text. See the documentation.

🚀 Features

• Pluggable translation strategies: New johannschopplich.content-translator.strategy config option accepts 'deepl', 'ai', a Closure, or a custom Strategy instance. See the strategies documentation.
• PHP classes: First-class PHP API for programmatic translation. Run translations from CLI, hooks, or any custom workflow. See the PHP classes documentation.

⚠️ Deprecated

• translateFn config option: Use 'strategy' => $closure instead – the closure signature is identical. Will be removed in v4. See the migration guide.

🚀 Features

• Translation Coverage view: A new Panel dashboard on /panel/languages showing per-language completion percentages and a pruned tree of pages still missing translations. Kirby 5 only. See the translation coverage documentation.
• Content inheritance for imports: When importing content from the default language, the secondary language's content file is now deleted instead of copied. Kirby's built-in content inheritance keeps the secondary language automatically in sync with the primary language.

🐛 Fixes

• KirbyTag handling: KirbyTags are now extracted structurally before translation. Only their translatable parts (such as link text) are sent to the provider, while attributes, file references, and tag syntax are preserved verbatim.
• File and site translation: Translating a file or the site model no longer attempts title and slug patches that don't apply to those models. Title and slug updates are now scoped to pages, where they belong.

🚀 Features

• AI translations: Kirby Copilot integration for AI-powered translations using OpenAI's GPT models, Google Gemini, Anthropic Claude, or Mistral models.
• UX Improvements: Loading indicator during translation requests for better user feedback.
• System view license management: View your license key, activation status, and version compatibility directly in the Kirby Panel system view. Activate new licenses without leaving the Panel – no more manual file editing required.
• Provider selection: Provider selection dialog when both DeepL and Copilot are configured – choose your translation backend per request.

🚀 Features

• View button theming: Customize the appearance of the Content Translator view button with the new theme prop. Available themes match Kirby's button styles (e.g., positive, negative, blue-icon).

🐞 Bug Fixes

• Respect translate: false in blocks: Fields marked with translate: false inside blocks are now correctly skipped during content synchronization (import). Previously, these fields were being imported even when marked as non-translatable, causing unwanted content overwrites.

🚀 Features

• Chunked translations: Texts are now sent to DeepL in chunks for translation by default when no custom translator function is set. This significantly improves performance by reducing the number of API calls to DeepL.

🚀 Features

• View button props: Support props for Content Translator view button (Kirby 5+) to customize its behavior per blueprint. See the View Button & Section Configuration guide for details.

buttons:
  preview: true
  content-translator:
    title: true
    slug: true
    excludeFields:
      - description
  languages: true

buttons:
  preview: true
  settings: true
  content-translator:
    title: true
    slug: true
    excludeFields:
      - description
  languages: true
  status: true

buttons:
  preview: true
  settings: true
  content-translator:
    title: true
    slug: true
    excludeFields:
      - description
  languages: true

• Batch concurrency: Global batchConcurrency option to set a maximum number of concurrent translations in batch mode (default: 2).

🚀 Features

• Kirby Table plugin support: Added translation support for the Kirby Table plugin by Bogdan Condorachi. Table cell content is now properly translated in both Panel (client-side) and programmatic (server-side) translation modes.

🐞 Bug Fixes

• File metadata batch translation: Batch translation of file metadata is now working correctly again. Previously, file metadata (like title, alt text) was skipped during batch operations.

🚀 Features

• KirbyTags translation: KirbyTags translation support with selective attribute translation while preserving tag structure and functionality.
• Translation hooks: Translation hooks for customizing translation behavior with content-translator.translate:before and content-translator.translate:after hooks.

🚀 Features

• Kirby 5 license status integration: The plugin now displays its license status on the Panel's system page, following Kirby 5's plugin license management conventions. This provides a unified view of all plugin licenses alongside Kirby's own license information.

🚀 Features

• Locale-based language resolution: Use the language's LC_ALL locale (if available) to resolve the DeepL target language.
• Language code validation: Validate language code against DeepL's supported target languages.

♻️ Refactorings

• Option renamed: bulk → batch: The bulk configuration option has been renamed to batch for clearer terminology. The old bulk option name continues to work for backward compatibility, but we recommend updating your blueprints to use batch for consistency with the documentation.

🚀 Features

• Language selection: Select the languages to translate the content into when using the batch translation feature.

Kirby Content Translator v3 is a major release with full support for Kirby 5. This major release requires a new license key. If you already have a license, you receive a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚀 Features

• Panel view button: Panel view button as an alternative to the section. Including backward compatibility for Kirby 4 🎉.
• Kirby 5: Full compatibility with Kirby 5 including the new Panel architecture.

🚀 Features

• Improved HTML translation: Enabled HTML handling for DeepL API requests, ensuring HTML content (like rich text with formatting) is translated correctly while preserving tags and structure.
• Markdown Field plugin support: Added compatibility with the community-driven Markdown Field plugin by Fabian Michael. Markdown content is now properly handled during translation.
• Custom DeepL options: The new DeepL.requestOptions configuration option lets you set custom request options for the DeepL API, such as formality level or specific glossary IDs.

🚀 Features

• Tags field translation: The tags field type is now supported for translation. Each tag value is translated individually while preserving the comma-separated structure. This is useful for translating categories, labels, or keywords stored in tags fields.

🚀 Features

• Slug translation API: New translateSlug PHP API method.
• Batch translation mode: Batch translation mode overwrites the content of all secondary languages with the data of the default language and then translates into the respective language.

Unlike per-language translation, this translation process is not reversible in the Panel and is handled server-side. Use it with caution, as it may take a while to translate all content. When the button is clicked, a confirmation dialog is displayed to prevent accidental batch translation.

🐞 Bug Fixes

• Homepage slug protection: Disallow changing the slug on the homepage page ID.

🚀 Features

• DeepL error visibility: Common DeepL API errors are now displayed in the Panel instead of failing silently. This includes quota exceeded errors, character limit warnings, and authentication issues. Editors will see clear error messages when translations fail, making it easier to diagnose and resolve issues.

🚀 Features

• Kirby 5 alpha: Added compatibility with the Kirby 5 alpha release for developers who want to test with the upcoming Kirby version.

🚀 Features

• Field-level translation control: Skip translating specific fields by setting translate: false in your blueprint field options. This is useful for fields that contain code, identifiers, or other content that should remain unchanged across languages.

fields:
  code:
    type: textarea
    translate: false # This field will not be translated

• Improved button labels: Translation button texts have been updated to more clearly indicate their action (Import/Translate).

Kirby Content Translator v2 is a major release with a complete overhaul of the plugin architecture. This release introduces a modern Panel section interface and streamlined translation workflows.

🚀 Features

• New Panel section UI: Redesigned translation interface with clearer actions for importing and translating content.
• Improved DeepL integration: Enhanced API handling with better error messages and support for all DeepL-supported languages.
• Structure-aware translation: Properly handles blocks, layouts, structures, and nested fields while preserving their structure.
• Field-level control: Skip specific fields from translation by setting translate: false in blueprint options.