README

Kirby Content Translator

The Kirby Content Translator plugin empowers editors to translate content from one language to another with a single click. Add the Panel view button to any page, file, or site blueprint and translate content directly in the Kirby Panel using DeepL or any Kirby Copilot provider for context-aware AI translations.

For developers, the plugin offers a flexible PHP API and hooks for custom translation workflows.

Features

• 🖱️ One-Click Translation: View button in any page, file, or site blueprint.
• 📦 Batch Translation: All secondary languages at once, from the default.
• 📄 All Content Types: Pages, files (metadata), and site content.
• 🧩 Blueprint-Aware: Walks blocks, layout, structure, object, and nested fields. translate: false is respected at any depth.
• 🏷️ KirbyTags: Translate tag attributes selectively – URLs and UUIDs preserved.
• ⚡ PHP API: Drive translations from CLI or custom workflows – see PHP classes.
• 🪝 Hooks: before, after, and warning for preprocessing, postprocessing, and observability.
• 🔌 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 Tools Website.

Getting Started

To get started, please refer to the documentation for guidance on installation, configuration, and usage.

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

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 License © 2024-PRESENT Johann Schopplich