Funktionsumfang
Das Plugin übersetzt Shop-Inhalte über die DeepL API. Alle Übersetzungsläufe werden über die Shopware Message Queue asynchron verarbeitet, sodass auch große Datenmengen ohne Timeout im Hintergrund abgearbeitet werden.
Übersetzbare Entitäten
Abschnitt betitelt „Übersetzbare Entitäten“| Entität | Felder / Details |
|---|---|
| Produkte | Name, Beschreibung, Metadaten, Custom Fields; optional Varianten einbeziehen |
| Kategorien | Name, Beschreibung, Custom Fields; optional Kindkategorien einbeziehen |
| CMS-Slots | Inhaltliche Slot-Konfigurationen, erweiterbar um eigene Feldpfade |
| Snippets | Übergabe kompletter Snippet-Sets (Storefront, Messages, dynamische Snippets), Key-Filter |
| E-Mail-Vorlagen | Betreff und/oder Inhalt, inkl. MailTemplateTypes |
| Eigenschaften | Gruppen und Optionen (Name, Beschreibung, Custom Fields) |
| Anreden | Anzeigename, Briefanrede |
| Mengeneinheiten | Kurzcode, Name |
| Blog (Netzp Blog 6) | Titel, Slug (optional), Inhalt, Teaser, Meta-Felder, Kategorien, Autoren |
| Formulare (MoorlForms) | Name, Erfolgs-/Fehlermeldung, Elemente, weitere Felder |
Netzp Blog 6 und MoorlForms sind optional: die jeweiligen Jobs erscheinen nur, wenn das Plugin installiert ist. Details: Plugin-Kompatibilität.
Verarbeitung
Abschnitt betitelt „Verarbeitung“| Funktion | Beschreibung |
|---|---|
| Message Queue | Asynchrone Verarbeitung als Shopware-Jobs, Status-Verfolgung (pending, running, completed, failed) |
| Fehlerverfolgung | Fehlgeschlagene Jobs speichern ihre Fehlermeldung, Einzel- und Massen-Retry über die Queue-Ansicht |
| Rate-Limiting | DeepL-Rate-Limits (HTTP 429) werden automatisch wiederholt, unter Berücksichtigung des Retry-After-Headers von DeepL |
| Übersetzungscache | Bereits übersetzte Texte werden in der Datenbank vorgehalten, Cache kann pro Job deaktiviert werden |
| Vorlagen | Häufig genutzte Job-Konfigurationen speichern und inkl. Ausführungs-Historie wiederverwenden |
| Zielsprachen | Mehrere Zielsprachen in einem Job-Durchlauf |
DeepL-Integration
Abschnitt betitelt „DeepL-Integration“| Funktion | Beschreibung |
|---|---|
| Free- und Pro-API | Umschaltbar in den Einstellungen, korrekte Basis-URL je Plan |
| Glossare | DeepL-Glossare pro Job, zusätzlich ein Standard-Glossar konfigurierbar |
| HTML-Handling | HTML-Inhalte werden strukturgetreu übersetzt (Tag-Handling), Formatierung bleibt erhalten |
| Ignore-Zeichen | Konfigurierbare Zeichen (z.B. ®, ✓) bleiben unverändert |
| Dummy-Text-Erkennung | Platzhaltertexte (z.B. Lorem Ipsum) werden nicht übersetzt, Schwellwert konfigurierbar |
SEO-Links
Abschnitt betitelt „SEO-Links“Interne Links in übersetzten Inhalten werden auf die SEO-URL der Zielsprache umgeschrieben:
- Relative Links (
/kategorie-name) werden durch die SEO-URL der Zielsprache ersetzt - Absolute Links nur, wenn sie zum passenden Verkaufskanal gehören, externe Links bleiben unverändert
- Sprach-Präfixe aus der Verkaufskanal-Domain-Konfiguration werden berücksichtigt (
https://domain.de/en) - Fallback auf technische URLs (
/navigation/{id}), wenn keine SEO-URL existiert - Statische URL-Ersetzungen konfigurierbar, z.B.
{"impressum": "imprint"}
Admin-Oberfläche
Abschnitt betitelt „Admin-Oberfläche“Das Modul finden Sie im Shopware-Admin unter Inhalte > Übersetzung mit DeepL:
| Bereich | Funktion |
|---|---|
| Create Job | Job-Typ oder gespeicherte Vorlage wählen, Parameter setzen, Job einreihen |
| Queue | Job-Liste mit Status und Fehlermeldungen, Einzel-/Massen-Löschen, Retry |
| Live Translation | Text direkt übersetzen, Cache-Verhalten und Laufzeit testen |
| Translation Cache | Cache-Einträge einsehen und verwalten |
| DeepL Usage | Verbrauch gegen das Kontingent der DeepL API |