函数文档

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

Return

array|WP_Error

Source

function wp_create_tag( $tag_name ) {
	return wp_create_term( $tag_name, 'post_tag' );
}

Changelog

Version Description
2.3.0 Introduced.