Einführung
WEB-T Magento ist ein JavaScript-Plug-in für die Übersetzung von Website-Inhalten. Es besteht aus zwei Teilen: einem clientseitigen Plug-in, das in Ihre Magenta-Website eingebettet ist, und einem serverseitigen Translation Hub, der Übersetzungs-Caching und Post-Editing bietet.
Wie es funktioniert
Das Plug-in übersetzt den aktuell gerenderten Webseiteninhalt in die ausgewählte Sprache. Alle Übersetzungen werden in einer Datenbank gespeichert, sodass Sie sie über den Übersetzungseditor in Translation Hub bearbeiten können.
Translation Hub einrichten:
- Kubernetes-Umgebung einrichten und vorbereiten.
- Bereitstellungs-HELM herunterladen und Werte konfigurieren.
- Bereitstellen.
- Nach außen zur Verfügung stellen.
Eine ausführlichere Beschreibung der Bereitstellung des Translation Hub finden Sie in der Dokumentation des Universal-Plug-ins. |
Autorisierungsinformationen von eTranslation oder WEB-T-kompatiblen Übersetzungsanbietern beziehen:
- Erhalten Sie MT-Anbieter-Zugang.
- Verwenden Sie diese Anmeldeinformationen im Translation Hub.
Eine Integration erstellen und das Plug-in auf Ihrer Website installieren:
- Erstellen Sie eine Website Translator-Integration im Translation Hub.
- Installieren Sie das Plug-in auf Ihrer Website.
Ihre Website übersetzen und die automatisierten Übersetzungen verbessern:
- Übersetzen Sie Ihre Website, indem Sie alle Seiten durchgehen und jede Zielsprache aus dem Menü auswählen.
- Verwenden Sie den Übersetzungseditor, um übersetzte Texte zu verbessern. Die Korrekturen werden sofort auf Ihrer Website angezeigt.
- Wenn neue Inhalte in der Originalsprache hinzugefügt werden, übersetzen Sie die bearbeitete Seite erneut, indem Sie jede Zielsprache aus dem Menü auswählen.
Das erste Mal, wenn der Inhalt einer Seite geladen wird, wird die Übersetzung einige Zeit dauern. Die Übersetzungen werden in einer Datenbank gespeichert und beim nächsten Mal schneller geladen.
Bitte beachten Sie: Websites, die das WEB-T-Plug-in mit aktivierter eTranslation-Integration verwenden, müssen online über den eTranslation-Dienst veröffentlicht und zugänglich gemacht werden. Andernfalls funktioniert die Übersetzung mit eTranslation nicht. |
Plug-in installieren
Dieser Abschnitt zeigt mehrere Möglichkeiten zum Herunterladen und Installieren des WEB-T-Plug-ins in Ihrer Magento-Website. Sie können wählen, welche am besten zu Ihnen passt.
WEB-T-Plug-in herunterladen
Um das Plug-in zu installieren, müssen Sie es zuerst herunterladen. Sie können die WEB-T-Erweiterung von der WEB-T-Website, dem Adobe Commerce Marketplace oder durch Klonen des WEB-T-Code-Repositorys und manuelles Erstellen des Plug-ins herunterladen.
Von der WEB-T-Webseite herunterladen
Die einfachste Möglichkeit, die ZIP-Datei dieses Plug-ins herunterzuladen, besteht darin, die WEB-T-Website zu besuchen und auf „Magento-Plug-in herunterladen“ zu klicken: https://website-translation.language-tools.ec.europa.eu/solutions/web-t-magento_en
Nachdem Sie die ZIP-Datei heruntergeladen haben, extrahieren Sie sie und kopieren den Ordner europeancommission in [Magento-Stammverzeichnis]/app/code. Folgen Sie dann den Installationsanweisungen.
Von Adobe Commerce Marketplace herunterladen
WEB-T kann von Adobe Commerce Marketplace heruntergeladen werden, indem Sie diesen Link aufrufen: https://commercemarketplace.adobe.com/europeancommission-webt.html
So laden Sie WEB-T herunter:
- Wählen Sie die Store-Version aus und klicken Sie auf Add to cart:
- Öffnen Sie den Einkaufswagen und klicken Sie auf Proceed to checkout.
- Sie werden aufgefordert, sich mit dem Adobe Commerce-Konto anzumelden. Falls Sie keines haben, können Sie in diesem Schritt (kostenlos) eines erstellen.
- Nachdem Sie sich angemeldet haben, bestätigen Sie die Bestellung, indem Sie auf Place Order klicken.
- Jetzt haben Sie WEB-T auf Ihrer Produktseite aufgelistet. Klicken Sie auf Installieren, und folgen Sie den Anweisungen, um dieses Plug-in über Composer Ihrer Website hinzuzufügen. Diese Anweisungen erfordern Folgendes:
- Erstellen Sie einen Adobe Commerce-Zugangsschlüssel (kostenlos).
- Konfigurieren Sie die auth.json-Datei mit Ihrem Zugangsschlüssel, damit Composer dieses Plug-in von Adobe Commerce herunterladen kann.
- Fügen Sie WEB-T mit Composer Ihrer Website hinzu.
Folgen Sie den Installationsanweisungen unten, um das WEB-T-Plug-in zu aktivieren.
Aus dem Code-Repository herunterladen
So laden Sie das Plug-in manuell herunter und erstellen es (aus dem Code-Repository):
- Plug-in-Repository klonen: https://code.europa.eu/web-t/web-t-magento-hybrid
- Bevor Sie den Plug-in-Code erstellen, müssen Sie die Voraussetzungen – Node.js und npm – installieren. Beachten Sie die offizielle Dokumentation: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm
- Führen Sie im Plug-in-Stammverzeichnis „npm install“ aus.
- Alternativ können Sie das neueste Website-Translator-Modul herunterladen unter: https://www.npmjs.com/package/@tilde-nlp/website-translator und die Datei @tilde-nlp/website-translator/dist/widget.js in das Verzeichnis europeancommission/webt/view/frontend/web/js/ kopieren.
- (Optional) Fügen Sie der CSP-Whitelist die Translation-Hub-URL hinzu, wenn dies gemäß der Inhaltssicherheitsrichtlinie nicht zulässig ist:
- Ändern Sie „localhost“ in Ihre nutzerdefinierte URL in europeancommission/webt/etc/csp_whitelist.xml
- Kopieren Sie den Ordner europeancommission in [Magento-Stammverzeichnis]/app/code/
- Folgen Sie den Installationsanweisungen unten, um das WEB-T-Plug-in zu aktivieren.
WEB-T-Plug-in installieren
- Translation Hub einrichten (siehe: https://website-translation.language-tools.ec.europa.eu/instruction-information-about-universal-plugin_en#translation-hub-setup).
- SSH in Magento-Instanz und ausführen:
- workdir ändern in [Magento-Stammverzeichnis]
- Modul europeancommission_webt aktivieren: php bin/magento module:enable europeancommission_webt
- DB aktualisieren: php bin/magento setup:upgrade
- Cache bereinigen: php bin/magento cache:clean
- Klassen generieren: php bin/magento setup:di:compile
- (Optional) Berechtigungen für den Ordner [Magento-Stammverzeichnis]/var beheben, wenn sie sich nach Ausführung eines der vorherigen Befehle geändert haben.
- z. B. für Apache: chown -R daemon:root [Magento-Stammverzeichnis]/var/
- Magento-Instanz neu starten.
Überblick
Eine ausführlichere Beschreibung zum Erstellen von Integrationen und zum Verwalten von Übersetzungen finden Sie in der Dokumentation zum Translation Hub des Universal-Plug-ins. |
Öffnen Sie nach dem Einrichten des Translation Hub den Browser, und navigieren Sie zu der URL, in der er sich befindet.
Im Translation Hub finden Sie:
- Übersetzungsanbieter – Zum Festlegen der Autorisierungsinformationen des Übersetzungsanbieters (eTranslation API-Anmeldeinformationen oder Basis-URL und API-Schlüssel).
- Meine Integrationen – Zum Erstellen und Verwalten Ihrer Website-Integrationen. Sobald Sie eine Integration erstellt haben, erscheint diese in der Liste „Meine Integrationen“.
- Übersetzungseditor – Zum Verwalten und Bearbeiten von Übersetzungen (für jede Integration separat).
- Einstellungen – Zum Bearbeiten von Sprachen, Engines maschineller Übersetzung und Domain-Zugriff (für jede Integration separat). Diese Seite enthält auch den generierten JavaScript-Integrationscode.
Sie können den Übersetzungsanbieter konfigurieren und neue Website-Integrationen im Translation Hub erstellen.
Im Magento-Dashboard finden Sie unter Stores > Konfiguration > WEB-T-Einstellungen Folgendes:
- Verbindung mit Translation Hub – Zum Festlegen Ihrer Translation Hub-URL und Client-ID.
- Allgemeine Einstellungen – Zum Ändern der Sichtbarkeit des MT-Hinweises und zum Ausschluss von Pfaden von der Übersetzung.
Eine Integration einrichten
Before you continue:
You have deployed and configured the Translation Hub.
You must have an eTranslation or WEB-T compatible translation provider account.
You have obtained the eTranslation API credentials or Base URL & API key from your translation provider.
Übersetzungsanbieter konfigurieren
So konfigurieren Sie den MT-Anbieter im Translation Hub:
- Öffnen Sie auf im Translation Hub Übersetzungsanbieter.
- Wählen Sie MT-Anbieter (eTranslation oder Nutzerdefiniert).
- Geben Sie die erforderlichen Daten ein (eTranslation-API-Anmeldeinformationen oder Basis-URL und API-Schlüssel).
- Klicken Sie auf Speichern.
Neue Integration erstellen
So erstellen Sie eine neue Website-Integration:
- Öffnen Sie im Translation Hub Meine Integrationen.
- Klicken Sie auf +Website Translator einrichten.
- Wählen Sie Allgemeine Einrichtung.
- Füllen Sie das Formular aus:
- Geben Sie Ihrer Integration einen Namen.
- Fügen Sie die URL Ihrer Website-Domäne hinzu. (https://example.com, https://www.example.com und https://sub.example.com sollten separat hinzugefügt werden, indem Sie auf Eine weitere Domain hinzufügen klicken.)
- Wählen Sie die Originalsprache Ihrer Website aus.
- Wählen Sie die Sprachen aus, in die Ihre Website übersetzt werden soll.
- Wählen Sie in der generierten Tabelle für jede Sprache eine MT-Engine aus.
- Klicken Sie auf Speichern.
Plug-in konfigurieren
So konfigurieren Sie das Plug-in:
- Öffnen Sie das Magento-Administrator-Dashboard.
- Öffnen Sie Stores > Konfiguration.
- Unter Allgemein-Einstellungen finden Sie WEB-T-Einstellungen.
- Geben Sie die im Translation Hub generierte Translation-Hub-URL und Client-ID ein.
- Klicken Sie auf Konfiguration speichern.
- Öffnen Sie eine Frontend-Seite; das WEB-T-Widget sollte oben auf jeder Seite sichtbar sein. Ändern Sie die Sprache, um zu sehen, ob die Übersetzung funktioniert.
Suchen Sie die Translation-Hub-URL und die Client-ID im Translation Hub in den Integrationseinstellungen unter Setup des Hybrid-Plug-ins.
MT-Hinweis ausblenden
So blenden Sie die Hinweisleiste für maschinelle Übersetzung aus, die oben auf jeder übersetzten Seite angezeigt wird:
- Öffnen Sie das Magento-Administrator-Dashboard.
- Öffnen Sie Stores > Konfiguration.
- Unter Allgemein-Einstellungen finden Sie WEB-T-Einstellungen.
- Legen Sie im Abschnitt Allgemeine Einstellungen den Wert für MT-Hinweis anzeigen auf Nein fest.
- Klicken Sie auf Konfiguration speichern.
Bestimmte Pfade von der Übersetzung ausschließen
Wenn Sie aus irgendeinem Grund bestimmte Seiten auf Ihrer Website nicht übersetzen möchten, können Sie deren URL über die Einstellungen des Plug-ins ausschließen.
So schließen Sie Pfade von der Übersetzung aus:
- Öffnen Sie das Magento-Administrator-Dashboard.
- Öffnen Sie Stores > Konfiguration.
- Unter Allgemein-Einstellungen finden Sie WEB-T-Einstellungen.
- Suchen Sie im Abschnitt Allgemeine Einstellungen nach Pfade aus der Übersetzung ausschließen.
- Geben Sie den Pfad zu jeder Seite, die Sie ausschließlich möchten, in einer eigenen Zeile ein. Wildcard (*) am Ende des Pfads wird ebenfalls unterstützt. Sie können entweder vollständige Pfade oder relative Pfade verwenden (z. B. „http://example.com/some/path“ oder „/some/path“ oder „/some/*“).
- Klicken Sie auf Konfiguration speichern.
Inhalt übersetzen
Die Übersetzungen werden im TranslationHub im Übersetzungseditor angezeigt, wo Sie sie bearbeiten können.
So übersetzen Sie Inhalte:
- Öffnen Sie die Seite, die Sie übersetzen möchten.
- Wählen Sie die Sprache aus dem Sprachwechsler des Widgets aus.
- Warten Sie, bis der Inhalt übersetzt wurde.
- Öffnen Sie jedes Formular, jedes Dropdown-Menü und jeden dynamischen Inhalt, um sie zu übersetzen und die Übersetzungsqualität zu bewerten.
- Wiederholen Sie diese Schritte für jede Sprache.