Skip to content

Requirements ​

Shopware and PHP ​

RequirementSupported
Shopware 6~6.6.9 || ~6.7.0 (Shopware 6.6.9, all later 6.6 releases, and the 6.7 line)
PHP8.2 or a later version

The extension installs no additional PHP dependencies of its own.

A translation provider ​

You need a minimum of one of these two items:

  • An API key for a provider. The extension supports DeepL, Google Translate, OpenAI (ChatGPT), Anthropic Claude, Google Gemini and Mistral. One key is sufficient. You can add more keys later and map each target language to a key. See Translation providers.
  • A connection between your shop and the Shopware Store. This connection lets you book modernice All-in-One as an in-app purchase.

You can use both items at the same time.

Languages in your shop ​

The extension translates into the languages that your shop already contains. It creates no language of its own. Add your target languages first, under Settings → Languages.

Storefront snippets need one more item: a snippet set for each target language (Settings → Snippets). If a snippet set is missing, the wizard shows a warning before the run and skips the snippets of that language.

Background processing ​

Translation goes through the Shopware message queue. Usual production hosting already processes that queue, and a small test run after the installation confirms it. A job that reaches Completed proves the full chain.

If you host the shop yourself, these two processes must operate continuously, for example under systemd or supervisor:

bash
bin/console messenger:consume async low_priority --time-limit=60 --memory-limit=512M
bash
bin/console scheduled-task:run --time-limit=60 --memory-limit=512M

A job that stays at Queued shows that this processing is missing. Troubleshooting gives more causes and the details.

Next steps ​

modernice extensions for Shopware 6. Shopware is a trademark of shopware AG — this documentation is not affiliated with shopware AG.