Änderungsprotokoll

Dies ist die Versionsgeschichte der KI-Übersetzungssuite. Die Versionsnummern haben die Form MAJOR.MINOR.PATCH, und jede veröffentlichte Version hat hier einen eigenen Abschnitt, die neueste zuerst.

modernice veröffentlicht die Erweiterung im Shopware Store als KI-Übersetzungssuite — DeepL, ChatGPT, Claude, Gemini & Google. Sie installieren sie und prüfen die Updates in Ihrer Administration, unter Erweiterungen → Meine Erweiterungen. Zur Installation über Composer siehe Installation.

1.0.0

Die erste Veröffentlichung. Sie unterstützt Shopware 6.6.9 bis 6.7, auf PHP 8.2 oder einer neueren Version.

Anbieter

• Sechs Anbieter sind in der Erweiterung enthalten, und jeder nutzt einen API-Schlüssel, den Sie hinterlegen: DeepL, Google Translate, OpenAI (ChatGPT), Anthropic Claude, Google Gemini und Mistral.
• modernice All-in-One in vier Tarifen: Starter, Growth, Scale und Enterprise. Der Dienst rechnet die Übersetzung in Guthabenpunkten ab, in drei Servicestufen: Speed, Ausgewogen und Premium-Qualität. Die Erweiterung liest die Kontingentwerte beim Dienst nach. Jede weitergeleitete Anfrage trägt einen stabilen Idempotenzschlüssel, deshalb gibt eine Wiederholung das ursprüngliche Ergebnis zurück.

Inhalte

• Ein Assistent für Massenläufe. Sie wählen die Inhaltstypen aus und legen den Umfang je Typ fest: alles oder nur Fehlendes. Danach schalten Sie die Zusatzfelder ein oder aus und wählen die Tonalität und den Anbieter aus.
• Die Erweiterung übersetzt Produkte, Kategorien, Erlebniswelten (ein generischer Walker über die Slot-Konfiguration erfasst auch CMS-Elemente von Drittanbietern), Landingpages, Hersteller, Eigenschaften, Alt-Texte und Titel von Medien, E-Mail-Vorlagen, Cross-Selling, Lieferzeiten, Maßeinheiten, Länder, Anreden, Währungen, Zahlungsarten, Versandarten, Storefront-Textbausteine und übersetzbare Zusatzfelder.
• Ein Glossar mit zwei Arten von Einträgen. Beibehalten-Begriffe sperrt die Erweiterung mit einem Token, bevor der Text den Shop verlässt. Ersetzen-Begriffe setzen die Formulierung durch, die Sie vorgeben. Einträge können die Groß-/Kleinschreibung beachten, und die Erweiterung importiert und exportiert die vollständige Liste als CSV.

Automatisierung

• Automatische Einplanung der fehlenden Übersetzungen nach einem Speichern in der Standardsprache. Das gilt für ein Produkt, eine Kategorie, einen Hersteller und eine Erlebniswelt.
• Geplante Übersetzung fehlender Inhalte, in jedem Intervall von stündlich bis wöchentlich. Eine stündliche Aufgabe prüft, ob der nächste Lauf fällig ist.
• Ein Flow-Builder-Trigger, „Übersetzungsauftrag abgeschlossen“ (nice_translate.job.finished).

Sicherheit und Wiederherstellung

• Der Übersetzungsverlauf hält jedes Feld fest, das ein Lauf schreibt. Einzelne Einträge setzen Sie zurück oder wenden sie erneut an, und einen ganzen Auftrag setzen Sie im Hintergrund zurück. Passt der aktuelle Wert eines Feldes nicht mehr zum Wert des Laufs, lässt das Zurücksetzen dieses Feld unverändert. Die Aufbewahrungsdauer ist konfigurierbar.
• Schutz manueller Änderungen und Änderungsverfolgung zum Überspringen unveränderter Inhalte. Beides ist standardmäßig aktiv, und beides arbeitet mit einem Hash des Inhalts.
• Die Erweiterung sperrt die Platzhalter, bevor ein Text zum Anbieter geht, und stellt sie danach wieder her. Rich Text geht im HTML-Modus hinaus, mit Anweisungen, die der Anbieter versteht.
• Ein Schnitt an einer Wortgrenze für ein längenbegrenztes Feld wie den Meta-Titel, wenn die Übersetzung länger ausfällt, als das Feld erlaubt.
• Eine Deinstallation behält jede Übersetzung, denn die Erweiterung schreibt native Shopware-Übersetzungen.

Zuverlässigkeit

• Die gesamte Übersetzungsarbeit läuft im Hintergrund, auf der niedrig priorisierten Message Queue, mit automatischen Wiederholungen und exponentiellem Backoff.
• Ein Auftrag schreibt ein dauerhaftes Manifest, bevor er die Arbeit übergibt. Ein Lauf über modernice All-in-One erfasst ein Manifest während des Schreibens. Die Erweiterung schreibt Inhalts- und Ergebnisquittungen atomar, und eine begrenzte, faire Weitergabe füllt die Warteschlange. Zusammen fangen diese Mechanismen einen Worker-Absturz während der Übergabe oder nach einem erfolgten Schreibvorgang ab. Doppelte Zustellungen derselben Nachricht serialisiert die Erweiterung vor jedem Anbieteraufruf.
• Abschließende Auftrags-Events verlassen den Shop über eine Outbox, die mindestens einmal zustellt und veraltete Reservierungen wieder freigibt. Über diesen Weg erreicht das Event den Flow Builder.
• Die Erweiterung liest Warteschlangen-Nachrichten weiter, die eine Vorabversion serialisiert hat. Die Aktualisierung der Store-Berechtigung nach einem Kauf ist authentifiziert und begrenzt.

Administration

• Vor dem Start eines Laufs zeigt der Assistent eine Schätzung von Einträgen, Zeichen und Kosten, dazu Vorab-Warnungen in verständlicher Sprache.
• Ein monatliches Verbrauchspanel auf dem Dashboard, mit einer Zeile je Anbieter: Zeichen, Tokens, Anfragen und Kosten.
• Ein Abdeckungsbericht je Sprache. Jede Zeile hat eine Schaltfläche Fehlende übersetzen, die den Assistenten mit dieser Sprache als gewähltem Ziel öffnet.
• Schnellübersetzung auf der Produktdetailseite und der Kategoriedetailseite sowie in der Produktliste als Mehrfachaktion.

CLI und Berechtigungen

• Zwei CLI-Befehle: nice-translate:run, der den Fortschritt mit --watch verfolgen kann, und nice-translate:providers, der einen Schlüssel mit --test prüft. Siehe CLI-Befehle.
• Die ACL-Berechtigung nice_translate, mit den Rollen nice_translate.viewer und nice_translate.editor. Keine der Rollen hat eine eigene Bezeichnung, erkennen Sie sie deshalb am Schlüssel. Siehe Berechtigungen (ACL).