Einstellungsreferenz
Diese Referenz führt jeden Tab und jedes Feld auf, mit der Wirkung und dem Standardwert jeder Einstellung. Die Handbuchseiten, die jeder Abschnitt verlinkt, erklären die Konzepte dahinter.
Wo die Einstellungen liegen
Öffnen Sie Kataloge → KI-Übersetzung und klicken Sie auf Einstellungen. Die Seite trägt den Titel Übersetzungseinstellungen, und Shopware registriert sie zusätzlich als KI-Übersetzung in seiner eigenen Übersicht Einstellungen.
- Zum Bearbeiten und Speichern brauchen Sie die Berechtigung
nice_translate.editor. In der Rollenverwaltung finden Sie sie unter KI-Übersetzung. Siehe Berechtigungen (ACL). - Die Erweiterung legt alle Werte in der Systemkonfiguration von Shopware ab, unter der Domain
NiceTranslate.config.*. Ein Speichervorgang schreibt nur die Schlüssel, die Sie geändert haben. Das Ende dieser Seite enthält die vollständige Liste. - Die Bezeichnungen unten sind die exakten Beschriftungen der deutschen Administration. Die englische Administration zeigt dieselben Felder mit englischen Bezeichnungen, nutzen Sie dafür die englische Fassung dieser Seite.
- Die Tabs heißen Anbieter, Automatisierung, Erweitert und Abonnement, in dieser Reihenfolge.
Die Felder arbeiten weiter, wenn die Erweiterung die Anbieterliste nicht laden kann. Die Seite zeigt dann den Hinweis Die Anbieterliste konnte nicht geladen werden. Sie können dennoch API-Schlüssel eingeben und speichern.
Solange kein API-Schlüssel gespeichert und modernice All-in-One buchbar ist, zeigen die übrigen Tabs eine Informationskarte zu modernice All-in-One. Die Karte wirbt nur für das Abonnement und ändert keine Einstellung.
Anbieter
Dieser Tab enthält alles zur Auswahl eines Übersetzungsdienstes und zur Anbindung an ihn. Übersetzungsanbieter beschreibt die Konzepte und die Einrichtungsschritte je Anbieter.
Allgemein
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Standard-Anbieter | Der Fallback, den die Erweiterung nutzt, wenn weder ein Auftrag noch eine Zielsprachen-Zuordnung einen Anbieter auswählt. | DeepL |
| Tonalität | Belegt die Tonalität neuer Übersetzungen vor: Neutral (Anbieter-Standard), Formell (Sie) oder Informell (Du). Nur die KI-Anbieter setzen sie um. DeepL nutzt seine eigene Einstellung Formalität. | Neutral (Anbieter-Standard) |
| Eigene Anweisungen | Optionale Anweisungen, die die Erweiterung dem Prompt der KI-Anbieter hinzufügt, zum Beispiel Formulierungs- oder Markenregeln. DeepL und Google Translate ignorieren sie. | leer |
Anbieter je Zielsprache
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Ein Auswahlfeld je Zielsprache, beschriftet mit dem Sprachnamen | Wählen Sie optional für jede Zielsprache einen Anbieter aus. Die Automatisierung beim Speichern und nach Zeitplan nutzt diese Zuordnung, wenn kein fester Anbieter ausgewählt ist. Manuelle Übersetzungen behalten den Anbieter aus ihrem Dialog. | Standard-Anbieter verwenden |
Die Erweiterung ermittelt den Anbieter in drei Schritten: zuerst die Sprachzuordnung, dann der Standard-Anbieter, dann DeepL als eingebauter Fallback. Die Karte listet jede Sprache außer der Systemsprache. Hat der Shop keine weitere Sprache, zeigt sie In diesem Shop sind noch keine zusätzlichen Zielsprachen vorhanden.
Anbieterkarten
Es gibt eine Karte je Anbieter: DeepL, Google Translate, OpenAI (ChatGPT), Anthropic Claude, Google Gemini und Mistral. modernice All-in-One hat hier keine Karte. Es liegt auf dem Tab Abonnement.
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| API-Schlüssel | Der Schlüssel, den dieser Shop für den Anbieter nutzt. Die Kennzeichnung neben dem Kartentitel zeigt Konfiguriert oder Nicht konfiguriert für den gespeicherten Schlüssel. | leer |
| Modell | Das Modell, mit dem die Erweiterung übersetzt. Die Karte zeigt dieses Feld nur bei den Anbietern mit Modellauswahl (OpenAI, Anthropic, Gemini, Mistral). Mit gültigem Schlüssel lädt die Erweiterung die Liste live vom Anbieter und legt sie über die Standardliste. | siehe Tabelle unten |
| Modelltyp (nur DeepL) | Qualitätsoptimiert bevorzugen (empfohlen), Nur qualitätsoptimiert oder Latenzoptimiert (schneller). | Qualitätsoptimiert bevorzugen (empfohlen) |
| Formalität (nur DeepL) | Anbieter-Standard, Eher formell oder Eher informell. Die Erweiterung sendet den Wert nur für die Zielsprachen, in denen DeepL Formalität unterstützt. | Anbieter-Standard |
| Verbindung testen (Schaltfläche) | Prüft den Schlüssel, der aktuell im Feld steht, gespeichert oder nicht, beim Anbieter. Zeigt die Kontingentangaben, sofern der Anbieter welche liefert. Ein erfolgreicher Test lädt außerdem die Live-Modellliste neu. | — |
Standardmodelle:
| Anbieter | Standardmodell |
|---|---|
| DeepL | — (keine Modellauswahl; stattdessen Modelltyp) |
| Google Translate | — |
| OpenAI (ChatGPT) | gpt-5.6-luna |
| Anthropic Claude | claude-opus-5 |
| Google Gemini | gemini-flash-lite-latest |
| Mistral | mistral-small-latest |
Preise verstehen
Diese Karte am Ende des Tabs enthält keine Einstellungen. Sie erklärt den Unterschied zwischen Token- und Zeichenabrechnung. Sie listet außerdem je Modell den Eingabe- und den Ausgabepreis, den die Erweiterung kennt, und verlinkt die aktuelle Preisliste jedes Anbieters. Siehe Kosten & Verbrauch.
Automatisierung
Dieser Tab konfiguriert die Übersetzung im Hintergrund, die ohne den Assistenten arbeitet. Automatisierung erklärt sie vollständig.
Beide Karten brauchen aktive Message-Queue-Worker. Ein Hinweis am Anfang des Tabs warnt davor: Die Automatisierung läuft im Hintergrund und benötigt aktive Message-Queue-Worker. Stellen Sie sicher, dass Ihr Hosting den Shopware Message-Consumer ausführt.
Beim Speichern übersetzen
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Inhalte nach dem Speichern automatisch übersetzen | Die Erweiterung übersetzt Inhalte, die Sie in der Standardsprache speichern, automatisch in die ausgewählten Zielsprachen. | aus |
| Inhaltstypen | Die Inhaltstypen, die die Automatisierung beobachtet: Produkte, Kategorien, Hersteller, Erlebniswelten (CMS). | nichts ausgewählt |
| Zielsprachen | Die Sprachen, in die die Erweiterung gespeicherte Inhalte übersetzt. Die Liste bietet die Systemsprache nicht an. | nichts ausgewählt |
| Anbieter | Wählen Sie einen Anbieter für jede Zielsprache aus, oder nutzen Sie die Sprachzuordnung mit dem Standard-Anbieter als Fallback (Sprachzuordnung / Standard verwenden). | Sprachzuordnung / Standard verwenden |
Übersetzungen beim Speichern arbeiten ohne Auftragskopf. Solange die Verlaufsaufzeichnung aktiv ist, erscheinen ihre geänderten Felder trotzdem im globalen Übersetzungsverlauf. Die Schaltfläche Übersetzungsverlauf öffnen springt direkt dorthin.
Geplante Übersetzung
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Fehlende Übersetzungen zeitgesteuert ergänzen | Legt im Intervall unten Übersetzungsaufträge für unübersetzte Inhalte an. | aus |
| Intervall | Stündlich, Alle 6 Stunden, Alle 12 Stunden, Täglich (empfohlen) oder Wöchentlich. Die Karte zeigt dieses Feld nur, solange der Zeitplan aktiv ist. | Täglich (empfohlen) |
| Inhaltstypen | Die Inhaltstypen des geplanten Laufs. Es sind dieselben vier Werte wie beim Speichern, aber Sie wählen sie getrennt aus. | nichts ausgewählt |
| Letzte Ausführung | Ein schreibgeschützter Zeitstempel des letzten geplanten Laufs, sonst Noch nie. | Noch nie |
Die geplante Übersetzung nutzt die Zielsprachen aus der Karte darüber, hat aber ihre eigene Auswahl an Inhaltstypen. Ein Typ, den Sie für das Übersetzen beim Speichern einschalten, kommt damit nicht in den Zeitplan.
Die geplante Shopware-Aufgabe nice_translate.auto_translate läuft einmal pro Stunde und startet einen Lauf, sobald seit dem letzten Lauf das eingestellte Intervall vergangen ist. Dafür müssen beide Worker laufen (scheduled-task:run und messenger:consume). Solange Fehlende Übersetzungen zeitgesteuert ergänzen aus ist, findet kein Übersetzungslauf statt, gleich welches Intervall eingestellt ist. Ein fälliger Lauf legt einen Auftrag je Anbietergruppe an, deshalb erzeugt eine Sprachzuordnung über mehrere Anbieter mehrere Aufträge.
Eine zweite geplante Aufgabe, nice_translate.dispatch_batches, läuft jede Minute. Sie hat auf dieser Seite keine Einstellung. Sie holt die Batches und die Auftragsende-Benachrichtigungen nach, die der erste Versuch nicht zugestellt hat.
Erweitert
Übersetzungsverhalten
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Batch-Größe | Die Anzahl der Datensätze in einer Warteschlangen-Nachricht. Der zulässige Bereich ist 5 bis 200, und Werte zwischen 10 und 50 passen für die meisten Shops. Einen Wert außerhalb des Bereichs setzt die Erweiterung auf die Grenze. | 25 |
| SEO-Felder automatisch kürzen | Kürzt Meta-Titel und Meta-Beschreibungen an Wortgrenzen, wenn die Übersetzung das Feldlimit überschreitet. Siehe Schutzmechanismen. | ein |
| Glossar anwenden | Wendet Ihre Glossarbegriffe auf jede Übersetzung an. Ausgeschaltet ist das Glossar global aus, auch für die Aufträge, die es anfordern. Siehe Glossar. | ein |
Übersetzungsverlauf
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Übersetzungsverlauf aufzeichnen | Speichert den vorherigen und den neuen Wert jedes übersetzten Feldes, damit Sie Übersetzungen später rückgängig machen oder erneut anwenden können. Siehe Übersetzungsverlauf. | ein |
| Aufbewahrungsdauer (Tage) | Die Erweiterung löscht ältere Verlaufseinträge automatisch, auch wenn die Aufzeichnung aus ist. Der zulässige Bereich ist 1 bis 365. Die Bereinigung läuft über die stündliche geplante Aufgabe, deshalb muss der Scheduled-Task-Runner aktiv sein. | 30 |
Ausgeschlossene Felder
Die Felder in dieser Liste übersetzt die Erweiterung niemals, in keinem Auftrag, keinem Lauf des Assistenten, keiner Schnellübersetzung und keinem Automatisierungslauf. Schließen Sie zum Beispiel description für Produkte aus, wenn jeder Markt eigene Beschreibungen schreibt.
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Entität | Der Inhaltstyp, für den eine Ausschlusszeile gilt. Entität hinzufügen legt eine Zeile an, und Entität entfernen löscht sie. | keine Zeilen |
| Ausgeschlossene Felder | Die Felder dieser Entität, die die Erweiterung nie übersetzt. Der Eintrag für Zusatzfelder trägt den Zusatz (alle Zusatzfelder). | keine |
| Expertenmodus (JSON bearbeiten) | Bearbeitet dieselbe Konfiguration als reines JSON: ein Objekt der Form {"<entity>": ["<field>", …]}. | aus |
Ist das JSON ungültig, blockiert die Erweiterung das Speichern mit der Meldung Die ausgeschlossenen Felder müssen ein gültiges JSON-Objekt enthalten. Bitte korrigieren Sie die Eingabe vor dem Speichern. und führt Sie zurück auf den Tab Erweitert. Der Expertenmodus arbeitet auch dann, wenn die Erweiterung die Entitätenliste nicht laden kann.
Unterstützte Inhalte nennt die Felder, die es je Inhaltstyp gibt.
Quellsprachen
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Ein Auswahlfeld je Zielsprache, beschriftet mit dem Sprachnamen | Wählen Sie die Sprache aus, die die Erweiterung als Quelle für diese Zielsprache nutzt. Ohne Auswahl nutzt sie die Standardsprache des Systems. | System-Standardsprache |
Eine Ausgangssprache, die Sie im Assistenten auswählen, überschreibt diese Zuordnung für den jeweiligen Lauf. Siehe Übersetzungsassistent.
Abonnement
Dieser Tab enthält die Karte modernice All-in-One. modernice All-in-One enthält die vollständige Anleitung.
| Einstellung | Was sie bewirkt | Standard |
|---|---|---|
| Abonnementtarif | Wählt den Tarif für den Kauf aus: Starter, Growth, Scale oder Enterprise, jeweils mit dem monatlich enthaltenen Guthaben. Die Erweiterung speichert dafür keine Einstellung. Das Feld steuert die Schaltfläche Abonnieren oder Tarif wechseln. | Starter |
| Standard-Servicestufe | Die Stufe, die ein Lauf nutzt, wenn er keine auswählt: Speed · 1×, Ausgewogen · 3× oder Premium-Qualität · 8×. Die Stufe bestimmt die Übersetzungsqualität und den Guthabenverbrauch. | Ausgewogen · 3× |
| Abonnieren / Tarif wechseln (Schaltflächen) | Öffnet den In-App-Kauf-Dialog von Shopware für den gewählten Tarif. | — |
| Status aktualisieren (Schaltfläche) | Liest den Shopware-In-App-Kaufstatus und das Guthabenkontingent erneut ein. | — |
Solange ein Tarif aktiv ist, zeigt die Karte zusätzlich Aktiver Tarif, Übersetzungsguthaben (verbraucht von enthalten, mit Fortschrittsbalken) und Abrechnungszeitraum.
Konfigurationsschlüssel
Alle Schlüssel liegen in der Systemkonfigurations-Domain NiceTranslate.config.. Die Erweiterung hat keine config.xml. Sie ändern diese Werte über die Einstellungsseite oben, oder programmatisch über die Systemkonfigurations-API von Shopware.
| Schlüssel | Typ | Standard | Tab |
|---|---|---|---|
defaultProvider | string | deepl | Anbieter |
tone | enum | default | Anbieter |
customPrompt | string | leer | Anbieter |
languageProviderMap | object | {} | Anbieter |
deeplApiKey | string | leer | Anbieter |
deeplModelType | enum | prefer_quality_optimized | Anbieter |
deeplFormality | enum | default | Anbieter |
googleApiKey | string | leer | Anbieter |
openaiApiKey | string | leer | Anbieter |
openaiModel | string | gpt-5.6-luna | Anbieter |
anthropicApiKey | string | leer | Anbieter |
anthropicModel | string | claude-opus-5 | Anbieter |
geminiApiKey | string | leer | Anbieter |
geminiModel | string | gemini-flash-lite-latest | Anbieter |
mistralApiKey | string | leer | Anbieter |
mistralModel | string | mistral-small-latest | Anbieter |
autoTranslateEnabled | bool | false | Automatisierung |
autoTranslateEntities | array | [] | Automatisierung |
autoTranslateLanguageIds | array | [] | Automatisierung |
autoTranslateProviderId | string | leer | Automatisierung |
scheduledEnabled | bool | false | Automatisierung |
scheduledIntervalHours | int | 24 | Automatisierung |
scheduledEntities | array | [] | Automatisierung |
scheduledLastRun | string | leer (die geplante Aufgabe schreibt ihn) | Automatisierung |
batchSize | int | 25 | Erweitert |
seoTruncate | bool | true | Erweitert |
glossaryEnabled | bool | true | Erweitert |
historyEnabled | bool | true | Erweitert |
historyRetentionDays | int | 30 | Erweitert |
excludedFields | object | {} | Erweitert |
sourceLanguageMap | object | {} | Erweitert |
managedServiceTier | enum | balanced | Abonnement |
Die Enums akzeptieren diese Werte: tone akzeptiert default, formal oder informal; deeplModelType akzeptiert prefer_quality_optimized, quality_optimized oder latency_optimized; deeplFormality akzeptiert default, prefer_more oder prefer_less; managedServiceTier akzeptiert speed, balanced oder quality. languageProviderMap ordnet einer Sprach-ID eine Anbieter-ID zu. sourceLanguageMap ordnet einer Zielsprachen-ID eine Ausgangssprachen-ID zu. excludedFields ordnet einem Entitätsnamen eine Liste von Feldnamen zu.