Installation

Step 1: Install the Plugin

Although it is a commercial plugin, you can download and test it in your local environment before purchasing.

composer require johannschopplich/kirby-content-translator

Step 2: Configure the Translation Provider

Content Translator requires at least one translation provider. Choose your preferred option:

return [
    'johannschopplich.content-translator' => [
        'DeepL' => [
            'apiKey' => '<deepl-api-key>'
        ]
    ]
];

return [
    'johannschopplich.copilot' => [
        'provider' => 'openai',
        'providers' => [
            'openai' => [
                'apiKey' => env('OPENAI_API_KEY')
            ]
        ]
    ]
];

Step 3: Choose Your Workflow

Kirby Content Translator offers two ways to add translation controls to the Panel. Both run the same translation and can be used together – only the section accepts a systemPrompt.

buttons:
  - open # `buttons` replaces Kirby's
  - preview # defaults, so list them all
  - "-"
  - settings
  - content-translator # Choose position
  - languages
  - status

contentTranslator:
  type: content-translator

Step 4: Translate Your Content

Open the Panel and navigate to a page. The translation workflow depends on your current language:

In Secondary Languages

1. Click Import to copy content from the default language to the current language.
2. Click Translate to send the imported content through your configured provider.

In the Default Language

Click → All Languages to translate content to multiple languages at once. A dialog lets you select which target languages to include.

Step 5: Buy a License

You can test the plugin locally. However, you need to purchase a license to use the plugin in production environments.

Visit the buy page and purchase a license. The easiest way to activate your license is to go to the system view in the Kirby Panel and click on Activate now:

Enter the email you used for the purchase and your license key, then hit the submit button. You will find your license key in your order confirmation email or at hub.kirby.tools. Done! Thanks for supporting our work. Once you activate your license, the license activation buttons will disappear.