[cfgeo_converter]300USD[/cfgeo_converter]
Use this shortcode to display real-time currency conversion based on the current exchange rate of the day. This is especially useful for showing prices in the visitor’s local currency without requiring additional currency plugins.
Parameters
- from – (accepts: ISO 4217 three-letter currency code) – The currency to convert from. If omitted, it defaults to the site’s currency.
- to – (accepts: ISO 4217 three-letter currency code) – The currency to convert to. If omitted, it defaults to the visitor’s local currency.
- align – (accepts: single letter)
- L – Symbol before the number (e.g. $300)
- R – Symbol after the number (default)
- separator – (accepts: any character) – Separator between the number and currency symbol (e.g. space, dot, dash)
- no-symbol – (accepts: 1 or 0) – Whether to hide the currency symbol
- 1 – Symbol is hidden
- 0 – Symbol is shown (default)
Return
Returns the converted currency amount based on today’s exchange rate from the specified or detected currencies.
Examples
Basic usage:
[cfgeo_converter]300USD[/cfgeo_converter]
This example converts 300 USD to the visitor’s local currency (unless the visitor is from the US, in which case it displays the original amount).
Conversion with source currency only:
[cfgeo_converter from="USD"]300[/cfgeo_converter]
This gives you more control by explicitly setting the source currency while letting the plugin detect the target (visitor’s currency).
Conversion with both source and target currencies:
[cfgeo_converter from="USD" to="EUR"]300[/cfgeo_converter]
This will convert 300 USD to EUR regardless of the visitor’s location.
Live example: 256.74€