函数文档

wxr_cat_name()

💡 云策文档标注

概述

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

关键要点

  • 函数接受一个 WP_Term 类型的分类对象作为必需参数。
  • 如果分类对象的 name 属性为空,函数将不输出任何内容。
  • 输出时使用 wxr_cdata() 函数将分类名称包装在 XML CDATA 标签中。
  • 该函数自 WordPress 2.1.0 版本引入。

代码示例

function wxr_cat_name( $category ) {
    if ( empty( $category->name ) ) {
        return;
    }

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

注意事项

  • 该函数主要用于 export_wp() 函数中,生成 WXR 导出文件。
  • 相关函数包括 wxr_cdata(),用于处理 XML CDATA 标签。

📄 原文内容

Outputs a cat_name XML tag from a given category object.

Parameters

$categoryWP_Termrequired
Category Object.

Source

function wxr_cat_name( $category ) {
	if ( empty( $category->name ) ) {
		return;
	}

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

Changelog

Version Description
2.1.0 Introduced.