WPML-Sprachumschalter per Konfigurationsdatei anpassen

WPML ermöglicht es Ihnen, den Sprachumschalter an Ihre spezifischen Bedürfnisse anzupassen, indem Sie die Einstellungen in der Datei wpml-config.xml konfigurieren.

Die wpml-config.xml ist eine Konfigurationsdatei, mit der Sie anpassen können, wie Ihr WPML-Sprachumschalter auf Ihrer Website angezeigt wird und sich verhält. Sie können eine Reihe von Attributen konfigurieren, wie z. B. CSS-Styling, Anzeigeeinstellungen und Shortcodes.

Dieser Leitfaden richtet sich an Entwickler, die den integrierten WPML-Sprachumschalter anpassen möchten. Wenn Sie einen eigenen erstellen möchten, lesen Sie unsere Seite über das Erstellen eines benutzerdefinierten Sprachumschalters.

Müssen Sie eine wpml-config.xml-Datei generieren? Besuchen Sie unsere Schritt-für-Schritt-Anleitung zum automatischen Generieren einer Konfigurationsdatei mit dem Plugin Multilingual Tools.

Was kann ich an meinem Sprachumschalter anpassen?

WPML ermöglicht es Ihnen, eine Reihe von Variablen in Ihrem Sprachumschalter anzupassen. Dazu gehört Folgendes:

Inline-CSS-Stile – benutzerdefiniertes CSS direkt zum Sprachumschalter hinzufügen
Link zu unübersetzten Inhalten – entscheiden, ob Links zu unübersetzten Inhalten angezeigt oder verborgen werden sollen
Zu kopierende URL-Parameter – URL-Parameter angeben, die beim Wechseln der Sprache kopiert werden sollen
Sprachumschalter in der Seitenleiste / im Footer – das Erscheinungsbild des Sprachumschalters in der Seitenleiste und im Footer konfigurieren, einschließlich:
- ob Flaggen und/oder Sprachennamen angezeigt werden sollen
- ob die aktuelle Sprache als Link angezeigt werden soll
- Festlegen eines Titels für das Sprachumschalter-Widget
- Auswählen eines Templates für das Layout des Umschalters
- Anpassen der Farben für Text, Hintergrund und Rahmen mithilfe von Hex-Farbcodes

Shortcode-Aktionen – das Erscheinungsbild von Sprachumschaltern definieren, die über Shortcodes hinzugefügt wurden

Beispiel für das Hinzufügen einer benutzerdefinierten Konfiguration für den integrierten WPML-Sprachumschalter

<wpml-config>
  <language-switcher-settings>
    <key name="additional_css">{inline CSS styles}</key>
    <key name="link_empty">{0 or 1}</key>
    <key name="copy_parameters">{parameter1, parameter2}</key>
    <key name="sidebars">
        <key name="{sidebar slug}">
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="widget_title">{widget title}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
    </key>
    <key name="statics">
        <key name="footer">
            <key name="show">{0 or 1}</key>
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
        <key name="post_translations">
            <key name="show">{0 or 1}</key>
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="display_before_content">{0 or 1}</key>
            <key name="display_after_content">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <key name="availability_text">{string like "See post translations: %s"}</key>
        </key>
        <key name="shortcode_actions">
            <key name="display_flags">{0 or 1}</key>
            <key name="display_names_in_current_lang">{0 or 1}</key>
            <key name="display_names_in_native_lang">{0 or 1}</key>
            <key name="display_link_for_current_lang">{0 or 1}</key>
            <key name="template">{template slug}</key>
            <!-- color picker keys -->
            <key name="background_normal">#{hex color}</key>
            <key name="border_normal">#{hex color}</key>
            <key name="font_current_normal">#{hex color}</key>
            <key name="font_current_hover">#{hex color}</key>
            <key name="background_current_normal">#{hex color}</key>
            <key name="background_current_hover">#{hex color}</key>
            <key name="font_other_normal">#{hex color}</key>
            <key name="font_other_hover">#{hex color}</key>
            <key name="background_other_normal">#{hex color}</key>
            <key name="background_other_hover">#{hex color}</key>
        </key>
    </key>
  </language-switcher-settings>
</wpml-config>

Es müssen nicht alle dieser Abschnitte in Ihrer Konfigurationsdatei vorhanden sein. Nur diejenigen, die für Ihr Plugin oder Theme relevant sind.

WPML-Sprachumschalter auf Standardeinstellungen zurücksetzen

Sie können die wpml-config.xml auch verwenden, um die Konfiguration des Sprachumschalters zurückzusetzen, falls diese im Backend (von ihren ursprünglichen Werten) geändert wurde.
Um neue Änderungen zu sehen, stellen Sie sicher, dass Sie auf den Button „Standard wiederherstellen“ unten auf der Seite WPML → Einstellungen → Sprachumschalter klicken.

Zusätzliche Ressourcen

Um mehr über die Datei wpml-config.xml zu erfahren, besuchen Sie den Leitfaden zu Sprachkonfigurationsdateien.

Zur Anpassung weiterer Elemente mithilfe der Datei wpml-config.xml besuchen Sie unsere zusätzlichen Leitfäden: