WooCommerce按用户角色显示商品页自定义meta字段代码失效问题

原代码失效原因 #

• 核心逻辑错误：把add_action钩子注册逻辑放在了外层的角色判断块内，Code Snippets加载代码的时机早于WordPress初始化当前用户信息的节点，这时候判断用户角色永远不成立，钩子根本没有被注册，后续页面渲染时自然不会执行输出。
• 语法错误：元字段键hiddencode没有加字符串引号，PHP会将其识别为未定义常量，直接抛出警告，无法正确读取元数据。
• 兼容缺失：没有做产品对象校验、非登录用户判断、元字段空值判断，容易在非商品页、字段为空时输出异常内容。
• 安全缺失：直接输出元字段内容没有做转义，存在XSS风险。

修正后可用代码 #

直接复制粘贴到Code Snippets新建的PHP片段中，选择全站运行启用即可：

add_action( 'woocommerce_single_product_summary', 'show_hidden_product_code', 6 );
function show_hidden_product_code(){
    // 未登录用户直接跳过
    if ( ! is_user_logged_in() ) {
        return;
    }
    // 判断当前用户角色是否匹配目标角色
    $current_user = wp_get_current_user();
    if ( ! in_array( 'hiddenrole', (array) $current_user->roles ) ) {
        return;
    }

    // 获取当前产品对象，兼容主题自定义场景
    global $product;
    if ( ! $product instanceof WC_Product ) {
        $product = wc_get_product( get_the_ID() );
    }
    if ( ! $product ) {
        return;
    }

    // 读取自定义元字段，第二个参数true表示返回单条字符串结果
    $hidden_code = $product->get_meta( 'hiddencode', true );
    // 元字段非空时才输出，额外做安全转义
    if ( ! empty( $hidden_code ) ) {
        echo '<div class="product-hidden-code">Code: ' . esc_html( $hidden_code ) . '</div>';
    }
}

可选调整说明 #

• 代码保留了你原来设置的钩子优先级6，默认会输出在商品标题下方、价格上方的位置，要调整展示位置可以修改优先级数值：数字越小输出位置越靠前，数字越大越靠后。
• 如果你的hiddencode字段是直接存在文章元表、没有通过WooCommerce元API注册，可以把读取元字段的代码替换为$hidden_code = get_post_meta( get_the_ID(), 'hiddencode', true );，效果完全一致。
• 如果需要给输出的编码加样式，可以给.product-hidden-code类写自定义CSS。

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