Multi-Currency Support in Optiontics

Overview #

Multi-currency support in Optiontics converts your product addon prices into whichever currency the shopper is browsing in. It works alongside a currency switcher plugin such as CURCY or FOX, so a $5 topping shows as €4.60 to a European customer, and the cart charges that same amount.

Currency switcher plugins convert product prices, but they cannot see Optiontics addon prices. Those are stored separately and never pass through WooCommerce’s pricing pipeline. Without this integration, your product price switches to euros while your addons stay in dollars, wearing a euro sign. The number is wrong and the cart total will not match what the shopper expected.

Requirements #

• WooCommerce installed and active.
• Optiontics Pro, which is where currency conversion lives. The free plugin does not convert addon prices.
• One multi-currency plugin, either CURCY – Multi Currency for WooCommerce or FOX – Currency Switcher for WooCommerce.
• At least one Optiontics option block with priced choices assigned to a product.

Note: Other multi-currency plugins work on a best-effort basis. See the FAQ below.

Step 1: Set Up Your Currency Plugin #

Install and activate either CURCY or FOX, then add the currencies you want to sell in.

1. Install your chosen plugin from Plugins → Add New.
2. Open its settings and add each currency alongside your shop’s base currency.
3. Set an exchange rate for each one, or turn on automatic rates.
4. Place the plugin’s currency switcher on your site so shoppers can change currency.

FOX does not display a switcher by default. Add its [woocs] shortcode to a page or header, add the WOOCS_SELECTOR widget to a sidebar, or turn on its side switcher. CURCY places one for you.

Step 2: Turn On the Multi-Currency Module #

Optiontics ships with conversion switched off, so nothing about your prices changes until you decide.

1. Go to Optiontics → Settings.
2. Select Integrations in the left sidebar.
3. Find the Multi-currency card.
4. Switch it on.

The setting saves right away. There is no save button on this card.

Step 3: Confirm What Optiontics Detected #

The card tells you which currency plugin it found and which currencies your shoppers can switch into. Use it to check your setup before testing the storefront.

When everything is working the card reads Converting through your plugin’s name, followed by the currencies shoppers can switch into. If it says the plugin was detected but conversion is off, the switch is still off, so turn it on. No multi-currency plugin detected means you need to install CURCY or FOX first, and the switch stays disabled until you do.

Two other messages are worth knowing. Converting, best effort means your plugin is not one Optiontics recognises, so prices convert using a rate read from the storefront. Nothing to convert means the module is on but no currency plugin is active, and conversion resumes as soon as you activate one.

The card lists your configured currencies rather than a live exchange rate. A live rate would only reflect your own admin session, not what your shoppers see.

Step 4: Check a Product on the Storefront #

Test with a real product before you announce anything.

1. Open a product that has an Optiontics option block with priced choices.
2. Note the addon prices and the total in your base currency.
3. Switch to another currency using your plugin’s switcher.
4. Check that every addon price changed by the exchange rate, not just the currency symbol.
5. Add the product to the cart and confirm the cart subtotal matches the total the product page showed.

That last check is the important one. The product page and the cart should always agree, because the cart is what the customer pays.

Step 5: Turn It Off If You Need To #

Switching the module off returns Optiontics to how it behaved before, with addon prices left in your shop’s base currency. Use it if your currency plugin already handles addon pricing some other way, or if conversion conflicts with your setup.

Orders keep recording the currency and exchange rate they were placed at even while the module is off. Rates move over time, so this record is what lets you reconcile an old order later. It changes nothing your customers see.

Frequently Asked Questions (FAQ) #

Q1: My addon prices show the euro sign but the dollar amount. What is wrong? The multi-currency module is switched off. Your currency plugin converts the product price and swaps the symbol everywhere, but it cannot reach Optiontics addon prices on its own. Go to Optiontics → Settings → Integrations and switch Multi-currency on, then reload the product page.

Q2: I use a different multi-currency plugin. Will my addon prices still convert? Usually yes. Optiontics reads the exchange rate from your storefront and applies it, and the card shows “Converting, best effort”. This ignores per-currency fixed prices and any rounding rules set inside that plugin, so check a product before relying on it. A developer can wire exact conversion through the optiontics_convert_price filter.

Q3: My cart total is one or two cents different from the product page. Why? Each addon price is rounded to two decimals for display, and those rounded figures are added up on the product page. The cart converts the untouched total once instead. On exchange rates that do not divide cleanly the two can differ by a minor unit. The cart figure is the one charged.

Conclusion #

Multi-currency support keeps your Optiontics addon prices consistent with the rest of your store, so shoppers see one currency throughout and the cart charges what they expected. Turn it on from Optiontics → Settings → Integrations, then test a product in a second currency.