Search by

johannschopplich / kirby-content-translator

johannschopplich

DeepL and AI translation in the Kirby Panel

Package info

github.com/kirby-tools/kirby-content-translator

Homepage

Type:kirby-plugin

pkg:composer/johannschopplich/kirby-content-translator

Fund package maintenance!

kirby.tools

Statistics

Installs: 12 388

Dependents: 0

Suggesters: 0

Stars: 20

Open Issues: 2


README

Kirby Content Translator

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: false holds 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, and warning hooks – 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