如何在页面正文插入菜单？自定义短代码类未生效排查

问题分析 #

你的自定义短代码功能正常但class属性没输出，核心问题出在**wp_nav_menu参数的理解**和代码的健壮性上：

你当前的代码把短代码的class参数传给了wp_nav_menu的menu_class——这个参数是用来设置菜单内部<ul>元素的类名的，但可能存在两个导致不生效的场景：

1. 你实际想给菜单的外层容器（默认是<div>）加类，而非<ul>；
2. 代码的健壮性不足，加上extract函数的潜在风险，导致类名没有正确传递。

解决方案 #

方案1：给菜单的<ul>元素添加类（匹配你的原始需求）

首先，不推荐使用extract函数（容易引发变量冲突），改用直接读取$atts数组的方式，同时给class设置默认值（和wp_nav_menu的默认行为对齐）：

function print_menu_shortcode($atts, $content = null) {
    // 合并短代码参数，设置默认值
    $atts = shortcode_atts(array(
        'name' => '',
        'class' => 'menu' // 匹配wp_nav_menu默认的ul类名
    ), $atts);

    return wp_nav_menu( array(
        'menu' => $atts['name'],
        'menu_class' => $atts['class'],
        'echo' => false
    ) );
}
add_shortcode('menu', 'print_menu_shortcode');

调用示例（注意不要给类名加多余的减号）：

[menu name="your-menu-slug" class="custom-menu-ul"]

如果还是没看到类名，检查你的主题是否通过wp_nav_menu_args过滤器修改了items_wrap参数——确保items_wrap里包含%2$s（这是menu_class的占位符），比如默认的items_wrap是：

'<ul id="%1$s" class="%2$s">%3$s</ul>'

方案2：给菜单的外层容器添加类（更常见的需求）

如果你想给菜单的外层<div>容器加类，只需要把menu_class换成container_class即可：

function print_menu_shortcode($atts, $content = null) {
    $atts = shortcode_atts(array(
        'name' => '',
        'class' => ''
    ), $atts);

    return wp_nav_menu( array(
        'menu' => $atts['name'],
        'container_class' => $atts['class'], // 给外层容器加类
        'echo' => false
    ) );
}
add_shortcode('menu', 'print_menu_shortcode');

调用示例：

[menu name="your-menu-slug" class="custom-menu-container"]

为什么原代码不生效？ #

1. extract的潜在风险：虽然extract能把数组转成变量，但如果有其他代码也使用了同名变量（比如$class），会导致值被覆盖；
2. 参数匹配错误：如果你期望给容器加类，但代码里传给了<ul>的menu_class，自然看不到效果；
3. 空值传递：原代码中class默认是null，传递给wp_nav_menu时，会覆盖默认的menu类名，导致<ul>没有类（而非显示你传入的类）。

内容的提问来源于stack exchange，提问作者JPashs