Installation

Installation via the Shopware Extension Store

In the Shopware admin go to Extensions > Store. Search for “Translation with DeepL” and install the extension using the “Add” button. Installation and activation happen automatically.

Manual Installation (ZIP)

1. Unpack the ZIP file to custom/plugins/SatagQueuedTranslator (keep the folder name)
2. Run in the Shopware root:

bin/console plugin:refresh
bin/console plugin:install SatagQueuedTranslator --activate
bin/console cache:clear

Message Queue Workers

Translation jobs are processed asynchronously via the Shopware message queue. Make sure a worker is running:

bin/console messenger:consume async

For continuous operation set up a systemd service or supervisor, see Shopware docs: message queue. Without a running worker, jobs stay in the queue in “pending” status.

First Configuration

1. Store the DeepL API token under Settings > System > Translation with DeepL, see Configuration
2. The DeepL Free API is enabled by default; disable “Use DeepL Free API” when using a Pro key, see FAQ: Free vs. Pro
3. Optional: review the default glossary and further settings

Uninstallation

When uninstalling, Shopware asks whether to keep the data:

• Keep data: the translation cache and settings are preserved and available again after reinstalling.
• Delete data: all plugin tables (jobs, cache, templates including execution history) are removed completely.