Installation und Einrichtung

In diesem Kapitel installieren Sie das Plugin CogiTranslator und richten es so ein, dass die erste echte Übersetzung gelingt. Rechnen Sie mit etwa 15 Minuten.

Voraussetzungen

• Shopware 6.6.9.0 oder neuer

• Ein Zugang zu mindestens einem Übersetzungsdienst:

  • DeepL (kostenloses „DeepL API Free"-Abo oder kostenpflichtiges „DeepL API Pro"-Abo), oder

  • ChatGPT (ein OpenAI-API-Schlüssel)

• Zugriff auf die Shopware-Administration mit Administratorrechten

Sie benötigen nicht zwingend beide Dienste. Ein einziger reicht aus, um zu starten.

Installation

1

Plugin installieren

Installieren Sie das Plugin wie gewohnt über den Shopware Store oder durch Hochladen der Plugin-Datei unter Erweiterungen → Meine Erweiterungen.

2

Plugin aktivieren

Aktivieren Sie das Plugin.

3

Cache leeren

Leeren Sie danach einmal den Cache, damit alle neuen Menüpunkte und Einstellungen sichtbar werden.

Nach der Aktivierung finden Sie das Plugin an zwei Stellen im Menü:

• Kataloge → Massenübersetzungen (und weitere Unterpunkte: Übersetzungsfreigabe, Übersetzungsvorlagen, Kostenkalkulation)

• Einstellungen → Erweiterungen → Übersetzer (die technischen Werkzeuge: Jobs, Logs, Cache, Glossar, Style Rules, Datenwiederherstellung, Textbausteine übersetzen)

Wichtiger erster Schritt: Testmodus deaktivieren

CogiTranslator startet standardmäßig im Testmodus. Solange dieser aktiv ist, wird keine echte Übersetzung durchgeführt — stattdessen werden Ihre Texte durch zufällige Buchstabenfolgen ersetzt. Das ist gewollt, damit beim Ausprobieren keine Kosten entstehen, führt aber dazu, dass frisch installierte Shops zunächst „kaputte" Übersetzungen zeigen, wenn der Testmodus übersehen wird.

Den Testmodus schalten Sie in der Plugin-Konfiguration unter der Karte „Grundeinstellungen" aus (Feld „Testmodus verwenden"). Details dazu im Kapitel Grundeinstellungen.

Am schnellsten gelingt die komplette Ersteinrichtung mit dem Setup-Assistenten, der Sie durch Übersetzer, Zugangsdaten, Standardfelder und die Erlebniswelten-Konfiguration führt.

Erste Übersetzung ausprobieren

Nach dem Deaktivieren des Testmodus und Hinterlegen mindestens eines API-Schlüssels (siehe API-Zugänge) können Sie direkt eine Probeübersetzung starten:

1

Produkt öffnen

Öffnen Sie ein beliebiges Produkt.

2

Übersetzung starten

Klicken Sie oben rechts auf „Produkte übersetzen".

3

Sprachen auswählen

Wählen Sie Quell- und Zielsprache und bestätigen Sie mit „Übersetzungsaufträge erstellen".

4

Auftrag verarbeiten

Der Auftrag landet in der Warteschlange. Ob und wann er verarbeitet wird, hängt von der Message Queue ab — dem nächsten wichtigen Baustein.

Nächster Schritt

Fahren Sie mit dem Setup-Assistenten fort, der die komplette Grundkonfiguration in einem geführten Ablauf erledigt.