函数文档

wxr_tag_name()

💡 云策文档标注

概述

wxr_tag_name() 函数用于从给定的标签对象输出一个 tag_name XML 标签,主要用于 WordPress 导出功能中生成 WXR 文件。

关键要点

  • 函数接受一个 WP_Term 类型的标签对象作为必需参数
  • 如果标签对象的 name 属性为空,函数将不输出任何内容
  • 函数内部调用 wxr_cdata() 来包装标签名称,确保 XML 数据的安全性
  • 该函数自 WordPress 2.3.0 版本引入,是导出系统的一部分

代码示例

function wxr_tag_name( $tag ) {
    if ( empty( $tag->name ) ) {
        return;
    }

    echo '' . wxr_cdata( $tag->name ) . "n";
}

注意事项

  • 确保传入的 $tag 参数是一个有效的 WP_Term 对象,否则可能导致错误或空输出
  • 此函数通常与 export_wp() 函数配合使用,用于生成完整的 WXR 导出文件

📄 原文内容

Outputs a tag_name XML tag from a given tag object.

Parameters

$tagWP_Termrequired
Tag Object.

Source

function wxr_tag_name( $tag ) {
	if ( empty( $tag->name ) ) {
		return;
	}

	echo '<wp:tag_name>' . wxr_cdata( $tag->name ) . "</wp:tag_name>n";
}

Changelog

Version Description
2.3.0 Introduced.