內容簡介
Excelsior Currency Converter 外掛讓您能夠在網站上顯示價格的多種貨幣，並以您的貨幣收款。透過小工具、短碼和區塊，輕鬆實現貨幣轉換和顯示當前匯率。
【主要功能】
• 支援多種貨幣顯示樣式
• 可選擇多個匯率提供者
• 自動與手動匯率更新
• 每種貨幣的手動匯率覆蓋
• 隱藏特定貨幣的支付閘道
• 互動式金額轉換器
外掛標籤
開發者團隊
② 後台搜尋「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.
