WPML kann eine Konfigurationsdatei lesen, die ihm mitteilt, was in Themes und Plugins übersetzt werden muss. Die Datei heißt wpml-config.xml und wird im Stammordner des Plugins oder Themes abgelegt.
Der Zweck der Sprachkonfigurationsdatei
Um Kompatibilität mit WPML zu erreichen, sollten Sie auch eine Konfigurationsdatei erstellen, die Ihnen dabei hilft, die Kompatibilität in Ihren zukünftigen Versionen aufrechtzuerhalten. WPML kann alles auf Ihrer WordPress-Website übersetzen, aber Sie müssen ihm mitteilen, was übersetzt werden muss. Diese Datei übernimmt das.
Gehen Sie zur Seite WPML → Einstellungen.
Diese Seite teilt WPML alles mit, was es wissen muss, einschließlich, welche benutzerdefinierten Felder übersetzt oder synchronisiert werden sollen, welche benutzerdefinierten Beitragstypen und Taxonomien mehrsprachig sein sollen und sogar, welche Admin-Texte übersetzt werden sollen.
Die Sprachkonfigurationsdatei enthält diese Informationen, damit nicht jeder einzelne Benutzer sie manuell auf der Admin-Seite eingeben muss.
Für einige der Themes und Plugins hosten wir die Sprachkonfigurationsdateien auf unseren Servern. Sie können hier eine Liste sehen. Sie ist so eingestellt, dass sie die lokale Sprachkonfigurationsdatei überschreibt, die sich im Stammordner des Themes oder Plugins befindet.
WPML ermöglicht es Ihnen auch, alle Einstellungen, die durch Sprachkonfigurationsdateien von Themes und Plugins geladen werden, manuell zu überschreiben. Dies gilt sowohl für Sprachkonfigurationsdateien im Stammordner des Themes oder Plugins als auch für die Sprachkonfigurationsdateien, die auf unseren Servern gehostet werden.
Übersetzungsoptionen für Themes und Plugins von Drittanbietern festlegen
WPML ist mit vielen beliebten Themes und Plugins kompatibel, und für diese müssen Sie keine Sprachkonfigurationsdatei erstellen.
Wenn Sie jedoch ein Theme oder Plugin verwenden, dessen Inhalte im Erweiterten Übersetzungs-Editor von WPML nicht korrekt angezeigt werden, müssen Sie deren Übersetzungsoptionen möglicherweise manuell konfigurieren.
Um Übersetzungsoptionen für Themes und Plugins von Drittanbietern zu konfigurieren, gehen Sie zu WPML → Einstellungen und klicken Sie auf den Tab Benutzerdefinierte XML-Konfiguration. Verwenden Sie den Texteditor auf dieser Seite, um den Code genau so einzugeben, als ob Sie eine wpml-config.xml-Datei erstellen würden.
Die Datei wpml-config.xml automatisch generieren
Wenn Sie mit dem Erstellen von XML-Dateien nicht vertraut sind, hat unser Team das Multilingual Tools-Plugin entwickelt, das diese Aufgabe erleichtert. Obwohl es ursprünglich als Werkzeug konzipiert wurde, um Theme- und Plugin-Autoren dabei zu helfen, ihre Produkte Multilingual Ready (mehrsprachig einsatzbereit) zu machen, kann es problemlos verwendet werden, um Ihre eigene wpml-config.xml-Datei zu generieren.
Um mehr über das Generieren Ihrer wpml-config.xml-Datei zu erfahren, besuchen Sie die Seite des Multilingual Tools-Plugins. Schauen Sie sich insbesondere den Abschnitt Wie generiere ich Sprachkonfigurationsdateien mit Multilingual Tools? an.
Sobald Sie die Konfigurationsdatei haben, fügen Sie sie dem Stammordner Ihres Themes hinzu. Wenn Sie bereits eine haben, überschreiben Sie diese nicht. Bearbeiten Sie stattdessen Ihre ursprüngliche XML-Datei und fügen Sie den mit dem Multilingual Tools-Plugin generierten Code hinzu.
Bitte beachten Sie, dass dieses Plugin nicht für den Einsatz auf Live-Websites vorgesehen ist.
Um dieses Tutorial zu lesen und Sprachkonfigurationsdateien für Ihre Themes und Plugins zu erstellen, können Sie mit diesem Beispiel beginnen – wpml-config.zip.
Sie müssen sie bearbeiten, aber Sie können die Abschnitte und die Struktur dieser Datei verwenden.
Struktur und Syntax
WPML ermöglicht es Ihnen, eine Reihe von Elementen mithilfe der Datei wpml-config.xml zu konfigurieren. Verwenden Sie die folgenden Leitfäden, um zusätzliche Informationen und Anweisungen zu finden, wie Sie bestimmte Website-Elemente übersetzbar machen:
- Benutzerdefinierte Shortcodes mit WPML übersetzen
- Page Builder-Inhalte für die Übersetzung registrieren
- Benutzerdefinierte Page Builder-Widgets für die Übersetzung registrieren
- Übersetzungsoptionen für benutzerdefinierte Felder mithilfe der WPML-Konfigurationsdatei festlegen
- Benutzerdefinierte Begriffe, Typen und Taxonomien als übersetzbar registrieren
- Benutzerdefinierte Gutenberg-Blöcke übersetzbar machen
- Texte übersetzen, die Themes und Plugins in wp_options speichern
- WPML-Sprachumschalter mithilfe der WPML-Konfigurationsdatei anpassen
- Numerische Werte für die Übersetzung aktivieren
Die WPML-Sprachkonfigurationsdatei mit Child-Themes verwenden
Wenn Sie ein Child-Theme verwenden, überschreibt die Sprachkonfigurationsdatei des Parent-Themes die des Child-Themes. WPML bietet eine Konfigurationsseite, die es Ihnen ermöglicht, dies problemlos mit beliebigen benutzerdefinierten Einstellungen zu überschreiben.
Betrachten wir ein Beispiel, in dem die Sprachkonfigurationsdatei des Parent-Themes den benutzerdefinierten Beitragstyp „Property“ als übersetzbar festlegt.
Wenn Sie ein Child-Theme verwenden und den benutzerdefinierten Beitragstyp „Property“ als nicht übersetzbar festlegen möchten, navigieren Sie zur Seite WPML → Einstellungen und klicken Sie auf den Tab Benutzerdefinierte XML-Konfiguration. Verwenden Sie den Editor, um den benutzerdefinierten Beitragstyp „Property“ als nicht übersetzbar festzulegen. Setzen Sie einfach den Wert des translate-Attributs auf 0 anstatt auf 1.
Die Einstellungen im Tab Benutzerdefinierte XML-Konfiguration haben Vorrang vor den Einstellungen in der Sprachkonfigurationsdatei des Parent-Themes.
