网址:eezz.net/FX-Loss-Calculator

FX Loss Calculator

贡献者：daijianpu | eezz.net 最低 WordPress 版本：6.5 最低 PHP 版本：7.4 测试最高版本：7.0 最低 WooCommerce 版本：7.0 稳定版本：1.3.0 许可证：GPLv2 or later 许可证地址：https://www.gnu.org/licenses/gpl-2.0.html

用于估算 WooCommerce 店铺在扣除支付手续费、提现成本和汇率点差后，最终可收到的目标货币金额。

插件介绍

FX Loss Calculator 是一个面向 WooCommerce 跨境卖家的后台管理工具，用于帮助店铺管理员估算订单或商品价格在扣除支付通道费用、提现费用和汇率损耗之后，最终可能收到多少目标货币。

很多 WooCommerce 店铺使用一种货币销售商品，但实际经营者关心的是另一种货币的最终到账金额。例如，店铺可能使用 USD、JPY 或 EUR 定价，但商家希望估算最终能收到多少 CNY 或其他目标货币。FX Loss Calculator 可以帮助管理员查看实时汇率、预估净汇率、支付配置费用，以及预估的目标货币到账金额。

本插件只用于后台管理和经营参考。它不会修改结账价格、商品价格、订单总额、支付网关行为、税费计算，也不会改变前台显示的货币。

汇率数据通过 WP-Cron 从配置的汇率服务下载，并保存在 WordPress 本地数据库中。商品估算、订单估算、仪表盘报表和汇率图表都会使用本地缓存数据，因此插件不需要在每次打开后台页面时都请求远程汇率数据。

本插件只提供估算结果，不提供金融、会计、税务、法律或货币兑换建议。实际到账金额可能会因为支付服务商、银行、换汇服务、结算时间、手续费和汇率规则不同而发生差异。

主要功能

• 配置汇率服务基础域名，并在 WordPress 后台刷新汇率数据。
• 设置 Calculation Currency，用于解释商品价格、订单金额和固定费用。
• 设置 Target Currency，用于到账估算、反向定价和仪表盘报表。
• 将汇率数据包保存在本地，并支持 WP-Cron 自动刷新和手动刷新。
• 在使用汇率数据前，对汇率数据包进行严格验证。
• 可创建和编辑 PayPal、Stripe、Wise、银行转账或自定义收款方式的 Payment Profiles。
• 可设置一个默认 Payment Profile，用于估算。
• 在 WooCommerce 商品编辑页面中，估算简单商品和变体商品的目标货币到账金额。
• 使用反向定价助手，根据希望收到的目标货币金额，估算应该设置的店铺售价。
• 在 WooCommerce 订单编辑页面中，使用当前缓存汇率估算订单到账金额。
• 在后台 Dashboard 中显示近期销售额、预估到账金额和预估汇率/支付损耗。
• 为授权管理员显示全局 Admin Bar 汇率摘要，包括 Live Rate 和 Net Rate。
• 在 Rate Service 页面显示实时汇率、预估净汇率和汇率损耗。
• 显示 USD/CNY 汇率图表，用于短期和历史汇率参考。
• 声明兼容 WooCommerce HPOS。

工作原理

FX Loss Calculator 主要依赖四类设置：

1. Calculation Currency
   这是插件用来解释商品价格、订单金额和固定费用的货币。大多数情况下，它应该与 WooCommerce 店铺货币一致。

2. Target Currency
   这是插件用于到账估算、反向定价、订单估算和仪表盘报表的目标货币。

3. Rate Service
   这是用于下载公开汇率数据包的基础域名。插件会验证数据包，并将可用汇率数据保存在本地。

4. Payment Profiles
   Payment Profile 用来描述某个收款通道的费用模型，例如百分比手续费、固定手续费、提现费或汇率点差。默认 Profile 会用于商品估算、订单估算和 Dashboard 摘要，部分后台页面也可以选择其他 Profile。

插件会将本地缓存的汇率数据与所选 Payment Profile 结合，估算扣除费用和汇率损耗后可能剩余的目标货币金额。

