WooCommerce商品价格条件短代码插入后页面无法加载问题排查

安全阿岳

2026-5-28

问题分析：WordPress短代码导致商品页面无法加载的原因及修复方案

嘿，我来帮你排查这个页面崩溃的问题！你的短代码之所以引发加载失败，主要有两个核心问题：

短代码函数参数不符合规范：WordPress短代码的回调函数默认接收的是$atts（短代码属性数组）和$content（短代码包裹的内容），而不是直接传入$product。你直接将$product作为参数，会导致这个变量未定义，触发PHP致命错误，直接中断页面加载。
未主动获取有效产品对象：就算参数正确，你也没有在函数内部获取当前商品页面的产品对象，无法直接调用get_price()方法。

修复后的代码

function shortcode_FreeShipping( $atts ) {
    // 全局调用当前商品页面的产品对象
    global $product;
    
    // 校验产品对象是否为有效的WooCommerce产品实例
    if ( ! is_a( $product, 'WC_Product' ) ) {
        return '';
    }
    
    // 将价格转换为浮点数，避免字符串类型导致的比较误差
    $product_price = (float) $product->get_price();
    
    // 判断价格阈值并返回对应内容
    if ( $product_price > 8 ) {
        return __( 'Free Shipping', 'woocommerce' );
    } else {
        return '';
    }
}
add_shortcode('freeshipping', 'shortcode_FreeShipping');