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”.

New sc - add new (1)

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

New sc - popup

  • 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
    • $

New sc - currency format

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

New sc - type

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

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

New sc - style

  • 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.

SC - edit default

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

SC - edit default popup

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
    • $

New sc - currency format

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

New sc - type

  • Style: 
    • Select
    • Checkbox
    • Labels

New sc - style

  • 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.