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 DeepL

By default, this plugin uses the DeepL API to translate your content. You can also use any other translation service by defining a custom translator function.

To use the DeepL API, create an account and generate an API key. The free account is sufficient for most use cases (500,000 characters per month).

Store the API key in your config.php file:

return [
    'johannschopplich.content-translator' => [
        'DeepL' => [
            // API key for the DeepL free or pro plan
            'apiKey' => '<deepl-api-key>'
        ]
    ]
];

Step 3: Choose Your Workflow

Kirby Content Translator offers two ways to add translation controls to the Panel. Both methods provide the same functionality and can be used together.

buttons:
  - preview
  - 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 to DeepL for translation.

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 product page on Lemon Squeezy and purchase a license. Then, open any Panel page that contains the Content Translator view button or section. You will see a license activation notice. Click the Activate link to open the activation form:

Enter the email you used for the purchase and the order number and hit the submit button. Done! Thanks for supporting our work. Once you activate your license, the license activation buttons will disappear.