Kompatibilität des WPBakery Page Builders mit WPML aufrechterhalten

Die Kompatibilität des WPBakery Page Builders mit WPML wird durch die Sprachkonfigurationsdatei sichergestellt. Erfahren Sie, wie Sie diese Datei verwenden, um die Kompatibilität aufrechtzuerhalten.

Diese Seite richtet sich an das WPBakery-Entwicklungsteam, an Entwickler, die eine angepasste Version des Page-Builders anbieten, an Autoren, die WPBakery-Add-ons entwickeln, und an Webentwickler, die den WPBakery Page Builder verwenden.

Wenn Sie ein Kunde sind, der eine mit WPBakery erstellte Website übersetzen möchte, lesen Sie bitte unsere ausführliche Dokumentation, um mehr über das Erstellen mehrsprachiger Websites mit dem WPBakery Page Builder und WPML zu erfahren.

Wie die Integration des WPBakery Page Builders mit WPML funktioniert

Um zu verstehen, wie der WPBakery Page Builder mit WPML funktioniert, erstellen wir zunächst eine einfache Seite mit dem WPBakery Page Builder. Wir werden einige Module einbinden, wie zum Beispiel einen Text Block, eine Message Box und eine Hover Box.

Um die von uns erstellte Seite zu übersetzen, klicken Sie auf das Plus-Symbol in der Meta-Box Sprache in der rechten Seitenleiste.

Dadurch gelangen Sie zum Bildschirm Erweiterter Übersetzungs-Editor, auf dem Sie Ihre Seite übersetzen können. Geben Sie die Übersetzungen für jeden Satz ein und bestätigen Sie diese durch Klicken auf das grüne Häkchen. Wenn Sie mit all Ihren Übersetzungen zufrieden sind, klicken Sie auf Abgeschlossen.

Aktualisieren der Sprachkonfigurationsdatei

Es kann aus verschiedenen Gründen erforderlich sein, die Page-Builder-Shortcodes in der Sprachkonfigurationsdatei zu aktualisieren:

1. Hinzufügen eines neuen Shortcodes zum Page-Builder
2. Hinzufügen eines neuen Attributs zu einem vorhandenen Shortcode
3. Entfernen eines veralteten Shortcodes

Sie können die Sprachkonfigurationsdatei aus unserem Repository herunterladen. Fügen Sie die Shortcodes oder Attribute zu den vorhandenen Shortcodes in der Sprachkonfigurationsdatei hinzu.

Autoren, die eine angepasste Version des WPBakery Page Builders in ihr Theme integrieren, sollten berücksichtigen, dass sie die Sprachkonfigurationsdatei der angepassten Version des Plugins aktualisieren müssen.

Struktur der Page-Builder-Shortcodes in der Sprachkonfigurationsdatei

Um Strings aus Seiten zu extrahieren, die mit dem WPBakery Page Builder erstellt wurden, und sie auf dem Bildschirm Übersetzungs-Editor zu laden, müssen wir WPML so konfigurieren, dass es die Shortcodes und Attribute identifiziert, die die zu übersetzenden Strings enthalten. Dies geschieht durch Hinzufügen einer Datei namens wpml-config.xml, die normalerweise im Stammordner Ihres Themes abgelegt wird. Für den WPBakery Page Builder hosten wir die Sprachkonfigurationsdatei auf unseren Servern. Sie ist so eingestellt, dass sie die lokale Konfigurationsdatei im Stammordner des WPBakery Page Builders überschreibt, wodurch sichergestellt wird, dass die Konfigurationsdatei immer auf dem neuesten Stand ist.

Die Datei wpml-config.xml wird auch zur Konfiguration der folgenden Elemente verwendet:

1. Benutzerdefinierte Felder
2. Benutzerdefinierte Taxonomien
3. Admin-Texte / wp_options
4. Sprachumschalter-Konfiguration
5. Page-Builder-Shortcodes

Lesen Sie unsere ausführliche Dokumentation, um mehr über die Struktur und Syntax der Sprachkonfigurationsdatei zu erfahren.

Lassen Sie uns als Beispiel ansehen, wie wir den Tabs-Shortcode zur Datei wpml-config.xml hinzugefügt haben.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

