Description

Baxtersweb Currency Display Converter converts display values only. It does not process payments, change WooCommerce transactions or alter the store currency.

Choose an ACF field, a WooCommerce product price or a direct shortcode amount as the value source. Visitors can then select a display currency using a configurable selector with optional local SVG flags.

The plugin retrieves reference exchange rates from the European Central Bank, stores the last successful rates locally, and supports manual overrides, buffers and rounding.

External service disclosure:
This plugin requests the European Central Bank daily exchange-rate XML feed at https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml. No visitor or website data is sent. The request is made to retrieve public reference exchange rates. ECB reference rates are informational and may not match transaction rates.

Shortcodes:
[bxtr_currency]
[bxtr_currency source=”woocommerce”]
[bxtr_currency id=”123″]
[bxtr_currency id=”{{ _layout.object_id }}”] — for Advanced Views Layout loops
[bxtr_currency field=”itinerary_price”]
[bxtr_currency amount=”2450″]
[bxtr_currency_selector]
[bxtr_currency_selector label=”Currency:”]

External services

Baxtersweb Currency Display Converter connects to the European Central Bank Data Portal API to retrieve currency exchange rates used by the plugin.

The plugin sends requests containing the selected base currency, requested currencies and relevant date or rate parameters. These requests are made when exchange-rate data needs to be retrieved or refreshed. No WordPress user account details, customer information, form submissions or payment information are intentionally sent by the plugin.

The exchange-rate service is provided by the European Central Bank:

API information: https://data.ecb.europa.eu/help/api/overview
Disclaimer and copyright: https://www.ecb.europa.eu/services/using-our-site/disclaimer/html/index.en.html
ECB Data Portal privacy statement: https://data.ecb.europa.eu/privacy-statement-ecb-data-portal

By using the plugin’s currency-conversion functionality, data requests are sent from the website server to this external service.

Installation

Upload and activate the plugin.
Open Tools > Currency Converter.
Choose ACF or WooCommerce as the price source.
Configure currencies, display formats and rate settings.
Add the price and selector shortcodes where required.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Baxtersweb Currency Display Converter” is open source software. The following people have contributed to this plugin.

Baxter Jones

Translate “Baxtersweb Currency Display Converter” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.3.3

Added clear documentation describing the external European Central Bank exchange-rate service, the data sent and the applicable privacy and usage information.
Corrected the placement of PHPCS output-escaping annotations for the generated currency table rows and JavaScript row template.
No conversion behaviour or settings were changed.

0.3.2

Resolved WordPress coding standards and Plugin Check findings.
Added the required GPL licence details to the plugin header.
Removed unnecessary manual translation loading and the unused language directory declaration.
Improved escaping documentation, translator context and safe handling of public currency query parameters.
Prefixed uninstall variables and documented the standard cache-control constant.

0.3.1

Moved all four setup steps into the Setup tab.
Renamed the secondary tab to Tools.
Added instant price-source guidance and selector preview updates.
Separated exchange-rate controls from uninstall settings.
Improved implementation examples and source-specific troubleshooting.
Fixed diagnostic status rendering and aligned the admin header title with its action pills.

0.3.0

Added a guided five-step setup and source-specific troubleshooting.
WooCommerce now uses the detected store currency as the authoritative base currency.
Added frontend diagnostics for selector, converted price and WooCommerce price-filter detection.
Added Docs and Demo links to the plugin metadata row.
Added value as a clearer alias for direct and Advanced Views shortcode values.
Preserved settings correctly when saving either admin tab.

0.2.1

Reworked the admin into a clear single-page layout.
Corrected the admin header and added consistent Docs, Demo and Version pills.
Added a selector preview and clearer currency adjustment guidance.
Added automatic WooCommerce product price display conversion.
Added a setting to retain or remove plugin data on uninstall.
Changed the public query parameter to display_currency.
Reduced frontend styling so selectors inherit more from the active theme.
Corrected the South African flag.
Expanded shortcode guidance.

0.2.0

Added WooCommerce product prices as a selectable display source.
Replaced manually typed currency codes with a supported currency dropdown.
Added locally bundled SVG flags and a setting to disable them.
Added configurable currency selector and converted price formats.
Added Docs and Demo links to the plugin header.
Standardised the text domain and bxtr_ code prefix conventions.
Split the plugin into focused admin, frontend, currency registry and rate classes.

0.1.4

Organised the plugin dashboard into Dashboard, Settings, Currencies and Shortcodes tabs.
Added the Advanced Views loop shortcode to the Shortcodes tab and readme.