WooCommerce短代码在REST API响应中不返回商品标题和价格

以下是可能导致仅显示商品图片、缺失标题和价格的原因及对应解决方法：

1. 短代码默认参数未包含所需元素 #

WooCommerce的[top_rated_products]短代码默认配置可能只指定了显示图片，未包含标题、价格等元素。你需要显式传递show参数来定义要输出的内容。

解决代码示例：

function myapi_top_rated_products_callback() {
    // 指定显示图片、标题、价格，可根据需求调整参数
    $html = do_shortcode('[top_rated_products show="image,title,price" columns="4"]');
    return new WP_REST_Response($html, 200, array('Content-Type' => 'text/html'));
}

2. REST API环境缺失模板上下文 #

REST API请求不会加载完整的主题模板环境，WooCommerce商品列表渲染依赖的部分钩子（如woocommerce_after_shop_loop_item_title）可能未触发，导致标题、价格无法输出。

解决方法：
在执行短代码前手动初始化WooCommerce的模板循环上下文：

function myapi_top_rated_products_callback() {
    // 加载商品循环的起始模板
    if (!function_exists('woocommerce_product_loop_start')) {
        wc_load_template('loop/loop-start.php');
    }
    
    $html = do_shortcode('[top_rated_products]');
    
    // 加载商品循环的结束模板
    if (!function_exists('woocommerce_product_loop_end')) {
        wc_load_template('loop/loop-end.php');
    }
    
    return new WP_REST_Response($html, 200, array('Content-Type' => 'text/html'));
}

同时检查主题的content-product.php模板，确认标题和价格的输出代码没有被is_front_page或is_shop等条件判断限制。

3. 请求上下文限制内容输出 #

部分主题或插件会根据请求类型（REST API vs 前端页面）限制内容显示，比如隐藏未登录用户的价格，或在API请求中简化商品信息。

解决方法：
在回调函数中模拟前端商品列表的请求上下文：

function myapi_top_rated_products_callback() {
    global $wp_query;
    // 标记当前请求为商品商店页面上下文
    $wp_query->is_shop = true;
    $wp_query->is_front_page = false;
    
    $html = do_shortcode('[top_rated_products]');
    return new WP_REST_Response($html, 200, array('Content-Type' => 'text/html'));
}

另外检查WooCommerce设置中的「价格可见性」选项，确保允许当前请求用户查看价格。

4. 第三方代码过滤短代码输出 #

主题或其他插件可能通过do_shortcode_tag等过滤器修改了短代码的输出，移除了标题和价格元素。

解决方法：

• 临时禁用所有第三方插件，切换到WooCommerce默认主题（如Storefront）测试，排查是否存在干扰。
• 如果确定是过滤器导致，可在回调中临时移除该过滤器：

function myapi_top_rated_products_callback() {
    // 替换为实际干扰的过滤器函数名和优先级
    remove_filter('do_shortcode_tag', 'custom_shortcode_filter', 10);
    
    $html = do_shortcode('[top_rated_products]');
    
    // 执行后恢复过滤器
    add_filter('do_shortcode_tag', 'custom_shortcode_filter', 10);
    
    return new WP_REST_Response($html, 200, array('Content-Type' => 'text/html'));
}

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