Konfigurieren Sie die WPML-Kompatibilität mit WordPress-Themes und -Plugins – Einstellungen und benutzerdefinierte wpml-config.xml

Diese Seite existiert für den Rest: weniger beliebte Themes und Plugins, sehr neue Versionen, die der Autor veröffentlicht hat, bevor die WPML-Kompatibilität nachziehen konnte, und eine kleine Anzahl allgemeiner Hilfsmittel für Websites, bei denen spezifische Symptome auftreten. Die meisten Kunden kommen nie hierher. Wenn Sie es doch tun, liegt es meistens daran, dass der WPML-Support Sie auf einen bestimmten Schalter hingewiesen hat oder auf eine wpml-config.xml, die Sie einfügen sollen.

Zwei Unterseiten der Einstellungen befassen sich mit der Kompatibilität, und diese Seite behandelt beide. Einstellungen > Kompatibilität enthält die Schalter für häufige Symptome. Unter Einstellungen > Benutzerdefinierte XML-Konfiguration schreiben Sie Ihre eigene wpml-config.xml – dies wird in der zweiten Hälfte dieser Seite beschrieben. Die Benutzeroberfläche für die häufigsten Standardeinstellungen (Übersetzungspräferenzen pro Beitragstyp, pro Taxonomie, pro Feld) befindet sich auf einer separaten Einstellungsseite, die unter Was übersetzt wird – und was nicht behandelt wird; die meisten Kunden nutzen diese Benutzeroberfläche und kommen nur hierher, wenn sie damit nicht erreichen, was sie benötigen.

Kompatibilitätsschalter

Öffnen Sie WPML > Einstellungen > Kompatibilität. Die Seite hat vier Karten. Jede Karte zielt auf eine bestimmte Art von Kompatibilitätsproblem ab.

Lokalisierungsoptionen – für Themes und Plugins, deren Übersetzungen nicht geladen werden

Wenn ein Theme oder Plugin bereits eigene UI-Übersetzungen enthält (.mo-Dateien in einem /languages/-Ordner), diese Übersetzungen aber nicht auf Ihrer Website angezeigt werden, bietet die Karte Lokalisierungsoptionen drei Schalter, die WPML helfen, diese zu finden und anzuwenden.

• Die .mo-Datei des Themes automatisch über load_textdomain laden. Zwingt WPML, load_textdomain() für die Textdomain des Themes aufzurufen. Verwenden Sie dies, wenn die Übersetzungen des Themes auf dem Datenträger liegen, aber nicht angezeigt werden.
• Textdomain eingeben. Überschreiben Sie die automatisch erkannte Textdomain. Einige Themes registrieren ihre Textdomain auf nicht standardmäßige Weise; dieses Feld ermöglicht es Ihnen, sie explizit anzugeben.
• Textdomains von Themes oder Plugins verwenden, wenn gettext-Aufrufe kein String-Literal verwenden. Ein Kompatibilitäts-Flag für Themes/Plugins, die __()-Aufrufe mit variablen Argumenten anstelle von literalen Strings verwenden. WPML kann diese nicht automatisch erkennen, und dieser Schalter hilft dabei, Übersetzungen dennoch anzuwenden.

Wenn der WPML-Support Sie hierher leitet, wird er Ihnen mitteilen, welchen Schalter Sie aktivieren und welche Textdomain Sie festlegen müssen.

Themes mehrsprachig machen

IDs für mehrsprachige Funktionalität anpassen. Eine Kompatibilitätsschicht für Themes, die einsprachige Annahmen fest codieren (z. B. ein Theme, das eine „Beitragsbild-ID“ einmal speichert und dasselbe Bild in jeder Sprache verwendet).

Die meisten modernen WPML-kompatiblen Themes benötigen dies nicht. Ältere oder weniger WPML-kompatible Themes hingegen manchmal schon. Aktivieren Sie es, wenn Sie feststellen, dass Inhaltsreferenzen (Bilder, Menüs, hervorgehobene Elemente) fälschlicherweise sprachübergreifend durchsickern.

Sprachfilterung für AJAX-Operationen

Ein Sprach-Cookie speichern, um die Sprachfilterung für AJAX zu unterstützen. Einige Plugins verwenden AJAX, um Inhalte abzurufen: gefilterte Produktlisten, AJAX-paginierte Beitragslisten, Suchergebnisse während der Eingabe. Ohne ein Sprach-Cookie weiß der AJAX-Endpunkt nicht, in welcher Sprache er antworten soll, und liefert Ergebnisse in der falschen Sprache.

Aktivieren Sie das Cookie, wenn Sie folgendes Symptom feststellen: Besucher auf der französischen Seite erhalten englische Ergebnisse aus AJAX-geladenen Abschnitten. Es ist eine Lösung mit nur einem Kontrollkästchen für eine ganze Klasse von Fehlern.

Anmelde- und Registrierungsseiten

Die Übersetzung der Anmelde- und Registrierungsseiten zulassen. Die integrierte /wp-login.php von WordPress und der Registrierungsbildschirm sind nicht Teil der regulären Inhalte, die WPML übersetzt. Sie befinden sich außerhalb der Template-Kette des Themes. Dieser Schalter fügt sie zu den übersetzbaren Seiten von WPML hinzu.

Wenn Ihre Website auf nginx läuft, erfordert der Schalter auch eine Anpassung der Serverkonfiguration. Die Seite verlinkt auf den nginx-Leitfaden von WPML mit dem genauen Konfigurationsblock.

Theme- und Plugin-Texte – Einstellungen hier, Scanner woanders

Zwei Arten der Arbeit mit Theme- und Plugin-Strings verteilen sich auf zwei Bildschirme:

