DeepL CSV-Übersetzer für Magento 2
Der DeepL CSV Translator ist eine zusätzliche Erweiterung für das DeepL Translator-Modul in Magento. Sie ermöglicht es Shop-Administratoren, große CSV-Dateien schnell zu übersetzen, Übersetzungen aus dem Backend zu verwalten und dynamisch Magento i18n Sprachpakete zu erstellen
Wichtiger Hinweis: Bitte beachten Sie, dass die DeepL CSV Translator-Erweiterung so konzipiert ist, dass sie nahtlos mit dem DeepL Translator-Modul zusammenarbeitet und einen gültigen DeepL API-Schlüssel erfordert
Beschreibung
DeepL CSV-Übersetzer für Magento 2
Dieses Modul ist perfekt für mehrsprachige Magento Shops und bietet skalierbare und optimierte Übersetzungsworkflows durch das Magento Message Queue (MQ) System. Es ermöglicht Shop-Administratoren die effiziente Übersetzung großer CSV-Dateien, die Verwaltung von Übersetzungen direkt aus dem Backend und die dynamische Generierung von Magento i18n Sprachpaketen. Durch die nahtlose Integration mit dem DeepL Translator-Modul gewährleistet es qualitativ hochwertige Übersetzungen für mehrere Sprachen, automatisiert die Bearbeitung von Übersetzungsaufgaben im Hintergrund und ermöglicht Administratoren eine einfache Überwachung des Fortschritts. Dies macht es zu einer idealen Lösung für Unternehmen, die global expandieren und gleichzeitig einen konsistenten, zuverlässigen und effizienten Übersetzungsprozess aufrechterhalten wollen.
>Features
Backend CSV-Übersetzungsmanagement
- Übersetzen Sie CSV-Dateien mit DeepL.
- Unterstützt Standard-CSV-Übersetzungsdateitypen.
- Vollständig kompatibel mit Magento i18n Sprachpaketen.
- Verwalten Sie CSV-Übersetzungen über das Backend-Raster.
- Kombinieren Sie mehrere Übersetzungen in einer einzigen CSV-Datei auf der Grundlage der Sprache.
Flexibler CSV-Upload
- Backend File Uploader: Laden Sie CSV-Dateien direkt aus dem Verwaltungsbereich hoch.
- Direkter Pfad-Upload: Legen Sie große CSV-Dateien in
var/translateab, wenn der Upload im Backend nicht möglich ist.
Stapelverarbeitung für große Dateien
- Teilen Sie große CSV-Dateien in kleinere Stapel (100-1000 Zeilen pro Stapel).
- Schnellere Verarbeitung und geringere Serverbelastung.
Verwaltung von Übersetzungsdatensätzen
- Option, um das Löschen von laufenden Übersetzungsdatensätzen zuzulassen oder einzuschränken.
- Verhindert versehentlichen Datenverlust.
Dynamische Sprachpaketgenerierung
- Generieren Sie Magento i18n Sprachpakete dynamisch aus übersetzten CSV-Dateien.
- Wählen Sie aus, welche CSV-Dateien eingebunden werden sollen und definieren Sie deren Reihenfolge.
Magento Message Queue Integration
- Übersetzungsvorgänge laufen asynchron über Magento MQ.
- Background Worker verarbeiten Übersetzungen ohne die Admin-Oberfläche zu blockieren.
- Unterstützt große Dateien zuverlässig und effizient.
Konfiguration
Einstellungen sind im Admin-Panel unter Stores → Konfiguration → Extendware → DeepL Translator → CSV-Übersetzungseinstellungen verfügbar.
| Einstellungen | Optionen | Beschreibung |
|---|---|---|
| Aktivieren | Ja / Nein | Aktivieren oder Deaktivieren der CSV-Übersetzungsfunktion. |
| Löschen zulassen | Ja / Nein | Benutzern das Löschen laufender Übersetzungssätze erlauben. Nicht empfohlen, wenn es nicht notwendig ist. |
| Datei-Uploader verwenden | Ja / Nein | CSV-Upload im Backend aktivieren. Wenn deaktiviert, müssen die Dateien manuell in var/translate hochgeladen werden. |
| Batch Count | Numerisch (100-1000) | Anzahl der Zeilen pro Batch für die Verarbeitung. Standard: 100 |
CSV-Übersetzungsmanager
Rufen Sie das Menü im Adminbereich unter Extendware → Extendware Deepl CSV Translate → DeepL CSV Translation auf.
Mit dem CSV Translation Manager können Sie alle Ihre Übersetzungsdateien effizient verwalten:
- Neue Übersetzung hinzufügen: Verwenden Sie die Schaltfläche Neu hinzufügen, um einen neuen Übersetzungseintrag zu erstellen und eine CSV-Datei zur Bearbeitung hochzuladen.
- Einträge bearbeiten oder löschen: Bearbeiten Sie in der Spalte Aktionen vorhandene Übersetzungen oder entfernen Sie sie, wenn sie nicht mehr benötigt werden.
- Übersetzung starten: Starten Sie den Übersetzungsprozess direkt in der Spalte Aktionen. Das System verarbeitet die Datei mit Hilfe der DeepL API im Hintergrund über die Message Queue (MQ) von Magento.
- Übersetzte CSV-Datei herunterladen: Sobald die Übersetzung abgeschlossen ist, laden Sie die übersetzte CSV-Datei aus dem Grid herunter.
- Status überwachen: Das Raster zeigt den Übersetzungsstatus in Echtzeit an (z.B., Ausstehend, In Bearbeitung, Abgeschlossen, Gescheitert).
- Quelldatei anzeigen: Nach erfolgreicher Übersetzung können Sie die ursprüngliche CSV-Quelldatei anzeigen und herunterladen.
- Sprachübersicht: Jede Zeile zeigt deutlich die ausgewählte Quellsprache und Zielsprache für die Übersetzung.
So erhalten Administratoren einen vollständigen Überblick über alle Übersetzungsaufträge und können Übersetzungen für mehrsprachige Magento-Shops einfach verwalten, verfolgen und exportieren.
Neu hinzufügen DeepL CSV-Formular übersetzen
Das Add New DeepL Translate CSV Form ermöglicht Administratoren die Konfiguration und Verwaltung neuer Übersetzungsaufträge.
- Status: Dieses Feld ist standardmäßig deaktiviert und wird automatisch vom System verwaltet. Es zeigt den Echtzeit-Status jeder Übersetzung an, wie z.B. In der Warteschlange, Laufend, Abgeschlossen, oder Scheitert.
- CSV-Datei: Sie können die CSV-Datei auf zwei Arten bereitstellen:
- Durch Hochladen einer Datei direkt über den Uploader.
- Durch Angabe eines Dateinamens im Texteingabefeld und manuelles Ablegen der Datei im Ordner
var/translation. Das Verhalten dieses Feldes wird über die Speicherkonfiguration gesteuert. Diese Option ist besonders nützlich für sehr große Dateien, die nicht über den Standard-Datei-Uploader hochgeladen werden können.
- Quellsprache: Wählen Sie die Sprache des Inhalts in der hochgeladenen CSV-Datei. Die hier angezeigten Sprachen basieren auf den bereits in Ihrem Magento-Shop verfügbaren Gebietsschemata.
- Zielsprache: Definieren Sie die Zielsprache, in die der Inhalt übersetzt werden soll. Die hier angezeigten Sprachen basieren auf den bereits in Ihrem Magento-Shop verfügbaren Gebietsschemata.
- In Sprachpaket einschließen: Entscheiden Sie, ob die Übersetzung in das endgültige i18n-Sprachpaket aufgenommen werden soll.
- Sortierreihenfolge: Funktioniert in Verbindung mit dem Feld In Sprachpaket aufnehmen. Geben Sie eine Nummer für die Sortierreihenfolge ein, um die Reihenfolge festzulegen, in der die Übersetzungen in das Sprachpaket aufgenommen werden. Standardmäßig ist der Wert auf
1eingestellt. - Meldung: In diesem Feld werden alle Fehler angezeigt, die während des Übersetzungsprozesses auftreten.
Dieses Formular bietet volle Kontrolle über die Konfiguration von Übersetzungsaufträgen, während das System die Verarbeitung und Überwachung automatisch verwaltet.
Edit DeepL Translate CSV Form
Dies ermöglicht Administratoren die Verwaltung und Überwachung bestehender Übersetzungsaufträge.
- Status: Das Formular zeigt den aktuellen Status des Übersetzungsauftrags an. Mögliche Status sind In Bearbeitung, Laufend, Abgeschlossen, oder Scheitert.
- Übersetzung starten: Sie können den Übersetzungsprozess starten, indem Sie auf die Schaltfläche Übersetzung starten klicken. Dadurch wird der Auftrag in die Nachrichtenwarteschlange von Magento gestellt und der Status wird auf Laufend aktualisiert.
- Laufende Aufträge löschen: Standardmäßig können laufende Übersetzungsaufträge nicht gelöscht werden. Um das Löschen zu ermöglichen, konfigurieren Sie die Option in Speicherkonfiguration. Dies gewährleistet verlässliche Ergebnisse bei der Verwendung der Nachrichtenwarteschlange.
- Übersetzte CSV herunterladen: Sobald die Übersetzung erfolgreich abgeschlossen ist, erscheint oben eine Schaltfläche Übersetzte CSV herunterladen. Wenn Sie darauf klicken, wird eine standardmäßige Magento i18n CSV-Datei heruntergeladen, die Sie in Ihrem angepassten Theme oder angepassten Modul i18n-Ordner verwenden können.
- Übersetzungshistorie: Alle übersetzten Zeilen werden in der Historie des Systems gespeichert, sodass Sie den ursprünglichen Inhalt überprüfen und die Ergebnisse vergleichen können.
- Fehlermeldungen und Protokolle: Alle Probleme während der Übersetzung werden im Feld Meldung angezeigt, wobei detaillierte Protokolle in einer angepassten Protokolldatei gespeichert werden.
Dieses Formular bietet Administratoren volle Transparenz und Kontrolle über jeden Übersetzungsauftrag und gewährleistet gleichzeitig Zuverlässigkeit durch die Magento-Warteschlangenverarbeitung im Hintergrund.
Hinweis: Die heruntergeladenen CSV-Dateien können in den i18n-Ordner Ihres benutzerdefinierten Themes gelegt werden, z.B.,
app/design/VendorName/ThemeName/i18n oder im Ordner i18n Ihres benutzerdefinierten Moduls, z. B.,
app/code/Anbietername/Modulname/i18n.
Nachfolgend finden Sie Beispiele für das DeepL Translate CSV Form mit verschiedenen Status.
Edit Deeplate Translate CSV Form (Status: Queued)
Wenn ein Übersetzungsauftrag erstellt, aber noch nicht gestartet wurde, wird der Status auf Queued gesetzt.
- Status zeigt Queued.
- Es ist noch keine Download-Option verfügbar.
- Der Auftrag wartet in der Nachrichten-Warteschlange von Magento; der Administrator muss ihn über die Schaltfläche Übersetzung starten starten.
Edit Deeplate Translate CSV Form (Status: Completed)
Wenn der Übersetzungsauftrag erfolgreich abgeschlossen wurde, wird der Status auf Completed gesetzt.
- Status zeigt Erledigt.
- Die Schaltfläche Übersetzte CSV herunterladen ist oben verfügbar.
- Die übersetzte CSV-Datei steht in Ihrem Magento i18n-Ordner zur Verfügung.
- Der Übersetzungsverlauf wird zur Referenz gespeichert.
Sprachpakete
Die Funktion Sprachpakete wird verwendet, um Standard-Magento 2-Sprachpakete zu erzeugen. Sie fasst alle übersetzten CSV-Dateien zu einem einzigen funktionierenden Paket zusammen, das Sie in Ihrem Shop anwenden können. Der Prozess verwendet die Felder In das Sprachpaket aufnehmen und Sortierreihenfolge aus dem Übersetzungsformular, um zu bestimmen, wie das endgültige Paket erstellt wird.
Wenn ein Paket erstellt wurde, steht es direkt im Grid zum Download bereit.
Sollten bei der Erstellung Fehler auftreten, können diese in der benutzerdefinierten Protokolldatei DeeplCsvTranslate.log im Verzeichnis var/log befindet.
Sie können wählen, ob Sie ein Paket für eine einzelne Sprache oder für alle verfügbaren Sprachen auf einmal erzeugen wollen. Um die Konsistenz zu wahren und doppelte Einträge zu vermeiden, können keine neuen Prozesse gestartet werden, während ein anderes Paket noch läuft. Alle Vorgänge werden über das Magento Message Queue System abgewickelt, was Skalierbarkeit und Zuverlässigkeit auch bei großen Übersetzungsmengen gewährleistet.
Hinweis: Heruntergeladene Sprachpakete werden im Magento-Stammverzeichnis unter dem Ordner app/i18n abgelegt.
Bulk Actions Log
Das Bulk Actions Log wird von Magento standardmäßig zur Verfügung gestellt und ermöglicht es Ihnen, Protokolle von Aktionen einzusehen, die über die Message Queue laufen.
Magento 2 Bulk Actions sind Tools, die es Administratoren ermöglichen, Aufgaben für mehrere Artikel gleichzeitig innerhalb des Admin-Panels durchzuführen. Sie können diese Aktionen unter:
System → Action Logs → Bulk Actions einsehen.
Im obigen Beispiel können Sie sehen:
- Deepl CSV Translate Processing File: test.csv - zeigt an, dass die Datei
test.csvgerade über die Nachrichtenwarteschlange übersetzt wird, wobei der Bearbeitungsstatus angezeigt wird. - Deepl übersetzte CSV Verarbeitung für de_DE - zeigt an, dass die deutsche (
de_DE) Sprachpaket generiert wird und der Verarbeitungsstatus angezeigt wird.
Bewährte Praktiken
Befolgen Sie diese bewährten Praktiken, um reibungslose und zuverlässige Übersetzungsabläufe zu gewährleisten:
- Benutzen Sie die Stapelverarbeitung für große CSV-Dateien.
- Löschen Sie laufende Übersetzungsdatensätze nur, wenn es notwendig ist.
- Aktualisieren Sie Sprachpakete regelmäßig, um die neuesten Übersetzungen einzubeziehen.
- Stellen Sie sicher, dass Cron- und MQ-Worker für die Hintergrundverarbeitung richtig konfiguriert sind.
Vorteile
Die wichtigsten Vorteile der Verwendung von DeepL CSV Translator in Magento 2 sind:
- Effizientes Übersetzungsmanagement für große CSV-Dateien.
- Flexible Upload-Optionen für jede Dateigröße.
- Optimierte Leistung durch Stapelverarbeitung und MQ.
- Automatische Generierung von Magento-Sprachpaketen.
- Sicherer, skalierbarer und unternehmenstauglicher Workflow.