sitegeist / lostintranslation
Automatic content translations for Neos using the DeepL Api
Installs: 30 443
Dependents: 2
Suggesters: 0
Security: 0
Stars: 10
Watchers: 4
Forks: 11
Open Issues: 5
Type:neos-package
Requires
- php: >=8.2.0
- neos/contentgraph-doctrinedbaladapter: ^9.0.0
- neos/contentrepository-core: ^9.0.0
- neos/http-factories: ^9.0.0
- neos/neos: ^9.0.0
Requires (Dev)
- fakerphp/faker: ^1.23.0
- mikey179/vfsstream: @stable
- mockery/mockery: @stable
- phpstan/phpstan: 1.10.37
- phpunit/phpunit: ^9
- squizlabs/php_codesniffer: ^3.7
- 3.0.x-dev
- v3.0.2
- v3.0.1
- v3.0.0
- v3.0.0-beta1
- v2.5.1
- v2.5.0
- v2.4.1
- v2.4.0
- v2.3.2
- v2.3.1
- v2.3.0
- v2.2.0
- v2.1.0
- 2.0.x-dev
- v2.0.1
- v2.0.0
- v1.1.1
- v1.1.0
- v1.0.0
- dev-bugfix-translate-on-shutdown
- dev-feature-crop-to-validation-length
- dev-bugfix-sync-deleted-nodes-correctly
- dev-feature-term-replacement
- dev-feature-exclude-node-paths
- dev-bugfix/fixPersistenceOfChangedGlosaryEntries
- dev-FEATURE/crop-to-validation-length
- dev-FEATURE/exclude-node-paths
- dev-bugfix/decode-html-entities
- dev-bugfix/sync-removed-nodes-correctly
- dev-bugfix/translate-on-shutdown
- dev-FEATURE/term-replacement
- dev-bugfix/no-double-moving-of-nodes-across-dimensions-if-synced
- dev-FEATURE/glossarySupport
- dev-FEATURE/sync-command
- dev-officialDeeplApiPackage
- dev-task/fixCIIssues
- dev-cancom-project
- dev-innsbruck-project
- dev-bugfix-uri-path-segment
- dev-php84Compatibility
- dev-glossaries-with-new-api
- dev-task/testNeos9WithReleasedVersion
- dev-neos9
- dev-feature/glossaries
- dev-chore-uri-path-segment
- dev-bugfix-only-get-node-identifiers
- dev-bugfix-ignored-terms
- dev-taxonomyCompatibility
- dev-FEATURE/testing
- dev-documentRecursiveComparison
- dev-CHORE/refactor
- dev-feature/contentCollectionComparison
- dev-BUGFIX/avoid-optimistic-lock
- dev-FEATURE/translation-cache
- dev-task/statusModule
- dev-BUGFIX/retry-failed-attempts
- dev-FEATURE/disable-autorization-checks
- dev-FEATURE/eel-helper
- dev-TASK/improveSyncProcess
- dev-BUGFIX/node-index-issue
- dev-BUGFIX/improve-sync-process
- dev-BUGFIX/disable-translation-for-property
- dev-BUGFIX/composer-constraint
- dev-mficzel-patch-1
- dev-bugfix/handleSourceLanguagesWithCombinedIdentifiers
This package is auto-updated.
Last update: 2025-07-10 12:16:59 UTC
README
Automatic Translations for Neos via DeeplApi
Documents and contents are translated automatically once editors choose to "create and copy" a version in another language. The included DeeplService can be used for other purposes as well.
The development was a collaboration of Sitegeist and Code Q.
Authors & Sponsors
- Martin Ficzel - ficzel@sitegeist.de
- Felix Gradinaru - fg@codeq.at
The development and the public releases of this package are generously sponsored by our employers http://www.sitegeist.de and http://www.codeq.at.
Installation
Sitegeist.LostInTranslation is available via Packagist. Run composer require sitegeist/lostintranslation
.
We use semantic versioning so every breaking change will increase the major version number.
How it works
By default, all inline editable properties are translated using DeepL (see setting translateInlineEditables
).
To include other string
properties in the automatic translation, the options.automaticTranslation: true
can be used in the property configuration. Also, you can disable automatic translation in general for certain node types
by setting options.automaticTranslation: false
.
Some very common fields from Neos.Neos:Document
are already configured to do so by default.
'Neos.Neos:Document': options: automaticTranslation: true properties: title: options: automaticTranslation: true titleOverride: options: automaticTranslation: true metaDescription: options: automaticTranslation: true metaKeywords: options: automaticTranslation: true
Also, automatic translation for all types derived from Neos.Neos:Node
is enabled by default:
'Neos.Neos:Node': options: automaticTranslation: true
Configuration
This package needs an authenticationKey for the DeepL API from https://www.deepl.com/pro-api. There are free plans that support a limited number, but for productive use we recommend using a paid plan.
Sitegeist: LostInTranslation: DeepLApi: authenticationKey: '.........................'
The translation of nodes is configured via settings:
Sitegeist: LostInTranslation: nodeTranslation: # # Enable the automatic translations of nodes while they are adopted to another dimension # enabled: true # # Translate all inline editable fields without further configuration. # # If this is disabled, inline editables can be configured for translation by setting # `options.translateOnAdoption: true` for each property separately # translateInlineEditables: true # # The name of the language dimension. Usually needs no modification # languageDimensionName: 'language'
If a preset of the language dimension uses a locale identifier that is not compatible with DeepL, the deeplLanguage
can
be configured explicitly for this preset via options.deeplLanguage
.
Neos: ContentRepository: contentDimensions: 'language': # # The `defaultPreset` marks the source for all translations with mode `sync` # label: 'Language' default: 'en' defaultPreset: 'en' presets: # # English has to be configured differently for source and target as DeepL requires so, # the source and target are separated by a `:` # 'en': label: 'English' values: ['en'] uriSegment: 'en' options: deeplLanguage: 'EN:EN-GB' # # Danish uses a different locale identifier than DeepL, so the `deeplLanguage` has to be configured explicitly # 'dk': label: 'Dansk' values: ['dk'] uriSegment: 'dk' options: deeplLanguage: 'DA' # # For German, the dimension value de is used in uppercase # 'de': label: 'Deutsch' values: ['de'] uriSegment: 'de' # # The Bavarian language is not supported by DeepL and is disabled # 'de_bar': label: 'Bayrisch' values: ['de_bar','de'] uriSegment: 'de_bar' options: deeplLanguage: false
Ignoring Terms
You can define terms that should be ignored by DeepL in the configuration. The terms are evaluated case-insensitively when searching for them, however they will always be replaced with their actual occurrence.
This is how an example configuration could look like:
Sitegeist: LostInTranslation: DeepLApi: ignoredTerms: - 'Sitegeist' - 'Neos.io' - 'Hamburg'
Eel Helper
The package also provides two Eel helpers to translate texts in Fusion.
⚠️ Every one of these Eel helpers makes an individual request to DeepL. Thus, having many of them on one page can significantly slow down the performance if the page is uncached. :bulb: Only use while the translation cache is enabled!
To translate a single text you can use:
# ${Sitegeist.LostInTranslation.translate(string textToBeTranslated, string targetLanguage, string|null sourceLanguage = null): string}
${Sitegeist.LostInTranslation.translate('Hello world!', 'de', 'en')}
# Output: Hallo Welt!
To translate an array of texts you can use:
# ${Sitegeist.LostInTranslation.translate(array textsToBeTranslated, string targetLanguage, string|null sourceLanguage = null): array}
${Sitegeist.LostInTranslation.translate(['Hello world!', 'My name is...'], 'de', 'en')}
# Output: ['Hallo Welt!', 'Mein Name ist...']
Translation Cache
The plugin includes a translation cache for the DeepL API that stores the individual text parts and their translated results for up to one week. By default, the cache is enabled. To disable the cache, you need to set the following setting:
Sitegeist: LostInTranslation: DeepLApi: enableCache: false
Performance
For every translated node, a single request is made to the DeepL API. This can lead to significant delay when documents with lots of nodes are translated. It is likely that future versions will improve this.
Contribution
We will gladly accept contributions. Please send us pull requests.
Changelog
2.0.0
- The preset option
translationStrategy
was introduced. There are now two auto-translation strategies:- Strategy
once
will auto-translate the node once "on adoption", i.e. the editor switches to a different language dimension - Strategy
sync
will auto-translate and sync the node every time a node is updated in the default preset language
- Strategy
- The node setting
options.translateOnAdoption
has been renamed tooptions.automaticTranslation
- The new node option
options.automaticTranslation
was introduced