Für Administratoren

Dieses Kapitel richtet sich an technisch versierte Anwender mit Zugriff auf die Kommandozeile des Servers — etwa Ihre Agentur oder Ihren Hoster. Für die tägliche Arbeit im Shop-Admin ist es nicht erforderlich.

Plugin-Lebenszyklus

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

Die Warteschlange betreiben

CogiTranslator reiht sich in die Shopware Message Queue ein. Ob und wie diese in Ihrer Umgebung läuft, hängt vom Hosting ab — üblich ist ein dauerhaft laufender Worker-Prozess:

bin/console messenger:consume async

Alternativ lässt sich die Warteschlange auch einmalig gezielt für CogiTranslator abarbeiten:

bin/console cogi-translator:consume

Ohne einen laufenden Worker-Prozess bleiben Übersetzungsaufträge dauerhaft im Status „Ausstehend" — siehe Die Warteschlange (Message Queue).

Geplante Aufgabe (Cleanup)

Shopware führt automatisch alle 24 Stunden eine Aufräumaufgabe für CogiTranslator aus. Sie:

• löscht Log- und Verbrauchseinträge, die älter sind als die in den Grundeinstellungen hinterlegte Aufbewahrungszeit (Standard: 90 Tage)

• markiert Aufträge, die länger als 6 Stunden im Status „In Bearbeitung" hängen (z. B. weil ein Worker-Prozess während der Verarbeitung abgestürzt ist), automatisch als „Fehlgeschlagen"

Diese Aufgabe läuft über den regulären Shopware-Scheduler und benötigt keine gesonderte Einrichtung, sofern der Scheduler selbst aktiv ist.

Reparatur-Kommando für CMS-Slot-Konfigurationen

Wurden in einer oder mehreren Zielsprachen versehentlich technische CMS-Slot-Felder übersetzt (siehe CMS-Elemente), lassen sich diese aus einer bekannt sauberen Referenzsprache zurückkopieren:

bin/console cogi-translator:cms-config-repair --reference-language=<Sprachcode> [--dry-run] [--language=<Sprachcode>] [--limit=<Anzahl>]

Option	Bedeutung
--reference-language	Pflichtangabe. Der Sprachcode einer bekannt sauberen Sprache (z. B. de-DE), aus der technische Felder zurückkopiert werden
--dry-run	Führt nur eine Prüfung durch und zeigt, was geändert würde, ohne tatsächlich zu schreiben
--language	Kann mehrfach angegeben werden, um bestimmte Zielsprachen einzuschränken. Ohne Angabe werden alle außer der Referenzsprache geprüft
--limit	Begrenzt die Anzahl der geprüften Datensätze, z. B. zum Testen

Führen Sie das Kommando zunächst mit --dry-run aus, um den Umfang der Änderungen einzuschätzen, bevor Sie es tatsächlich schreibend ausführen.

Was bei der Deinstallation passiert

Wählen Sie im Deinstallationsdialog „Daten löschen", entfernt CogiTranslator seine Datenbanktabellen — Jobs, Cache, Logs, Verbrauch, Vorlagen, Preiskalkulationen und Wiederherstellungs-Sicherungen.

Die Tabellen der Übersetzungsfreigabe (Review) sowie die interne Tabelle für die Flow-Abkühlzeit werden dabei nicht entfernt und bleiben nach der Deinstallation bestehen.

Ohne „Daten löschen" bleiben sämtliche Daten unangetastet und stehen bei einer erneuten Installation wieder zur Verfügung.

Berechtigungen (ACL) — Reichweite

Die im Kapitel Berechtigungen (ACL) beschriebenen Rechte steuern ausschließlich die Administrationsoberfläche (Navigation, Buttons, Assistenten). Die Schnittstellen des Plugins selbst prüfen diese Rechte serverseitig nicht — jeder angemeldete Administrations-Zugang kann sie direkt ansprechen. Das ist bewusst so gebaut und bei der Vergabe von Administrator-Zugängen zu berücksichtigen.