Introduction ↑ Back to top
The Currency Switcher plugin will help you to change the currency while shopping. Currency can be switched at Shop, Cart and Checkout pages.
Admin can set a list of currencies that can be placed on the shop page as a sticky switcher. Moreover, currency switchers can be placed as a Menu Item where exchange rates can be displayed against selected currency.
Admin can either manually set the exchange rate of currencies or can configure it through API.
Key Features ↑ Back to top
- Admin can set multiple currencies from backend so that the frontend user can select his desired currency for transaction.
- Admin can manually set fixed exchange rate of all the added currencies with respect to primary selected currency
- Admin can set currency exchange rate option via API that will update the currency exchange rate on specified time interval.
- Admin has an option to show the flag of countries with respect to currencies.
- Admin has an option at backend to allow or un-allow the execution of purchase in selected currency by customer. If it is un-allowed from backend so whatever the currency has selected by customer, final payment will be made in backend default currency.
- Admin can add currency switch option in widget.
- Frontend User can change the currency on Shop page.
- Frontend User can change the currency on cart page.
- Frontend User can change the currency on checkout page.
- Currency Switcher can be shown as Menu Item
- Currency Exchange rate can be displayed on Menu
- Multiple layout options for Currency Switcher menu item
- Currency can be displayed at frontend by using IP Address of current location
- Selected Payment Gateways can be shown against each currency
Pre-Requisites ↑ Back to top
- WooCommerce Plugin
- Currency Switcher Plugin
Installation of Plugin ↑ Back to top
Once the plugin is downloaded then:
- Go to WordPress Admin > Plugins > Add New and Upload Plugin
- Attach the downloaded file at ‘Choose File’ option
- Click on ‘Install Now’
- Click on ‘Activate’
Configuration of Plugin ↑ Back to top
- Go to ‘WooCommerce’ tab
- Then ‘WCCS Settings’ tab
- In ‘Currencies Section’, select as many currencies as you require from the dropdown button. Once you select a currency so it will get listed
- Now, you may type the ‘Label Name’ for selected currency
- Set the ‘Exchange Rate’ of each currency manually. Exchange Rate will be compared as value ‘1’ of default currency of your WordPress environment. If exchange rate has been fetched from API so it will be displayed automatically
- In ‘Price Format’ set the alignment of currency from dropdown option
Frontend Impact
Currency value been placed on left hand side i-e: after currency symbol
- Select ‘Decimals’ option from dropdown that how much decimal points you want to show against exchanged currency
Frontend Impact
All exchanged values are showing results in two decimal values
- Set ‘Flag’ of your currency from dropdown list
Frontend Impact
Configure Payment Gateway Option. In dropdown you will get the options for installed payment gateways. Checkmark on those options to which you want to hide for each specific currency.
Frontend Impact
While switching on GBP, we can see that there is no option of Direct Bank Transfer at checkout
- Shuffle the currencies in sequence. At frontend currencies will get listed in same order after default currency
- Delete a specific currency
‘Exchange Rate Section’
There are two options here. One is for ‘Fixed’ currency (Manually adjusted exchange rate)
Other one is for ‘API’ (Exchange rate will be fetched from API). For that we need to enter following details:
- Open exchange rate API key
- Update Rate (Interval for fetching updated rates from API)
- Send Email checkbox (Emails will be routed on every update of currency)
- Enter ‘Email’ on which email alert will be send
You can switch from setting whether to show currency symbol or currency ISO code.
Currency Symbol:
- Dashboard > WooCommerce > WCCS Settings
- Select Symbol in Currency Display Type.
Currency ISO Code:
- Dashboard > WooCommerce > WCCS Settings
- Select ISO Code in Currency Display Type.
You can add a prefix before the currency symbol.
- Dashboard > WooCommerce > WCCS Settings
- Select Symbol in Currency Display Type.
- Add prefix in the Currencies section
- We added PKR the as symbol prefix
‘Rate Storage Section’
Select Rate Storage option as ‘Transient’ or ‘Session’ time
Transient time is ’24 hours’ while Session time will be fetched from your browser
‘Set Default Currency Flag’
Set flag of default currency from the drop-down list
Flag Section
Checkmark on this option to show the flags for all currencies
‘Shop Currency Section’
Checkmark this option if you want to let your customers to execute the purchase in their selected currency, if it has been unchecked and your customer has selected some other currency then the transaction will get executed in default currency
Frontend Impact
As we can see that the default currency is ‘USD’ and selected currency is ‘GBP’. Final transaction has been placed in GBP
‘Currency Symbol Section’
Checkmark this option if you want to display the currency symbol at frontend Menu of currency switcher
Frontend Impact
We can see currency symbol at frontend option of currency switcher
‘Currency By location Section’
Checkmark this option to get the currency from IP address of your current location. Let’s suppose your general currency has been set as USD and you have logged in from Singapore so the shop will show products in ‘Singaporean Dollar’.
Note: Singaporean Dollar should have been added in currency list of WCCS Settings
Frontend Impact
Products now automatically showing currency in Singaporean Dollar
‘Add Menu Section’
Checkmark this option if you want to show ‘Currency Switcher’ tab as a Menu. Here we can switch the currency and its impact will select and change the currency
‘Shortcode Section’
Copy below mentioned shortcodes and paste it on a page. It will show the exchange rate of Currencies on a separate menu.
‘Switcher Style Section’
Select style options from dropdown menu to change the layout styles of ‘Currency Switcher Menu’
Frontend Impact
By clicking on the header of the Currency Switcher option, a dropdown option will appear from where we can change the currency. The exchange rate will be shown according to the selected currency
The exchange rate will be shown according to the selected currency
Frontend Impact
By clicking on header of Currency Switcher option, a dropdown option will appear from where we can change the currency. Exchange rate will be shown according to the selected currency
Frontend Impact
By clicking on header of Currency Switcher option, a dropdown option will appear from where we can change the currency. Exchange rate will be shown according to the selected currency
Frontend Impact
By clicking on header of Currency Switcher option, a popup option will appear from where we can select the currency. Exchange rate will be shown according to the selected currency
‘Sticker Switcher Section’
- Checkmark this option if you want to show the currencies on frontend pages and can be switched from sticky option
- Select alignment ‘Right’ or ‘left’ where you want to get it displayed
Widget Settings ↑ Back to top
- Go to ‘Appearance’ tab
- Then ‘Widgets’
- Now scroll down and go to ‘WCC Switcher Widget’ option
- Set the style where you want to display the currency switcher option as Widget
- Click on ‘Add Widget’
- Next Step is to give ‘Title’ and ‘Select Style’ from dropdown option
- Click on ‘Done’
Frontend Impact
At footer area of frontend window, we can see the widget for Currency Switch has been appeared
Frontend Functionality ↑ Back to top
- Go to shop page
- All the products will be listed along with their prices
- Currency can be switched on Shop page. Here we are switching it from ‘GBP’ to ‘USD’
Cart Page
Currency can be switched from ‘USD’ to ‘GBP’
Checkout Page
Currency has been switched from ‘GBP’ to ‘AUD’
General Guidelines
- If you change the default woocommerce currency, you need to update rates in your currencies settings (either automatically “by updating all buttons in case API option is selected” or manually “in case Fixed option is selected”). Also if the newly chosen woocommerce currency also exists in currencies settings, it will be removed from currencies settings.
- When you add new currency in settings page and API option is enabled, the new currency will not automatically have an exchange rate.
- Transient currency storage expiration time is one day (24 Hours).
- Note: We use woocommerce currency setting as the base currency for open exchange rates API. If you use any currency other than USA Dollar (USD), make sure your account is not free, otherwise it will not work (see API limitation at:https://openexchangerates.org/signup).
Compatibility with Donation Feature ↑ Back to top
User went for a donation of 10 GBP with default currency
But at the time of checkout he swtiched the currency to USD
The donation was made in USD
Donation from Widget ↑ Back to top
User selected by default GBP currency in widget to donate:
But on checkout option he switched the currency to USD
Payment was made in USD as we can see in below image
Currency Switcher at Round off Donation ↑ Back to top
Customer went for a purchase with default GBP currency
But at the time of checkout it gave an option to round off the value by giving donation
User changed the currency here:
The final transaction has processed with USD
Compatibility with Wholesale ↑ Back to top
- Set up a Wholesale User
- After login go to SHOP
- Select any Wholesale Product
- Default Currency (USD Dollar)
- Minimum 5 Quantity required to apply the Wholesale price
- Before Wholesale price is applied
- After Wholesale price is applied
- Currency Switched (Euro)
- Minimum 5 Quantity required to apply the Wholesale price
- Before Wholesale price is applied
- After Wholesale price is applied
Compatible with All product Subscription plugin ↑ Back to top
- Create a subscription product
- Once published, go to SHOP
- Default Currency (USD Dollar)
- Currency Switched (EURO)