Installation and requirements
Requirements
| Requirement | Minimum version |
|---|---|
| WordPress | 6.6 |
| PHP | 7.4 |
| WooCommerce | 7.4 |
This is the only page on this site that states these floors — see them here, not elsewhere.
Install the plugin
- Upload the
mhm-currency-switcherfolder to/wp-content/plugins/, or install it directly from the WordPress plugin screen. - Activate it from the Plugins menu.
- Make sure WooCommerce is installed and active — the plugin does nothing without it, and shows an admin notice saying so.
- Go to WooCommerce > MHM Currency.
You need the manage_woocommerce capability to see the settings screen (the Shop manager and Administrator roles have it by default).
What you get right after activation
- The currency list starts empty. No currencies are pre-added; you add the ones you want.
- Geolocation detection starts off (since 2.2.0). Working out a visitor's country from their IP address is data processing, so it's left for you to switch on deliberately. Stores that upgrade keep whatever they had already chosen.
- The switcher's appearance starts with these defaults: flag on, symbol on, code on, currency name off, size Medium.
- Cache compatibility mode starts on — see Advanced settings for what that does.
Your store's base currency always comes from WooCommerce's own settings (WooCommerce > Settings > General > Currency options). You cannot add the base currency to the plugin's currency list — it is already the conversion's starting point.
The four settings tabs
| Tab | What it holds |
|---|---|
| Manage Currencies | The currency list: rate, fee, rounding, ordering |
| Display Options | The switcher's appearance and the product price widget |
| Advanced | Geolocation, the automatic rate-update schedule, and cache compatibility |
| How to use | Copyable snippets for every place the switcher can be placed on your site |
Unsaved changes show a bar at the top of the screen. Save Changes appears both in that bar and at the bottom of the page, and saves all four tabs in one request.
Languages
The plugin ships in English and Turkish. On a site whose language is Turkish and that runs WordPress 6.8 or later, the whole plugin appears in Turkish; on 6.6 and 6.7 part of it stays in English — see Known limits. Translations into other languages are made on translate.wordpress.org, where anyone with a WordPress.org account can contribute.
The full FAQ is on the FAQ page; the full list of known limits is on the Known limits page.