Currency Converter Widget 是由 Kestrel 为 WooCommerce 开发的插件，可在网站上展示一个货币选择器，让客户动态切换商品价格的币种显示方式。
WooCommerce 多币种切换插件 Currency Converter 使用指南
插件要求
WooCommerce 4.0 及以上版本
安装步骤
登录 WooCommerce 账户，下载插件 .zip 文件
进入 WordPress 后台，点击“插件 > 安装插件 > 上传插件”
选择下载的 .zip 文件，点击“立即安装”并激活插件
参考官方安装与激活扩展文档获取更多说明
Open Exchange Rates（可选设置）
默认情况下，插件使用 Kestrel 内建的汇率服务。也可以接入 Open Exchange Rates 作为外部服务。只需注册一个账户并获取 App ID。
设置方法：
前往 WooCommerce 后台菜单：设置 > Integrations > Open Exchange Rates
将 App ID 粘贴进设置表单中
点击保存
提供 App ID 后，界面中将出现额外设置：
汇率刷新周期
用于设置汇率更新的时间间隔（单位为小时）。默认每 12 小时刷新一次。支持范围为 1 至 24 小时。
小工具配置
插件所有设置集中在 Currency Converter Widget 小工具中操作完成。
添加货币转换器小工具
打开 WordPress 后台菜单：外观 > 小工具
找到想要插入小工具的区域，点击“+”
搜索“Currency converter”，选择并添加
插入后点击展开配置选项
小工具参数设置
标题：设置显示在前端的小工具名称
货币代码：每行输入一个币种代码，例如 USD、EUR。示例：输入 SEK* 将显示为 999kr，输入 USD * 显示为 999 $
如果省略 *，则会使用 WooCommerce 的默认币种符号位置
币种显示方式：支持“按钮”或“下拉选择框”
信息提示语：显示在币种选择器上方的说明文字
是否显示货币符号：默认关闭，开启后显示如 $、€
显示重置按钮：启用后，在前端展示“重置币种”按钮
关闭位置识别：勾选后，不自动检测访客地理位置
前端展示样式
启用后，网站前端将显示一个币种切换器，允许用户在支持的币种间切换显示价格。
按钮模式示意：
每个币种以独立按钮形式出现，用户点击后立即更新页面显示的价格。
下拉选择框模式：
可在小工具中选择“Select Box”切换为下拉菜单形式。
转换内容包括：
商品价格与促销价格
购物车总计
结账页面价格
运费金额
所有金额将以对应币种符号显示，例如 $10 而不是 10 USD。
注：实际支付金额仍然使用商店的基础币种，显示币种仅供参考。
常见问题解答
缺少货币符号怎么办？
如果某币种未包含在 WooCommerce 默认币种列表中，可手动添加符号。参见官方文档：添加自定义货币符号
想在侧边栏以外的位置显示小工具？
支持使用短代码 [woocommerce_currency_converter] 插入任意内容区域。
如果在模板文件中使用，可通过 WordPress do_shortcode 函数调用：
echo do_shortcode( ‘[woocommerce_currency_converter]’ );
短代码参数说明
参数名功能默认值currency_codes设置支持币种USD, EUR（或默认币种）message上方提示语空currency_display显示方式（button 或 select）buttonshow_symbols是否显示币种符号0show_reset是否显示重置按钮0disable_location是否关闭位置识别功能0
短代码示例：
[woocommerce_currency_converter currency_codes=”AUD, USD, GBP, EUR”
message=”Prefer to see prices in a different currency?”
show_symbols=1 show_reset=1 currency_display=”select” disable_location=1]
该短代码会生成一个带提示信息、显示为下拉框、支持重置和符号的转换器。
故障排查
页面加载缓慢或价格未更新？
请检查服务器防火墙是否屏蔽了汇率服务。该服务使用的 IP 地址为：
185.24.96.251
运费未被转换？
插件当前仅支持使用“单选按钮”方式显示的运费。如果你的网站使用的是“下拉框”，将无法切换币种显示。
使用国旗图标替代货币代码
你可以通过添加以下 CSS 片段，在币种按钮中显示对应国家国旗：
a[data-currencycode=”USD”] {
background-image: url(‘http://upload.wikimedia.org/wikipedia/en/a/a4/Flag_of_the_United_States.svg’) !important;
background-size: 60px !important;
width: 30px;
background-repeat: no-repeat;
font-size: 0;
height: 20px;
}
提示：WooCommerce 官方不提供自定义代码的支持。如不熟悉 CSS、模板文件或插件冲突排查，建议寻求专业开发者协助。
为什么在购物车和结账页未生效？
需分别在购物车页面和结账页面插入 [woocommerce_currency_converter] 短代码，才能正常显示转换器。
默认短代码只支持 USD 与 EUR，如果需要支持更多币种，必须手动添加 currency_codes 参数。
总结
Currency Converter Widget 是 WooCommerce 商店的多币种价格显示工具，可让客户切换币种查看价格。插件支持按钮或下拉选择方式，能嵌入页面任意位置，并可接入实时汇率服务。它不影响实际付款币种，适合提供参考价格给国际用户，操作简单，功能实用。