Currency Switcher for WooCommerce: Multi-Currency Setup with Geolocation Detection

How to Enable Currency Switcher

1. Navigate to the ShopLentor menu on your WordPress dashboard.
2. Click Settings, then select the Modules tab.
3. Locate and click on Currency Switcher, then access its settings.
4. In the Currency Switcher settings window, enable the feature.

How to add Multiple Currencies

In the Currency Switcher settings window, you’ll find the default currency displayed along with the convenient “+ADD ITEM” button. Simply click on this button to add a new currency. Here’s a detailed overview of the settings you can configure:

1. Currency Selection: Choose the currency you want to add to your website.
2. Decimal Placement: Specify the decimal placement for the currency.
3. Currency Symb: Select the position of the currency symbol: Left, Right, Left Space, or Right Space.
4. Exchange Rate: Manually set the exchange rate or effortlessly update it by clicking the “UPDATE EXCHANGE RATES” button for the latest rates.
5. Exchange Fee: Set an exchange fee to be added to the original or exchanged rate.
6. Payment Method Disables: Disable specific payment methods for this currency if needed.
7. Custom Currency Symb: Optionally, add a custom currency symbol. If left blank, the default symbol for the currency will be used.

These settings allow you to tailor the Currency Switcher to match your website’s requirements and provide a seamless multi-currency experience for your users. Experiment with these options to create a currency configuration that best suits your needs.

Set Default Currency

After adding currencies, navigate to the “Default Currency” section. Choose from the list of added currencies to set your preferred default currency for the website. This choice influences the initial currency users see, providing a smooth and user-friendly experience.

How to Enable Currency Switcher with Geolocation

Once you’ve configured your default currency, you can enhance your store’s user experience by enabling geolocation-based currency switching. This allows the currency to be automatically detected based on the customer’s location.

1. Navigate to the ShopLentor Settings:

• Go to ShopLentor → Modules in your WordPress dashboard.
• Click Currency Switcher to open the settings.

2. Enable Geolocation:

• In the Currency Switcher settings, toggle Enable Geolocation to ON. This feature will automatically detect and set the currency based on the customer’s location using WooCommerce geolocation. For best accuracy, ensure that Geolocate is enabled under WooCommerce → Settings → General → Default Customer Location.

3. Configure Country to Currency Mapping (Optional):

• You can map specific countries to currencies using the Country Currency Mapping feature. This helps automatically select the correct currency based on the customer’s location.
• For instance, map Germany to EUR or USA to USD.

4. Optional – Hide Currency Switcher:

• If you don’t want customers to manually select their currency, enable the option Hide Currency Switcher. When this is activated, the currency switcher widget (for Elementor/Gutenberg) will be hidden, and customers will not be able to manually change the currency.

Step 2: Adjust Geolocation Settings

Google API Key (Required for enhanced geolocation features):

• To use advanced geolocation features, such as country-specific restrictions and autocomplete, you’ll need to enter your Google API Key in the settings. This key is required to use Google’s geolocation and address services.

Step 3: Test the Geolocation Currency Switching

To ensure everything is working:

1. Visit the site from different countries (or use a VPN) and check if the currency changes automatically.
2. Test with billing and shipping addresses to confirm proper currency detection.
3. If the country is not mapped to a currency, the system will default to the main currency set in the system.

How to display the Currency Switcher Using Elementor Widget

After configuring the multi-currency settings, the next step is to display the currency switcher on your website. So customer can change to their desired currency. Follow these simple steps:

1. Navigate to your preferred page.
2. Edit the page using Elementor.
3. Search for the “Currency Switcher” Elementor widget.
4. Drag and drop the widget onto your desired section.

It’s that easy! The Currency Switcher will now be seamlessly integrated into your Elementor-designed page, allowing users to switch between currencies effortlessly.

How to display the Currency Switcher Using Shortcode

[woolentor_currency_switcher]

This shortcode makes it simple to showcase the currency switcher. It comes with several parameters, and as with other shortcodes, each one should be enclosed in double quotation marks, “like this”.

1. style: Pick the style for displaying the currency switcher. Choose between “list” and “dropdown”.
2. flags: Decide whether the currency switcher should include flags. Options are “yes” and “no”.
3. flag_style: Select the style for displaying the currency switcher with flags. Options include “square” and “circle”.

Example

[woolentor_currency_switcher flags="yes" style="dropdown" flag_style="square"]

Contact Support for Further Assistance

If you encounter any issues while adding currency or have queries not addressed in this documentation, feel free to reach out to our support team for assistance.