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