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>


Euro FxRef Currency Converter (by DKZR)

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

falselight

<p>Currency Converter Calculator helps visitors convert prices and amounts without leaving your page.<br />
Add live currency conversion to pricing pages, tourism and travel guides, news websites, finance articles, business pages, and sidebars with a shortcode or classic widget.</p>
<p>Visitors get instant currency context in the place where they are already reading, shopping, comparing, or planning.<br />
Site owners get a lightweight setup: no API key, no local rate database, and no exchange-rate processing load on WordPress.</p>
<h4>⭐ What makes it useful</h4>
<ul>
<li>🌍 190+ currencies and assets, including popular cryptocurrencies and metals.</li>
<li>💱 Live currency conversion directly inside posts, pages, sidebars, and footers.</li>
<li>🧩 Add the converter with a shortcode, the Shortcode block, or a classic WordPress widget.</li>
<li>⚡ No API key, local exchange-rate database, or exchange-rate processing load on your WordPress site.</li>
<li>📱 Responsive layout for desktop and mobile visitors.</li>
<li>🎨 Color themes, background color, large mode, and corner style options.</li>
<li>🌐 Multilingual widget labels for international audiences.</li>
<li>🕒 Time zone setting for the displayed update date.</li>
<li>🔒 SSL-ready CurrencyRate.Today service URLs.</li>
</ul>
<h4>🎯 Where it works best</h4>
<ul>
<li>Pricing pages where visitors need to understand a price in their own currency.</li>
<li>Tourism and travel websites where readers estimate trip costs.</li>
<li>News websites that cover markets, business, inflation, travel, or international stories.</li>
<li>Finance blogs that need a simple converter next to rate commentary.</li>
<li>Business and service pages for international customers.</li>
<li>Multilingual sites that need converter labels in the visitor’s language.</li>
</ul>
<h4>👀 Demos</h4>
<ul>
<li>Official demo: <a href="https://currencyrate.today/converter-widget" rel="nofollow ugc">Currency Converter Widget</a></li>
<li>Product demo: <a href="https://yuri.ws/currency-converter-calculator/" rel="nofollow ugc">Currency Converter Calculator</a></li>
</ul>
<h4>🚀 Quick start</h4>
<ol>
<li>Install and activate Currency Converter Calculator.</li>
<li>Paste the shortcode into a post, page, or Shortcode block.</li>
<li>Choose the source currency, target currency, language, theme, background, and layout.</li>
<li>Optionally add the classic widget to a sidebar or footer.</li>
</ol>
<p>Important: this plugin provides a classic <code>WP_Widget</code>.<br />
On modern WordPress installations with the block-based widget screen, install and activate Classic Widgets to manage the widget in Appearance > Widgets.<br />
Shortcodes work without Classic Widgets.</p>
<h4>🧩 Shortcode examples</h4>
<p>Pricing converter example:</p>
<pre><code>[ccc_currency_converter_calculator lg="en" tz="0" fm="EUR" to="USD" st="info" bg="FFFFFF" lr="1" rd="0" size_width="100%"][/ccc_currency_converter_calculator]
</code></pre>
<p>Travel converter example:</p>
<pre><code>[ccc_currency_converter_calculator lg="en" tz="0" fm="USD" to="EUR" st="success" bg="FFFFFF" lr="0" rd="0" size_width="100%"][/ccc_currency_converter_calculator]
</code></pre>
<h4>🔧 Shortcode attributes</h4>
<ul>
<li><code>lg</code> – language. Supported values: <code>en</code>, <code>ru</code>, <code>it</code>, <code>fr</code>, <code>es</code>, <code>de</code>, <code>cn</code>, <code>pt</code>, <code>ja</code>, <code>id</code>, <code>hi</code>.</li>
<li><code>tz</code> – time zone offset.</li>
<li><code>fm</code> – source currency code, for example <code>EUR</code>.</li>
<li><code>to</code> – target currency code, for example <code>USD</code>.</li>
<li><code>st</code> – theme. Supported values: <code>primary</code>, <code>info</code>, <code>danger</code>, <code>warning</code>, <code>gray</code>, <code>success</code>.</li>
<li><code>bg</code> – widget background color when rounded corners are enabled, for example <code>FFFFFF</code>.</li>
<li><code>lr</code> – large widget mode. Use <code>1</code> to enable it or <code>0</code> to disable it.</li>
<li><code>rd</code> – straight corners. Use <code>1</code> for straight corners or <code>0</code> for rounded corners.</li>
<li><code>size_width</code> – widget width, for example <code>100%</code>.</li>
</ul>
<p>Currency codes are listed at <a href="https://currencyrate.today/different-currencies" rel="nofollow ugc">https://currencyrate.today/different-currencies</a>.</p>
<h3>Donations</h3>
<p>Official website and data source: <a href="https://currencyrate.today/" rel="nofollow ugc">CurrencyRate.Today</a></p>
<p>You may also like these plugins:</p>
<ul>
<li><a href="https://wordpress.org/plugins/crypto-converter-widget/" rel="ugc">Crypto Converter ⚡ Widget</a></li>
<li><a href="https://wordpress.org/plugins/cryptocurrency-price-widget/" rel="ugc">Cryptocurrency Price Widget</a></li>
<li><a href="https://wordpress.org/plugins/currency-converter-calculator/" rel="ugc">Currency Converter Calculator</a></li>
<li><a href="https://wordpress.org/plugins/currency-converter-widget-pro/" rel="ugc">Currency Converter Widget ⚡ PRO</a></li>
<li><a href="https://wordpress.org/plugins/currencyrate-today-currency-blocks/" rel="ugc">CurrencyRate.Today – Currency Blocks and Widgets</a></li>
<li><a href="https://wordpress.org/plugins/exchange-rates/" rel="ugc">Exchange Rates</a></li>
<li><a href="https://wordpress.org/plugins/exchange-rates-widget/" rel="ugc">Exchange Rates Widget</a></li>
<li><a href="https://wordpress.org/plugins/fx-currency-converter/" rel="ugc">FX Currency Converter</a></li>
</ul>


Currency Converter Calculator

Useful widget

Beautiful live currency converter for 190+ currencies, crypto, and metals. No API key needed.

Euro FxRef Currency Converter (by DKZR) vs Currency Converter Calculator