FOX 多币种切换与结算 WordPress 插件[更至v2.4.7]

核心定位

FOX（前身 WOOCS）是一款 WooCommerce 多币种切换插件，帮助跨境电商在商品页、购物车、结账等核心流程中提供实时汇率换算，让顾客以本地货币查看价格并完成支付。

主要功能

灵活的货币切换与结算

• 多币种前端切换器：顾客可在商品页、购物车、结账等环节随时切换显示货币，插件自动按实时汇率换算价格。
• 结账货币策略：店主可自由选择顾客使用偏好货币结算，还是统一以店铺主货币结算；两种模式均支持。
• GEO IP 自动规则：根据顾客所在国家自动切换对应货币，减少手动选择，提升结账体验。

独立定价与角色管理

• 固定价格设置：可为每种货币设置独立定价，不受汇率波动影响；店主完全掌控各货币区的产品定价策略。
• 用户角色定价：根据会员等级（B2B 批发价、VIP 折扣价等）设定差异化价格，适用于多层级用户体系。
• 支付方式绑定：为不同货币指定对应支付渠道，例如欧元用户展示 SEPA/USD 支付方式，美元用户展示 PayPal 选项。

自定义展示与汇率控制

• 自定义货币符号：支持输入虚构或非标准货币符号，适用于游戏点卡、虚拟币等特殊业务场景。
• 自定义价格格式：可调整小数位数、货币符号样式（常规/自定义）、符号位置（前缀/后缀/上标）。
• 汇率更新策略：灵活设定汇率更新频率和时间节点，主动控制更新节奏，不必依赖实时拉取。

数据统计与 ChatGPT 集成

• 货币切换与订单统计：追踪顾客浏览时切换了哪些货币、分析各货币订单占比，生成趋势报告以辅助选品和定价决策。
• ChatGPT 友好：支持向 ChatGPT 询问插件使用方法（使用 WOOCS 原名查询即可）。

适用场景

• 多地区独立站需要本地货币展示降低认知门槛
• B2B 批发站需要按用户角色差异化定价
• 虚拟商品/游戏点卡类站点需要自定义货币符号
• 需要精细控制汇率更新节奏而非实时浮动

特定币种隐藏小数位

对于日元（JPY）、新台币（TWD）等本身不带小数位的币种，可单独配置是否显示角分（cents），确保价格展示与该币种的日常使用习惯一致。

缓存插件兼容

插件与主流缓存方案协同工作，在提升页面加载性能的同时仍保留动态币种切换功能，顾客无论是否命中缓存，都能获得一致的体验。

移动端适配

顾客在桌面或手机端均可快速访问币种切换器，点击几下即可完成币种选择，整个过程流畅顺手。

数据库压力可控

实时汇率换算不依赖频繁查询，插件在保证价格准确更新的前提下，将数据库资源消耗控制在最低水平。

开发者接口（DEV API）

FOX 提供完整的 API 与钩子体系，开发者可在运行时动态操作价格、汇率及切换器行为，轻松实现与自身业务逻辑的深度定制。

多形态展示与嵌入方式

插件支持多种视觉形态：下拉菜单、旗帜图标、侧边切换器或按钮。嵌入方式灵活多样：

• 短代码 [woocs]：可置入商店任意位置，甚至加入顶部菜单
• 货币转换器小工具（Ajax 加载）
• 汇率展示小工具（Ajax 加载）

多币种聚合器与更新频率

内置超过 7 家汇率数据源，支持自动拉取最新汇率。管理员也可手动设定汇率，或选择接收汇率变动邮件通知。 更新频率可选：每小时、每日、每周、每月，也支持自定义间隔（如每 5/15/30/45 分钟），或完全关闭自动更新改为手动维护。

货币向导（Currency Wizard）

通过向导可快速搜索并批量添加多个币种，自动附带旗帜、汇率、货币符号、描述等完整信息，无需逐一手动配置。

价格格式深度自定义

