wp_set_post_tags() │ WP 2.3.0

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

Работает на основе: wp_set_post_terms()

Хуков нет.

Возвращает

Массив|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_set_object_terms()

Список изменений

С версии 2.3.0

Введена.

Код `wp_set_post_tags() wp set post tags` ^{WP 6.5.2}

wp-includes/post.php

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