A simple yet advance currency converter

Dependencies

• accounting.js (included): A library that provides reliable localisation and formatting of money and currency.
• jQuery Cookie (included): A simple, lightweight jQuery plugin for reading, writing and deleting cookies.

Installation

Include these lines after jQuery library.

<style rel="stylesheet" type="text/css" href="/path/to/currencyr.css">
<style rel="stylesheet" type="text/css" href="/path/to/themes/@theme@/@theme@.css">
<script src="/path/to/currencyr.js"></script>

Usage

First you MUST assign the currencies, base and rates:

var currencies = {
        "AED": "United Arab Emirates Dirham",
        "AFN": "Afghan Afghani",
        "ALL": "Albanian Lek",
        "AMD": "Armenian Dram",
        ...
    },
    base = 'USD',
    rates = {
        "AED": 3.673177,
        "AFN": 51.719367,
        "ALL": 107.942001,
        "AMD": 405.503334,
        ...
    };

$.currencyr( currencies, base, rates );

It doesn't matter the way it assigned, statically or dinamically flavour.

Then call the plugin right on selector:

$('.amount').currencyr();

It's super easy to integrate with Open Exchange Rates:

var appId = YOUR_APP_ID;
$.getJSON( 'http://openexchangerates.org/api/currencies.json', function( response ) {
    var currencies = response;
    $.getJSON( 'http://openexchangerates.org/api/latest.json', { 'app_id': appId }, function( response ) {
        $.currencyr( currencies, response.base, response.rates );
        $( '.amount' ).currencyr();
    });
});

Options

$('.amount').currencyr( { option_name: option_value } );

• root (default: "currencyr") — An Id of root container without "#"
• numcodes (default: 5) — How many currency codes of dropdown
• pad (default: 20) — Number of space of dialog with current target in pixels
• currency (default: null) — Default currency
• thousand (default: ",") — Thousand separator
• decimal (default: ".") — Decimal point separator
• precision (default: 2) — Decimal places

Roadmap

• Even more smooth scroll
• Add scroll indicator
• Add auto-complete input
• Enable keystroke
• More themes

Feedback

If you have any feedback, any at all, tweet @firmanw, or head over to the Currencyr github repository and create a new issue.