wp_create_tag()
云策文档标注
概述
wp_create_tag() 函数用于向数据库添加新标签,如果标签已存在则不会重复添加。它是基于 wp_create_term() 实现的,专门用于处理 post_tag 分类法。
关键要点
- 函数接受一个必需的参数 $tag_name,类型为 int 或 string,用于指定标签名称。
- 返回值类型为 array 或 WP_Error,成功时返回标签数据数组,失败时返回 WP_Error 对象。
- 函数内部调用 wp_create_term($tag_name, 'post_tag') 来实现功能,简化了标签创建过程。
- 自 WordPress 2.3.0 版本引入,是处理标签创建的核心函数。
代码示例
function wp_create_tag( $tag_name ) {
return wp_create_term( $tag_name, 'post_tag' );
}
原文内容
Adds a new tag to the database if it does not already exist.
Parameters
$tag_nameint|stringrequired
Source
function wp_create_tag( $tag_name ) {
return wp_create_term( $tag_name, 'post_tag' );
}
Changelog
| Version | Description |
|---|---|
| 2.3.0 | Introduced. |