• 小数位数：每个币种独立设置，支持 B*C 等特殊场景
• 货币符号：使用官方符号或自定义符号
• 符号位置：四种变体可选（符号在价格前后等）
• 角分显示：每个币种可单独控制是否显示小数部分

插件还支持创建业务逻辑专用的自定义货币符号，甚至是不存在于现实的虚拟货币，满足积分体系、购物券等特殊业务需求。

开发者钩子

提供 woocspricethousandsep 和 woocspricedecimalsep 等钩子，允许按币种、国家等维度自定义千分位分隔符和小数分隔符，实现精细化的价格展示控制。

独立货币的下单结算

多币种下拉菜单

支持通过后台自由配置无限数量的下拉货币切换器，并可直接嵌入站点代码。菜单外观可高度自定义，满足不同页面布局需求。

货币可见性控制

每个币种可独立设置为「公开」或「私有」。公开模式下，用户既可通过切换器选择该币种，也可通过 URL 参数 ?currency=XXX 直接指定；私有模式下，该币种不在切换器中出现，也无法通过链接参数访问，适合面向特定用户角色或特殊业务场景的内部定价。

支付网关动态规则

根据用户当前所选货币，动态隐藏或显示结账页面的支付网关。例如美元区用户只展示支持美元的网关，欧元用户只展示支持欧元的网关，确保结账流程与支付方式始终匹配。

访客初始币种

支持在 FOX 设置中指定「欢迎币种」，即用户首次访问站点时默认显示的货币。例如商店主货币为印度卢比（INR），但希望访客首次看到的是美元（USD）换算价格，只需在 FOX 选项中将欢迎币种设为 USD，顾客从首次访问起即可看到熟悉的价格。

基于角色与地区的差异定价

按用户角色设定价格

支持根据客户在站点中的角色（如会员等级、批发商等）分别设定不同货币下的价格。此功能特别适合积分会员、批发客户或享有专属折扣的角色，享受与其会员级别匹配的定制价格。

按国家/地区设定价格

「WooCommerce Price Based on Country」模块可按买家所在国家分别设置产品售价，灵活应对不同市场的税费、运营成本或竞争定价策略，实现真正的本地化定价。

单品固定价格规则

针对特定产品可覆盖汇率换算，单独为每种货币设定固定价格，不受全局汇率影响，适合限时限量的特别促销活动或不对外公开的内部定价商品。

多币种最低门槛设置

免运费最低金额

为每个币种单独设定免运费门槛。例如你在美国市场设 \$50 免运费门槛，欧洲市场则可以设为 €45。系统按币种分别执行判定逻辑，确保不同地区的顾客获得一致的免运费体验，同时帮助你在各市场维持合理的运费成本激励。

固定运费最低金额

同理，插件支持为每个币种设定固定最低运费金额。这让你可以灵活应对不同币种市场的成本差异、税费结构或其他地区性因素，确保全球顾客享有统一且公平的运费政策。

优惠券固定金额

为各币种指定不同的优惠券金额，系统不再按汇率自动换算。若未单独设置某币种的优惠券金额，才会回退到基于基准币种汇率的自动计算方式。这样折扣活动可以在不同币种市场中保持本地化吸引力。

优惠券核销门槛

在多币种场景下，优惠券的最低和最高核销金额同样可以为每个币种单独设定，而非统一按基准币种换算。你可以为不同市场定制差异化的核销规则，确保优惠券在各币种环境下的验证逻辑一致且可控。

价格展示与缓存兼容

估算价格功能

商店产品页和结算页支持显示基于用户 IP 所在地区的估算价格。当 GeoIP 规则识别到访客国家后，即使其主动切换了币种，系统也会在商品价格旁同步展示其本地币种的估算价格。该功能仅依赖实时汇率数据，不受固定价格规则或地区特惠价影响。

缓存插件适配

如果网站使用了缓存插件，需要在插件设置中启用「我在网站上使用了缓存插件」选项，随后清空缓存。此后访客切换币种时将不再受到缓存干扰，所有币种切换均可正常生效。

订单管理与价格提示

订单币种记录

