使用WooCommerce地理定位或配送国家展示自定义消息的缓存问题如何解决

解决方案 #

方案1：使用WooCommerce内置的Fragment动态渲染（无需手动写Ajax） #

WooCommerce自带的Fragment缓存机制专门适配静态缓存场景，你可以直接通过钩子注册你的自定义内容，系统会自动在后台拉取最新内容替换缓存的静态内容，全程不需要你手动写Ajax逻辑。

首先替换你原来的函数，改成返回内容而不是直接输出，然后注册到WC的fragments里：

// 定义获取国家对应消息的函数
function get_custom_country_message() {
    global $woocommerce;
    $country = '';
    if( isset($woocommerce->customer) ){
        $country = $woocommerce->customer->get_shipping_country();
    } else {
        $geo      = new WC_Geolocation(); 
        $user_ip  = $geo->get_ip_address(); 
        $user_geo = $geo->geolocate_ip( $user_ip ); 
        $country  = $user_geo['country']; 
    }
    if( $country == 'CA' ){
        return 'We offer free shipping to Canada';
    }
    // 其他国家的消息可以在这里补充
    return '';
}

// 注册自定义内容到WooCommerce fragments
add_filter( 'woocommerce_get_script_data', function( $params, $handle ) {
    if ( $handle === 'wc-cart-fragments' ) {
        $params['fragments']['.custom-country-message'] = '<div class="custom-country-message">' . get_custom_country_message() . '</div>';
    }
    return $params;
}, 10, 2 );

// 确保前端加载wc-cart-fragments脚本
add_action( 'wp_enqueue_scripts', function() {
    if ( is_front_page() ) { // 只在首页加载
        wp_enqueue_script( 'wc-cart-fragments' );
    }
} );

然后你只需要在首页你要展示消息的位置放一个占位标签即可：

<div class="custom-country-message"></div>

该方法完全不需要手动编写Ajax逻辑，WooCommerce自带的脚本会自动处理内容更新，不会受首页静态缓存影响。

方案2：Cookie+前端渲染（更轻量化） #

你可以在用户第一次访问的时候把国家信息存在用户本地的Cookie里，前端直接读Cookie输出内容，完全避开服务端缓存的问题：

首先服务端添加设置Cookie的钩子：

add_action( 'init', function() {
    if ( ! isset($_COOKIE['user_country']) ) {
        global $woocommerce;
        $country = '';
        if( isset($woocommerce->customer) ){
            $country = $woocommerce->customer->get_shipping_country();
        } else {
            $geo      = new WC_Geolocation(); 
            $user_ip  = $geo->get_ip_address(); 
            $user_geo = $geo->geolocate_ip( $user_ip ); 
            $country  = $user_geo['country']; 
        }
        // Cookie有效期1天，可自行调整
        setcookie( 'user_country', $country, time() + 86400, COOKIEPATH, COOKIE_DOMAIN );
    }
} );

然后在首页要展示消息的位置加一段简单的JS：

<div id="country-message"></div>
<script>
function getCookie(name) {
    let value = "; " + document.cookie;
    let parts = value.split("; " + name + "=");
    if (parts.length === 2) return parts.pop().split(";").shift();
}
const userCountry = getCookie('user_country');
const messageEl = document.getElementById('country-message');
if (userCountry === 'CA') {
    messageEl.textContent = 'We offer free shipping to Canada';
}
// 其他国家的消息可以在这里补充
</script>

该方法逻辑更简单，完全不需要依赖WooCommerce的额外脚本，适合新手操作。

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