Extension Configuration

Some general settings can be configured in the Extension Configuration.

Go to System > Settings > Extension Configuration
Choose deepltranslate_core

The settings are divided into several tabs and described here in detail:

Properties

Settings

Tab Settings provides basic extension settings required for minimal operational state.

Name	Type	Default
apiKey	string

apiKey

Type: string
Required: true

Add your DeepL API Key here, either DeepL Free API or DeepL Pro.

API

Tab API provides the ability to set default settings used for DeepL API. requests.

Note

Options have been added in preparation for upcoming Glossary API v3 usage in deepltranslate_glossary and also in deepltranslate_core, but have not been implemented yet. They are not used yet.

Screenshot of :guilabel:`Extension Configuration > deepltranslate_core > API`

Name	Type	Default
modelType	string	`prefer_quality_optimized`: Prefer quality optimized (with fallback)
splitSentences	string	`on`: Split at punctuation and newlines
preserveFormatting	bool	`false`
ignoreTags	string
nonSplittingTags	string
splittingTags	string
outlineDetection	bool	`true`

modelType

Type: string
Default: prefer_quality_optimized: Prefer quality optimized (with fallback)

DeepL model, available options:

latency_optimized: Latency optimized
quality_optimized: Quality optimized
prefer_quality_optimized Prefer quality optimized (with fallback)

splitSentences

Type: string
Default: on: Split at punctuation and newlines

Enable Text splitting, available options:

off: No splitting
on: Split at punctuation and newlines
nonewlines: Split only at new lines

preserveFormatting

Type: bool
Default: false

Keep existing formatting

ignoreTags

Type: string

Exclude content from being translated in between these tags; Comma separated, useful for available options:

placeholders
shortcodes
pre

For example: shortcodes,pre

nonSplittingTags

Type: string

Only for tag_handling XML! Prevent splitting inside these tags. Comma separated, allows the API keeping the text unsplitted.

splittingTags

Type: string

Split inside these tags. Comma separated list, defines tags that should be splitted, for example: p,div

outlineDetection

Type: bool
Default: true

Enable automatic detection of document structure in XML/HTML