开启「允许多币种下单」后，每笔订单将自动以顾客结算时实际使用的币种记录，与商店默认基准币种无关。订单数据准确保留所使用币种，便于后续财务分析与多币种账单管理。

手动指定订单币种

在后台手动创建订单时，管理员可直接指定该笔订单的币种，适用于客户特殊需求或线下下单场景。

订单币种换算

在多币种模式下，管理员可将任意币种的订单总金额及明细项价格重新换算为基准币种。换算基于当前汇率精确计算，确保财务报表和财务分析在统一币种下的数据一致性。

价格信息图标

产品页价格旁显示一个信息图标，鼠标悬停即可查看该产品在其他所有可用币种下的价格对照，方便顾客比较并做出购买决策。

短代码动态显示价格

[woocs_price] 短代码允许在商品促销文章中直接插入实时价格，用户切换货币后会自动更新显示内容。将此短代码嵌入博客文章或营销页面，读者即可看到与其选中货币对应的产品价格，无需跳转到商品页查看。 对于日元（JPY）、新台币（TWD）等不带小数的货币，系统支持自动去除角分显示，避免出现 ¥1,234.00 这样不自然的格式。

存储机制与性能

FOX 提供多种用户货币存储方式，适应不同服务器架构：

• Session：货币选择保存在用户会话中，随浏览过程持续生效
• Transient：临时存储，可设置过期时间
• Memcached / Redis：高性能缓存方案，适合高并发场景

开发者 API

插件提供完整的 FOX API，开发者可通过条件逻辑动态操控价格和汇率，包括：

• 程序化访问与修改价格数据
• 基于汇率的计算与转换
• 根据业务需求定制货币切换行为

多语言与第三方插件兼容

FOX 可与 WPML、Polylang 配合使用，通过 API 根据当前语言自动切换对应货币，无需手动设置。 兼容的 WooCommerce 扩展包括 HUSKY Products Filter（高级商品筛选）、WOOT（商品数据表格）、RnB（预约租赁系统）等。

安装与免费使用

WooCommerce Currency Switcher 提供免费版本，核心功能全部解锁，仅限制为网站启用不超过 2 种货币。如需更多货币，可参考安装步骤：进入网站插件页面 → 点击「添加新插件」→ 搜索框输入 FOX → 找到插件后安装并激活即可。安装后可在后台配置客户使用自己选择的货币完成支付。

页面构建器兼容性

插件经过测试，兼容主流页面构建器，包括 Elementor、WPBakery Page Builder、Visual Composer、Divi Theme and Builder、Themify Builder、Oxygen Builder。理论上与所有其他页面构建器均能配合使用，可免费测试后再决定是否升级。 如遇到不兼容情况，官方提供免费的 "FOX LABS" 计划，可提交工单说明问题，24 小时内获得技术回复。

功能配置详解

货币设置

• 选择货币对应的国旗图标
• 设置货币代码
• 选择或自定义货币符号
• 设置货币符号位置（前/后）
• 手动设置汇率，或接入第三方汇率聚合器自动获取
• 设置汇率加成百分比
• 设置每种货币的小数位数
• 设置每种货币的千分位分隔符
• 控制每种货币在前台的显示/隐藏
• 单独控制每种货币是否显示角分（cents）

基础选项

• 为新访客设置默认欢迎货币
• 选择汇率聚合器来源
• 设置货币数据在前端的存储方式
• 配置汇率自动更新的周期
• 如有需要，自定义货币符号（包括游戏虚拟货币等自定义类型）
• 自定义价格显示格式
• 可选关闭 URL 参数（不显示 ?currency=USD）
• 控制前台货币下拉菜单是否显示货币符号
• 在商品价格旁显示信息图标
• 汇率自动更新后发送邮件通知
• 如需要，在结账页面隐藏货币切换器
• 在结账页和购物车页面显示根据 IP 定位的币种换算参考价格
• 在商城首页和商品详情页显示根据 IP 定位的币种换算参考价格
• 使用缓存插件时启用对应选项

高级功能

