wp_set_post_categories() │ WP 2.1.0

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

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

При использовании этой функции все старые категории поста будут удалены и установлены указанные.

Работает на основе: wp_set_post_terms()
Хуки из функции

Возвращает

Массив|false|WP_Error. идентификаторы - массив ID терминов, которые были добавлены/прикреплены к записи или WP_Error объект.

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

<?php wp_set_post_categories( $post_ID, $post_categories, $append ) ?>
$post_ID(число)
ID поста, который будем прикреплять к категориям.
$post_categories(массив)
Список ID категорий к которым прикрепить пост.
По умолчанию: array()
$append(логический)
true - добавить к существующим рубрикам. false - полностью обновить рубрики (удалить из существующих и добавить к указанным).
По умолчанию: false

Примеры

0

#1 Программно переместим пост из одной категории в другую:

Обратите внимание, что если мы не зададим третий параметр, то по умолчанию он будет false, то есть категории будут заменяться, а не добавляться.

wp_set_post_categories( $post_id, array( 1 ) );

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

С версии 2.1.0 Введена.

Код wp_set_post_categories() WP 6.6.1

wp-includes/post.php 
function wp_set_post_categories( $post_id = 0, $post_categories = array(), $append = false ) {
	$post_id     = (int) $post_id;
	$post_type   = get_post_type( $post_id );
	$post_status = get_post_status( $post_id );

	// If $post_categories isn't already an array, make it one.
	$post_categories = (array) $post_categories;

	if ( empty( $post_categories ) ) {
		/**
		 * Filters post types (in addition to 'post') that require a default category.
		 *
		 * @since 5.5.0
		 *
		 * @param string[] $post_types An array of post type names. Default empty array.
		 */
		$default_category_post_types = apply_filters( 'default_category_post_types', array() );

		// Regular posts always require a default category.
		$default_category_post_types = array_merge( $default_category_post_types, array( 'post' ) );

		if ( in_array( $post_type, $default_category_post_types, true )
			&& is_object_in_taxonomy( $post_type, 'category' )
			&& 'auto-draft' !== $post_status
		) {
			$post_categories = array( get_option( 'default_category' ) );
			$append          = false;
		} else {
			$post_categories = array();
		}
	} elseif ( 1 === count( $post_categories ) && '' === reset( $post_categories ) ) {
		return true;
	}

	return wp_set_post_terms( $post_id, $post_categories, 'category', $append );
}

Для записей