Die Kompatibilität des Avia Layout 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 Entwicklerteam von Enfold, an Entwickler, die eine angepasste Version des Page-Builders anbieten, an Autoren, die Add-ons für den Avia Layout Builder entwickeln, sowie an Webentwickler, die Enfold verwenden.
Wie die Integration des Avia Layout Builders mit WPML funktioniert
Um zu verstehen, wie der Avia Layout Builder mit WPML funktioniert, beginnen wir mit der Erstellung einer einfachen Seite mithilfe des Avia Layout Builders. Wir werden einige Module einbinden, wie zum Beispiel einen Text Block, eine Icon Box und einen Button.
Diese Module umschließen den Inhalt in Shortcodes:
Um die von uns erstellte Seite zu übersetzen, klicken Sie auf das Plus-Symbol in der Sprachen-Meta-Box in der Seitenleiste.
Dadurch wird die Seite im Erweiterten Übersetzungs-Editor geöffnet, wo Sie Ihre Seite übersetzen können. Fügen Sie Ihre Übersetzungen hinzu und klicken Sie auf Abgeschlossen.
Wenn wir uns nun die übersetzte Seite im Frontend ansehen, können wir die übersetzten Inhalte sehen.
Aktualisieren der Sprachkonfigurationsdatei
Aus verschiedenen Gründen müssen Sie möglicherweise die Page-Builder-Shortcodes in der Sprachkonfigurationsdatei aktualisieren:
- Hinzufügen eines neuen Shortcodes zum Page-Builder
- Hinzufügen eines neuen Attributs zu einem bestehenden Shortcode
- Entfernen eines veralteten Shortcodes
Sie können die Sprachkonfigurationsdatei aus unserem Repository herunterladen. Fügen Sie die Shortcodes oder Attribute zu den bestehenden Shortcodes innerhalb der Sprachkonfigurationsdatei hinzu.
Struktur der Page-Builder-Shortcodes in der Sprachkonfigurationsdatei
Um Strings aus Seiten zu extrahieren, die mit dem Avia Layout Builder erstellt wurden, und sie auf dem Bildschirm des Übersetzungs-Editors 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 Stammverzeichnis Ihres Themes abgelegt wird. Für Enfold hosten wir die Sprachkonfigurationsdatei auf unseren Servern. Sie ist so eingestellt, dass sie die lokale Konfigurationsdatei im Stammverzeichnis von Enfold ü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:
- Benutzerdefinierte Felder
- Benutzerdefinierte Taxonomien
- Admin-Texte / wp_options
- Sprachumschalter-Konfiguration
- Page-Builder-Shortcodes
Lesen Sie unsere ausführliche Dokumentation, um mehr über die Struktur und Syntax der Sprachkonfigurationsdatei zu erfahren.
Sehen wir uns als Beispiel an, wie wir den Button-Shortcode zur Datei wpml-config.xml hinzugefügt haben:
<wp-config>
<shortcodes>
<shortcode>
<tag>av_button</tag>
<attributes>
<attribute>label</attribute>
<attribute type="link" encoding="av_link">link</attribute>
</attributes>
</shortcode>
</shortcodes>
</wp-config>
Die Struktur des obigen Beispiels lässt sich wie folgt aufschlüsseln:
- Alle Shortcodes werden vom Haupt-Tag shortcodes (Plural) umschlossen.
- Das Tag shortcode (Singular) umschließt alle Tags, die zu einem einzigen Shortcode gehören.
- Das Tag tag definiert den Namen des Shortcodes, der in diesem Fall av_button 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 die Attribute label und link.
Für Shortcodes, die Link-Attribute enthalten, können Sie interne Links automatisch auf die übersetzte Version dieses Beitrags verweisen lassen, indem Sie die Typ-Option „link“ für das Attribut verwenden, wie im vorherigen Beispiel gezeigt.
Testen der Sprachkonfigurationsdatei
Um die aktualisierte Sprachkonfigurationsdatei zu testen, führen Sie die folgenden Schritte aus:
- Richten Sie eine Installation ein, bei der sowohl Enfold als auch WPML aktiviert sind. Aktivieren Sie die Add-ons String-Übersetzung und Medienübersetzung.
- 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 auf Speichern.
- Erstellen Sie eine neue Seite und fügen Sie ihr das neue Modul (oder die neuen Module) hinzu. Wenn 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 Button neu zum Avia Layout Builder hinzugefügt wurde. Fügen Sie es zur Seite hinzu und klicken Sie auf Veröffentlichen.
- Klicken Sie auf das Plus-Symbol, um die Seite zu übersetzen. Dies bringt Sie zum Bildschirm des Erweiterten Übersetzungs-Editors.
- Stellen Sie sicher, dass der Text des Moduls im Erweiterten Übersetzungs-Editor angezeigt wird.
- Fügen Sie Ihre Übersetzungen hinzu und klicken Sie dann auf Abgeschlossen, um die Übersetzungen zu speichern und anzuwenden.
- Überprüfen Sie die übersetzte Seite im Frontend.
Die übersetzte Seite zeigt alle übersetzten Strings an, was bedeutet, dass die aktualisierte Sprachkonfigurationsdatei ordnungsgemäß funktioniert. Wenn Sie auf Probleme stoßen, kontaktieren Sie bitte unser Kompatibilitäts-Entwicklungsteam. Sie werden Probleme im Zusammenhang mit der Sprachkonfigurationsdatei gerne prüfen.
Sobald Sie mit den Tests fertig sind, reichen Sie bitte einen Merge Request in unserem Repository ein. Unsere Kompatibilitäts-Entwickler werden Ihre Anfrage erhalten und überprüfen.