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.

com

* Purpose: Fetches real-time exchange rates when automatic rate updates are enabled.

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

com

com/terms

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.

org

org/terms

org/privacy

co

* Purpose: GeoIP detection to automatically suggest the visitor’s local currency on their first visit.

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.

co

co/terms/

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

com and Open Exchange Rates for exchange rate data

co for GeoIP detection