WPML
apply_filters( 'wpml_display_language_names', mixed $empty_value, string $native_name, string|bool $translated_name, bool $lang_native_hidden, bool $lang_translated_hidden )
Typ
filter
WPML-Version
3.2

Beschreibung

Prüft, ob der Eigenname einer Sprache und der übersetzte Name derselben Sprache unterschiedlich sind. Wenn ja, werden beide zurückgegeben. Andernfalls wird nur einer zurückgegeben.

Dieser Filter wird normalerweise in benutzerdefinierten Sprachumschaltern verwendet.

Argumente

$empty_value
(mixed) (Erforderlich) Dies ist normalerweise der Wert, den der Filter ändert. Wir filtern hier nichts, setzen Sie dies also auf NULL. Dies stellt sicher, dass die Filterfunktion tatsächlich die vollständige Argumentenliste erhält.
$native_name
(string) (Erforderlich) Der native Name der Sprache
$translated_name
(string|bool) (Erforderlich) Der übersetzte Name der Sprache. Standardmäßig FALSE.
$lang_native_hidden
(bool) (Optional) Standardmäßig FALSE. 0|false oder 1|true. Gibt an, ob der native Name der Sprache verborgen werden soll oder nicht.
$lang_translated_hidden
(bool) (Optional) Standardmäßig FALSE. 0|false oder 1|true. Gibt an, ob der übersetzte Name der Sprache verborgen werden soll oder nicht.

Anwendungsbeispiel

Beispiel
function my_footer_languages_list(){
    $languages = apply_filters( 'wpml_active_languages', NULL, 'skip_missing=0&orderby=code' );
    if( !empty( $languages ) ){
        echo '<div id="footer_language_list"><ul>';
        foreach( $languages as $l ){
            echo '<li>';
            if( $l['country_flag_url'] ){
                if( !$l['active'] ) echo '<a href="'.$l['url'].'">';
                echo '<img src="'.$l['country_flag_url'].'" height="12" alt="'.$l['language_code'].'" width="18" />';
                if( !$l['active'] ) echo '</a>';
            }
            if(!$l['active']) echo '<a href="'.$l['url'].'">';
            echo apply_filters( 'wpml_display_language_names', NULL, $l['native_name'], $l['translated_name'] );
            if( !$l['active'] ) echo '</a>';
            echo '</li>';
        }
        echo '</ul></div>';
    }
}

Die obige Beispielfunktion führt Folgendes aus:

  1. Wenn Sprachen vorhanden sind, erstellt sie ein DIV und beginnt eine ungeordnete Liste

  2. Dann durchläuft sie jede der Sprachen in einer Schleife und fügt sie als Listenelement hinzu.
    Wenn die Sprache nicht die aktive Sprache ist, fügt sie einen Link zur übersetzten Seite für diese Sprache hinzu

  3. Anschließend fügt sie die Flagge der Sprache hinzu

  4. Schließlich fügt sie sowohl den nativen als auch den übersetzten Namen der Sprache hinzu, falls diese unterschiedlich sind

wpml_decode_custom_field, wpml_footer_language_selector, wpml_add_language_form_field, wpml_ls_exclude_in_menu, wpml_is_rtl, wpml_alternate_hreflang, wpml_head_langs, wpml_must_translate_canonical_url, wpml_browser_redirect_language_params, wpml_active_languages

Alle 29 Websiteübergreifende Sprachinformationen-Hooks →