Installation

Installation über den Shopware Extension Store

Wechseln Sie im Shopware-Admin in den Bereich Erweiterungen > Store. Suchen Sie nach “Übersetzung mit DeepL” und installieren Sie die Erweiterung über den Button “Hinzufügen”. Die Installation und Aktivierung erfolgt automatisch.

Manuelle Installation (ZIP)

1. ZIP-Datei in custom/plugins/SatagQueuedTranslator entpacken (Ordnername beibehalten)
2. Konsole im Shopware-Root ausführen:

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

Message Queue Worker

Übersetzungsjobs werden über die Shopware Message Queue asynchron verarbeitet. Stellen Sie sicher, dass ein Worker läuft:

bin/console messenger:consume async

Für den Dauerbetrieb richten Sie einen systemd-Service oder Supervisor ein, siehe Shopware-Dokumentation: Message Queue. Ohne laufenden Worker bleiben Jobs in der Queue im Status “pending”.

Erstkonfiguration

1. DeepL API Token unter Einstellungen > System > Übersetzung mit DeepL hinterlegen, siehe Konfiguration
2. Bei Nutzung des kostenlosen DeepL-Plans die Option “DeepL Free API verwenden” aktivieren, siehe FAQ: Free vs. Pro
3. Optional: Standard-Glossar und weitere Einstellungen prüfen

Deinstallation

Bei der Deinstallation fragt Shopware, ob die Daten behalten werden sollen:

• Daten behalten: Übersetzungscache und Einstellungen bleiben erhalten, nach einer Neuinstallation sind sie wieder verfügbar.
• Daten löschen: Alle Plugin-Tabellen (Jobs, Cache, Vorlagen inkl. Ausführungs-Historie) werden vollständig entfernt.