FAQ
Kurze Antworten zum Verhalten der KI-Übersetzungssuite. Wenn etwas nicht korrekt arbeitet, beginnen Sie bei der Fehlerbehebung.
Löscht eine Deinstallation meine Übersetzungen?
Nein. Die Erweiterung speichert alles, was sie schreibt, als native Shopware-Übersetzung, und eine Deinstallation verändert diese Datensätze nie. Ihre eigenen Daten sind Aufträge, Fehlerzeilen, Übersetzungsverlauf, Glossar, Verbrauchszahlen, Änderungs-Fingerabdrücke und Einstellungen. Diese Daten löscht die Erweiterung nur, wenn Sie sich bei der Deinstallation gegen das Behalten der Benutzerdaten entscheiden.
Welche Daten verlassen meinen Shop?
Drei Dinge gehen an den Anbieter, den Sie für diesen Lauf ausgewählt haben: die Inhalte, die Sie zur Übersetzung ausgewählt haben, die Übersetzungsanweisungen sowie das Quell- und das Ziel-Locale. Die Erweiterung wählt Bestell- und Kundenentitäten nie zur Übersetzung aus. Katalog-, CMS-, E-Mail-Vorlagen-, Textbaustein- und Zusatzfeldinhalte können trotzdem personenbezogene oder vertrauliche Daten enthalten. Prüfen Sie deshalb, was Sie senden. Die Seite Datenschutz führt jedes Ziel auf, den Betreiber dahinter und die Bedingung, unter der die Erweiterung Daten sendet.
Welche Sprachen werden unterstützt?
Das hängt von Ihrem Anbieter und Ihrem Konto dort ab. Die Erweiterung bringt keine eigene Sprachliste mit. Sie bildet Shopware-Locales auf die Sprachcodes des jeweiligen Anbieters ab, darunter pt-PT und pt-BR, vereinfachtes und traditionelles Chinesisch sowie Norwegisch Bokmål. Vor einem manuellen Lauf warnt sie, wenn sie ein Locale für den gewählten Anbieter nicht zuordnen kann. LLM-Anbieter erhalten die Sprache als Namen und sind für seltenere Locales deshalb meist die flexiblere Wahl.
Kann ich steuern, welche Felder die Erweiterung übersetzt?
Ja, auf zwei Ebenen. Für jeden Auftrag wählen Sie im Assistenten die Inhaltstypen aus. Für jeden Inhaltstyp legen Sie danach den Umfang fest, entweder Alle Einträge oder Nur Einträge ohne Übersetzung. Sie entscheiden außerdem, ob der Lauf die Zusatzfelder einbezieht. Der Assistent hat keine Auswahl einzelner Felder, deshalb übersetzt der Lauf jedes berücksichtigte Feld eines ausgewählten Inhaltstyps. Global führen Sie unter Einstellungen → Erweitert → Ausgeschlossene Felder eine dauerhafte Liste, die kein Auftrag übergehen kann. Einzelne Felder wählen Sie über options.fields am Auftrags-Endpunkt der Admin-API aus. Ein Zusatzfeld übersetzt die Erweiterung nur, wenn seine Definition vom Typ Text oder HTML ist und das Feld als übersetzbar markiert. Siehe Unterstützte Inhalte und die Einstellungsreferenz.
Sind meine Erlebniswelten-Layouts sicher?
Die Erweiterung schreibt den übersetzten Text in die Zielsprachebene des Layouts. Medienreferenzen, URLs, Farben, CSS-Klassen und Konfigurationsschlüssel verändert sie nicht. Gesperrte Systemlayouts von Shopware schreibt sie nie. Es bleibt trotzdem ein Massenschreibvorgang. Testen Sie repräsentative Seiten vor einem großen Lauf in einem Staging-Shop, und lassen Sie den Übersetzungsverlauf als Rückweg aktiviert.
Kann ich modernice All-in-One und eigene API-Schlüssel zusammen nutzen?
Ja. modernice All-in-One erscheint als ein weiterer Anbieter in der Liste, und Ihre eigenen Schlüssel arbeiten daneben weiter. Unter Einstellungen → Anbieter → Anbieter je Zielsprache leiten Sie eine Zielsprache über modernice All-in-One und eine andere Sprache über DeepL. Sie wählen auch für jeden einzelnen Auftrag einen anderen Anbieter aus.
Wie genau ist die Kostenschätzung?
Die Schätzung ist unverbindlich, und ein Hinweis im Assistenten warnt davor: Die Schätzung basiert auf Stichproben und kann vom endgültigen Ergebnis abweichen. Bei großen Mengen misst die Erweiterung eine Stichprobe Ihrer echten Inhalte und rechnet hoch. Im Modus „nur fehlende“ überspringt der Lauf die Felder mit vorhandener Übersetzung, deshalb liegen die tatsächlichen Kosten oft unter der Schätzung. Maßgeblich ist die Rechnung des Anbieters, oder die Kontingentprüfung von modernice All-in-One zum Zeitpunkt der Anfrage. Siehe Kosten & Verbrauch.
Muss ich auf meinem Server etwas betreiben?
Ja. Die Message-Queue-Worker und der Scheduled-Task-Runner sind zwingend erforderlich, denn jede Übersetzung läuft über die Hintergrund-Warteschlange. Bei Managed-Hosting sind beide meist bereits vorhanden. In einem selbst gehosteten Shop richten Sie sie einmalig unter einem Prozessmanager ein. Sonst ist nichts nötig: Es gibt keinen separaten Dienst zu betreiben und keinen Cronjob speziell für diese Erweiterung. Siehe Voraussetzungen und Automatisierung.
Was passiert, wenn ich eine Übersetzung von Hand bearbeite?
Die Erweiterung speichert einen Fingerabdruck von allem, was sie schreibt. Eine aktuelle Übersetzung, die nicht mehr zu diesem Fingerabdruck passt, ist eine Handbearbeitung. Die Erweiterung überspringt das Feld dann, solange Manuelle Änderungen schützen aktiviert ist. Dieser Schutz ist in jedem Auftrag der Standard und bei der Automatisierung immer aktiv. Für einen einzelnen manuellen Lauf schalten Sie ihn im Assistenten aus.
Kann ich einen Übersetzungslauf rückgängig machen?
Ja, wenn die Verlaufsaufzeichnung zum Zeitpunkt des Laufs aktiv war. Einen abgeschlossenen Auftrag nehmen Sie auf seiner Detailseite mit Alle Übersetzungen rückgängig machen als Ganzes zurück. Einzelne Felder machen Sie im Verlauf rückgängig oder wenden sie erneut an. Ein Schutz sichert das Zurücksetzen ab: Ein Feld, das jemand nach der Übersetzung geändert hat, überspringt die Erweiterung. Den Verlauf behält sie für die Aufbewahrungsdauer, die Sie konfiguriert haben, standardmäßig 30 Tage. Siehe Übersetzungsverlauf.
Funktioniert die Erweiterung mit CMS-Elementen von Drittanbietern?
In der Regel ja. Der CMS-Walker erkennt Text anhand von Schlüsselnamen und Werteformen. Er übersetzt deshalb den Text in kompatiblen Drittanbieter-Elementen zusammen mit den Elementen von Shopware. Ein Element, das seinen Text unter einem ungewöhnlichen Schlüssel speichert, erkennt er nicht. Testen Sie solche Elemente zuerst in einem Staging-Shop.
Wie übersetze ich Storefront-Textbausteine?
Wählen Sie im Assistenten Storefront-Textbausteine als Inhaltstyp aus, genau wie Produkte oder Kategorien. Für das Quell-Locale und für das Ziel-Locale muss ein Snippet-Set vorhanden sein. Die Erweiterung liest aus dem einen Set und schreibt in das andere Set, und sie legt selbst keines an. Fehlt ein Set, erhalten Sie vorab eine Warnung, und die Erweiterung überspringt die Textbausteine. Die Textbausteine, die die Erweiterung schreibt, tragen NiceTranslate als Autor. In der Textbaustein-Verwaltung von Shopware unterscheiden Sie sie deshalb von Ihren eigenen.