WPML

wpml_element_link

Ottieni l'URL per un tipo di post o un termine della tassonomia per la lingua attuale

apply_filters( 'wpml_element_link', int $element_id, string $element_type, string $link_text, array $optional_parameters, string $anchor, bool $echo, bool $return_original_if_missing )
Tipo
filter
Categoria
Recupero dei contenuti localizzati
Versione di WPML
3.2

Descrizione

Restituisce il link di un tipo di articolo o di un termine di tassonomia nella lingua corrente.

* Nota: ci sono modi alternativi per recuperare il link di un elemento, che offrono agli sviluppatori un maggiore controllo sull’output HTML.

WordPress offre diverse funzioni per farlo, come get_permalink(), get_term_link(), ecc.

Se prevedi di utilizzare funzioni che richiedono un tipo di articolo o un ID del termine come parametro, potrebbe interessarti il filtro wpml_object_id.

Argomenti

$element_id
(int) (Obbligatorio) L’ID del tipo di post (articolo, pagina, allegato, tipo di post personalizzato) o del termine della tassonomia (tag, categoria, tassonomia personalizzata) a cui collegarsi
$element_type
(string) (Opzionale) Il tipo di elemento a cui collegarsi. Può essere ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’, '{custom taxonomy}'. Il valore predefinito è ‘post’
$link_text
(string) (Opzionale) Il testo del link. Il valore predefinito è il nome dell’elemento
$optional_parameters
(array) (Opzionale) Argomenti per il link
$anchor
(string) (Opzionale) Ancora per il link
$echo
(bool) (Opzionale) 0|false per restituire o 1|true per stampare il link localizzato. Il valore predefinito è true
$return_original_if_missing
(bool) (Opzionale) Se impostato su true restituirà sempre un valore (il valore originale, se manca la traduzione). Il valore predefinito è TRUE

Esempio di utilizzo

Esempi 
//produces: <a href="/hello-world/">Hello World!</a>
apply_filters( 'wpml_element_link', 1 );

//produces: <a href="/sample-page/">Custom link text for the sample page</a>
apply_filters( 'wpml_element_link', 2, 'page', __( 'Custom link text for the sample page' ) );

//produces: <a href="/sample-page/?category=foo&bar=baz">Sample Page</a>
apply_filters( 'wpml_element_link', 2, 'page', '', array( 'category'=>'foo', 'bar'=>'baz' ) );

//produces: <a href="/sample-page/#contact">Sample Page</a>
apply_filters( 'wpml_element_link', 2, 'page', '', '', 'contact' );

//produces: <a href="/category/uncategorized/">Uncategorized</a>
apply_filters( 'wpml_element_link', 1, 'category' );

//produces: <a href="/it/?attachment_id=25">'Attachment image title</a>
apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );

Hook correlati

wpml_media_url, wpml_media_id, force_suppress_filters, wpml_get_translated_slug, wpml_home_url, wpml_translate_single_string, wpml_translate_string, wpml_elements_without_translations, wpml_permalink, wpml_unfiltered_admin_string

Tutti i 12 hook della categoria Recupero dei contenuti localizzati →