Skip to content

Commit ff7db58

Browse files
authored
feat: Improve required steps and mention improvements (#2108)
Add required steps to successfully remove the Language Pack after migration. Mention changes in the process starting with Shopware 6.7.7.0 and Language Pack 5.37.1
1 parent f201b67 commit ff7db58

1 file changed

Lines changed: 19 additions & 5 deletions

File tree

resources/references/upgrades/core/translation/language-pack-migration.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -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

5656
2. 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

Comments
 (0)