WooCommerce Multi-Currency Switching Plugin Currency Converter User Guide

Currency Converter Widget is an application designed by Kestrel for WooCommerce Developed plugins that can be displayed on a website acurrencySelector to allow customers to dynamically switch how the currency of the product price is displayed.

Plug-in Requirements

WooCommerce 4.0 and above

Installation steps

Log in to your WooCommerce account and download the plugin! .zip file
go into WordPress In the backend, click "Plugins > Install Plugins > Upload Plugin".
Select Downloaded .zip file, click "Install Now" and activate the plugin.
Refer to the official Installation and Activation of Extensions documentation for more instructions.

Open Exchange Rates (optional setting)

By default, the plugin uses Kestrel's built-in exchange rate service. It is also possible to access Open Exchange Rates as an external service. Simply register an account and get an App ID.

Setting method:

leave for WooCommerce Backstage menu:Settings > Integrations > Open Exchange Rates
Paste the App ID into the setup form
Click Save

After you provide your App ID, additional settings will appear in the interface:

Exchange rate refreshment cycle

Used to set the interval (in hours) at which the exchange rate is updated. The default is every 12 hours. The supported range is 1 to 24 hours.

Widget Configuration

All settings of the plugin are centralized in the Currency Converter Widget.

Add Currency Converter Widget

show (a ticket) WordPress Backstage menu:Appearance > Gadgets
Find the area where you want to insert the widget and click on the "+".
Search for "Currency converter", select and add
Click to expand the configuration options after insertion

Widget Parameter Settings

caption: Set the name of the widget to be displayed on the frontend
Currency code: Enter a currency code for each line, e.g. USD, EUR.
- Example: Enter SEK* will be displayed as 999krInput USD * Displayed as 999 $
- If * is omitted, WooCommerce's default currency symbol position is used
Currency Display: Support for "buttons" or "drop-down boxes"
Info Tips: Description text displayed above the currency selector
Whether to display currency symbols: off by default, on the display as $,€
Show Reset Button: Show "Reset Currency" button on front-end when enabled
Disable position recognition: When checked, the visitor's geolocation is not automatically detected

Front-end display style

When enabled, a currency switcher will be displayed on the front-end of the site, allowing the user to toggle the displayed price between supported currencies.

Button mode schematic:

Each coin appears as a separate button that immediately updates the price displayed on the page when the user clicks on it.

Drop-down selection box mode:

You can select "Select Box" in the widget to switch to the drop-down menu.

Conversions include:

Commodity prices and promotional prices
Shopping Cart Totals
Checkout page price
Freight amount

All amounts will be displayed in the corresponding currency symbols, e.g. $10 rather than 10 USDThe

Note: The actual payment amount will still be in the store's base currency, the displayed currency is for reference only.

Frequently Asked Questions

What about the lack of currency symbols?

If a currency is not included in the WooCommerce Default list of currencies, symbols can be added manually. See official documentation:Add custom currency symbols

Want to display widgets in a location other than the sidebar?

Support for the use of short codes [woocommerce_currency_converter] Insert any content area.
If used in a template file, it can be accessed through the WordPress do_shortcode function call:

echo do_shortcode( '[woocommerce_currency_converter]' );

Short Code Parameter Description

parameter name	functionality	default value
`currency_codes`	Setting Supported Currencies	USD, EUR (or default currency)
`message`	Top Tip	unoccupied
`currency_display`	Display method (button or select)	button
`show_symbols`	Whether to display the currency symbol	0
`show_reset`	Whether to display the reset button	0
`disable_location`	Whether to disable the position recognition function	0

Short code example:

[woocommerce_currency_converter currency_codes="AUD, USD, GBP, EUR"
message="Prefer to see prices in a different currency?"
 show_symbols=1 show_reset=1 currency_display="select" disable_location=1]

The short code generates a converter with a hint message, displays as a drop-down box, and supports resets and symbols.

fault resolution

Page loading slow or prices not updated?

Please check if the server firewall is blocking the exchange rate service. This service uses the IP Address for:

185.24.96.251

Shipping not converted?

The plugin currently only supports shipping rates that are displayed using the "radio button" method. If your site uses a "drop down box", you will not be able to toggle the currency display.

Use flag icons instead of currency codes

You can do this by adding the following CSS clip that displays the corresponding country's flag in the Currency button:

a[data-currencycode="USD"] {
    background-image: url('http://upload.wikimedia.org/wikipedia/en/a/a4/Flag_of_the_United_States.svg') !important;
    background-size: 60px !important;
    width: 30px;
    background-repeat: no-repeat; font-size: 0; font-image: url('') !
    font-size: 0; height: 20px;
    height: 20px; !
}

Tip: WooCommerce officially does not provide support for custom code. If you are not familiar with CSS,templatesFile or plugin conflict troubleshooting, it is recommended to seek professional developer assistance.

Why is it not working on the shopping cart and checkout pages?

need to be separately in theshopping cart pagerespond in singingcheckout pagestick [woocommerce_currency_converter] short code to display the converter properly.
The default shortcode only supports USD and EUR, if you need to support more currencies, you have to add them manually. currency_codes Parameters.

summarize

Currency Converter Widget is WooCommerce Store's multi-currency price display tool allows customers to switch currencies to view prices. The plugin supports button or drop-down selection methods, can be embedded anywhere on the page, and can access real-time exchange rate services. It does not affect the actual currency of payment, suitable for providing reference prices to international users, easy to operate and practical features.

Contact Us
Can't read the tutorial? Contact us for a free answer! Free help for personal, small business sites!	Customer Service
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) E-mail: info@361sale.com
④ Working hours: Monday to Friday, 9:30-18:30, holidays off