WooCommerce精选产品区块无法渲染：代码实现为何失效？

你的代码无法正常渲染产品区块，主要有以下几个关键问题：

1. 钩子时机与输出逻辑错误 #

wp_loaded钩子触发时，WordPress还未进入页面模板渲染阶段，直接echo序列化后的区块只会输出一段注释格式的区块标记，WordPress不会自动解析这段内容。而且这种输出会直接出现在页面最顶部，位置也不符合预期。

2. 区块构造方式错误 #

WP_Block_Parser_Block是WordPress内部用于解析区块的类，不是用来手动构建区块的正确工具。手动实例化这个类无法生成符合渲染要求的区块结构。

3. 区块属性参数错误 #

woocommerce/handpicked-products区块不需要你传入query对象，它的核心属性是productIds，只需传入产品ID数组即可，区块内部会自动处理产品查询逻辑。

修正后的代码示例 #

add_action( 'wp_footer', 'show_handpicked_products_block');
function show_handpicked_products_block(){
    // $products 是已定义的产品ID数组
    $block_attrs = array(
        'productIds' => $products,
        'columns' => 3, // 可选：自定义列数
        'rows' => 1     // 可选：自定义行数
    );

    // 构造WordPress标准的区块注释格式
    $block_string = sprintf(
        '<!-- wp:woocommerce/handpicked-products %s /-->',
        wp_json_encode($block_attrs)
    );

    // 让WordPress解析并渲染区块为HTML
    echo do_blocks($block_string);
}

修正说明 #

• 替换wp_loaded为wp_footer（可根据需求换成woocommerce_single_product_summary等更合适的模板钩子），确保输出在页面正确位置
• 直接构造WordPress标准的区块注释字符串，传入正确的productIds属性
• 使用do_blocks()函数解析区块标记，将其转换为可显示的产品列表HTML

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