快速开始

启用插件后，在 WordPress 后台菜单中打开 FX Loss Calculator，并完成以下步骤：

1. 打开 Rate Service 页面。
2. 输入官方汇率服务基础域名。
3. 选择 Calculation Currency。
4. 选择 Target Currency。
5. 保存设置。
6. 刷新汇率数据包。
7. 打开 Payment Profiles 页面。
8. 为你的收款方式创建或编辑 Payment Profile。
9. 选择默认 Payment Profile。
10. 打开 WooCommerce 商品或订单页面，查看到账估算结果。

Rate Service 设置区域在保存后可能会进入锁定状态，以减少误操作。如需再次修改汇率服务域名或货币设置，请先点击 Unlock settings 解锁。

商品价格助手

在支持的 WooCommerce 商品编辑页面中，插件可以在商品价格字段旁边显示到账估算结果。管理员可以通过这些估算，了解某个商品售价在扣除支付配置成本后，可能换算成多少目标货币到账金额。

反向定价助手还可以根据期望收到的目标货币金额，估算需要填写的店铺售价。该结果只是估算，不会自动修改商品价格，除非管理员主动复制或填入计算结果。

订单估算

在 WooCommerce 订单编辑页面中，插件可以使用当前缓存汇率和所选或默认 Payment Profile，估算订单的目标货币到账金额。这些估算只用于后台经营参考，不会修改订单总额、订单货币、支付状态或会计记录。

如果订单货币与当前选择的 Calculation Currency 不一致，插件可能会跳过估算或标记提示，以避免产生误导。

仪表盘报表

Dashboard 会汇总近期店铺活动、预估到账金额和预估支付/汇率损耗。该报表用于帮助管理员观察经营趋势和可能的汇率损耗，不应替代正式会计报表。

为了提升性能，Dashboard 数据可能会被缓存。当货币设置或 Payment Profiles 发生变化时，插件会在需要时清理相关报表缓存。

汇率图表

插件会在本地保存部分汇率历史数据，并显示短期和历史汇率图表作为参考。历史汇率仅供参考，可能与支付服务商、卡组织、银行或收款服务在实际结算时使用的汇率不同。

重要说明

• FX Loss Calculator 是后台管理工具。
• 它不会为前台结账添加货币转换功能。
• 它不会自动修改 WooCommerce 商品价格。
• 它不会修改 WooCommerce 订单总额。
• 它不能替代支付网关报表。
• 它不保证实际到账金额。
• 它不提供金融、会计、法律、税务或货币兑换建议。

隐私

FX Loss Calculator 不会上传订单、商品、客户或管理员数据。

插件只会从配置的汇率服务下载公开汇率数据包，并将验证后的汇率数据保存在本地。它不会为客户数据注册公开 REST 接口，不会在前台添加广告，也不会把 WooCommerce 订单数据发送给汇率服务。

安装方法

1. 将插件目录上传到 /wp-content/plugins/，如果插件通过 WordPress.org 分发，也可以直接在 WordPress 后台安装。
2. 启用插件。
3. 确认 WooCommerce 已安装并启用。
4. 在 WordPress 后台菜单中打开 FX Loss Calculator。
5. 配置 Rate Service 设置。
6. 刷新汇率数据包。
7. 配置 Payment Profiles。
8. 在后台商品、订单和 Dashboard 页面查看估算结果。

常见问题

这个插件会修改结账价格吗？

不会。插件不会修改结账价格、商品价格、购物车金额、订单总额、支付网关行为或前台货币显示。

这个插件会给顾客做前台货币转换吗？

不会。FX Loss Calculator 是一个后台估算工具，不是前台货币切换插件，也不是多货币结账插件。

这个插件能提供准确到账金额吗？

不能。插件会基于本地缓存汇率和 Payment Profile 设置提供估算结果。实际到账金额可能因为支付服务商、银行、换汇服务、手续费、汇率和结算时间不同而变化。

什么是 Calculation Currency？

Calculation Currency 是插件用于解释商品价格、订单金额和固定费用的货币。大多数情况下，它应该与 WooCommerce 店铺货币一致。

