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.