Woocommerce自定义标签展示指定属性及过滤代码不生效问题咨询

• 属性键名不匹配：Woocommerce全局商品属性的taxonomy默认带pa_前缀，如果你要移除的color是后台创建的全局属性，实际数组键为pa_color，而非直接用color作为键；如果是产品级自定义属性，键为属性名称经过清理后的字符串，可通过下方调试方法获取准确键名。
• 过滤器挂载时机错误：过滤器代码需要提前挂载到全局执行栈中，如果你将过滤代码和echo wc_display_product_attributes( $product )放在自定义标签页的同一段执行逻辑里，且过滤器定义在输出语句之后，会因为过滤器挂载晚于函数执行导致不生效。正确做法是将过滤逻辑放到主题functions.php文件或自定义功能插件中。

可以逐个写unset语句移除属性，更简洁的方式是定义排除属性列表，通过循环批量处理：

// 该段代码放到主题functions.php或自定义功能插件中
add_filter( 'woocommerce_display_product_attributes', 'custom_remove_product_attributes', 10, 2 );
function custom_remove_product_attributes( $product_attributes, $product ) {
    // 此处填写需要移除的属性键，全局属性加pa_前缀，产品级自定义属性填实际键名
    $remove_attributes = [
        'pa_color',
        'pa_size',
        'custom_attribute_slug'
    ];

    foreach ( $remove_attributes as $attr_key ) {
        if ( isset( $product_attributes[$attr_key] ) ) {
            unset( $product_attributes[$attr_key] );
        }
    }

    return $product_attributes;
}

如果你的需求是仅保留少量指定属性，反向筛选的逻辑更高效：

add_filter( 'woocommerce_display_product_attributes', 'custom_keep_product_attributes', 10, 2 );
function custom_keep_product_attributes( $product_attributes, $product ) {
    // 此处填写需要保留的属性键
    $keep_attributes = [
        'pa_material',
        'pa_weight'
    ];

    foreach ( array_keys( $product_attributes ) as $attr_key ) {
        if ( !in_array( $attr_key, $keep_attributes ) ) {
            unset( $product_attributes[$attr_key] );
        }
    }

    return $product_attributes;
}

过滤器挂载完成后，在自定义标签页的输出逻辑中直接调用属性展示函数即可：

echo wc_display_product_attributes( $product );

如果不知道属性的准确键名，可临时添加以下代码，页面加载后会输出所有属性的键列表，调试完成后删除即可：

add_filter( 'woocommerce_display_product_attributes', 'debug_attribute_keys', 99, 2 );
function debug_attribute_keys( $product_attributes, $product ) {
    echo '<pre>属性键列表：';
    print_r( array_keys( $product_attributes ) );
    echo '</pre>';
    return $product_attributes;
}

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