wp_set_post_tags

Устанавливает метки для поста.

Хуков нет.

Возвращает

Массив/false/WP_Error.
false, если $post_id не число или равно 0, в остальных случаях – массив ID которые были задействованы или объект WP_Error.

Использование

wp_set_post_tags( $post_id, $tags, $append );
$post_id(число) (обязательный)
ID поста. По умолчанию НЕ относиться к глобальной переменной global $post.
$tags(строка/массив)

Список элементов таксономии в виде массива или в строке через запятую.

Функция создаст новые метки, если не найдет указанные. Если указать название (в кириллице), то функция создаст метку. При этом: название будет названием, слаг слагом (обработается как обычно).

Если передается ID, или массив из ID, то убедитесь, что переменные передаются как числа, а не как строки! Потому что строки в виде числа, например, ’98’ будут интерпретироваться как название термина, а не его ID!

По умолчанию: ”

$append(логический)
Дополнить запись указанными метками или заменить их.
Если true, то текущая связь записи с метками не будет оборвана, а новые указанные метки добавятся к текущими.
Если false, то для записи установятся только указанные метки, из всех остальных запись будет удалена.
По умолчанию: false

Примеры

#1 Добавим метки для поста

Этот пример добавляет пост 42 в метки «чувства» и «жизнь»

wp_set_post_tags( 42, 'чувства,жизнь', true );

П.С. Если указанных меток не существует, то они будут созданы.

Код из


wp-includes/post.php

WP 4.7.2

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