Installation

Lesen Sie zuerst die Voraussetzungen.

Über die Administration installieren

modernice verkauft die Erweiterung über den Shopware Store, deshalb führt der übliche Weg über Erweiterungen → Meine Erweiterungen. Erwerben Sie die Erweiterung mit dem Konto, mit dem Ihr Shop verbunden ist. Installieren und aktivieren Sie sie danach in der Liste. Der Store führt sie als KI-Übersetzungssuite — DeepL, ChatGPT, Claude, Gemini & Google. Eine ZIP-Datei direkt von modernice installieren Sie genauso, über Erweiterung hochladen.

Dieselbe Verbindung zu einem Shopware-Konto braucht auch modernice All-in-One für seinen In-App-Kauf.

Mit Composer installieren

composer require modernice/sw-translate

bin/console plugin:refresh

bin/console plugin:install --activate NiceTranslate

bin/console cache:clear

Tipp

Installation und Aktivierung führen Sie auch in zwei getrennten Schritten aus, etwa in einem Wartungsfenster. Nutzen Sie dafür bin/console plugin:install NiceTranslate. Aktivieren Sie die Erweiterung später mit bin/console plugin:activate NiceTranslate.

Installation prüfen

Öffnen Sie Kataloge → KI-Übersetzung. Bei einer neuen Installation zeigt das Dashboard das Banner Übersetzungsanbieter einrichten, und Einstellungen hat vier Tabs: Anbieter, Automatisierung, Erweitert und Abonnement.

Führen Sie diesen Befehl aus, um die Registrierung der Konsolenbefehle zu bestätigen:

bin/console nice-translate:providers

Die Ausgabe listet die sieben Übersetzungsanbieter und den Konfigurationsstatus jedes Anbieters.

Die beiden Rollen nice_translate.viewer und nice_translate.editor stehen unter Einstellungen → Benutzer & Berechtigungen → Rollen, im Bereich Kataloge. Berechtigungen (ACL) beschreibt, was jede Rolle erlaubt.

Nach diesen Prüfungen geht es weiter mit dem Schnellstart.

Erweiterung aktualisieren

Store-Installationen: Shopware bietet das Update unter Erweiterungen → Meine Erweiterungen an, sobald modernice eine neue Version veröffentlicht.

ZIP-Installationen: Laden Sie die neue ZIP-Datei über Erweiterungen → Meine Erweiterungen → Erweiterung hochladen hoch. Shopware bietet das Update danach in der Liste an.

Composer-Installationen:

composer update modernice/sw-translate

bin/console plugin:update NiceTranslate

bin/console cache:clear

Ein Update löscht keine Daten. Lassen Sie alle aktiven Übersetzungsaufträge zu Ende laufen, bevor Sie aktualisieren.

Erweiterung deinstallieren

Deinstallieren Sie die Erweiterung über Erweiterungen → Meine Erweiterungen. Das Kontextmenü der Erweiterung enthält den Befehl Deinstallieren. Auf der Konsole nutzen Sie diesen Befehl:

bin/console plugin:uninstall NiceTranslate

In der Administration fragt Shopware, ob es die Benutzerdaten behalten soll. Auf der Konsole ist dieselbe Entscheidung die Shopware-Option --keep-user-data. Ohne diese Option löscht Shopware die Daten der Erweiterung. Von dieser einen Entscheidung hängt alles Weitere in diesem Abschnitt ab.

Ihre Übersetzungen bleiben immer erhalten

Die Erweiterung schreibt jede Übersetzung als native Shopware-Übersetzung in die Übersetzungstabellen von Shopware. Es sind dieselben Zeilen, die die Administration schreibt, wenn Sie ein Feld von Hand übersetzen. Kein Deinstallationsweg löscht sie.

Was „die Daten der Erweiterung“ bedeutet

Wenn Sie die Benutzerdaten nicht behalten, löscht die Erweiterung ihre eigenen Aufzeichnungen und sonst nichts:

Gelöscht	Was Sie verlieren
Übersetzungsaufträge und ihre Fehler je Datensatz	Die Aufzeichnung darüber, welche Läufe stattfanden, was sie kosteten und welche Einträge fehlschlugen
Übersetzungsverlauf	Den vorherigen und den neuen Wert jedes übersetzten Feldes und damit die Möglichkeit, etwas zurückzusetzen
Glossar	Alle Beibehalten- und Ersetzen-Begriffe mit ihren Übersetzungen je Sprache. Exportieren Sie zuvor die CSV-Datei, wenn Sie sie behalten möchten.
Monatliche Verbrauchsdaten	Die Zeichen, Tokens, Anfragen und berechneten Kosten je Anbieter, die das Dashboard zeigt
Fingerabdrücke von Quelle und Ziel	Die Grundlage für den Schutz manueller Änderungen und für das Überspringen unveränderter Inhalte
Interne Aufzeichnungen der Warteschlange	Dauerhafte Batch-Manifeste, Abschlussmarkierungen und Ereignis-Snapshots abgeschlossener Aufträge
Sämtliche Einstellungen der Erweiterung	Alles unter den Konfigurationsschlüsseln NiceTranslate.*, einschließlich Ihrer hinterlegten Anbieter-API-Schlüssel

Wenn Sie die Benutzerdaten behalten, bleiben alle diese Aufzeichnungen in der Datenbank. Bei einer späteren Neuinstallation kommt das Modul mit Ihren Aufträgen, dem Verlauf, dem Glossar, dem Verbrauch und den Einstellungen zurück.

Achtung

Der Schutz manueller Änderungen und das Überspringen unveränderter Inhalte vergleichen gegen die gespeicherten Fingerabdrücke. Nach dem Löschen dieser Fingerabdrücke hat eine neue Installation nichts mehr zum Vergleichen, bis sie selbst ein Feld schreibt. Ein späterer Lauf im Modus Alle Felder neu übersetzen würde die vorhandenen Übersetzungen überschreiben, weil er sie nicht mehr erkennt. Wenn Sie eine Neuinstallation planen, behalten Sie die Benutzerdaten.

Vor der Deinstallation

• Exportieren Sie Ihr Glossar als CSV-Datei, wenn Sie es weiterverwenden möchten.
• Wenn Sie modernice All-in-One nutzen und nicht mehr brauchen, kündigen Sie den Tarif im Shopware Store. Der Tarif ist ein Shopware In-App-Kauf, und Sie verwalten ihn dort. Die Erweiterung selbst hat keine eigene Kündigungsfunktion. Siehe modernice All-in-One.
• Setzen Sie zuerst alles zurück, was Sie zurücksetzen möchten. Nach dem Löschen des Verlaufs kann die Erweiterung nichts mehr zurücksetzen.

Nächste Schritte

• Schnellstart: einen Anbieter verbinden und die erste Übersetzung starten.
• Übersetzungsanbieter: API-Schlüssel, Modelle und Zuordnung je Sprache.
• Einstellungsreferenz: jede Einstellung auf jedem Tab.