Die Struktur des obigen Beispiels lässt sich wie folgt aufschlüsseln:

• Alle Shortcodes sind vom Haupt-Tag shortcodes (Plural) umschlossen.
• Das Tag shortcode umschließt alle Tags, die zu einem einzelnen Shortcode gehören.
• Das Tag tag definiert den Namen des Shortcodes, der in diesem Fall vc_tta_tabs lautet.
• Shortcodes können ein oder mehrere Attribute haben; daher umschließen wir sie mit dem Tag attributes (Plural) und verwenden das Tag attribute (Singular), um den Titel jedes Attributs zu definieren. In diesem Fall haben wir das Attribut title.

Bei Shortcodes, die Link-Attribute enthalten, können Sie interne Links automatisch auf die übersetzte Version dieses Beitrags verweisen lassen, indem Sie die Option „type“ für das Attribut verwenden. Hier ist ein Beispiel:

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

Testen der Sprachkonfigurationsdatei

Befolgen Sie diese Schritte, um die aktualisierte Sprachkonfigurationsdatei zu testen:

1. Richten Sie eine Installation ein, bei der sowohl der WPBakery Page Builder als auch WPML aktiviert sind. Laden Sie die Add-ons String-Übersetzung und Medienübersetzung herunter und aktivieren Sie diese.
2. Sie müssen die Remote-Sprachkonfigurationsdatei mit der aktualisierten überschreiben. Navigieren Sie dazu zur Seite WPML → Einstellungen und klicken Sie auf den Tab Benutzerdefinierte XML-Konfiguration. Kopieren Sie den Inhalt Ihrer aktualisierten Sprachkonfigurationsdatei in den Editor und klicken Sie dann auf Speichern.

3. Erstellen Sie eine neue Seite und fügen Sie ihr das/die neue(n) Modul(e) hinzu. Falls Sie einige Attribute für bestehende Module aktualisiert haben, fügen Sie diese ebenfalls zur Seite hinzu. In diesem Beispiel gehen wir davon aus, dass das Modul Call To Action neu zum WPBakery Page Builder hinzugefügt wurde. Fügen Sie es zur Seite hinzu und klicken Sie auf Veröffentlichen.

4. Klicken Sie auf das Plus-Symbol, um die Seite zu übersetzen. Dadurch gelangen Sie zum Bildschirm Erweiterter Übersetzungs-Editor.
5. Stellen Sie sicher, dass die Textelemente des Moduls im Erweiterten Übersetzungs-Editor angezeigt werden.
6. Geben Sie Ihre Übersetzungen ein und bestätigen Sie diese mit dem grünen Häkchen. Wenn Sie fertig sind, klicken Sie auf den Button Abgeschlossen.

7. Überprüfen Sie die übersetzte Seite im Frontend.

Die übersetzte Seite zeigt alle übersetzten Strings an, was bedeutet, dass die aktualisierte Sprachkonfigurationsdatei ordnungsgemäß funktioniert.

Bitte beachten Sie, dass die CSS-Stile für die Seitenelemente aus der Originalsprache in die Übersetzungssprache kopiert werden. Dies stellt sicher, dass zwischen den Sprachen alles korrekt aussieht. Wenn Sie diese Funktion deaktivieren möchten, finden Sie in diesem Artikel eine Anleitung.

Wenn Sie auf Probleme stoßen, kontaktieren Sie bitte unser Kompatibilitäts-Entwicklungsteam. Es wird Probleme im Zusammenhang mit der Sprachkonfigurationsdatei gerne überprüfen.

Sobald Sie mit den Tests fertig sind, senden Sie bitte einen Merge Request an unser Repository. Unsere Kompatibilitätsentwickler werden Ihre Anfrage erhalten und prüfen.

Bitte beachten Sie, dass die in unserem Repository gehostete Sprachkonfigurationsdatei für die Standardversion des WPBakery Page Builders vorgesehen ist. Falls Sie die Sprachkonfigurationsdatei einer angepassten Version des WPBakery Page Builders aktualisieren, wenden Sie die Änderungen auf die Konfigurationsdatei im Stammordner Ihres Plugins an.