| 开发者 | baxterjones |
|---|---|
| 更新时间 | 2026年8月26日 20:57 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
[bxtr_currency_switcher]
Optional label:
[bxtr_currency_switcher label="Currency:"]
Display codes, symbols and locally bundled SVG flags, with Basic, Clean and Pill switcher styles that remain easy to override with theme CSS.
Exchange rates and price control
The plugin retrieves daily European Central Bank (ECB) reference rates and stores the latest successful rate set in WordPress.
For each enabled currency, configure its symbol, percentage adjustment, optional manual rate, rounding, decimals and visitor availability. You can also choose the default display currency, switcher format and converted-price format.
Convert custom prices with shortcodes
Configured field on the current post:
[bxtr_currency]
Specific field:
[bxtr_currency field="itinerary_price"]
Specific post:
[bxtr_currency id="123"]
Supplied numeric value:
[bxtr_currency value="2450"]
WooCommerce product price in a custom template:
[bxtr_currency source="woocommerce" id="123"]
Add surrounding text when needed:
[bxtr_currency value="2450" prefix="From " suffix=" per person"]
JavaScript API for dynamic prices
Dynamic controls can use the same selected currency, rates, adjustments, rounding and formatting:
BXTRCurrency.convert(5000)
BXTRCurrency.format(5000)
BXTRCurrency.getCurrency()
BXTRCurrency.getConfig()
Useful for sliders, calculators and configurators where the underlying value remains in the site's base currency.
WooCommerce display behaviour
Automatic WooCommerce conversion supports standard simple, sale and variable product price output on product and shop pages.
Cart, checkout, orders, payments and account pages remain in the WooCommerce store currency.
Some themes and builders bypass WooCommerce's standard price output. In those cases, use the manual WooCommerce shortcode in the custom template.
Live Demo
View the live demo
Documentation
View the documentation
Support
For support, use the public support forum on WordPress.org.
[bxtr_currency_switcher] for the switcher.[bxtr_currency] for custom values, or enable automatic WooCommerce price replacement.No. The plugin converts supported values for display. The original product price, custom-field value or supplied base value remains unchanged.
No. Cart, checkout, orders, payments and account pages continue to use the WooCommerce store currency.
No. It focuses on display conversion while the site keeps one base price and, when applicable, one WooCommerce transaction currency.
No. You can convert direct numeric amounts, ACF fields or standard WordPress custom fields without WooCommerce.
No. If ACF is active, the plugin can retrieve values through ACF. Otherwise it can read the configured field from standard WordPress post meta.
The plugin retrieves the European Central Bank's daily reference-rate XML feed and stores the last successful rates in WordPress.
Yes. Each currency can use a percentage adjustment, manual rate, rounding increment and chosen number of decimal places. A manual rate replaces the calculated ECB cross-rate for that currency before the configured percentage adjustment is applied.
The plugin keeps using the last successfully stored rates. A failed update does not delete the previous rate set.
Check that the source is numeric, the correct field or post ID is used, the target currency is enabled and valid rates are stored. The Tools tab also shows frontend detection status.
Full-page caching varies between hosts and cache plugins. Exclude affected pages from full-page caching or configure the cache to vary by the bxtr_cdc_currency cookie or display_currency query parameter.
Yes. The selected enabled currency code is stored in the bxtr_cdc_currency browser cookie for up to one year.
[bxtr_currency_switcher] as the standard currency switcher shortcode.tools.php?page=currency-switcher.BXTRCurrency.convert(), BXTRCurrency.format(), BXTRCurrency.getCurrency() and BXTRCurrency.getConfig().bxtr:currency-change browser event while preserving the existing selector reload behaviour.