外掛標籤
開發者團隊
② 後台搜尋「Shills Multi Currency Manager」→ 直接安裝（推薦）
原文外掛簡介
Shills Multi Currency Manager is a powerful yet lightweight currency switcher plugin for WordPress that allows your visitors to switch between multiple currencies seamlessly. Perfect for e-commerce stores, international businesses, and multilingual websites.
Key Features:
Multi-Currency Management – Add unlimited currencies with custom symbols, positions, and exchange rates
Real-Time Exchange Rates – Automatic rate updates from ExchangeRate-API.com or Open Exchange Rates
WooCommerce Integration – Full compatibility with WooCommerce product prices, cart, and checkout
WPML & Polylang Support – Automatic currency switching based on language selection
Language-Currency Mapping – Map specific currencies to languages (e.g., English → USD, Chinese → CNY)
GeoIP Detection – Auto-detect visitor location and set appropriate currency
Multiple Display Styles – Choose between dropdown or button display formats
REST API – Complete REST API for currency operations and frontend integration
Widget & Shortcode – Easy implementation via widget or [shmcm_switcher] shortcode
Theme Integration – Auto-detect theme colors or set custom colors
User Choice Persistence – Remember visitor currency selection for 30 days
Cache Compatible – Works with WP Rocket, W3 Total Cache, and other caching plugins
Modern JavaScript – Built with Webpack and modern ES6+ JavaScript
Currency Features:
Custom currency symbols and positions (left, right, left_space, right_space)
Configurable decimal places per currency
Manual or automatic exchange rate updates
Base currency support with rate normalization
Currency validation and error handling
WooCommerce Features:
Automatic price conversion on product pages
Cart and checkout price formatting
Order currency metadata storage
Currency display in admin order details
AJAX fragment support for dynamic updates
Multilingual Features:
Automatic currency sync when switching languages
Respect user manual currency selection
Configurable language-currency mappings
Compatible with WPML and Polylang language switchers
Arbitrary section
Development
This plugin is built with modern development practices:
PHP 7.4+ with strict types
WordPress Coding Standards
Webpack for asset building
ES6+ JavaScript
SCSS for styling
REST API architecture
Comprehensive error handling and logging
External Services
This plugin may connect to the following third-party services. All are optional.
ExchangeRate-API.com
* Purpose: Fetches real-time exchange rates when automatic rate updates are enabled.
* Data sent: Only the base currency code (e.g., “USD”) as part of the request URL. No API key or personal data is transmitted.
* When: Only when the admin manually triggers a rate update or when the scheduled auto-update cron runs.
* Service URL: https://www.exchangerate-api.com
* Terms of Service: https://www.exchangerate-api.com/terms
* Privacy Policy: https://www.exchangerate-api.com/privacy
Open Exchange Rates
* Purpose: Fetches real-time exchange rates as an alternative provider when automatic rate updates are enabled.
* Data sent: The API key (configured by the site admin) and base currency code as URL parameters. No user data is transmitted.
* When: Only when the admin manually triggers a rate update or when the scheduled auto-update cron runs.
* Service URL: https://openexchangerates.org
* Terms of Service: https://openexchangerates.org/terms
* Privacy Policy: https://openexchangerates.org/privacy
ipapi.co
* Purpose: GeoIP detection to automatically suggest the visitor’s local currency on their first visit.
* Data sent: The visitor’s IP address is transmitted as part of the HTTP request to ipapi.co. No API key, personal information, or cookies are sent.
* When: Only when a visitor first loads the site and no currency preference cookie is set. Once set, no further GeoIP requests are made.
* Service URL: https://ipapi.co
* Terms of Service: https://ipapi.co/terms/
* Privacy Policy: https://ipapi.co/privacy/
All external services are optional. Select “None – Use Manual Rates” in the General Settings tab to disable all exchange rate API calls. Rate updates only occur on admin-initiated actions or scheduled WordPress cron events; no exchange rate API requests are made during regular frontend visits. GeoIP detection can be disabled in the Multilingual Settings.
Filter Reference
shmcm_currencies – Filter the currencies array
shmcm_exchange_rates – Filter exchange rates before storage
shmcm_price_format – Filter price formatting
shmcm_api_providers – Filter available API providers
shmcm_geo_country_currency_map – Filter GeoIP country-currency mapping
Action Reference
shmcm_currency_switched – Fires when currency is switched
shmcm_rates_updated – Fires when exchange rates are updated
shmcm_language_currency_synced – Fires when language-currency sync occurs
shmcm_activated – Fires on plugin activation
shmcm_deactivated – Fires on plugin deactivation
shmcm_components_loaded – Fires after all components are loaded
REST API Endpoints
All endpoints are under /wp-json/shmcm/v1/:
GET /settings – Get currency switcher settings
POST /switch – Switch currency (sets cookie)
POST /update-rates – Update exchange rates from API
GET /theme-color – Get current theme color
GET /lang-map – Get language-currency mapping
POST /sync-lang – Sync language with currency
GET /currencies – Get all currencies (admin)
POST /currencies – Add new currency (admin)
GET /currency/{code} – Get single currency (admin)
POST /currency/{code} – Update currency (admin)
DELETE /currency/{code} – Delete currency (admin)
Shortcode Parameters
[shmcm_switcher]
display – Display style: dropdown (default) or buttons
theme – Theme mode: auto (default), light, dark, or custom
Example: [shmcm_switcher display="buttons" theme="dark"]
Requirements
PHP 7.4 or higher
WordPress 6.0 or higher
WooCommerce 6.0 or higher (optional, for e-commerce features)
WPML or Polylang (optional, for multilingual features)
Credits
Built with love by Shawn Hills
Special thanks to:
* The WordPress community
* Contributors and testers
* ExchangeRate-API.com and Open Exchange Rates for exchange rate data
* ipapi.co for GeoIP detection
