WPML

wpml_element_link

Obtenir l’URL d’un type de publication ou d’un terme de taxonomie pour la langue actuelle

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 )
Type
filter
Catégorie
Récupération du contenu localisé
Version de WPML
3.2

Description

Renvoie un lien de type de publication ou un lien de terme de taxonomie dans la langue actuelle.

* Remarque : Il existe d’autres moyens de récupérer le lien d’un élément qui donnent aux développeurs un plus grand contrôle sur la sortie HTML.

WordPress propose plusieurs fonctions pour ce faire, telles que get_permalink(), get_term_link(), etc.

Si vous prévoyez d’utiliser des fonctions qui nécessitent un type de publication ou un ID de terme comme paramètre, le filtre wpml_object_id pourrait vous intéresser.

Arguments

$element_id
(int) (Requis) L’ID du type de publication (article, page, fichier joint, type de publication personnalisé) ou du terme de taxonomie (étiquette, catégorie, taxonomie personnalisée) vers lequel créer un lien
$element_type
(string) (Facultatif) Le type d’élément vers lequel créer un lien. Peut être ‘post’, ‘page’, ‘attachment’, '{custom post}', ‘tag’, ‘category’, '{custom taxonomy}'. La valeur par défaut est ‘post’
$link_text
(string) (Facultatif) Le texte du lien. La valeur par défaut est le nom de l’élément
$optional_parameters
(array) (Facultatif) Les arguments pour le lien
$anchor
(string) (Facultatif) L’ancre pour le lien
$echo
(bool) (Facultatif) 0|false pour renvoyer ou 1|true pour afficher le lien localisé. La valeur par défaut est true
$return_original_if_missing
(bool) (Facultatif) Si défini sur true, il renverra toujours une valeur (la valeur d’origine, si la traduction est manquante). La valeur par défaut est TRUE

Exemple d’utilisation

Exemples 
//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="/fr/?attachment_id=25">'Attachment image title</a>
apply_filters( 'wpml_element_link', 25, 'attachment', __( 'Attachment image title' ) );

Hooks associés

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

Les 12 hooks de la catégorie Récupération du contenu localisé →