Currencies

In this guide, we will discuss all aspects related to currency handling in the plugin. Starting from defining the default currency, through the possibility of using other currencies in the same form, to the possibility of modifying the way the currency is displayed in the system. Chauffeur Taxi Booking System supports all world currencies and also allows you to handle multiple currencies in a single form.

Setting the Base Currency

The first step in configuring the plugin is to define the base currency, i.e. the main currency, which will also be the basis for calculating exchange rates. All prices shown in the form are displayed in the base currency by default.

Go to your WordPress admin, navigate to the ‘Settings’ -> ‘Chauffeur Booking System’ menu, ‘General’ -> ‘Main’ tab. Find the option called ‘Currency’ and set the base currency. In our example, it will be United States dollar (USD).

Setting Additional Currencies

A single form can support multiple currencies. To add additional currencies to the form navigate to the ‘Chauffeur Booking System’ -> ‘Booking Forms’ menu, click on the desired form, and then go to the ‘General’ -> ‘Prices’ tab. Select additional currencies (excluding the base one) from the list next to ‘Currencies’ option and save the changes by clicking ‘Update’. In our example, we will also add the British Pound (GBP) by selecting it from the list.

Setting Exchange Rates

Go to the ‘Settings’ -> ‘Chauffeur Booking System’ menu, ‘Exchange rates’ tab. Here, define the exchange rates for all additional currencies supported by your form. The exchange rate is simply a numerical value by which the price of the base currency will be multiplied. In our case, we find the row with the British Pound currency in the table and enter 0.83 in the ‘Exchange rate’ field.

Import Exchange Rates

The plugin allows you to import currency rates with a single click, using the ‘Import exchange rates’ button located in the ‘Settings’ -> ‘Chauffeur Booking System’ menu, ‘Exchange rates’ tab.

To use this option, go to fixer.io website, register your account and generate free API key. Then, in the plugin settings, go to the ‘General’ -> ‘Main’ tab and enter the obtained key in the ‘Fixer.io API Key’ field and save your settings.

In case of any problems with the fixer.io operation, you can check the error log in ‘Settings’ -> ‘Chauffeur Booking System’, ‘Log manager’ -> ‘Fixer.io’ tab.

Displaying the Form in a Different Currency

To display the booking form in a different currency, add a query string to the URL with the form:

?currency=CURRENCY_CODE
e.g.:
?currency=GBP

As a result, your URL may look like this:

https://yourdomain.com/booking-form/?currency=GBP

The second way is to use a shortcode with an additional ‘currency’ parameter:

[chbs_booking_form booking_form_id="FORM_ID" currency="CURRENCY_CODE"]
e.g.:
[chbs_booking_form booking_form_id="2151" currency="GBP"]

The form will be displayed in a different currency and prices will be converted at the exchange rate defined in the plugin settings. Below is an illustration for USD and GBP currencies (currency ratio 0.83).

See screenshot

See screenshot

Modifying the Currency Display

You can modify the way currency is displayed in the system. The options to configure are:

• Currency symbol
• Position of the currency symbol (left, right, with space, without space)
• Decimal separator
• Number of decimal places
• Thousands separator

To make changes, go to the menu item ‘Chauffeur Booking System’ -> ‘Currencies’ and click ‘Add New’ button. Select the currency to be modified from the list and enter your settings for it. Click the ‘Publish’ button to save your changes.