• Die Einstellungen auf dieser Seite. Sie behandeln die Kompatibilität für Übersetzungen, die das Theme/Plugin bereits enthält: load_textdomain, Überschreiben der Textdomain, nicht-literales gettext.
• Der Scanner ist ein eigener Bildschirm. Wenn Sie Theme- und Plugin-Strings finden müssen, die noch nicht für die Übersetzung registriert sind, verwenden Sie den Bildschirm Admin-Texte übersetzen. Er ist über den Tab Strings unter Übersetzungen im Abschnitt „Sie sehen die gesuchten Strings nicht?“ erreichbar.

Den vollständigen Workflow zum Durchsuchen von Strings finden Sie unter Strings übersetzen.

Benutzerdefinierte wpml-config.xml

WPML-kompatible Themes und Plugins liefern eine wpml-config.xml-Datei mit, die WPML genau mitteilt, welche ihrer Felder, Beitragstypen, Taxonomien, Shortcodes und Meta-Keys übersetzbar sein sollen. WPML liest diese bei der Aktivierung. Für jedes große und beliebte Theme und Plugin bedeutet dies, dass die Übersetzung sofort einsatzbereit ist und korrekt funktioniert. Sie müssen nichts tun.

Wenn die wpml-config.xml, die mit einem Theme oder Plugin geliefert wird, für Ihre Website nicht ausreicht, schreiben Sie Ihre eigene. WPML wendet diese zusätzlich zu dem an, was das Theme oder Plugin mitliefert.

Wann Sie Ihre eigene wpml-config.xml schreiben sollten

Drei Szenarien.

• Ein Feld, das Sie übersetzen müssen, ist nicht in der mitgelieferten wpml-config.xml enthalten. Der Theme-Autor oder Plugin-Autor hat ein benutzerdefiniertes Feld nicht als übersetzbar deklariert, aber Sie müssen es auf Ihrer Website übersetzen.
• Ein Feld hat den falschen Standardwert. Die mitgelieferte wpml-config.xml markiert etwas als Kopieren und Sie möchten Übersetzen, oder umgekehrt.
• Sie entwickeln ein benutzerdefiniertes Theme oder Plugin und möchten dessen Übersetzungsverhalten auf der WPML-Einstellungsseite deklarieren, anstatt eine wpml-config.xml-Datei mit Ihrem Code zu bündeln.

In jedem Fall kann der WPML-Support Sie hierher leiten und Ihnen die genaue wpml-config.xml zum Einfügen geben. Meistens ist es eine vom Support gesteuerte Aktion, gelegentlich auch eine vom Entwickler gesteuerte.

Warum Sie die wpml-config.xml im WPML-Admin-Bereich bearbeiten sollten anstatt in der Theme-Datei

Sie könnten die eigene wpml-config.xml des Themes oder Plugins direkt bearbeiten. Aber diese Änderung geht beim nächsten Update des Themes oder Plugins verloren. Der Editor im WPML-Admin-Bereich unter WPML > Einstellungen > Benutzerdefinierte XML-Konfiguration legt Ihre wpml-config.xml über das, was das Theme oder Plugin mitliefert, und übersteht Updates. Es ist der richtige Ort für website-spezifische Anpassungen.

Der Aufbau einer wpml-config.xml

Die Seite ist ein XML-Editor. Fügen Sie einen <wpml-config>...</wpml-config>-Block ein, speichern Sie, und WPML wendet Ihre wpml-config.xml an.

Eine minimale wpml-config.xml, die einen Shortcode als übersetzbar deklariert:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

Die Elementtypen, die Sie typischerweise deklarieren würden:

• <custom-fields>. Markieren Sie ein benutzerdefiniertes Feld als translate, copy, copy-once oder nothing.
• <custom-types>. Deklarieren Sie einen benutzerdefinierten Beitragstyp als übersetzbar.
• <taxonomies>. Deklarieren Sie eine benutzerdefinierte Taxonomie als übersetzbar.
• <shortcodes>. Listen Sie Shortcodes auf, deren Inhalt WPML übersetzen soll.
• <custom-term-fields>. Für Begriff-Metadaten.

Jedes Element hat seine eigenen Attribute (z. B. action="translate" bei einem benutzerdefinierten Feld). Die vollständige Referenz zur wpml-config.xml (jedes Element, jedes Attribut, jeder zulässige Wert) finden Sie in den WPML-Entwicklerinformationen.

Ein praktischer Workflow

Wenn der WPML-Support Ihnen einen wpml-config.xml-Block zum Einfügen gibt:

1. Öffnen Sie WPML > Einstellungen > Benutzerdefinierte XML-Konfiguration.
2. Fügen Sie deren XML in den vorhandenen <wpml-config>-Block ein (oder ersetzen Sie den Inhalt, wenn Sie den vollständigen Block erhalten haben).
3. Speichern Sie.
4. WPML wendet Ihre wpml-config.xml sofort an. Wenn sie einen neuen übersetzbaren Beitragstyp oder ein neues Feld deklariert, erscheint der Eintrag sofort unter Einstellungen > Beitragstypen-Übersetzung / Übersetzung benutzerdefinierter Felder.

Wenn Sie ein benutzerdefiniertes Theme oder Plugin entwickeln und dessen WPML-Konfiguration mit dem Code ausliefern möchten, legen Sie denselben <wpml-config>-Block stattdessen in eine wpml-config.xml-Datei im Stammverzeichnis Ihres Themes oder Plugins. WPML liest diese bei der Aktivierung. Der Editor im Admin-Bereich ist für website-spezifische Anpassungen gedacht; die gebündelte Datei ist für die eigenen Standardeinstellungen des Themes/Plugins.