函数文档

wxr_tag_description()

💡 云策文档标注

概述

wxr_tag_description() 函数用于从给定的标签对象输出一个 tag_description XML 标签,主要用于 WordPress 导出功能。

关键要点

  • 函数接受一个必需的 WP_Term 类型参数 $tag,表示标签对象。
  • 如果标签对象的 description 属性为空,函数将不输出任何内容。
  • 函数通过调用 wxr_cdata() 将描述内容包装在 XML CDATA 标签中,并输出为 XML 格式。
  • 该函数在 WordPress 2.3.0 版本中引入,与 export_wp() 函数相关,用于生成 WXR 导出文件。

代码示例

function wxr_tag_description( $tag ) {
    if ( empty( $tag->description ) ) {
        return;
    }

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

📄 原文内容

Outputs a tag_description XML tag from a given tag object.

Parameters

$tagWP_Termrequired
Tag Object.

Source

function wxr_tag_description( $tag ) {
	if ( empty( $tag->description ) ) {
		return;
	}

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

Changelog

Version Description
2.3.0 Introduced.