函数文档

wxr_nav_menu_terms()

💡 云策文档标注

概述

wxr_nav_menu_terms() 函数用于输出所有导航菜单术语,作为 WordPress 导出功能的一部分,生成 WXR 文件中的菜单数据。

关键要点

  • 函数通过 wp_get_nav_menus() 获取所有导航菜单对象,并遍历输出每个菜单的 term_id、slug 和名称。
  • 输出格式为 XML 结构,使用 wxr_cdata() 和 wxr_term_name() 辅助函数处理数据。
  • 该函数在 export_wp() 中被调用,用于生成完整的站点导出文件。

代码示例

function wxr_nav_menu_terms() {
    $nav_menus = wp_get_nav_menus();
    if ( empty( $nav_menus ) || ! is_array( $nav_menus ) ) {
        return;
    }

    foreach ( $nav_menus as $menu ) {
        echo "t";
        echo '' . (int) $menu->term_id . '';
        echo 'nav_menu';
        echo '' . wxr_cdata( $menu->slug ) . '';
        wxr_term_name( $menu );
        echo "n";
    }
}

注意事项

  • 函数在 WordPress 3.1.0 版本中引入,是导出系统的核心组件。
  • 输出内容直接用于 WXR 文件,需确保数据格式符合 XML 标准。

📄 原文内容

Outputs all navigation menu terms.

Source

function wxr_nav_menu_terms() {
	$nav_menus = wp_get_nav_menus();
	if ( empty( $nav_menus ) || ! is_array( $nav_menus ) ) {
		return;
	}

	foreach ( $nav_menus as $menu ) {
		echo "t<wp:term>";
		echo '<wp:term_id>' . (int) $menu->term_id . '</wp:term_id>';
		echo '<wp:term_taxonomy>nav_menu</wp:term_taxonomy>';
		echo '<wp:term_slug>' . wxr_cdata( $menu->slug ) . '</wp:term_slug>';
		wxr_term_name( $menu );
		echo "</wp:term>n";
	}
}

Changelog

Version Description
3.1.0 Introduced.