chameleon-system-private/translation-tools-bundle
Provides a set of tools that help you work with translations in chameleon
8.47.1
2025-12-15 13:55 UTC
Requires
- chameleon-system/chameleon-base: ~8.0.0
- deeplcom/deepl-php: *
- symfony/http-client: ^6.4
- 8.47.1
- 8.47.0
- 8.0.x-dev
- 8.0.51
- 8.0.50
- 8.0.48
- 8.0.46
- 8.0.45
- 8.0.44
- 8.0.43
- 8.0.42
- 8.0.41
- 8.0.40
- 8.0.39
- 8.0.38
- 8.0.37
- 8.0.36
- 8.0.35
- 8.0.34
- 8.0.33
- 8.0.32
- 8.0.31
- 8.0.30
- 8.0.29
- 8.0.28
- 8.0.27
- 8.0.26
- 8.0.25
- 8.0.24
- 8.0.23
- 8.0.22
- 8.0.21
- 8.0.20
- 8.0.19
- 8.0.18
- 8.0.17
- 8.0.16
- 8.0.15
- 8.0.14
- 8.0.13
- 8.0.12
- 8.0.11
- 8.0.10
- 8.0.9
- 8.0.8
- 8.0.7
- 8.0.6
- 8.0.5
- 8.0.4
- 8.0.3
- 8.0.2
- 8.0.1
- 7.1.x-dev
- 7.1.140
- 7.1.139
- 7.1.138
- 7.1.137
- 7.1.136
- 7.1.135
- 7.1.134
- 7.1.133
- 7.1.132
- 7.1.131
- 7.1.130
- 7.1.129
- 7.1.128
- 7.1.127
- 7.1.126
- 7.1.125
- 7.1.124
- 7.1.123
- 7.1.122
- 7.1.121
- 7.1.120
- 7.1.119
- 7.1.118
- 7.1.117
- 7.1.116
- 7.1.115
- 7.1.114
- 7.1.113
- 7.1.112
- 7.1.111
- 7.1.110
- 7.1.109
- 7.1.108
- 7.1.107
- 7.1.106
- 7.1.105
- 7.1.104
- 7.1.103
- 7.1.102
- 7.1.101
- 7.1.100
- 7.1.99
- 7.1.98
- 7.1.97
- 7.1.96
- 7.1.95
- 7.1.94
- 7.1.93
- 7.1.92
- 7.1.91
- 7.1.90
- 7.1.89
- 7.1.88
- 7.1.87
- 7.1.86
- 7.1.85
- 7.1.84
- 7.1.83
- 7.1.82
- 7.1.81
- 7.1.80
- 7.1.79
- 7.1.78
- 7.1.77
- 7.1.76
- 7.1.75
- 7.1.74
- 7.1.73
- 7.1.72
- 7.1.71
- 7.1.70
- 7.1.69
- 7.1.68
- 7.1.67
- 7.1.66
- 7.1.65
- 7.1.64
- 7.1.63
- 7.1.62
- 7.1.61
- 7.1.60
- 7.1.59
- 7.1.58
- 7.1.57
- 7.1.56
- 7.1.55
- 7.1.54
- 7.1.53
- 7.1.52
- 7.1.51
- 7.1.50
- 7.1.49
- 7.1.48
- 7.1.47
- 7.1.46
- 7.1.45
- 7.1.44
- 7.1.43
- 7.1.42
- 7.1.41
- 7.1.40
- 7.1.39
- 7.1.38
- 7.1.37
- 7.1.36
- 7.1.35
- 7.1.34
- 7.1.33
- 7.1.32
- 7.1.31
- 7.1.30
- 7.1.29
- 7.1.28
- 7.1.27
- 7.1.26
- 7.1.25
- 7.1.24
- 7.1.23
- 7.1.22
- 7.1.21
- 7.1.20
- 7.1.19
- 7.1.18
- 7.1.17
- 7.1.16
- 7.0.x-dev
- 7.0.25
- 7.0.24
- 7.0.23
- 7.0.22
- 7.0.21
- 7.0.19
- 7.0.18
- 7.0.17
- 7.0.16
- 7.0.15
- dev-main
- dev-66480-paypal-button-integration-wip
- dev-65797-paypal-button-integration
- dev-65797-paypal-checkout-7.1.x
- dev-64817-update-tag-manager-bundle
- dev-64992-campaign-tracking-bundle
README
Description
The Bundle provides a set of tools to translate text and work with / on translations.
Installation / configuration
- Execute
composer require chameleon-system/translation-tools-bundle - Copy the content from the config.yml.dist into your app/config/config.yml
- Make sure to provide the DEEPL_API_KEY env variable containing your DeepL api key
- Optionally if you don't want to configure the API key via. env you can also create a table called deepl_api_key that has a column called api_key. The API key from the database overwrites the env. It doesn't matter if you have only one or both configs, it only matters that you have one.
- Execute the database updates
Export Database Translations as XLIFF
You can export database translations using the console command chameleon_system:translation_tools:export_translations.
The command will generate an XLIFF file for every table with translatable fields in every language defined for the system.
Output
Translation files are written into cmsdata/xliff (please make sure the folder exists).
Testing
Since translations via deepl are expensive, you can use the mock lorem ipsum translator service
(chameleon_system_translation_tools.mock_translator_lorem_ipsum) to test your code.