wp_set_post_tags( int $post_id, string|array $tags = '', bool $append = false )

Associe une étiquette à un poste.

Paramètres

$post_id(int)optionnel

Id du poste. Ne prend par défaut l'id de la global $post.

$tags(string|array)optionnel

Un tableau d'étiquettes à associer au poste ou une chaîne d'étiquettes séparées par des virgules.

Valeur par défaut : ''

$append(bool)optionnel

Si true, ne supprime pas la relation des étiquettes existantes avec le poste. Si false, supprime la relation avec les étiquettes existantes et les remplace par les nouvelles.

Valeur par défaut : false

Description / Informations supplémentaires

Vous pouvez remplir le tableau $tags en mixant chaînes et ids. Le texte créera une étiquette si elle n'existe pas et l'id sera utilisé pour une étiquette existante, les deux seront assignés au poste.

Retourne

(array|false|WP_Error) Un tableau d'ids (term_taxonomy_id) des étiquettes associées. WP_Error ou false si échec.

Déclaration et structure de la fonction wp_set_post_tags()

function wp_set_post_tags( $post_id = 0, $tags = '', $append = false ) {
    return wp_set_post_terms( $post_id, $tags, 'post_tag', $append );
}
wp_set_post_terms()

Associe un terme à un poste.

Où est utilisée la fonction wp_set_post_tags() dans le CMS WordPress

Exemples

$post_id = 100;
$tags = array('Mango', 'Apple', 'Banana');
wp_set_post_tags( $post_id, $tags);
Ajouter une étiquette sans que celles qui sont déjà associées au poste ne soient supprimées :
wp_set_post_tags( 42, 'meaning,life', true );

Sources

Codex WordPress : wp_set_post_tags()

Autres fonctions dans le même fichier : wp-includes/post.php

Retour