WPML-Sprachumschalter per Konfigurationsdatei anpassen

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

Die wpml-config.xml ist eine Konfigurationsdatei, mit der Sie das Erscheinungsbild und Verhalten Ihres WPML-Sprachumschalters auf Ihrer Website anpassen können. 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 mithilfe des Plugins Multilingual Tools.

Was kann ich an meinem Sprachumschalter anpassen?

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

Inline-CSS-Stile – Fügen Sie benutzerdefiniertes CSS direkt zum Sprachumschalter hinzu
Link zu unübersetzten Inhalten – Entscheiden Sie, ob Links zu unübersetzten Inhalten angezeigt oder verborgen werden sollen
Zu kopierende URL-Parameter – Geben Sie URL-Parameter an, die beim Wechseln der Sprachen kopiert werden sollen
Sprachumschalter in der Seitenleiste / im Footer – Konfigurieren Sie das Erscheinungsbild des Sprachumschalters in der Seitenleiste und im Footer, einschließlich:
- Ob Flaggen und/oder Sprachnamen 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 – Definieren Sie das Erscheinungsbild von Sprachumschaltern, 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>

Nicht alle dieser Abschnitte müssen in Ihrer Konfigurationsdatei vorhanden sein. Nur diejenigen, die für Ihr Plugin oder Theme gelten.

WPML-Sprachumschalter auf Standardeinstellungen zurücksetzen

Sie können die wpml-config.xml auch zum Zurücksetzen der Sprachumschalter-Konfiguration verwenden, wenn diese im Backend (von ihren ursprünglichen Werten) geändert wurde.
Um neue Änderungen zu sehen, klicken Sie unbedingt auf die Schaltfläche „Standard wiederherstellen“ unten auf der Seite WPML → Sprachen.

Zusätzliche Ressourcen

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

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