Das Multilingual Tools-Plugin ist ein Test-Plugin, das Sie verwenden können, wenn Sie benutzerdefinierte Elementor-Widgets für die Übersetzung registrieren. Das Plugin enthält einen WPML – Config Generator for Elementor, der automatisch die erste Version des XML-Codes für diese benutzerdefinierten Widgets generiert.
Mit diesem Tool erhalten Sie die Informationen, die Sie benötigen, um Ihr Widget zu registrieren.
Diese Anleitung richtet sich an Entwickler, die Elementor-Themes und -Plugins erstellen und diese mit WPML kompatibel machen möchten. Wenn Sie kein Entwickler sind, lesen Sie stattdessen unsere Anleitung zum Übersetzen einer Elementor-Website mit WPML.
Erste Schritte
So legen Sie los:
- Laden Sie das Multilingual Tools-Plugin von der GitHub-Seite von OnTheGoSystems herunter.
- Stellen Sie sicher, dass Sie das Core-Plugin WPML Multilingual CMS und das Add-on WPML String-Übersetzung auf Ihrer Website installiert und aktiviert haben.
- Stellen Sie sicher, dass Sie bereits einige Inhalte mit Elementor auf Ihrer Website erstellt haben.
Warum das Multilingual Tools-Plugin verwenden
In WPML 4.9 und neuer erkennt WPML benutzerdefinierte Elementor-Widgets automatisch und macht sie übersetzbar. Es kann jedoch vorkommen, dass Strings registriert werden, die Sie nicht übersetzen möchten.
Deshalb empfehlen wir die Verwendung von Multilingual Tools, um Ihr benutzerdefiniertes Elementor-Widget für die Übersetzung zu registrieren. Dadurch erhalten Sie genaue Kontrolle darüber, welche Felder übersetzbar sind.
Wie es funktioniert
Wenn Sie eine Seite mit dem Elementor-Page-Builder erstellen, werden alle Inhalte im benutzerdefinierten Feld _elementor_data gespeichert.
Sobald Sie die benutzerdefinierten Widgets, die Sie für die Übersetzung registrieren möchten, zu einer Seite hinzufügen, greift der WPML – Config Generator for Elementor auf dieses _elementor_data-Feld zu, um dessen Inhalt zu lesen. Nach dem Lesen konvertiert er die Daten in XML-Code, der den benutzerdefinierten Widgets entspricht, die Sie auf Ihrer Seite verwendet haben.
Generieren von XML-Code mit dem WPML – Config Generator
So generieren Sie automatisch XML-Code für Ihre benutzerdefinierten Widgets:
- Erstellen Sie eine neue Seite und klicken Sie auf Mit Elementor bearbeiten.
- Fügen Sie die benutzerdefinierten Widgets, die Sie für die Übersetzung registrieren möchten, zur Seite hinzu.
Wichtig: Wenn Sie Ihr Widget hinzufügen, um es übersetzbar zu machen, stellen Sie sicher, dass Sie alle Felder ausfüllen und alle verfügbaren Optionen aktivieren.
Dies liegt daran, dass der WPML – Config Generator for Elementor keinen XML-Code für unkonfigurierte Felder oder Optionen generiert.
- Veröffentlichen Sie die Seite und kehren Sie zum WordPress-Bearbeitungsbildschirm für diese Seite zurück. Scrollen Sie nach unten zum Abschnitt mit der Bezeichnung WPML: Elementor Widgets. Sie sehen den generierten XML-Code für die Widget-Felder und Einstellungen, die noch nicht für die Übersetzung registriert sind.
Testen des automatisch generierten XML-Codes
Bevor Sie den Code Endbenutzern zur Verfügung stellen, sollten Sie ihn gründlich überprüfen und testen. Der WPML – Config Generator for Elementor ist nur ein Ausgangspunkt.
So testen Sie den automatisch generierten XML-Code:
- Kopieren Sie den XML-Code aus dem Abschnitt mit der Bezeichnung WPML: Elementor Widgets auf dem WordPress-Bearbeitungsbildschirm Ihrer Seite mit den benutzerdefinierten Widgets.
- Gehen Sie zu WPML → Einstellungen und klicken Sie auf die Registerkarte Benutzerdefinierte XML-Konfiguration.
- Fügen Sie den Code in den Editor ein und klicken Sie auf die Schaltfläche Speichern. Überprüfen Sie, ob keine Warnungen oder Validierungsfehler angezeigt werden. Stellen Sie sicher, dass Sie alle Felder entfernen, die von Benutzern nicht übersetzt oder geändert werden sollten, wie z. B. Konfigurationsfelder und Felder mit booleschen Werten. Wenn Sie diese Felder für die Übersetzung verfügbar lassen, kann dies zu Problemen und Fehlern für Endbenutzer führen.
- Gehen Sie zurück zum Bearbeitungsbildschirm der Seite mit den benutzerdefinierten Widgets. Nehmen Sie eine kleine Änderung an der Seite vor, z. B. das Bearbeiten des Seitentitels, und klicken Sie auf Aktualisieren.
- Klicken Sie in der Box Sprache auf das Plus-Symbol, um die Seite zu übersetzen. Der Erweiterte Übersetzungs-Editor öffnet sich und Sie sollten die registrierten Felder aus dem benutzerdefinierten Widget sehen, die für die Übersetzung verfügbar sind. Überprüfen Sie die automatischen Übersetzungen oder geben Sie Ihre eigenen ein und klicken Sie auf Abgeschlossen, wenn Sie fertig sind.
- Sehen Sie sich die übersetzte Seite im Frontend an, um sicherzustellen, dass die benutzerdefinierten Widget-Felder korrekt angezeigt werden.
Verwenden zusätzlicher Inspektionsfunktionen
Neben der automatischen Generierung des XML-Codes für Ihre benutzerdefinierten Elementor-Widgets bietet der WPML – Config Generator for Elementor zusätzliche Debug-Informationen.
Diese Informationen ermöglichen es Ihnen, die zugrunde liegenden Daten und deren Verwendung zu überprüfen und zu verstehen. Sie können in bestimmten Fällen nützlich sein, z. B. wenn der XML-Code nicht wie erwartet funktioniert.
WPML Config XML (generiert für alle Widgets auf der Seite)
Was es tut: Stellt den XML-Code für alle Widgets auf der Seite bereit, einschließlich derer, die bereits für die Übersetzung registriert sind.
Warum es nützlich ist: Ermöglicht es Ihnen, den XML-Code bestehender Widget-Einstellungen zu überprüfen oder zu bearbeiten.
RAW-Wert von _elementor_data (JSON)
Was es tut: Zeigt den ursprünglichen Wert des _elementor_data-Felds des Beitrags an.
Warum es nützlich ist: Lässt Sie die Daten sehen, die der WPML – Config Generator for Elementor Widgets verwendet, um den XML-Code zu generieren.
Aus _elementor_data generiertes Array
Was es tut: Stellt den Wert des _elementor_data-Felds des Beitrags bereit, konvertiert in ein Array.
Warum es nützlich ist: Sie können das Array für Debugging-Zwecke verwenden.
Extrahierte Widgets aus _elementor_data
Was es tut: Zeigt an, welche benutzerdefinierten Widgets das Plugin aus dem _elementor_data-Feld extrahieren und verwenden konnte.
Warum es nützlich ist: Wenn Sie hier kein benutzerdefiniertes Widget, kein benutzerdefiniertes Widget-Feld oder keine benutzerdefinierte Widget-Option sehen, wird es nicht zum XML hinzugefügt. Dies ist nützlich für das Debugging.