Configuration

Configure the extension in the site configuration:

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

If the ddDeepl key is missing, DeepL is disabled for that site.

Site configuration reference

Name	Type	Default
ddDeepl.apiKey	string	empty
ddDeepl.timeout	integer	30
ddDeepl.maximumNumberOfGlossariesPerLanguage	integer	2
ddDeepl.glossaries	map	empty

ddDeepl.apiKey

Type: string
Default: empty

DeepL API key for the site. Free API keys end with :fx and automatically use the DeepL free API endpoint.

The value can use a TYPO3 environment placeholder, for example %env(TYPO3_DEEPL_API_KEY)%. If the placeholder is still unresolved at runtime, the API key is treated as empty, DeepL is disabled for the site, and a notice is written to the TYPO3 log.

ddDeepl.timeout

Type: integer
Default: 30

Timeout in seconds for network requests to DeepL. Values are limited to the effective range from 3 to 60.

Larger pages may perform many DeepL requests. If DeepL does not respond before the timeout, the affected localized records are removed again so editors can retry them later. The technical error details are written to the TYPO3 log.

ddDeepl.maximumNumberOfGlossariesPerLanguage

Type: integer
Default: 2

Maximum number of DeepL glossaries that can be created per language pair through this extension.

ddDeepl.glossaries

Type: map
Default: empty

Maps a language pair to a glossary id. The key format is source-target, for example de-en.