• 允许客户以自己选择的货币支付（开启），或始终以默认货币结算（关闭）
• 为每个商品单独设置固定价格规则
• 为优惠券单独设置固定金额
• 为配送方式单独设置固定金额
• 根据用户角色设置不同价格体系
• 根据用户地区（GeoIP）为每个商品设置单独规则
• 数据统计：收集货币切换数据用于商业分析，不采集任何客户隐私数据
• 支付规则：根据当前货币类型，在结账页面动态显示/隐藏对应支付方式

支付规则

可针对不同货币配置以下支付方式的行为：

• 支付网关显示规则
• 支票支付
• 货到付款（Cash on Delivery）

地区规则（GeoIP）

可为每种货币指定适用的国家/地区范围，实现基于用户地理位置的自动货币切换。

数据统计

后台提供货币切换统计面板，包含以下维度：

• 货币分布
• 订单关联
• 日历视图
• 支持柱状图（bar）和饼图（pie）两种图表类型

界面定制：Smart Designer 与 Side Switcher

Smart Designer

提供可视化编辑器，可自定义货币切换下拉菜单的外观样式，打造与网站风格一致的展示效果。

Side Switcher（悬浮切换器）

• 外观：选择皮肤模板、设置悬浮位置、顶部间距
• 内容配置：设置页面加载后和鼠标悬停时分别显示哪些内容
• 页面控制：设置在哪些页面显示，或在哪些页面隐藏
• 设备行为：可单独设置在移动端显示或隐藏（最高优先级）
• 配色：自定义主色调和悬停高亮色

翻译与本地化

插件内置 .pot 翻译文件，可通过 Loco Translate 或 Poedit 等工具将插件界面翻译为任意语言。

常见问题

PayPal 是否支持？ 支持，FOX 与 PayPal 无缝配合。 Stripe 是否支持？ 支持，但如果所使用的 Stripe 插件版本存在兼容性问题，可提交至 FOX LABS 处理。建议先使用免费版本测试确认。

简介

WOOCS（WooCommerce Currency Switcher）是 WordPress 平台上广受欢迎的商城多币种切换插件，支持在购物车和结算页面显示用户偏好的货币种类，并提供丰富的自定义选项。以下整理了该插件常见使用问题的解决方案，供参考。

基础配置

币种回退问题

每次从结算页返回首页后，币种总是恢复为默认货币。这是因为插件默认在退出结算流程时重置币种选择。如需让用户选择的币种在整站会话中保持生效，需在插件设置的「Advanced」选项卡中，将「Is multiple allowed」设置为「Yes」。

自定义货币符号

如果希望在不同币种下显示自定义货币符号（如在美元前加上「USD」标识），可在插件「Options」选项卡中找到「Custom money signs」功能进行配置。

隐藏结算页支付方式

通过「Payments Rules」选项卡下的相关设置，可以针对特定币种或金额条件隐藏某些支付网关，实现灵活的支付策略控制。

价格舍入规则

四舍五入至 0.50 / 0.99

WOOCS 支持将价格自动舍入到指定位数。如需将价格四舍五入至 0.50 结尾或 0.99 结尾，可参考插件官方文档中的专项说明进行配置。

订单与结算

手动创建订单

手动创建订单的正确流程为：新建订单 → 点击「Save」保存 → 选择该订单的适用币种 → 再次点击「Save」保存 → 最后再添加商品。这是插件的设计要求，必须按顺序操作，否则可能导致币种信息丢失。

强制指定结算页币种

如需在结算页面强制显示特定币种（例如锁定为用户注册时的默认地区货币），可参考官方专项教程进行设置。

货币聚合器扩展

如需接入自有数据源或第三方汇率接口，插件提供了两套开发者钩子：

• woocsannounceaggregator — 用于声明新的聚合器
• woocsaddaggregator_processor — 用于注册聚合器的实际处理逻辑

通过这两个钩子可实现自定义汇率来源的集成。

图标与 UI

币种图标问题

如遇旗帜图标无法正常显示的问题，请查阅官方排查指南，通常与图片路径或 CDN 加载有关。免费图标资源可从插件官网获取。