WP_SET_POST_TAGS() │ WP 2.3.0

Функция wp_set_post_tags() позволяет установить теги для поста в WordPress. Это удобный инструмент для управления метками ваших записей.

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

Для использования функции нужно вызвать её следующим образом:

wp_set_post_tags( $post_id, $tags, $append );

Параметры

• $post_id (int) — ID поста. Он не будет автоматически установлен в ID текущего поста.
• $tags (string|array) — массив тегов, которые нужно установить для поста, или строка тегов, разделенных запятыми. По умолчанию пустая строка.
• $append (true|false) — если true, то существующие теги не удаляются, а добавляются новые. Если false, то старые теги заменяются новыми. По умолчанию false.

Возврат

Функция возвращает:

• массив с ID новых терминов,
• WP_Error в случае ошибки,
• или false при неудаче.

Примеры использования

Пример 1: Добавление тегов к посту

Этот пример добавляет посту с ID 42 теги "чувства" и "жизнь", при этом существующие теги остаются:

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

Пример 2: Установка массива тегов для поста с ID 100

В этом примере текущие теги поста будут заме��ены на новые.

$post_id = 100;
$tags = [ 'Манго', 'Яблоко', 'Банан' ];

wp_set_post_tags( $post_id, $tags );

Заметки

• Функция использует wp_set_post_terms(), которая позволяет устанавливать термины для постов.

Изменения

• С версии 2.3.0 функция была введена в WordPress.

Связанные функции

Вот некоторые функции, которые могут быть полезны при работе с тегами и постами в WordPress:

• get_object_taxonomies()
• get_the_tags()
• has_tag()
• the_tags()
• wp_delete_object_term_relationships()

Эти функции помогут вам управлять тегами и категориями, а также получать информацию о терминах, связанных с постами.