# Currency Code
Contributors: stevenkellow
Author URI: http://www.stevenkelllow.com
Plugin URI: http://www.stevenkellow.com/plugins
Tags: currency, conversion, dollars, widget, shortcode
Tested up to: 4.6.1
Requires at least: 4.0
Stable tag: 0.1
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Currency code lets you use live currency conversions either as a shortcode in your content or as a widget in your sidebar.

Supports 31 different currencies, with values updating automatically on site once a day.

Conversation values are processed by fixer.io (http://fixer.io) & currency rate library (hosted in /js/money.min.js) provided by  Openexchangerates (https://openexchangerates.org/).  NO DATA COLLECTED BY EITHER SERVICE OR PLUGIN.

Fixer.io Licence: https://github.com/hakanensari/fixer-io/blob/master/LICENSE
OpenExchangeRates Licence: https://github.com/openexchangerates/money.js/blob/master/license

### Installation

1. Upload the plugin files to the `/wp-content/plugins/currency-code` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress

Shortcodes work out-of-the-box and widgets require adding to your sidebar before being available.

### FAQ / Info

##### Shortcode

To use the shortcode, simply use something like the default value below in your content:

[currency from="GBP" to="USD" round="2"]

You can replace the currency values with any of the supported currencies, which are listed below.

The round attribute controls to how many decimal places the figure display will round to.

The sample output for this is:

1 GBP = 1.33 USD

##### Widget

To use the widget go to Appearance -> Widgets and drag the Currency Converter widget into one of your sidebars.

The sample output of the widget is the same as the shortcode:

1 GBP = 1.33 USD

To see how the widget works code-wise check out the JSFiddle the widget is built from (https://jsfiddle.net/stevenkellow/x3hdtja6/2/)


##### Currencies 

Here are the 31 available currencies for use with this plugin:

AUD  =  Australian Dollars  
BRL  =  Brazilian Reals  
BGN  =  Bulgarian Levs  
CAD  =  Canadian Dollars  
CNY  =  Chinese Yuan Renminbi  
HRK  =  Croatian Kunas  
CZK  =  Czech Koruna  
DKK  =  Danish Kroner  
EUR  =  Euros  
HKD  =  Hong Kong Dollar  
HUF  =  Hungarian Florins  
INR  =  Indian Rupee  
IDR  =  Indonesian Rupiah  
ILS  =  Israeli Shekel  
JPY  =  Japanese Yen  
KRW  =  Korean Won  
MYR  =  Malaysian Ringgits  
MXN  =  Mexican Pesos  
NZD  =  New Zealand Dollar  
NOK  =  Norwegian Kroner  
PHP  =  Philippine Pesos  
PLN  =  Polish Zloty  
RON  =  Romanian Leus  
RUB  =  Russian Rubles  
SGD  =  Singapore Dollars  
ZAR  =  South African Rand  
SEK  =  Swedish Krona  
CHF  =  Swiss Francs  
THB  =  Thai Baht  
TRY  =  Turkish Lira  
GBP  =  UK Pounds  
USD  =  US Dollars

### Changelog

0.1 - 20th October 2016
- First version of the plugin