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 )
Tipo
filter
Versão do WPML
3.2

Descrição

Verifica se o nome nativo de um idioma e o nome traduzido do mesmo idioma são diferentes. Se sim, retorna ambos. Caso contrário, retorna apenas um.

Este filtro é geralmente usado em seletores de idiomas personalizados.

Argumentos

$empty_value
(mixed) (Obrigatório) Este normalmente é o valor que o filtro irá modificar. Não estamos filtrando nada aqui, então defina isso como NULL. Isso serve para que a função de filtro realmente receba a lista completa de argumentos
$native_name
(string) (Obrigatório) O nome nativo do idioma
$translated_name
(string|bool) (Obrigatório) O nome traduzido do idioma. O padrão é FALSE
$lang_native_hidden
(bool) (Opcional) O padrão é FALSE 0|false ou 1|true Se deve ocultar o nome nativo do idioma ou não
$lang_translated_hidden
(bool) (Opcional) O padrão é FALSE 0|false ou 1|true Se deve ocultar o nome traduzido do idioma ou não

Exemplo de uso

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

A função de exemplo acima faz o seguinte:

  1. Se houver algum idioma, ela cria uma DIV e inicia uma lista não ordenada

  2. Em seguida, ela percorre cada um dos idiomas e o adiciona como um item de lista.
    Se o idioma não for o idioma ativo, ela adiciona um link para a página traduzida para esse idioma

  3. Depois, ela adiciona a bandeira do idioma

  4. Por fim, ela adiciona os nomes nativo e traduzido do idioma, se forem diferentes

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

Todos os 29 hooks de Informações de idioma de todo o site →