wp_set_post_terms

函数


wp_set_post_terms ( $post_id = 0, $terms = '', $taxonomy = 'post_tag', $append = false )
参数
  • (int)
    $post_id
    Optional. The Post ID. Does not default to the ID of the global $post.
    Required: 否
  • (string|array)
    $terms
    Optional. An array of terms to set for the post, or a string of terms separated by commas. Hierarchical taxonomies must always pass IDs rather than names so that children with the same names but different parents aren’t confused. Default empty.
    Required: 否
    Default: (empty)
  • (string)
    $taxonomy
    Optional. Taxonomy name. Default ‘post_tag’.
    Required: 否
    Default: ‘post_tag’
  • (bool)
    $append
    Optional. If true, don’t delete existing terms, just add on. If false, replace the terms with the new terms. Default false.
    Required: 否
    Default: false
返回值
  • (array|false|WP_Error) Array of term taxonomy IDs of affected terms. WP_Error or false on failure.
相关
  • wp_set_object_terms()
定义位置
  • wp-includes/post.php
    , line 5235
引入
2.8.0
弃用
–

设置一个文章的条款。

function wp_set_post_terms( $post_id = 0, $terms = '', $taxonomy = 'post_tag', $append = false ) {
	$post_id = (int) $post_id;

	if ( ! $post_id ) {
		return false;
	}

	if ( empty( $terms ) ) {
		$terms = array();
	}

	if ( ! is_array( $terms ) ) {
		$comma = _x( ',', 'tag delimiter' );
		if ( ',' !== $comma ) {
			$terms = str_replace( $comma, ',', $terms );
		}
		$terms = explode( ',', trim( $terms, " ntrx0B," ) );
	}

	/*
	 * Hierarchical taxonomies must always pass IDs rather than names so that
	 * children with the same names but different parents aren't confused.
	 */
	if ( is_taxonomy_hierarchical( $taxonomy ) ) {
		$terms = array_unique( array_map( 'intval', $terms ) );
	}

	return wp_set_object_terms( $post_id, $terms, $taxonomy, $append );
}
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。