wpml_display_language_names

apply_filters( 'wpml_display_language_names', mixed $empty_value, string $native_name, string|bool $translated_name, bool $lang_native_hidden, bool $lang_translated_hidden )

Type

filter

Catégorie

Informations sur les langues à l’échelle du site

Version de WPML

3.2

Description

Vérifie si le nom natif d’une langue et le nom traduit de la même langue sont différents. Si c’est le cas, il renvoie les deux. Sinon, il n’en renvoie qu’un.

Ce filtre est généralement utilisé dans les sélecteurs de langue personnalisés.

Arguments

$empty_value

(mixed) (Requis) Il s’agit normalement de la valeur que le filtre modifiera. Nous ne filtrons rien ici, définissez donc cette valeur sur NULL. Cela permet à la fonction de filtre de recevoir la liste complète des arguments

$native_name

(string) (Requis) Le nom natif de la langue

$translated_name

(string|bool) (Requis) Le nom traduit de la langue. Par défaut sur FALSE

$lang_native_hidden

(bool) (Facultatif) La valeur par défaut est FALSE. 0|false ou 1|true. Indique s’il faut masquer le nom natif de la langue ou non

$lang_translated_hidden

(bool) (Facultatif) La valeur par défaut est FALSE. 0|false ou 1|true. Indique s’il faut masquer le nom traduit de la langue ou non

Exemple d’utilisation

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>';
    }
}

1. S’il y a des langues, elle crée un élément DIV et commence une liste non ordonnée


2. Ensuite, elle parcourt chacune des langues et l’ajoute en tant qu’élément de liste.
   Si la langue n’est pas la langue active, elle ajoute un lien vers la page traduite pour cette langue


3. Elle ajoute ensuite le drapeau de la langue


4. Enfin, elle ajoute à la fois le nom natif et le nom traduit de la langue s’ils sont différents

Hooks associés

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

Les 29 hooks de la catégorie Informations sur les langues à l’échelle du site →