johannschopplich / kirby-content-translator
DeepL and AI translation in the Kirby Panel
Package info
github.com/kirby-tools/kirby-content-translator
Type:kirby-plugin
pkg:composer/johannschopplich/kirby-content-translator
Fund package maintenance!
Requires
- php: >=8.2
- getkirby/composer-installer: ^1
- johannschopplich/kirby-tools-licensing: ^0.9
- johannschopplich/kirby-tools-utils: ^0.1
Requires (Dev)
- getkirby/cli: ^1
- getkirby/cms: ^5
- phpunit/phpunit: ^12
- vlucas/phpdotenv: ^5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-09-07 15:38:48 UTC
README
Kirby Content Translator
Kirby Content Translator is a plugin for Kirby CMS that adds a translation button to any page, file, or site blueprint. Translate with DeepL or Kirby Copilot for AI – the same pipeline runs from PHP and the CLI for hooks, custom controllers, and batch jobs.
Features
- 🖱️ One-Click Translation: View button in any page, file, or site blueprint.
- 📦 Batch Translation: All target languages from one dialog, with DeepL or AI.
- 📊 Translation Coverage: Rings per language and the pages still missing one, in the Languages view.
- 🧩 Nested Fields: Walks blocks, layouts, structures, and objects –
translate: falseholds at any depth. - 🏷️ KirbyTags: Tag attributes translated selectively, URLs and UUIDs preserved.
- 🔁 Import from Source: Copy default-language content without translating.
- 🎛️ Configurable Scope: By field type, or include and exclude fields, globally or per section.
- ⚡ PHP API: Drive translations from CLI or custom workflows, with
before,after, andwarninghooks – see PHP classes. - 🔌 Pluggable Strategies: DeepL, AI via Copilot, or your own custom strategy.
Licensing
Kirby Content Translator is a commercial plugin that requires a license. You can install and test the plugin locally without a license. However, production environments require a valid license. You can purchase a license from the Kirby Content Translator Website.
Requirements
- Kirby 4 or Kirby 5
Installation
Composer (Recommended)
composer require johannschopplich/kirby-content-translator
Manual Installation
Download and copy this repository to /site/plugins/kirby-content-translator.
Documentation
For installation, configuration, and usage, see the Kirby Content Translator documentation.
Support and Questions
We are committed to support you if you have any questions or issues with Kirby Content Translator. There are several ways to get support:
- GitHub Discussions: Join the community and engage in discussions on our GitHub Discussions page.
- Email Support: You can ask questions and seek assistance by emailing us at hello@kirby.tools. Please use the GitHub discussions if you have a general question or comment about Kirby Content Translator.
- GitHub Issues: For reporting bugs or requesting new features, please use the GitHub Issues page.
We encourage you to use the resources above to connect with us and other users of Kirby Content Translator.
For the sake of reproducible bug reports, please include the following information in your bug reports:
- Kirby & Kirby Content Translator version
- Browser environment (name, version, operating system)
- Global and section configuration (without any sensitive information)
- Steps to reproduce the bug (if no reproduction is provided)
- Screenshots or screen recordings if applicable
Warning
Please ensure to never include any API keys or other sensitive information in bug reports, feature requests, or any other public communication channel.
Feedback
We value your feedback and ideas for improving Kirby Content Translator. If you have any suggestions, please feel free to reach out to us via email or preferably by creating a new discussion on our GitHub Discussions page.
License
Kirby Tools License © 2024-PRESENT Johann Schopplich