@@ -39,7 +39,7 @@ Starting with Shopware **6.7.3.0**, translations are managed directly in Shopwar
3939- Nothing changes.
4040- To install additional languages, use the CLI command:
4141
42- ``` bash
42+ ``` bash
4343 bin/console translation:install --locales < locale-code>
4444```
4545
@@ -55,10 +55,16 @@ Example: `bin/console translation:install --locales it-IT,fr-FR` will install It
5555
56562. The command uses the ** same source ([translate.shopware.com][shopware-translations])** as the [Language Pack plugin][language-pack-plugin] but is
5757 updated more frequently. So it' s essentially identical – or even more up to date!
58- 3. You can safely uninstall and remove the Language Pack plugin. Your **custom snippets** created in the Snippet module
59- remain intact since they are saved in the database.
60- 4. Make sure that all languages you need are **active** in the Administration:
61- `Settings → Languages`
58+ 3. Make sure that all languages you need are **active** in the Administration: `Settings → Languages`
59+ 4. Create base snippet sets for used languages
60+ - If you' re on Shopware ** 6.7.7.0** or later, this is done automatically.
61+ - If you' re on Shopware **6.7.6.0** or earlier, for each language in use, create a base snippet, e.g. `BASE en-US` for English (US).
62+ 5. Change all sales channel domains to use the base snippet sets.
63+ - If you' re on Language Pack ** 5.37.1** or later, this is done automatically.
64+ - If you' re on Language Pack **5.37.0** or earlier, open each sales channel, scroll down to the domains and change the
65+ snippet set from `LanguagePack` to `BASE`, e.g.: `LanguagePack en-US` to `BASE en-US`.
66+ 6. It is recommended to uninstall and remove the Language Pack plugin after `translation:install` succeeded for all locales.
67+ Your **custom snippets** created in the snippet module remain intact since they are saved in the database.
6268
6369## New installations
6470
@@ -70,6 +76,14 @@ Example: `bin/console translation:install --locales it-IT,fr-FR` will install It
7076
7177- Additional details about the new translation handling are available in the [integrated language handling][translation-system] guide.
7278
79+ ## Common problems and troubleshooting
80+
81+ ### Can' t remove Language Pack: a foreign key constraint fails (\` shopware\` .\` sales_channel_domain\` …
82+
83+ Starting with ** Shopware 6.7.7.0** and ** Language Pack 5.37.1** , the migration process was improved. If you encounter this issue,
84+ please update Shopware to > = 6.7.7.0, Language Pack to > = 5.37.1, remove the translation files created from running the
85+ command and run the command again. Or follow the updated migration guide.
86+
7387[translation-system]: ../../../../../concepts/translations/built-in-translation-system.md
7488[language-pack-plugin]: https://store.shopware.com/en/swag338126230916f/shopware-language-pack.html
7589[shopware-translations]: https://translate.shopware.com
0 commit comments