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

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.

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.

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.