WooCommerce结账页多国家增值税信息动态显示教程
在跨境电商场景中，不同国家的用户访问WooCommerce结账页时，需要展示符合当地法规的增值税说明信息。本文将介绍如何实现结账页根据当前用户选择的国家，动态显示对应的增值税信息，无需为每个国家单独创建结账页。
前置准备
在开始开发前，需要确认以下环境已经就绪：
已安装WordPress 5.8及以上版本
已安装WooCommerce 6.0及以上版本
已开启WooCommerce的多国家/地区设置，在WooCommerce后台「设置」-「常规」-「通用选项」中，将「允许的国家/地区」设置为需要支持的所有国家
准备不同国家的增值税说明文本，例如：德国用户显示“德国境内订单需缴纳19%增值税”，法国用户显示“法国境内订单需缴纳20%增值税”
核心实现逻辑
整体实现分为三个步骤：首先获取用户当前选择的结账国家，然后匹配对应的增值税说明文本，最后将说明动态插入到结账页指定位置。WooCommerce提供了丰富的钩子（Hook）机制，我们可以借助这些钩子在不修改核心文件的前提下完成功能扩展。
1. 获取用户选择的结账国家
WooCommerce结账页的国家选择框会通过AJAX实时更新用户数据，我们可以通过woocommerce_checkout_get_value钩子获取当前用户选择的国家代码，也可以通过WC()->customer->get_shipping_country()或WC()->customer->get_billing_country()获取用户当前的账单/收货国家，优先以收货国家为准。
2. 匹配对应国家的增值税说明
我们可以定义一个数组，存储国家代码和对应增值税说明的映射关系，根据用户选择的国家代码从数组中取出对应文本。如果需要后续扩展，也可以将说明存储到WordPress的选项表中，方便后台统一管理。
3. 动态插入说明到结账页
使用WooCommerce提供的woocommerce_before_checkout_form或woocommerce_checkout_order_review等钩子，将匹配到的增值税说明插入到结账页的合适位置，比如表单顶部或者订单汇总区域上方。
完整代码实现
将以下代码添加到当前主题的functions.php文件中，或者封装为独立的插件使用：
<?php
/**
* WooCommerce结账页多国家增值税信息动态显示
*/
add_action('woocommerce_before_checkout_form', 'display_dynamic_vat_notice');
function display_dynamic_vat_notice() {
// 获取用户选择的收货国家，如果没有则使用默认国家
$customer_country = WC()->customer->get_shipping_country();
if (empty($customer_country)) {
$customer_country = WC()->customer->get_billing_country();
}
if (empty($customer_country)) {
$customer_country = wc_get_base_location()['country'];
}
// 国家代码与增值税说明的映射数组，可根据需求扩展
$vat_notices = array(
'DE' => '德国境内订单需缴纳19%增值税，增值税号可填入下方备注栏。',
'FR' => '法国境内订单需缴纳20%增值税，符合免税条件的用户请上传相关证明文件。',
'IT' => '意大利境内订单需缴纳22%增值税，企业用户可填写增值税号申请反向征收。',
'ES' => '西班牙境内订单需缴纳21%增值税，欧盟境内B2B订单可申请免税。',
'GB' => '英国境内订单需缴纳20%增值税，海外订单需符合HMRC相关规定。'
);
// 如果当前国家有对应的增值税说明，则显示
if (!empty($customer_country) && isset($vat_notices[$customer_country])) {
echo '<div class="woocommerce-info">' . esc_html($vat_notices[$customer_country]) . '</div>';
}
}
/**
* 当用户切换国家时，通过AJAX更新增值税说明
*/
add_action('wp_ajax_update_checkout_vat_notice', 'update_checkout_vat_notice');
add_action('wp_ajax_nopriv_update_checkout_vat_notice', 'update_checkout_vat_notice');
function update_checkout_vat_notice() {
check_ajax_referer('update_vat_notice_nonce', 'security');
$country = isset($_POST['country']) ? sanitize_text_field($_POST['country']) : '';
$vat_notices = array(
'DE' => '德国境内订单需缴纳19%增值税，增值税号可填入下方备注栏。',
'FR' => '法国境内订单需缴纳20%增值税，符合免税条件的用户请上传相关证明文件。',
'IT' => '意大利境内订单需缴纳22%增值税，企业用户可填写增值税号申请反向征收。',
'ES' => '西班牙境内订单需缴纳21%增值税，欧盟境内B2B订单可申请免税。',
'GB' => '英国境内订单需缴纳20%增值税，海外订单需符合HMRC相关规定。'
);
$notice = '';
if (!empty($country) && isset($vat_notices[$country])) {
$notice = $vat_notices[$country];
}
wp_send_json_success(array('notice' => $notice));
}
/**
* 加载AJAX所需的JS脚本
*/
add_action('wp_enqueue_scripts', 'enqueue_vat_notice_script');
function enqueue_vat_notice_script() {
if (is_checkout()) {
wp_enqueue_script('vat-notice-script', get_template_directory_uri() . '/js/vat-notice.js', array('jquery'), '1.0', true);
wp_localize_script('vat-notice-script', 'vatAjax', array(
'ajax_url' => admin_url('admin-ajax.php'),
'nonce' => wp_create_nonce('update_vat_notice_nonce')
));
}
}
?>接着创建主题下的js/vat-notice.js文件，添加以下JavaScript代码，实现国家切换时动态更新增值税说明：
jQuery(document).ready(function($) {
// 监听国家选择框的变化，包括账单和收货国家
$(document).on('change', '#billing_country, #shipping_country', function() {
var country = $(this).val();
var noticeContainer = $('.woocommerce-info.vat-notice');
// 如果容器不存在则创建
if (noticeContainer.length === 0) {
noticeContainer = $('<div class="woocommerce-info vat-notice"></div>');
$('.woocommerce-notices-wrapper').after(noticeContainer);
}
$.ajax({
url: vatAjax.ajax_url,
type: 'POST',
data: {
action: 'update_checkout_vat_notice',
country: country,
security: vatAjax.nonce
},
success: function(response) {
if (response.success && response.data.notice !== '') {
noticeContainer.text(response.data.notice).show();
} else {
noticeContainer.hide();
}
}
});
});
// 页面加载时触发一次国家检查，显示默认国家的说明
$('#billing_country').trigger('change');
});功能验证
完成代码添加后，可以按照以下步骤验证功能是否正常：
访问网站结账页，默认会显示你站点基础地址对应国家的增值税说明
切换结账页的国家选择框，选择不同的国家，页面会自动更新对应的增值税说明
选择未配置说明的国家，增值税说明区域会自动隐藏
清空缓存后测试，确认AJAX请求正常返回对应说明，无报错
扩展建议
如果需要更灵活的管理方式，可以做以下扩展：
在WooCommerce后台添加设置页面，允许管理员可视化添加、编辑不同国家的增值税说明，无需修改代码
支持对不同用户角色（如企业用户、个人用户）显示不同的增值税说明
结合WooCommerce的税收设置，自动从税收规则中提取增值税税率，避免手动维护税率信息
支持多语言站点，根据当前站点语言显示对应语言的增值税说明
如果需要参考完整的WooCommerce钩子文档，可以访问https://www.ipipp.com查看相关接口说明，获取更多可使用的钩子和函数信息。