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
- Versione di WPML
- 3.2
Descrizione
Verifica se il nome nativo di una lingua e il nome tradotto della stessa lingua sono diversi. In caso affermativo, li restituisce entrambi. Altrimenti, ne restituisce solo uno.
Questo filtro viene solitamente utilizzato nei selettori di lingua personalizzati.
Argomenti
- $empty_value
- (mixed) (Obbligatorio) Normalmente, questo è il valore che il filtro andrà a modificare. Dato che qui non stiamo filtrando nulla, impostalo su NULL. Questo permette alla funzione del filtro di ricevere effettivamente l’elenco completo degli argomenti
- $native_name
- (string) (Obbligatorio) Il nome nativo della lingua
- $translated_name
- (string|bool) (Obbligatorio) Il nome tradotto della lingua. Il valore predefinito è FALSE
- $lang_native_hidden
- (bool) (Opzionale) Il valore predefinito è FALSE (0|false oppure 1|true). Indica se nascondere o meno il nome nativo della lingua
- $lang_translated_hidden
- (bool) (Opzionale) Il valore predefinito è FALSE (0|false oppure 1|true). Indica se nascondere o meno il nome tradotto della lingua
Esempio di utilizzo
Esempio
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>';
}
}
La funzione di esempio qui sopra esegue le seguenti operazioni:
- Se ci sono delle lingue, crea un DIV e inizia un elenco puntato
- Quindi esegue un ciclo su ciascuna delle lingue e la aggiunge come elemento dell’elenco.
Se la lingua non è quella attiva, aggiunge un link alla pagina tradotta per quella lingua - Aggiunge poi la bandiera della lingua
- Infine, aggiunge sia il nome nativo che quello tradotto della lingua se sono diversi
Hook correlati
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
Tutti i 29 hook della categoria Informazioni sulla lingua a livello di sito →