Skip to content

Migration Guide: Language Pack Plugin → Integrated Translation Handling

Migration Guide: Language Pack Plugin → Integrated Translation Handling ​

Starting with Shopware 6.7.3.0, translations are managed directly in Shopware. From 6.8.0.0, the Language Pack plugin will no longer be compatible. Follow this guide to migrate safely.

What changes ​

bash
  bin/console translation:install --locales it-IT
  • The Language Pack plugin still works but is not recommended.

  • Languages now have an active flag which can be toggled in the Administration under Settings → Languages.

  • Languages installed/managed from other sources do not need to register their locales in the admin anymore.

  • Other translation plugins or snippets in themes are not affected and can still be used alongside the integrated handling.

  • Shopware 6.8.0.0 and later

Migration paths ​

1. You are not using the Language Pack plugin ​

  • Nothing changes.
  • To install additional languages, use the CLI command:
bash
  bin/console translation:install --locales <locale-code>

Example: bin/console translation:install --locales it-IT,fr-FR will install Italian and French.

2. You are currently using the Language Pack plugin ​

  • Before you start, update the Language Pack plugin to 5.79.0 or later and back up your database. Language Pack 5.78.0 and earlier can delete the custom snippets of a LanguagePack snippet set during the migration. Custom snippets that were already deleted can only be restored from a backup.

  • Run the translation command and install every language you are using in your shop:

    bash
        bin/console translation:install --locales <locale-code>,<locale-code>
  • The command uses the same source (translate.shopware.com) as the Language Pack plugin but is updated more frequently. So it's essentially identical – or even more up to date!

  • Make sure that all languages you need are active in the Administration: Settings → Languages

  • Create base snippet sets for used languages

    • If you're on Shopware 6.7.7.0 or later, this is done automatically. With Language Pack 5.79.0 or later, the LanguagePack snippet set becomes the BASE snippet set, e.g. LanguagePack en-US becomes BASE en-US, and keeps your custom snippets.
    • 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).
  • Change all sales channel domains to use the base snippet sets.

    • If you're on Language Pack 5.37.1 or later, this is done automatically.
    • If you're on Language Pack 5.37.0 or earlier, open each sales channel, scroll down to the domains and change the snippet set from LanguagePack to BASE, e.g.: LanguagePack en-US to BASE en-US.
  • It is recommended to uninstall and remove the Language Pack plugin after translation:install succeeded for all locales. With Language Pack 5.79.0 or later, your custom snippets created in the snippet module move to the BASE snippet set of their language, also when you uninstall the plugin with all its data. If you're on Shopware 6.7.6.0 or earlier, uninstall the plugin with all its data. Only then do your custom snippets move to the BASE snippet set. If both snippet sets contain the same snippet key, the BASE value is used and the LanguagePack snippet set is kept with the other value.

New installations ​

  • During a fresh Shopware installation, you can select the desired languages directly in the installer. They will be downloaded and installed automatically.
  • No additional language plugin is required.

More information ​

Common problems and troubleshooting ​

Can't remove Language Pack: a foreign key constraint fails (`shopware`.`sales_channel_domain`… ​

Starting with Shopware 6.7.7.0 and Language Pack 5.37.1, the migration process was improved. If you encounter this issue, please update Shopware to >= 6.7.7.0, Language Pack to >= 5.37.1, remove the translation files created from running the command and run the command again. Or follow the updated migration guide.

Custom snippets are still in the LanguagePack snippet set after the migration ​

If you migrated with Language Pack 5.78.0 or earlier, your custom snippets can remain in the LanguagePack snippet set next to the new BASE snippet set. Update the Language Pack plugin to 5.79.0 or later. The update moves these snippets to the BASE snippet set of their language.

Was this page helpful?
UnsatisfiedSatisfied
Be the first to vote!
0.0 / 5  (0 votes)