View Product Page

Default shortcodes

By default there are 6 different shortcodes in the plugin, one of each type:

Below we will explain the options within each shortcode and the way it looks on the frontend.

List – Select

The current selected currency is visible, by clicking on the arrow you see a dropdown where you can select another currency. The currently active currency is marked with a ‘check’ mark. Within the shortcode options you can decide to show/not show a search field.

SC - List - select

List – Checkbox

A box with all available currencies is visible and you can select another currency. The currently active currency is marked with a ‘check’ mark. Within the shortcode options you can decide to show/not show a search field.

list checkbox

Please note: if you set the flag position to the left, the flags replace the checkboxes:

SC - List checkbox

List – Label

An oversight of all currencies with flags are visible as labels. You can change the content of the labels (show/not show flag) and change the colors of the labels within the ‘Shortcodes’ settings tab.

SC - list - label

Currency rates

Show a quick view of a currency and the corresponding rates in other currencies. With a dropdown you can change the current selection.

SC - currency rates

Alphabetic list

All available currencies shown in alphabetic order and grouped by letter.

SC - Alphabetic list

Currency converter

Show a currency converter to quickly calculate the value of different currencies.

SC - Currency converter

Create your own shortcode

To create your own shortcode, click on “+ add shortcode”.

A popup will appear with all the possible options for the shortcode that you are about to create.

  • Name: The name of the shortcode (only visible for admin).
  • Currency format: How to display the currency, let’s take for example US Dollars, you can choose to show:
    • USD
    • United States (US) Dollar
    • $

The currency that shows up here, is the ‘Default currency’ that you have set in “General settings > Default currency”. 

  • Type: 
    • Currency list
    • Currency alphabetic list
    • Currency converter
    • Currency rates

For the different type examples, please refer to this examples page here.

  • Style: 
    • Select
    • Checkbox
    • Labels
  • Show search: Decide to show a ‘search’ box or not. 
  • Show flags: Decide to show flags and where to show them.

How to edit a default shortcode

By clicking on the ‘pencil’ icon of a certain (default) shortcode, you are able to edit it.

A popup will appear with all preset options, which you can easily edit.

Depending on the shortcode you are editing, the corresponding options appear:

  • Name: The name of the shortcode (only visible for admin).
  • Currency format: How to display the currency. Let’s take for example US Dollars, you can choose to show:
    • USD
    • United States (US) Dollar
    • $
  • Type: 
    • Currency list
    • Currency alphabetic list
    • Currency converter
    • Currency rates
  • Style: 
    • Select
    • Checkbox
    • Labels
  • Show search: Decide to show a ‘search’ box or not. 
  • Show flags: Decide to show flags and where to show them.

Widgets

In order to show any of the created shortcodes, you will have to add the “YITH Multi Currency Shortcode” widget to a sidebar.

multi currency shortcode widget (1)

You can give the widget a title as usual, and you can select the shortcode to display.

Search shortcode widget

If you wonder how to create these shortcodes, or how to edit the default shortcodes, please take a look at this section here.

Blocks

The plugin widgets are also available in the block editor.

Gut - overview 1

There are four possible widgets you can use:

  • YITH Multi Currency List
  • YITH Multi Currency Alphabetic List
  • YITH Multi Currency Converter
  • YITH Multi Currency Rates

Below some examples of the use of blocks with our widgets.

Gut - examples