Adds the [currency] and [currency_legal] shortcodes to convert currencies based on the ECB reference exchange rates.

falselight

Currency Converter Calculator

❤️‍ Is a magic real-time and easy-to-use with beautiful UI widget. Included 195+ world currencies with popular cryptocurrencies.

enclick

Currency Converter

Currency calculator, converts amounts between currencies. Size, color, and layout can be customized.

joost de keijzer

<p>Using the <code>[currency]</code> shortcode you can convert one currency to another. The conversion is based on the rates published by the ECB. You can change from and to any of the supported currencies.</p>
<p>The <code>[currency_legal]</code> shortcode outputs a disclaimer text and a link to the ECB eurofxref page.</p>
<h4>Important!</h4>
<p>ECB advices against using their rates for transaction purposes. From their site: “The reference rates are published for information purposes only. Using the rates for transaction purposes is strongly discouraged.”</p>
<p>The reference rates are usually updated by ECB at around 16:00 CET every working day, except on <a href="https://www.ecb.europa.eu/services/contacts/working-hours/html/index.en.html" rel="nofollow ugc">TARGET closing days</a>.</p>
<p>Go to the <a href="https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html" rel="nofollow ugc">ECB site</a> for more information and disclaimers.</p>
<p>Also note that conversion from non-Euro to non-Euro is done through the Euro, so GBP to USD is calculated as GBP → EUR → USD (converted 2 times).</p>
<p>This plugin is based on a plugin by <a href="http://www.xclamationdesign.co.uk/free-currency-converter-shortcode-plugin-for-wordpress/" rel="nofollow ugc">Xclamation</a>.</p>
<p>Also see <a href="https://github.com/joostdekeijzer/wp_eurofxref" rel="nofollow ugc">wp_eurofxref on GitHub</a> where development takes place.</p>
<h3>Shortcode usage & examples</h3>
<h4>currency_legal shortcode</h4>
<p>This shortcode returns the string ‘* For informational purposes only. Exchange rates may vary. Based on <a href="https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/" rel="nofollow ugc">ECB reference rates</a>.’</p>
<p>The prepended ‘* ‘ (the same string as the [currency] append string) can be changed using the ‘prepend’ attribute.</p>
<p>For example: <code>[currency_legal prepend='Please note: ']</code></p>
<p>If you want to change the default prepent string for your whole site you can use the default <code>shortcode_atts_currency_legal</code> filter.<br />
See the <a href="https://developer.wordpress.org/reference/hooks/shortcode_atts_shortcode/" rel="nofollow ugc">shortcode_atts_{$shortcode} reference</a> for more information about this.</p>
<h4>currency shortcode</h4>
<p>Attributes:</p>
<ul>
<li><code>from</code>: currency code (default: EUR)</li>
<li><code>to</code>: currency code (default: USD)</li>
<li><code>amount</code>: number of “from” currency (default: 1)</li>
<li><code>iso</code>: boolean (default false); use ISO currency formatting.”€ 1″ would become “1 EUR” in ISO notation.</li>
<li><code>show_from</code>: boolean (default true); show from amount in output</li>
<li><code>between</code>: string (default ‘&nbsp;/&nbsp;’ which is displayed as ‘ / ‘ in the browser); string between from and to amounts</li>
<li><code>append</code>: string (default ‘&nbsp;<em>‘ which is displayed as ‘ </em>‘ in the browser); string put after conversion. The * references the disclaimer text, see [currency_legal] shortcode.</li>
<li><code>round: boolean</code> (default true); Round numbers to whole units.</li>
<li><code>round_append</code>: string (default ‘=’); replaces decimals</li>
<li><code>no_from_show_rate</code>: boolean (default true); when from amount is hidden in the output the “to” text gets a tooltip that displays the exchange rate. The <span> element with this tooltip is styled with the <code>to_style</code> css string below. Set the <code>no_from_show_rate</code> option to false to disable the <span> and tooltip.</li>
<li><code>to_style</code>: css string (default ‘cursor:help;border-bottom:1px dotted gray;’); styling of “to” text <span> wrapper.</li>
</ul>
<p>If you want to change the defaults for your whole site you can use the default <code>shortcode_atts_currency</code> filter. See the <a href="https://developer.wordpress.org/reference/hooks/shortcode_atts_shortcode/" rel="nofollow ugc">shortcode_atts_{$shortcode} reference</a> for more information about this.</p>
<h4>Examples</h4>
<ul>
<li><code>[currency amount="875" from="EUR" to="GBP"]</code><br />
becomes “€ 875,= / £ 697.= *”</li>
<li><code>[currency amount="875" from="GBP" to="USD" iso=true between=" converts to " append="" round_append=""]</code><br />
becomes “875 GBP converts to 1,418 USD”</li>
<li><code>[currency amount="875" from="GBP" to="USD" show_from=false round=false]</code><br />
becomes “$ 1,130.15 *”</li>
</ul>
<h3>Static method usage & examples</h3>
<h4>`legal_string` method</h4>
<p>The legal string can also be retrieved in PHP</p>
<p><em>Usage</em></p>
<pre><code><?php echo EuroFxRef::legal_string( &#36;prepend ) ?>
</code></pre>
<p><em>Parameters</em></p>
<ul>
<li>$prepend (string) The string to prepend the legal text with, default ‘* ‘</li>
</ul>
<p><em>Return Value</em></p>
<p>(string) Legal text prepended with $prepend string.</p>
<h4>`convert` method</h4>
<p>Since v1.3, you can call the convertor staticly from PHP in your code.</p>
<p><em>Usage</em></p>
<pre><code><?php EuroFxRef::convert( &#36;amount, &#36;from, &#36;to ); ?>
</code></pre>
<p><em>Parameters</em></p>
<ul>
<li>$amount (float) The amount of currency you want to convert.</li>
<li>$from (string) The currency code the amount is in, default EUR.</li>
<li>$to (string) The currency code the amount must be converted to, default USD</li>
</ul>
<p><em>Return Value</em></p>
<p>(float) the converted value or 0 (zero) if any of the currency code’s are not available.</p>
<h4>Examples</h4>
<ul>
<li><code><?php &#36;process_later = EuroFxRef::convert( 10, 'USD', 'GBP' ); ?></code><br />
will return the raw numeric (float) value without formatting: <code>6.01877256317689468545495401485823094844818115234375</code></li>
</ul>
<h3>Currently available currencies</h3>
<ul>
<li><code>AUD</code> – Australian dollar ($)</li>
<li><code>BGN</code> – Bulgarian lev (лв.)</li>
<li><code>BRL</code> – Brasilian real (R$)</li>
<li><code>CAD</code> – Canadian dollar ($)</li>
<li><code>CHF</code> – Swiss franc (CHF)</li>
<li><code>CNY</code> – Chinese yuan (¥)</li>
<li><code>CZK</code> – Czech koruna (Kč)</li>
<li><code>DKK</code> – Danish krone (kr.)</li>
<li><code>EUR</code> – Euro (€)</li>
<li><code>GBP</code> – Pound sterling (£)</li>
<li><code>HKD</code> – Hong Kong dollar ($)</li>
<li><code>HUF</code> – Hungarian forint (Ft)</li>
<li><code>IDR</code> – Indonesian rupiah (Rp)</li>
<li><code>ILS</code> – Israeli new sheqel (₪)</li>
<li><code>INR</code> – Indian rupee (₹)</li>
<li><code>ISK</code> – Icelandic króna (kr.)</li>
<li><code>JPY</code> – Japanese yen (¥)</li>
<li><code>KRW</code> – South Korean won (₩)</li>
<li><code>MXN</code> – Mexican peso ($)</li>
<li><code>MYR</code> – Malaysian ringgit (RM)</li>
<li><code>NOK</code> – Norwegian krone (kr)</li>
<li><code>NZD</code> – New Zealand dollar ($)</li>
<li><code>PHP</code> – Philippine peso (₱)</li>
<li><code>PLN</code> – Polish złoty (zł)</li>
<li><code>RON</code> – Romanian leu (lei)</li>
<li><code>SEK</code> – Swedish krona (kr)</li>
<li><code>SGD</code> – Singapore dollar ($)</li>
<li><code>THB</code> – Thai baht (฿)</li>
<li><code>TRY</code> – Turkish lira (₺)</li>
<li><code>USD</code> – United States (US) dollar ($)</li>
<li><code>ZAR</code> – South African rand (R)</li>
</ul>
<p>LTL and LVL are not published any more at least since 2-jan-2020.<br />
RUB is not published since 1-jun-2022 and HRK since 2-jan-2023.</p>


Alternatives to Euro FxRef Currency Converter (by DKZR)

Top alternatives