wp_set_object_terms() — привязывает указанный пост к указанным элементам таксономий

2.3.0 wp-includes / taxonomy.php / Кодекс WordPress

Функция позволяет добавить пост в любую указанную рубрику и присвоить ему нужные метки. Также работает с произвольными типами постов и таксономиями.

wp_set_object_terms( $object_id, $terms, $taxonomy, $append = false )

$object_id
(целое) (обязательное) — ID поста.

$terms
(массив|целое|строка) (обязательное) — ID или ярлык элемента таксономии, к которому нужно привязать пост. Можно передавать несколько значений в виде массива. Если указать NULL или пустую строку, то пост будет удален из всех категорий.

Если в качестве значений параметра указан ярлык или массив ярлыков, и при этом таких элементов таксономий не существует — они будут добавлены автоматически.

$taxonomy
(массив|строка) (обязательное) — название (ярлык) таксономии, к элементам которой производится привязка, например category, post_tag или какая-нибудь созданная вами таксономия.

$append
(логическое) — может принимать два значения:

true — присвоить объекту новые элементы вдобавок к уже существующим,
false — заменить существующие элементы таксономий, в которых находится пост, на новые;

Возвращаемые значения

(массив) в случае успеха возвращает массив присвоенных элементов,
(WP_Error) в том случае, если указана несуществующая таксономия или произошла ошибка при добавлении в базу данных, возвращает объект WP_Error;

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

Добавим пост с ID=541 в рубрику WordPress (например ID=5, ярлык=wordpress), первый вариант:

wp_set_object_terms( 541, 5, 'category' );

Второй вариант:

$terms = wp_set_object_terms( 541, 'wordpress', 'category' );

Добавление поста в несколько рубрик при помощи массива:

wp_set_object_terms( 541, array('jquery', 'wordpress'), 'category' );

Теперь сделаем так, чтобы этот наш пост не находился ни в одной рубрике:

wp_set_object_terms( 541, NULL, 'category' );

Пример с произвольной таксономией:

wp_set_object_terms( get_the_id(), array('gta-vice-city', 'crysis-3'), 'game' );

Кодекс WordPress: Таксономии: add_term_meta(), edit_term_link(), get_ancestors(), get_edit_term_link(), get_taxonomies(), get_taxonomy(), get_term(), get_term_by(), get_term_children(), get_term_field(), get_term_link(), get_term_meta(), get_term_parents_list(), get_terms(), get_the_term_list(), get_the_terms(), is_object_in_term(), is_tax(), is_taxonomy_hierarchical(), register_taxonomy(), register_taxonomy_for_object_type(), sanitize_term(), sanitize_term_field(), single_term_title(), taxonomy_exists(), term_description(), term_exists(), term_is_ancestor_of(), the_terms(), unregister_taxonomy(), unregister_taxonomy_for_object_type(), update_term_meta(), wp_count_terms(), wp_delete_term(), wp_get_object_terms(), wp_get_post_terms(), wp_get_term_taxonomy_parent_id(), wp_insert_term(), wp_set_object_terms(), wp_update_term()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.