Excelsior Currency Converter

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, exchangerate.host, National Bank of Poland, National Bank of Georgia, and Bank of Israel.

• Cached rates with stale-while-revalidate, manual refresh, and automatic refresh schedules.

• Per-currency manual rate overrides and percentage offsets.

• Per-currency rate safety limits (floor/ceiling) to guard against provider glitches; saving changed limits refreshes rates immediately.

• Currency converter widget and shortcode — convert any amount between your currencies.

• Currency rates widget and shortcode — show current exchange rates relative to your base currency.

• Payment-gateway rules — hide specific gateways for specific display currencies.

• 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.

Shortcodes

• [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_converter] — an interactive amount converter (amount + from/to currency).

• [excelsior_currency_converter_rates] — a table of exchange rates relative to the base currency.

• [excelsior_currency_converter_rate_limits] — a diagnostic table showing cached fetched rates, configured safety limits, and limiter status.

Widgets

• Currency Switcher — the currency switcher.

• Currency Rates — exchange rates relative to the store base currency.

• Currency Converter — an interactive amount converter.

Blocks

• 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.

Developer Hooks

• 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.

External services

Excelsior Currency Converter does not track visitors, serve ads, or collect personal data for marketing. It contacts only the exchange-rate provider selected by an administrator, and only when rates are manually or automatically refreshed. These requests are made by the store server, not by a shopper’s browser.

The provider receives the store server’s IP address as part of a normal HTTP request and the requested base/target currency codes. No customer, order, cart, product, or payment data is sent.

• Frankfurter supplies current exchange rates. The plugin sends the base currency code when rates are refreshed. The public service requires no account or API key. Frankfurter states in its service FAQ and privacy information that the API does not collect personal data, although its public site is behind Cloudflare. Its open-source service is provided under the MIT license; it does not publish a separate terms-of-service page.

• European Central Bank (ECB) supplies daily euro reference rates. The plugin downloads the ECB’s public XML feed when rates are refreshed; no currency, customer, or store data is added to the request. See the ECB disclaimer and copyright terms and website privacy statement.

• exchangerate.host supplies current exchange rates when selected. The plugin sends the administrator’s API key, base currency code, and target currency codes when rates are refreshed. See exchangerate.host’s terms of use and privacy policy.

• National Bank of Poland (NBP) supplies the zloty-anchored daily average rates from api.nbp.pl when selected. No API key is required.

• National Bank of Georgia (NBG) supplies lari-anchored daily rates from nbg.gov.ge when selected. No API key is required.

• Bank of Israel (BOI) supplies shekel-anchored daily rates from boi.org.il when selected. No API key is required.

If no provider is selected or no refresh occurs, the plugin makes no exchange-rate request. Provider use is subject to the linked provider policies.

Data stored locally: exchange rates are cached in WordPress transients; your currency preference is saved in a browser cookie / localStorage; order records store the displayed currency and exchange rate. Nothing is shared with third parties other than the provider calls described above.

Bundled assets: the currency flag icons come from the flag-icons project (MIT license, GPL-compatible) and are served locally from this plugin — no external image requests.