{"id":334859,"date":"2026-07-08T05:11:11","date_gmt":"2026-07-08T05:11:11","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/shills-simple-currency-switcher\/"},"modified":"2026-07-08T05:10:58","modified_gmt":"2026-07-08T05:10:58","slug":"shills-multi-currency-manager","status":"publish","type":"plugin","link":"https:\/\/test.wordpress.org\/plugins\/shills-multi-currency-manager\/","author":23464285,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Shills Multi Currency Manager","header_author":"shawn hills","header_description":"Lightweight multi-currency manager for WooCommerce. Supports real-time exchange rates, WPML\/Polylang integration, GeoIP detection, and frontend currency switcher.","assets_banners_color":"706c95","last_updated":"2026-07-08 05:10:58","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":18,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"shawnhills","date":"2026-07-08 05:10:58"}},"upgrade_notice":{"1.0.0":"<p>First release - no upgrade needed!<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3599779,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3599779,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3599779,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500-rtl.png":{"filename":"banner-1544x500-rtl.png","revision":3599797,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3599797,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250-rtl.png":{"filename":"banner-772x250-rtl.png","revision":3599797,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3599797,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Currency management interface with add\/edit\/delete functionality","2":"Exchange rate settings with multiple API providers","3":"Multilingual settings with language-currency mapping","4":"Frontend switcher showing dropdown and button styles","5":"WooCommerce integration showing converted prices","6":"Widget configuration in the block editor"}},"plugin_section":[],"plugin_tags":[21294,21292,24514,99,286],"plugin_category":[45,48],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-334859","plugin","type-plugin","status-publish","hentry","plugin_tags-currency-switcher","plugin_tags-exchange-rates","plugin_tags-multi-currency","plugin_tags-multilingual","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-language-tools","plugin_committers-shawnhills"],"banners":{"banner":"https:\/\/ps.w.org\/shills-multi-currency-manager\/assets\/banner-772x250.png?rev=3599797","banner_2x":"https:\/\/ps.w.org\/shills-multi-currency-manager\/assets\/banner-1544x500.png?rev=3599797","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/shills-multi-currency-manager\/assets\/icon.svg?rev=3599779","icon":"https:\/\/ps.w.org\/shills-multi-currency-manager\/assets\/icon.svg?rev=3599779","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<p><strong>Key Features:<\/strong><\/p>\n\n<ul>\n<li><strong>Multi-Currency Management<\/strong> - Add unlimited currencies with custom symbols, positions, and exchange rates<\/li>\n<li><strong>Real-Time Exchange Rates<\/strong> - Automatic rate updates from ExchangeRate-API.com or Open Exchange Rates<\/li>\n<li><strong>WooCommerce Integration<\/strong> - Full compatibility with WooCommerce product prices, cart, and checkout<\/li>\n<li><strong>WPML &amp; Polylang Support<\/strong> - Automatic currency switching based on language selection<\/li>\n<li><strong>Language-Currency Mapping<\/strong> - Map specific currencies to languages (e.g., English \u2192 USD, Chinese \u2192 CNY)<\/li>\n<li><strong>GeoIP Detection<\/strong> - Auto-detect visitor location and set appropriate currency<\/li>\n<li><strong>Multiple Display Styles<\/strong> - Choose between dropdown or button display formats<\/li>\n<li><strong>REST API<\/strong> - Complete REST API for currency operations and frontend integration<\/li>\n<li><strong>Widget &amp; Shortcode<\/strong> - Easy implementation via widget or <code>[shmcm_switcher]<\/code> shortcode<\/li>\n<li><strong>Theme Integration<\/strong> - Auto-detect theme colors or set custom colors<\/li>\n<li><strong>User Choice Persistence<\/strong> - Remember visitor currency selection for 30 days<\/li>\n<li><strong>Cache Compatible<\/strong> - Works with WP Rocket, W3 Total Cache, and other caching plugins<\/li>\n<li><strong>Modern JavaScript<\/strong> - Built with Webpack and modern ES6+ JavaScript<\/li>\n<\/ul>\n\n<p><strong>Currency Features:<\/strong><\/p>\n\n<ul>\n<li>Custom currency symbols and positions (left, right, left_space, right_space)<\/li>\n<li>Configurable decimal places per currency<\/li>\n<li>Manual or automatic exchange rate updates<\/li>\n<li>Base currency support with rate normalization<\/li>\n<li>Currency validation and error handling<\/li>\n<\/ul>\n\n<p><strong>WooCommerce Features:<\/strong><\/p>\n\n<ul>\n<li>Automatic price conversion on product pages<\/li>\n<li>Cart and checkout price formatting<\/li>\n<li>Order currency metadata storage<\/li>\n<li>Currency display in admin order details<\/li>\n<li>AJAX fragment support for dynamic updates<\/li>\n<\/ul>\n\n<p><strong>Multilingual Features:<\/strong><\/p>\n\n<ul>\n<li>Automatic currency sync when switching languages<\/li>\n<li>Respect user manual currency selection<\/li>\n<li>Configurable language-currency mappings<\/li>\n<li>Compatible with WPML and Polylang language switchers<\/li>\n<\/ul>\n\n<h3>Arbitrary section<\/h3>\n\n<p><strong>Development<\/strong><\/p>\n\n<p>This plugin is built with modern development practices:<\/p>\n\n<ul>\n<li>PHP 7.4+ with strict types<\/li>\n<li>WordPress Coding Standards<\/li>\n<li>Webpack for asset building<\/li>\n<li>ES6+ JavaScript<\/li>\n<li>SCSS for styling<\/li>\n<li>REST API architecture<\/li>\n<li>Comprehensive error handling and logging<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>This plugin may connect to the following third-party services. All are optional.<\/p>\n\n<p><strong>ExchangeRate-API.com<\/strong>\n* Purpose: Fetches real-time exchange rates when automatic rate updates are enabled.\n* Data sent: Only the base currency code (e.g., \"USD\") as part of the request URL. No API key or personal data is transmitted.\n* When: Only when the admin manually triggers a rate update or when the scheduled auto-update cron runs.\n* Service URL: https:\/\/www.exchangerate-api.com\n* Terms of Service: https:\/\/www.exchangerate-api.com\/terms\n* Privacy Policy: https:\/\/www.exchangerate-api.com\/privacy<\/p>\n\n<p><strong>Open Exchange Rates<\/strong>\n* Purpose: Fetches real-time exchange rates as an alternative provider when automatic rate updates are enabled.\n* Data sent: The API key (configured by the site admin) and base currency code as URL parameters. No user data is transmitted.\n* When: Only when the admin manually triggers a rate update or when the scheduled auto-update cron runs.\n* Service URL: https:\/\/openexchangerates.org\n* Terms of Service: https:\/\/openexchangerates.org\/terms\n* Privacy Policy: https:\/\/openexchangerates.org\/privacy<\/p>\n\n<p><strong>ipapi.co<\/strong>\n* Purpose: GeoIP detection to automatically suggest the visitor's local currency on their first visit.\n* 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.\n* When: Only when a visitor first loads the site and no currency preference cookie is set. Once set, no further GeoIP requests are made.\n* Service URL: https:\/\/ipapi.co\n* Terms of Service: https:\/\/ipapi.co\/terms\/\n* Privacy Policy: https:\/\/ipapi.co\/privacy\/<\/p>\n\n<p>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.<\/p>\n\n<h3>Filter Reference<\/h3>\n\n<ul>\n<li><code>shmcm_currencies<\/code> - Filter the currencies array<\/li>\n<li><code>shmcm_exchange_rates<\/code> - Filter exchange rates before storage<\/li>\n<li><code>shmcm_price_format<\/code> - Filter price formatting<\/li>\n<li><code>shmcm_api_providers<\/code> - Filter available API providers<\/li>\n<li><code>shmcm_geo_country_currency_map<\/code> - Filter GeoIP country-currency mapping<\/li>\n<\/ul>\n\n<h3>Action Reference<\/h3>\n\n<ul>\n<li><code>shmcm_currency_switched<\/code> - Fires when currency is switched<\/li>\n<li><code>shmcm_rates_updated<\/code> - Fires when exchange rates are updated<\/li>\n<li><code>shmcm_language_currency_synced<\/code> - Fires when language-currency sync occurs<\/li>\n<li><code>shmcm_activated<\/code> - Fires on plugin activation<\/li>\n<li><code>shmcm_deactivated<\/code> - Fires on plugin deactivation<\/li>\n<li><code>shmcm_components_loaded<\/code> - Fires after all components are loaded<\/li>\n<\/ul>\n\n<h3>REST API Endpoints<\/h3>\n\n<p>All endpoints are under <code>\/wp-json\/shmcm\/v1\/<\/code>:<\/p>\n\n<ul>\n<li><code>GET \/settings<\/code> - Get currency switcher settings<\/li>\n<li><code>POST \/switch<\/code> - Switch currency (sets cookie)<\/li>\n<li><code>POST \/update-rates<\/code> - Update exchange rates from API<\/li>\n<li><code>GET \/theme-color<\/code> - Get current theme color<\/li>\n<li><code>GET \/lang-map<\/code> - Get language-currency mapping<\/li>\n<li><code>POST \/sync-lang<\/code> - Sync language with currency<\/li>\n<li><code>GET \/currencies<\/code> - Get all currencies (admin)<\/li>\n<li><code>POST \/currencies<\/code> - Add new currency (admin)<\/li>\n<li><code>GET \/currency\/{code}<\/code> - Get single currency (admin)<\/li>\n<li><code>POST \/currency\/{code}<\/code> - Update currency (admin)<\/li>\n<li><code>DELETE \/currency\/{code}<\/code> - Delete currency (admin)<\/li>\n<\/ul>\n\n<h3>Shortcode Parameters<\/h3>\n\n<pre><code>[shmcm_switcher]\n<\/code><\/pre>\n\n<ul>\n<li><code>display<\/code> - Display style: <code>dropdown<\/code> (default) or <code>buttons<\/code><\/li>\n<li><code>theme<\/code> - Theme mode: <code>auto<\/code> (default), <code>light<\/code>, <code>dark<\/code>, or <code>custom<\/code><\/li>\n<\/ul>\n\n<p>Example: <code>[shmcm_switcher display=\"buttons\" theme=\"dark\"]<\/code><\/p>\n\n<h3>Requirements<\/h3>\n\n<ul>\n<li>PHP 7.4 or higher<\/li>\n<li>WordPress 6.0 or higher<\/li>\n<li>WooCommerce 6.0 or higher (optional, for e-commerce features)<\/li>\n<li>WPML or Polylang (optional, for multilingual features)<\/li>\n<\/ul>\n\n<h3>Credits<\/h3>\n\n<p>Built with love by Shawn Hills<\/p>\n\n<p>Special thanks to:\n* The WordPress community\n* Contributors and testers\n* ExchangeRate-API.com and Open Exchange Rates for exchange rate data\n* ipapi.co for GeoIP detection<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>shills-multi-currency-manager<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to <strong>Settings \u2192 Currency Switcher<\/strong> to configure currencies and settings<\/li>\n<li>Add the currency switcher to your site using:\n\n<ul>\n<li>Widget: Go to <strong>Appearance \u2192 Widgets<\/strong> and add \"Currency Switcher\"<\/li>\n<li>Shortcode: <code>[shmcm_switcher]<\/code> in posts, pages, or templates<\/li>\n<li>PHP: <code>&lt;?php echo do_shortcode('[shmcm_switcher]'); ?&gt;<\/code><\/li>\n<\/ul><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20add%20a%20new%20currency%3F\"><h3>How do I add a new currency?<\/h3><\/dt>\n<dd><p>Go to <strong>Settings \u2192 Currency Switcher \u2192 Currencies<\/strong> and click \"Add Currency\". Enter the currency code, symbol, exchange rate, and other settings.<\/p><\/dd>\n<dt id=\"how%20do%20i%20enable%20automatic%20exchange%20rate%20updates%3F\"><h3>How do I enable automatic exchange rate updates?<\/h3><\/dt>\n<dd><p>Go to <strong>Settings \u2192 Currency Switcher \u2192 General Settings<\/strong> and select an API provider (ExchangeRate-API.com or Open Exchange Rates). You can also set the auto-update frequency.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20work%20with%20woocommerce%3F\"><h3>Does this plugin work with WooCommerce?<\/h3><\/dt>\n<dd><p>Yes! The plugin fully integrates with WooCommerce and automatically converts product prices, cart totals, and checkout amounts.<\/p><\/dd>\n<dt id=\"can%20i%20sync%20currency%20with%20language%20selection%3F\"><h3>Can I sync currency with language selection?<\/h3><\/dt>\n<dd><p>Yes! Go to <strong>Settings \u2192 Currency Switcher \u2192 Multilingual Settings<\/strong> and enable \"Auto Sync\". Then map languages to currencies (e.g., English \u2192 USD, Spanish \u2192 EUR).<\/p><\/dd>\n<dt id=\"what%20multilingual%20plugins%20are%20supported%3F\"><h3>What multilingual plugins are supported?<\/h3><\/dt>\n<dd><p>WPML and Polylang are fully supported with automatic currency switching.<\/p><\/dd>\n<dt id=\"can%20i%20display%20the%20switcher%20as%20buttons%20instead%20of%20dropdown%3F\"><h3>Can I display the switcher as buttons instead of dropdown?<\/h3><\/dt>\n<dd><p>Yes! Use the shortcode <code>[shmcm_switcher display=\"buttons\"]<\/code> or select \"Buttons\" in the widget settings.<\/p><\/dd>\n<dt id=\"how%20do%20i%20set%20a%20custom%20color%20for%20the%20switcher%3F\"><h3>How do I set a custom color for the switcher?<\/h3><\/dt>\n<dd><p>Go to <strong>Settings \u2192 Currency Switcher \u2192 Appearance<\/strong> and select \"Custom\" theme mode, then choose your color.<\/p><\/dd>\n<dt id=\"is%20this%20plugin%20compatible%20with%20caching%20plugins%3F\"><h3>Is this plugin compatible with caching plugins?<\/h3><\/dt>\n<dd><p>Yes! The plugin adds <code>Vary: Cookie<\/code> headers and works with WP Rocket, W3 Total Cache, and other caching plugins.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Multi-currency management with unlimited currencies<\/li>\n<li>Real-time exchange rate updates from multiple providers<\/li>\n<li>WooCommerce integration with price conversion<\/li>\n<li>WPML and Polylang multilingual support<\/li>\n<li>Language-currency automatic sync<\/li>\n<li>REST API for all currency operations<\/li>\n<li>Widget and shortcode support<\/li>\n<li>GeoIP detection for automatic currency selection<\/li>\n<li>Modern JavaScript with Webpack build system<\/li>\n<li>Cache compatibility with major caching plugins<\/li>\n<\/ul>","raw_excerpt":"Lightweight multi-currency manager for WooCommerce with real-time rates, WPML\/Polylang support, GeoIP detection, and frontend switcher.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/334859","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=334859"}],"author":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/shawnhills"}],"wp:attachment":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=334859"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=334859"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=334859"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=334859"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=334859"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=334859"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}