The switcher does not appear.
The switcher only shows when there is something to switch to. Check that:
- At least one extra currency has a rate. A currency with automatic rate ticked is not offered until its first rate has arrived; save the settings once to fetch it straight away.
- The code is a real three-letter code and is not your base currency — either is dropped on save.
- You have put a switcher somewhere: the Sticky switcher bar, a Currency Switcher block, or
[gatemi_currency_switcher].
Full edition: check the Display tab — the sidebar only appears on the pages ticked under Show the sidebar on these pages, and the menu item only on those under Show the menu item on these pages.
My automatic rate never updates.
Rates are fetched by a WordPress scheduled task, which only runs when the site has visitors (or a real server cron calls wp-cron.php). On a quiet site, set up a server cron. Also check that your server can reach gatemi.com and open.er-api.com — a firewall that blocks both means the last good rate is kept, because a failed fetch never changes a rate.
Can I type my own rate and never have it change?
Yes. Untick automatic rate (free) or choose Fixed (set by you) (full edition) and type the rate.
Visitors from abroad still see my base currency.
Location detection is off by default in the free edition — tick Visitor detection. It also needs WooCommerce's own geolocation to work: under WooCommerce → Settings → General, set Default customer location to a geolocation option and connect MaxMind as WooCommerce asks. Detection only picks currencies you have added, and only on a visitor's first visit. A visitor who has already chosen a currency keeps it.
Does it work with my page cache?
Yes, with care. The plugin tells WP Rocket and LiteSpeed Cache to keep a separate copy per currency cookie, and the request that changes currency is never cached. With another full-page cache, configure it to vary on the gmcswf_currency cookie (free) or gatemi_csw_currency (full edition), or exclude the cart and checkout. Without that, a cache can show one visitor a page priced in another visitor's currency.
Are shipping, fees and coupons converted?
Yes, in both editions: shipping rates and their taxes, cart fees, fixed coupon amounts and coupon spend limits all convert at the currency's rate. (Free-edition versions before this fix converted product prices only.)
Is a variable product's price range converted?
Yes, in both editions. The range on listings ("10.00 – 20.00") is converted, and WooCommerce's price cache is kept separate per currency, so one shopper's range is never served to another.
Can I stop a payment method being offered in one currency?
Yes. Under that currency's Payment gateways, tick only the methods that should be offered. With none ticked, all are offered.
Can customers browse in their currency but pay in mine?
Full edition. On the Checkout tab, turn off Let customers pay in their selected currency. Orders are then charged in your base currency, with the converted amount shown beside it for reference.
Does it work with the Cart and Checkout blocks?
Yes. The currency is read from the shopper's cookie on every request, including the Store API requests the blocks make, so the block cart and checkout are priced and labelled in the chosen currency, and the payment methods offered follow your per-currency choice. The order is stamped with its rate on the Checkout block as well as the classic checkout.
Does it work with HPOS?
Yes. Both editions declare compatibility with High-Performance Order Storage, and order data is written through WooCommerce's order API.
How many currencies can I have?
Three extra currencies in the free edition — four in all, counting your base currency. Any number in the full edition.
Can I see what an order was worth in my own currency?
Yes. Each order stores the rate used and its totals converted back into your base currency; see the Developer reference.
I'm moving to the full edition. Are my settings kept?
Your currencies are. The first time the full edition loads and has no currencies of its own, it copies the free edition's — each code, its rate, automatic or manual, symbol position and decimals — and the GeoIP choice. Each currency's payment-gateway mapping comes across to the Checkout tab. Charm pricing comes across as a Price rules rule (round up to the nearest 1, ending .99, in every range) when every currency had it on with no rounding increment — the one case the full edition's store-wide price rules reproduce exactly. A rounding increment, or charm pricing on some currencies and not others, has no exact equivalent there, so set those on Price rules yourself. Nothing you already set in the full edition is overwritten, and a store that upgraded before this was carried gets the mapping and the charm rule filled in once. The Currency Switcher blocks keep working because both editions register them under the same names, and the full edition also answers the free edition's [gatemi_currency_switcher] shortcode. Then deactivate and delete the free edition — its settings are never removed by the full edition.
What does uninstalling remove?
- Free edition: its settings, its scheduled rate update, and the per-currency Name Your Price bounds its compatibility module stored.
- Full edition: all of its
gatemi_csw_*settings and its licence. - Neither touches your products, their prices or your orders. The rate recorded on past orders stays.