什么是 Target Currency？

Target Currency 是插件用于到账估算、反向定价、订单估算和 Dashboard 报表的目标货币。

什么是 Payment Profiles？

Payment Profiles 是可编辑的费用模型，用于描述 PayPal、Stripe、Wise、银行转账或自定义收款方式。一个 Profile 可以包含百分比手续费、固定手续费、提现成本和汇率点差。

插件会上传我的店铺数据吗？

不会。插件不会上传订单、商品、客户或管理员数据。它只会从配置的汇率服务下载公开汇率数据包。

我可以用这个插件做会计或报税吗？

不可以。插件只提供经营参考和价格估算。会计或税务用途应以支付服务商官方报表、银行流水和专业意见为准。

更新日志

1.3.0

• 增加 Rate Service 设置锁定状态，减少保存后误操作。
• 增加后台推荐资源根据 Target Currency 自动切换语言。
• 改进自定义汇率表查询的 WordPress.org Plugin Check 兼容性。
• 改进本地图表和状态查询使用的汇率仓库缓存。
• 将最低 WordPress 版本要求更新为 6.5，以支持现代数据库占位符。

1.2.9

• 修复 USD/CNY 图表同步结果处理，避免部分 latest sync 被显示为完整成功。
• 在图表完全同步成功后清理旧的图表同步错误。
• 改进 USD/CNY 图表标签、最新汇率显示和 tooltip 来源细节。
• 改进 WooCommerce 未启用时的后台 capability fallback。
• 在卸载/停用时清理图表同步计划和锁。

1.2.8

• 改进 WordPress.org Plugin Check 的国际化和输出转义兼容性。
• 增加插件 license header metadata。
• 更新 readme Tested up to 值。
• 在适用位置改进后台输入清理。
• 保持简单商品和变体商品价格布局不变。

1.2.7

• 使用 UTC timestamp 改进汇率新鲜度检查，避免依赖本地时间字符串。
• 增加更清晰的汇率状态标签，例如 Ready、Needs refresh、Stale 和 Not ready。
• 将 0 的净汇率值显示为 0.00，而不是 0。
• 保持 Admin Bar Live Rate 和 Net Rate 显示不变。
• 保持简单商品和变体商品价格布局不变。

1.2.6

• 修复预估到账为 0 时的 Net Rate 显示。
• 避免汇率刷新已在运行时显示误导性成功通知。
• 将商品编辑器汇率格式与后台汇率摘要保持一致。
• 更新 Admin Bar 和 Rate Service 汇率摘要功能说明。
• 保持简单商品和变体商品价格布局不变。

1.2.5

• 当货币设置实际变化时清理 Dashboard 报表缓存，即使其他汇率设置保存失败。
• 改进 Dashboard 设置状态中对过期汇率包的提示。
• 保持 Admin Bar Live Rate 和 Net Rate 显示不变。
• 保持简单商品和变体商品价格布局不变。

1.2.4

• 增加更清晰的 Dashboard 设置状态和默认 payout profile 摘要。
• 在 Dashboard 报表中增加报表范围说明和跳过订单信息。
• 在 Rate Service 页面增加预估汇率损耗和损耗比例详情。
• 为 Admin Bar Net Rate 参考金额增加 hover 引导。
• 为 WooCommerce 商品价格助手的 Fill 按钮增加 hover 引导。
• 在货币设置变化时增加 cache-cleared notice。
• 在 Payment Profiles 页面增加说明，解释默认 profile 如何影响估算。
• 保持简单商品和变体商品价格布局不变。

1.2.3

• 改进小额货币汇率格式。
• 当 Net Rate 无法计算时仍保留 Live Rate 可见。
• 为授权用户全局显示 Admin Bar 汇率摘要。
• 保持简单商品和变体商品价格布局不变。

1.2.2

• 增加全局 Admin Bar 汇率摘要，显示 Live Rate 和 Net Rate。
• 在 Rate Service 页面增加大号实时汇率显示。
• 修复商品编辑器 live-rate note 的方向，显示店铺货币到目标货币。
• 增加简单商品 reverse-result 的 scoped alignment CSS。
• 保持简单商品和变体商品价格布局不变。

1.2.1

• 改进 Payment Profiles 中添加、删除和选择默认项的说明。
• 为 Payment Profiles 增加删除确认。
• 将插件金额格式改为使用 ISO 货币代码，而不是货币符号。
• 更新卸载清理，覆盖 target currency、dashboard report cache 和 report cron。
• 移除 standalone calculator 和 reports 页面后，更新 readme 文案。
• 保持简单商品和变体商品价格布局不变。

1.2.0

• 增加可配置的 target currency，用于到账估算和反向定价。
• 用动态 ISO 货币代码替换硬编码货币标签。
• 将商品和变体商品价格助手改为使用所选 target currency。
• 增加近期销售和 FX-loss 估算的缓存 Dashboard 报表。
• 将报表摘要移动到 Dashboard，并移除单独的 Calculator、Reports 和 Resources 菜单。
• 改进 Payment Profiles 表格在大屏后台中的宽度。
• 保持简单商品和变体商品价格布局不变。

1.1.3

• 修复变体商品计算结果中 CNY 和店铺货币值的颜色。
• 增加变体结果颜色变量的 CSS fallback。
• 保持用户输入值为黑色，计算值为深红色。
• 保持简单商品和变体商品价格行为不变。

1.1.2

• 将 WooCommerce 变体商品价格助手优化为紧凑的垂直布局。
• 在 target CNY 输入框旁显示反向计算后的店铺价格。
• 将 target currency 标签移动到 target CNY 输入框下方。
• 使变体 Fill 按钮更紧凑，并与目标输入框对齐。
• 改进变体 CNY 和店铺货币结果的间距。
• 保持简单商品 inline assistant 不变。

1.1.1

• 加固变体助手 DOM 插入逻辑，避免在变体表单行中插入 block 元素。
• 通过忽略 FX Loss Calculator helper mutations，减少不必要的变体重新扫描。
• 当助手重新初始化时刷新反向价格结果。
• 将 variation live-rate note 放入 variable product panel。
• 改进变体 Fill 按钮间距。
• 保持简单商品 inline pricing 行为不变。

1.1.0

• 为 WooCommerce 变体 regular 和 sale price 字段增加 inline JPY-to-CNY 到账估算。
• 为每个变体价格字段增加 target-CNY 反向价格填充控件。
• 重构商品价格助手 JavaScript，使用独立的 per-field keys。
• 增加对 loaded、added 和 expanded variation rows 的动态挂载。
• 保持简单商品 inline assistant 布局和行为不变。

1.0.7

• 压缩 WooCommerce 简单商品定价行中的水平空白。
• 限制主价格输入列宽度，使反向定价控件向左移动。
• 收紧 target-CNY 输入框和 Fill 按钮间距。
• 改进中等宽度屏幕的响应式表现，避免右侧控件被裁切。
• 保持 CNY/JPY 结果对齐、用户输入黑色和计算结果深红色。

1.0.6

• 减少 WooCommerce 简单商品定价行左侧浪费空间。
• 通过收紧 assisted field grid 和 label column，将 inline price assistant 布局向左移动。
• 改进小屏下反向 target-CNY 控件的水平空间。
• 保持 CNY/JPY 结果对齐、用户输入黑色和计算结果深红色。

1.0.5

• 微调简单商品 inline price assistant 对齐。
• 将反向计算店铺价格结果对齐到 target CNY 输入列下方。
• 将反向货币标签对齐到 target currency 标签列下方。
• 改进左侧 CNY 估算和右侧店铺货币结果的水平对齐。
• 保持用户输入黑色和计算结果深红色。

1.0.4

• 将简单商品 inline pricing assistant 重做为两行两列布局。
• 将反向计算店铺价格显示为醒目的文本，而不是 readonly 输入框。
• 统一颜色语义：用户输入保持黑色，计算结果使用深红色。
• 将正向 CNY 估算和反向店铺货币结果对齐在同一结果行。
• 保持 live rate footer、紧凑 CNY 显示和不自动保存行为。

1.0.3

• 优化 WooCommerce 简单商品的 product price inline assistant 布局。
• 将 target-CNY 反向定价控件稳定为固定水平列。
• 改进货币标签、required store price 和 Fill 按钮之间的间距。
• 保持 CNY 到账估算显示在 Regular 和 Sale price 字段下方。
• 保持 shared live-rate footer note 和紧凑 CNY 显示。

1.0.2

• 将 CNY 到账结果移动到 WooCommerce Regular 和 Sale price 字段下方。
• 从反向定价控件中移除重复的 Estimated payout 文本。
• 将 target-CNY 反向定价控件对齐在同一水平行。
• 将 rate source 和 updated time 移动到一个共享底部说明中。
• 增加商品价格估算的紧凑 CNY 显示格式。
• 清理发布包产物，例如嵌套 ZIP 和隐藏工具目录。

1.0.1

• 为简单商品增加 inline WooCommerce 商品价格转换助手。
• 在 Regular 和 Sale price 字段下方增加 live calculation-currency 到 CNY 的到账估算。
• 为 Regular 和 Sale price 增加独立 target-CNY 反向价格和填充控件。
• 移除重复的 product-side calculator box。
• 保持 standalone calculator 页面和 order estimator 不变。

1.0.0

初始 MVP。

FX Loss Calculator

Contributors: daijianpu Requires at least: 6.5 Requires PHP: 7.4 Tested up to: 7.0 WC requires at least: 7.0 Stable tag: 1.3.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Estimate WooCommerce payout amounts in a target currency after payment fees, withdrawal costs and FX spread.

Description

FX Loss Calculator is an admin-only WooCommerce tool for cross-border store owners who want a clearer estimate of how much money may remain after payment processing fees, withdrawal fees and exchange-rate spread.

Many WooCommerce stores sell in one currency but review their final payout in another currency. For example, a store may price products in USD, JPY or EUR, while the business owner wants to estimate the final amount in CNY or another target currency. FX Loss Calculator helps administrators compare the live exchange rate, estimated net rate, payment profile fees and expected target-currency payout.

The plugin is designed for store administration and decision support. It does not change checkout prices, product prices, order totals, payment gateway behavior, tax calculations or frontend currency display.

Rates are downloaded from the configured rate service by WP-Cron and stored locally. Product helpers, order estimates, dashboard reports and exchange-rate charts use cached local data so the plugin does not need to request remote rate data on every admin page load.

This plugin provides estimates only. It does not provide financial, accounting, tax, legal or currency exchange advice. Actual payouts may differ because payment providers, banks and exchange services may use their own fees, rates, timing rules and settlement policies.

Main Features

• Configure a rate service base domain and refresh exchange-rate data from the WordPress admin.
• Select a Calculation Currency for store prices, order amounts and fixed fees.
• Select a Target Currency for payout estimates, reverse pricing and dashboard reports.
• Store the rate bundle locally and refresh it by WP-Cron or manual refresh.
• Validate the rate bundle before it is used by product, order and dashboard estimates.
• Create editable payment profiles for PayPal, Stripe, Wise, bank transfer or custom payout methods.
• Set one default payment profile for estimates.
• Estimate product and variation payouts directly inside WooCommerce product editing screens.
• Use reverse pricing helpers to estimate the store price required for a target-currency payout amount.
• Show order payout estimates in the WooCommerce order edit screen using the current cached rates.
• Display dashboard summaries for recent sales, estimated payout and estimated FX/payment loss.
• Show a global admin bar summary for Live Rate and Net Rate for authorized administrators.
• Display live-rate and estimated net-rate loss information on the Rate Service page.
• Display USD/CNY exchange-rate charts for short-term and historical reference.
• Include HPOS compatibility declaration.

How It Works

FX Loss Calculator uses four main settings:

1. Calculation Currency This is the currency used to interpret product prices, order amounts and fixed fees. In most stores, this should match the WooCommerce store currency.

2. Target Currency This is the currency used for payout estimates, reverse pricing, order estimates and dashboard reports.

3. Rate Service This is the base domain used to download the public exchange-rate bundle. The plugin stores the validated bundle locally.

4. Payment Profiles A payment profile describes the estimated cost of a payout channel, such as percentage fees, fixed fees, withdrawal fees or exchange-rate spread. The default profile is used by product helpers, order estimates and dashboard summaries unless another profile is selected in a supported admin screen.

The plugin then combines the cached exchange-rate data with the selected payment profile to estimate how much target currency may remain after fees and spread.

Getting Started

After activation, open FX Loss Calculator in the WordPress admin menu and complete these steps:

1. Open Rate Service.
2. Enter the official rate service base domain.
3. Choose the Calculation Currency.
4. Choose the Target Currency.
5. Save the settings.
6. Refresh the rate bundle.
7. Open Payment Profiles.
8. Create or edit a payment profile for your payout channel.
9. Choose a default payment profile.
10. Open a WooCommerce product or order to review payout estimates.

The Rate Service settings area may be locked after saving to help prevent accidental changes. Use Unlock settings before editing the rate service domain or currency settings again.

Product Price Helpers

On supported WooCommerce product edit screens, the plugin can display payout estimates beside product price fields. Administrators can use these estimates to understand how a product price may convert into a target-currency payout after payment profile costs.

The reverse pricing helper can also estimate the store price required to reach a desired target-currency payout amount. This is only an estimate and does not automatically change the product price unless an administrator chooses to copy or fill a calculated value.

Order Estimates

On WooCommerce order edit screens, the plugin can estimate target-currency payout values using current cached rates and the selected or default payment profile. These estimates are for administrative reference and do not change the order total, order currency, payment status or accounting records.

If an order currency is different from the selected Calculation Currency, the plugin may skip or label the estimate to avoid misleading results.

Dashboard Reports

The Dashboard summarizes recent store activity and estimated payout loss using cached local data. Reports are designed to help administrators review patterns and possible FX/payment loss, not to replace accounting reports.

Dashboard data may be cached for performance. If currency settings or payment profiles change, the plugin clears relevant report cache where needed.

Exchange-Rate Charts

The plugin stores selected exchange-rate history locally and can show short-term and historical chart views for reference. Historical rates are for reference only. They may not match the exact rate used by a payment provider, card network, bank or payout service at settlement time.

Important Notes

• FX Loss Calculator is an admin-only tool.
• It does not add frontend checkout currency conversion.
• It does not modify WooCommerce product prices automatically.
• It does not modify WooCommerce order totals.
• It does not replace payment gateway reports.
• It does not guarantee actual payout amounts.
• It does not provide financial, accounting, legal, tax or currency exchange advice.

Privacy

FX Loss Calculator does not upload order, product, customer or administrator data.

The plugin downloads a public exchange-rate bundle from the configured rate service and stores validated rate data locally. It does not register public REST endpoints for customer data, does not add frontend advertising and does not send WooCommerce order data to the rate service.

Installation

1. Upload the plugin directory to /wp-content/plugins/, or install it from the WordPress admin if distributed through WordPress.org.
2. Activate the plugin.
3. Make sure WooCommerce is installed and active.
4. Open FX Loss Calculator from the WordPress admin menu.
5. Configure Rate Service settings.
6. Refresh the rate bundle.
7. Configure Payment Profiles.
8. Review product, order and dashboard estimates from the admin screens.

Frequently Asked Questions

Does this plugin change checkout prices?

No. The plugin does not change checkout prices, product prices, cart totals, order totals, payment gateway behavior or frontend currency display.

Does this plugin convert currencies for customers?

No. FX Loss Calculator is an admin-only estimation tool. It is not a frontend currency switcher or multi-currency checkout plugin.

Does this plugin provide exact payout amounts?

No. It provides estimates based on cached rates and payment profile settings. Actual payouts may differ because payment providers, banks and exchange services may apply their own rates, fees and settlement timing.

What is the Calculation Currency?

The Calculation Currency is the currency used to interpret product prices, order amounts and fixed fees. In most cases it should match the WooCommerce store currency.

What is the Target Currency?

The Target Currency is the currency used for payout estimates, reverse pricing, order estimates and dashboard reports.

What are Payment Profiles?

Payment Profiles are editable fee models for payout methods such as PayPal, Stripe, Wise, bank transfer or a custom method. A profile can include estimated percentage fees, fixed fees, withdrawal costs and exchange-rate spread.

Does the plugin upload my store data?

No. The plugin does not upload order, product, customer or administrator data. It only downloads a public exchange-rate bundle from the configured rate service.

Can I use this for accounting or tax filing?

No. The plugin provides estimates for store administration and pricing reference only. Use official payment provider reports, bank statements and professional advice for accounting or tax decisions.

Changelog

1.3.0

• Added Rate Service setting lock state to reduce accidental changes after saving.
• Added target-currency based recommended resource language switching in admin screens.
• Improved WordPress.org Plugin Check compatibility for custom exchange-rate table queries.
• Improved exchange-rate repository caching for local chart and status queries.
• Updated minimum WordPress requirement to 6.5 for modern database placeholder support.

1.2.9

• Fixed USD/CNY chart sync result handling so partial latest sync is no longer shown as full success.
• Cleared stale chart sync errors after fully successful chart synchronization.
• Improved USD/CNY chart labels, latest-rate display, and tooltip source details.
• Improved admin capability fallback when WooCommerce is inactive.
• Cleaned chart sync schedules and locks on uninstall/deactivation.

1.2.8

• Improved WordPress.org Plugin Check compliance for internationalization and output escaping.
• Added plugin license header metadata.
• Updated readme Tested up to value.
• Improved admin input sanitization where applicable.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.7

• Improved rate freshness checks by using a UTC timestamp instead of local time strings.
• Added clearer rate status labels such as Ready, Needs refresh, Stale and Not ready.
• Displayed zero net-rate values as 0.00 instead of 0.
• Kept Admin Bar Live Rate and Net Rate display unchanged.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.6

• Fixed Net Rate display when estimated payout is zero.
• Avoided misleading success notices when a rate refresh is already running.
• Aligned product editor rate formatting with the admin rate summary.
• Updated feature descriptions for Admin Bar and Rate Service rate summaries.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.5

• Cleared dashboard report cache whenever currency settings actually change, even if another rate setting fails to save.
• Improved Dashboard setup status wording for stale rate bundles.
• Kept Admin Bar Live Rate and Net Rate display unchanged.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.4

• Added clearer Dashboard setup status and default payout profile summaries.
• Added report-scope notes and skipped-order information to the Dashboard report.
• Added estimated rate loss and loss ratio details to the Rate Service page.
• Added Admin Bar hover guidance for Net Rate reference amount.
• Added Fill button hover guidance on WooCommerce product price helpers.
• Added a cache-cleared notice when currency settings change.
• Added a Payment Profiles note explaining how the default profile affects estimates.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.3

• Improved exchange-rate formatting for small currency rates.
• Kept Live Rate visible when Net Rate cannot be calculated.
• Made the Admin Bar rate summary available globally for authorized users.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.2

• Added a global admin bar rate summary with Live Rate and Net Rate.
• Added a large live-rate display to the Rate Service page.
• Fixed product editor live-rate note direction to show store currency to target currency.
• Added scoped Simple Product reverse-result alignment CSS.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.1

• Added clearer Payment Profiles instructions for adding, deleting and choosing defaults.
• Added a delete confirmation for Payment Profiles.
• Changed plugin money formatting to use ISO currency codes instead of currency symbols.
• Updated uninstall cleanup for target currency, dashboard report cache and report cron.
• Updated readme wording after removing the standalone calculator and reports pages.
• Kept Simple Product and Variation pricing layouts unchanged.

1.2.0

• Added configurable target currency for payout estimates and reverse pricing.
• Replaced hard-coded currency labels with dynamic ISO currency codes.
• Converted product and variation pricing helpers to use the selected target currency.
• Added cached dashboard sales and FX-loss estimates for recent periods.
• Moved report summaries into Dashboard and removed separate Calculator, Reports and Resources menus.
• Improved Payment Profiles table width on large admin screens.
• Kept Simple Product and Variation pricing layouts unchanged.

