Excelsior Currency Converter
| 开发者 | donaldanet1 |
|---|---|
| 更新时间 | 2026年9月1日 01:53 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Excelsior Currency Converter — see your prices in their currency, get paid in yours.
- Currency switcher widget, shortcode, and block.
- Pluggable exchange rate providers: Frankfurter, European Central Bank, and exchangerate.host.
- Cached rates with stale-while-revalidate, manual refresh, and automatic refresh schedules.
- Per-currency manual rate overrides and percentage offsets.
- Unlimited supported currencies and all switcher display styles.
- "Both" display mode — base and converted prices side by side.
- Presentational-only conversion — gateways always charge your base currency.
- Order records and emails show the customer's placed currency.
- Per-currency symbol, position, decimal, and separator formatting.
[excelsior_currency_converter_switcher mode="dropdown|buttons|radio|links|flags" title=""]— the currency switcher in any format.[excelsior_currency_converter_currency_code]— the active currency ISO code.[excelsior_currency_converter_currency_symbol]— the active currency symbol.[excelsior_currency_converter_convert_price amount="10" currency=""]— convert and format a base-currency amount.[excelsior_currency_converter_price_table product_id="123"]— a product's price across every supported currency.
Excelsior Currency Converter — Currency Switcher— place the currency switcher anywhere blocks are supported (post content, widget areas, and site editor templates). Choose a style (dropdown, buttons, radio, links, or flags) and an optional title in the block inspector.
excelsior_currency_converter_convert_amount— filter the converted amount (per-product / per-currency overrides).excelsior_currency_converter_rounding_settings— filter the rounding rule and charm pricing per currency.excelsior_currency_converter_convert_price( $amount, $currency = '' )/excelsior_currency_converter_active_currency()— template helpers.
安装:
- In your WordPress admin, go to Plugins → Add New, search for Excelsior Currency Converter, then click Install Now. Alternatively upload the plugin ZIP under Plugins → Add New → Upload Plugin.
- Click Activate.
- Go to WooCommerce → Settings → Excelsior Currency Converter to set your base currency, supported currencies, exchange-rate provider, refresh schedule, and switcher placement.
屏幕截图:
常见问题:
Will customers be charged in their own currency?
No — conversion is presentational only. Customers see prices in their own currency, but payment gateways always charge your store's base currency. That means no currency-mismatch disputes and no surprise fees.
Which exchange rate providers are supported?
Frankfurter.dev and the European Central Bank need no API key; exchangerate.host needs an API key. Rates refresh manually or on an hourly, twice-daily, or daily schedule.
Does it work with the Cart/Checkout blocks and HPOS?
Yes. It is compatible with the WooCommerce Store API (Cart and Checkout blocks), classic checkout, and HPOS (custom order tables).
Do order records and emails show the right currency?
Every order stores the currency and total the customer saw at checkout. Emails are pinned to that placed currency, so invoices and support conversations stay consistent even when resent later.
更新日志:
1.6.0
- Made per-currency price formatting fully available: its service now loads and registers, settings are rendered in WooCommerce, and values are sanitized and persisted.
- Automatic hourly, twice-daily, and daily exchange-rate refresh schedules are available alongside manual refresh.
- Removed edition upsells, unavailable-feature descriptions, runtime edition gates, and references to absent edition-specific classes from the normal package.
- Retained encrypted API-key storage and hardened generated price markup from the 1.5 release.
- API keys are now encrypted before they are stored in the settings option.
- Fixed: clearing the API key field now also removes the cached per-provider key, so the previously saved key is no longer silently reused.
- Hardened shortcode and order-note output with
wp_kses_postso generated price markup is always sanitized before rendering.
- Fixed the flags-style dropdown changing the navbar height when opened: the dropdown list is now forcibly absolutely positioned (
!important) so it overlays the page instead of being pulled into the menu's flow by theme rules like Astra's.main-navigation ul { position: relative }. - Switcher CSS/JS are now enqueued with file-modified-time versions so style/script changes are never served stale from the browser cache.
- Reworked the header switcher placement: the “Site header” option now places the currency switcher in the navigation menu, appended after the last item (e.g. after “Checkout”), so it is reliably visible on any theme instead of trying to sit beside the page title.
- Redesigned the switcher UI: dropdown, buttons, radio, and links formats now share the polished pill/segmented look of the flags style, and each currency shows its flag. Buttons render as a segmented control, radio as pill chips with a custom indicator, and links as pill chips with the active currency highlighted.
- Fresh-install defaults: base currency follows the store's WooCommerce currency; supported currencies default to EUR, GBP, USD; provider defaults to the European Central Bank; manual-rate and offset rows are pre-seeded for each supported currency; switcher placement defaults to floating bottom-left with the flags style; rounding is off and display mode is converted-only.
- Added a new switcher placement: “Site header — next to the page title”, which shows the currency switcher beside the site title on any theme (previously the header placement only worked on Storefront).
- Added the European Central Bank as a free exchange-rate provider (no API key required).
- Added per-currency manual rate overrides and percentage offsets in the Excelsior Currency Converter settings tab.
- Added per-currency price formatting for symbols, positions, decimals, and separators.
- Order totals are now converted for display everywhere a customer sees a figure: order-received (thank you), order-pay, My Account order details, and order emails. Previously stored orders showed the base amount under the active-currency symbol (e.g. £149 instead of the converted amount); the amount and symbol are now always consistent.
- Cart/Checkout block orders now record the displayed currency and exchange rate (the Store API never fires the classic checkout-create hook, so the order meta was never saved for block checkouts).
- Replaced platform-dependent flag emoji with bundled local SVG flags so the flags switcher renders consistently on Windows, Cart, and Checkout without external requests.
- Fixed a late WooCommerce Blocks hydration race that could overwrite the cleared cart snapshot with base-currency data. Cart and Checkout now validate the registered cart store and refetch until its currency matches the active display currency.
- Fixed stale base-currency cart amounts reappearing when navigating between Cart and Checkout. Browser history restores now clear persisted snapshots and immediately refresh the WooCommerce Blocks cart store, without the previous unconditional second page load.
- Fixed the Cart and Checkout blocks showing base-currency amounts under the active-currency symbol on first load. The blocks preload cart data through an internal REST dispatch that bypassed the previous conversion hook; conversion now runs on
rest_request_after_callbacks, which also covers preloaded and batched requests. Conversion is now idempotent so no amount is ever converted twice.
- Fixed the flags-style switcher toggle text becoming invisible on hover by using an explicit text color instead of inheriting the theme's.
- Renamed the plugin to Excelsior Currency Converter. Internal settings, cached exchange rates, and stored data are unchanged.
- Fixed converted prices in the Cart and Checkout blocks when data loads through the Store API
batchendpoint (amounts could appear in the base currency with the active currency symbol). - "Both" display mode now shows the base price with the base currency symbol.
- The currency switcher now shows each currency's own symbol regardless of the active currency.
- Security: currency switching now runs only through the nonce-verified handler; removed the unauthenticated switch path.
- Fixed automatic refresh intervals not saving.
- Rounding is applied consistently across classic and Blocks, and charm pricing no longer touches tax, shipping, or fee amounts.
- Stored order totals (account, order-received, emails) are no longer re-converted.
- Added
[excelsior_currency_converter_currency_code],[excelsior_currency_converter_currency_symbol],[excelsior_currency_converter_convert_price], and[excelsior_currency_converter_price_table]shortcodes. - Added
radioandlinksswitcher formats. - Added
excelsior_currency_converter_convert_amountandexcelsior_currency_converter_rounding_settingsfilters plusexcelsior_currency_converter_convert_price()/excelsior_currency_converter_active_currency()helpers. - Added a Currency Converter section to WooCommerce → Status → System status.
- Added a Switcher placement setting: site header, any screen corner (floating), manual-only, or hidden from visitors (admin-only currency control).
- Added a Switcher style setting including a Flags style (country flag + code + symbol) with a
excelsior_currency_converter_currency_flag_htmlfilter for image flags.
- Inject an early inline script that clears the WooCommerce Blocks cart snapshot before
wc/store/cartregisters. - Add
Cache-Control: no-store+Vary: excelsior_currency_converter_currencyto Cart and Checkout pages when the active currency differs from base, preventing bfcache / disk-cache from replaying stale base values. - Move runtime URL parsing inside
DOMContentLoadedso the switcher IIFE no longer throwsdocument is not definedon early-included pages.
- Forced a fresh Store API cart response on Cart/Checkout pages when the display currency differs from the base.
- Kept WooCommerce payment currency and shipping calculations in base currency.
- Added Cart and Checkout Blocks disclaimer support.
- Improved multisite uninstall, cron cleanup, and cart-fragment refresh behavior.
- Hardened Store API conversion and currency-aware cart cache handling.
- Updated compatibility metadata and cleanup behavior.
- Initial release.