WooCommerce使用recent_products短码排除隐藏产品如何避免空占位框

• 变量名不匹配：代码中定义排除产品ID的变量是$product_id_to_exclude，判断时错误调用了未定义的$product_id_to_hide，导致排除逻辑完全失效。
• 钩子使用错误：storefront_homepage_after_recent_products是最近产品区块输出完成后触发的动作钩子，无法修改产品查询结果，先输出产品再隐藏的处理方式必然会留下空占位框。
• 处理节点错误：你当前的逻辑是在产品渲染阶段做隐藏，正确方案是在数据库查询阶段就过滤掉不符合要求的产品，查询返回的结果会自动补全符合条件的产品，不会出现空位。

<?php
add_filter( 'woocommerce_shortcode_products_query', 'adjust_recent_products_exclude_rule', 10, 3 );
function adjust_recent_products_exclude_rule( $query_args, $atts, $shortcode ) {
    // 仅对recent_products短码生效
    if ( $shortcode !== 'recent_products' ) {
        return $query_args;
    }

    $product_id_to_exclude = array( 9872 );
    // 保留原有逻辑：仅用户有活跃会员时排除目标产品
    if ( !empty( wc_memberships_get_user_active_memberships() ) ) {
        // 合并原有排除规则，避免覆盖其他功能的排除配置
        if ( isset( $query_args['post__not_in'] ) ) {
            $query_args['post__not_in'] = array_merge( $query_args['post__not_in'], $product_id_to_exclude );
        } else {
            $query_args['post__not_in'] = $product_id_to_exclude;
        }
    }

    return $query_args;
}

• 更换过滤钩子为woocommerce_shortcode_products_query，该钩子在产品短码执行查询前触发，直接修改查询参数从根源过滤目标产品，查询返回的结果数量和短码配置的显示数量一致，不会出现空占位。
• 修复了变量名不匹配的问题，排除逻辑可正常执行。
• 增加短码类型判断，排除规则仅作用于最近产品短码，不会影响其他产品短码的正常显示。
• 合并原有post__not_in配置，不会覆盖其他插件或自定义功能的产品排除规则，兼容性更强。

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