1.1.3

• Fixed variation calculated result colors for CNY and store-currency values.
• Added CSS fallback values for variation result color variables.
• Kept user-entered values black and calculated values deep red.
• Kept simple product and variation pricing behavior unchanged.

1.1.2

• Refined the WooCommerce variation price assistant into a compact vertical layout.
• Displayed reverse-calculated store prices beside the target CNY input.
• Moved the target currency label below the target CNY input.
• Made variation Fill buttons compact and aligned with the target input.
• Improved spacing in variation CNY and store-currency results.
• Kept the simple product inline assistant unchanged.

1.1.1

• Hardened variation assistant DOM insertion to avoid block elements inside variation form rows.
• Reduced unnecessary variation rescans by ignoring FX Loss Calculator helper mutations.
• Refreshed reverse price results when assistants are re-initialized.
• Placed the variation live-rate note inside the variable product panel.
• Improved variation Fill button spacing.
• Kept simple product inline pricing behavior unchanged.

1.1.0

• Added inline JPY-to-CNY payout estimates for WooCommerce variation regular and sale price fields.
• Added target-CNY reverse price fill controls for each variation price field.
• Refactored product price assistant JavaScript to use independent per-field keys.
• Added dynamic attachment for loaded, added and expanded variation rows.
• Preserved the simple product inline assistant layout and behavior.

1.0.7

• Compressed horizontal whitespace in the WooCommerce simple product pricing rows.
• Limited the main price input column width so reverse pricing controls move left.
• Tightened target-CNY input and Fill button spacing.
• Improved medium-width responsiveness to prevent right-side controls from being clipped.
• Preserved CNY/JPY result alignment, black user-entered values and deep-red calculated results.

1.0.6

• Reduced wasted left-side space in the WooCommerce simple product pricing rows.
• Moved the inline price assistant layout left by tightening the assisted field grid and label column.
• Improved horizontal space for the reverse target-CNY controls on smaller screens.
• Preserved CNY/JPY result alignment, black user-entered values and deep-red calculated results.

1.0.5

• Fine-tuned the simple product inline price assistant alignment.
• Aligned reverse calculated store-price results under the target CNY input column.
• Aligned reverse currency labels under the target currency label column.
• Improved horizontal alignment between left CNY estimates and right store-currency results.
• Kept black user-entered values and deep-red calculated results.

1.0.4

• Reworked the simple product inline pricing assistant into a two-row, two-column layout.
• Displayed reverse calculated store prices as prominent text instead of readonly inputs.
• Unified color semantics: user-entered values stay black, calculated results use deep red.
• Aligned forward CNY estimates and reverse store-currency results on the same result row.
• Kept the live rate footer, compact CNY display and no-auto-save behavior.

1.0.3

• Refined the product price inline assistant layout for WooCommerce simple products.
• Stabilized the target-CNY reverse pricing controls into fixed horizontal columns.
• Improved spacing between currency labels, required store price and Fill buttons.
• Kept CNY payout estimates below the Regular and Sale price fields.
• Kept the shared live-rate footer note and compact CNY display.

1.0.2

• Moved CNY payout results below the WooCommerce Regular and Sale price fields.
• Removed duplicate Estimated payout text from the reverse pricing controls.
• Aligned target-CNY reverse pricing controls on one horizontal row.
• Moved rate source and updated time into one shared bottom note.
• Added compact CNY display formatting for product price estimates.
• Cleaned release package artifacts such as nested ZIP and hidden tool directories.

1.0.1

• Added an inline WooCommerce product price conversion assistant for simple products.
• Added live calculation-currency to CNY payout estimates below Regular and Sale price fields.
• Added independent target-CNY reverse price and fill controls for Regular and Sale price.
• Removed the duplicate product-side calculator box.
• Kept the standalone calculator page and order estimator unchanged.

1.0.0

Initial MVP.