numero2/contao-deepl

DeepL powered translations in the Contao Backend.

Installs: 44

Dependents: 0

Suggesters: 0

Security: 0

Stars: 5

Watchers: 3

Forks: 0

Open Issues: 1

Type:contao-bundle

1.0.4 2024-11-18 14:36 UTC

This package is auto-updated.

Last update: 2024-11-18 14:37:52 UTC


README

About

This extension allows you to translate individual fields within a DCA (Data Container Array) with just one click, leveraging the DeepL API for accurate translations. It also includes caching of previously translated texts to optimize performance and minimize API calls.

System requirements

Installation & Configuration

  • Install the extension via Contao Manager or Composer (composer require numero2/contao-deepl)
  • Add your DeepL API Key to your .env

    DEEPL_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:fx

  • Alternatively, you can add the API key to your config/config.yaml
deepl:
    api_key: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:fx'

Usage

After installation, each field that can be translated will display a small DeepL translation icon DeepL Logo next to its label. Once clicked, DeepL will automatically translate the text in the field to match the language of your current page settings.

Contao Backend showing the DeepL translation button

💡 Hint: You can also translate all fields at once by pressing ALT+T on Windows or Option+T on Mac.

Supported bundles

This extension supports the following Contao bundles: