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
- Categoria
- Informações de idioma de todo o site
- 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:
- Se houver algum idioma, ela cria uma DIV e inicia uma lista não ordenada
- 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 - Depois, ela adiciona a bandeira do idioma
- Por fim, ela adiciona os nomes nativo e traduzido do idioma, se forem diferentes
Hooks relacionados
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