directus-extension-deeplmn

A Directus extension bundle for automatic translation of content using DeepL, with flexible language and translation management.

Features

This extension can be installed via the Directus Marketplace.

Alternatively, install via npm:

npm install deeplmn

Then copy the extension files to your Directus extensions directory.

Set your DeepL API key as an environment variable in your Directus project:

export DEEPLMN_API_KEY=your-deepl-api-key

Or add it to your .env file:

DEEPLMN_API_KEY=your-deepl-api-key

In your Directus instance, navigate to https://directus.example.com/admin/content/languages and configure the languages:

DeepL Language Keys: Set the DeepL language key for all languages you want to translate. See DeepL Supported Languages.
Source Language: Select the checkbox for the source language, which will be the base for your translations.
Target Languages: For all target languages, select the checkbox to enable automatic translation.

The extension will attempt to create the required fields and translations on server start.

Once installed and configured:

On item creation or update, the extension will automatically translate fields for enabled languages.
The translation mode can be set in Directus settings (deeplmn_mode):
- default: Always translate empty fields if present in the default language.
- only_new: Only translate for new content.

If you make changes, rebuild the extension:

npm run build