README

This project contains a TYPO3 CMS extension that uses DeepL official PHP API library to translate TYPO3 content to various languages. DeepL is possibly the best available online translator on the Internet.

Differences from other similar extensions are:

• No legacy code (the extension uses the TYPO3 14 localization handler)
• The extension uses official API instead of https calls
• The extension allows to manage & use glossaries in an easy way
• The code is minimalistic to make sure very little of needs to be changed in future

Installation

1. Install using composer:

composer req "dmitryd/dd-deepl"

1. Add DeepL settings to the site configuration:

ddDeepl:
  apiKey: '%env(TYPO3_DEEPL_API_KEY)%'
  timeout: 30
  maximumNumberOfGlossariesPerLanguage: 2
  glossaries:
    de-en: '1a7170f3-edab-4c66-949a-4db3dc6a233f'

1. Register with DeepL to get the API key.
2. Set the TYPO3_DEEPL_API_KEY environment variable to that API key. The %env(TYPO3_DEEPL_API_KEY)% value in the site configuration only reads this variable; it does not create it. You can also put the API key directly into the site configuration, but committing that value to git is a security risk.

Warning! Due to dependencies on various 3rd party packages, this extension works only if TYPO3 is installed in composer mode. There will be no support for non-composer installations.

Usage

When you translate a page, content element, or record, TYPO3 opens the localization wizard. Select DeepL as the localization handler to create the localized record and translate its fields with DeepL.

Copyright

The extension is copyright (c) by Dmitry Dulepov, 2023.

Contact me by email if you need a custom TYPO3 extension made for you.