Introduction
The Kirby Content Translator plugin empowers editors to translate content from one language to another. Translations can be done either language by language or in batches. The tool seamlessly integrates with the Kirby Panel and provides manual translation capabilities and programmatic access via its PHP API.
Key Features
- 🎛️ Panel Integration: Direct translation from the Kirby Panel with view buttons and blueprint sections.
- 🔌 Multiple Translation Services: Built-in DeepL support with option for custom translation providers.
- 🧩 Structure-Aware: Translates complex field types including blocks, layouts, structures, and objects.
- 🏷️ KirbyTags Support: Selective translation of KirbyTags attributes while preserving UUIDs, URLs and other technical content.
- ⚡ PHP API: Programmatic translation capabilities for automation and CLI commands.
- 📦 Batch Translation: Translate content to multiple languages simultaneously.
- 🪝 Hooks System: Customize translation behavior with before/after hooks.
Translation Modes
Kirby Content Translator operates in two distinct modes depending on your current language context. This allows for both interactive, real-time translations in the Kirby Panel and efficient batch processing on the server side.
| Feature | Per-Language Translation | Batch Translation |
|---|---|---|
| Language Context | 🌍 Secondary language | 🏠 Primary/default language |
| Translation Speed | ⚡ Real-time, instant | 🚀 Batch processing |
| Reversibility | ✅ Reversible changes | ❌ Non-reversible |
| Interactivity | ✅ See & edit immediately | ❌ Background processing |
| Target Languages | 🎯 Single language | 📊 Multiple languages at once |
| Use Case | 🔧 Fine-tuning translations | 🏗️ Initial content creation |
Usage Overview
The plugin provides two main ways to translate content:
- Panel Integration: Use view buttons or blueprint sections to translate content directly in the Kirby Panel.
- PHP API: Programmatically translate content using PHP methods for automation or CLI commands.
Translation Services
By default, the plugin uses the DeepL API for high-quality translations. If you prefer to use a different translation service, you can define custom translation functions to integrate other providers.