Description

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.

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

Retourne

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

Structure de la fonction wp_set_post_tags()

Définie dans le fichier wp-includes/post.php à la ligne 4773 :

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

Fonction utilisée par wp_set_post_tags()

wp_set_post_terms()

Associe un terme à un poste.

Où trouver 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