wp_set_object_terms函数用于为一个对象(例如,文章或用户)设置相关的标签或分类。
函数原型如下:
wp_set_object_terms( int $object_id, string|int|array $terms, string $taxonomy, bool $append = false );
参数说明:
- $object_id:需要设置标签或分类的对象ID。
- $terms:要设置的标签或分类,可以是标签/分类的ID,名称或数组。如果是数组,则数组的每个元素可以是ID,名称或slug。
- $taxonomy:要设置的分类法(例如,post_tag表示设置标签,category表示设置分类)。
- $append:可选参数,默认为false。如果为true,则将标签或分类追加到对象上。如果为false,则会替换对象的标签或分类。
示例用法:
// 为文章ID为10的文章设置标签为tag1和tag2
wp_set_object_terms( 10, array('tag1', 'tag2'), 'post_tag' );
// 为用户ID为20的用户设置分类ID为5
wp_set_object_terms( 20, 5, 'category' );
注意事项:
- wp_set_object_terms函数会自动创建不存在的标签或分类。
- 如果$append参数为false,则如果传入的标签或分类ID/name/slug与现有的标签或分类完全匹配,则现有的标签或分类将被删除,然后设置新的标签或分类。
0 个评论