Premium Currency Converter for jQuery

Introduction

The Premium Currency Converter for jQuery is a powerful and easy-to-use plugin that allows developers to add a currency conversion feature to their web application with just a few lines of code. This comprehensive tutorial will guide you on how to use the plugin to convert currencies, setup different exchange rates, handle user input, and present the results in a seamless and user-friendly manner.

Prerequisites

• jQuery 1.6.0 or higher is required
• The latest version of the Premium Currency Converter for jQuery plugin should be downloaded and included in your project
• HTML and CSS knowledge is essential

Step 1: Include the Plugin in Your Project

To begin using the Premium Currency Converter for jQuery, you first need to include the plugin's JavaScript file in your project. You can include the file by adding the following code in the head section of your HTML file:

<script src="https://example.com/premium-currency-converter/jquery.currency.converter.min.js"></script>

Assuming the plugin's script is located at https://example.com/premium-currency-converter/jquery.currency.converter.min.js in your project.

Step 2: Setup the Plugin

To activate the plugin, you need to create a new JavaScript object and pass the reference to the plugin's initialize method. This method configures the plugin and specifies the base currency, intermediate rates, and the range of currencies to be available for conversion. Here is an example:

var converter = {};

// Initialize the plugin with the base currency (default: USD)
converter.CC_Initialize({
    "base": "EUR", // Set the base currency
    "decimal Places": 2,
    "showSymbol": true,
    "calculateWithSymbols": true
});

// Set the rates
converter.CC_Load_Rates({
    'USD': 1, 'EUR': 0.84, 'JPY': 114, 'GBP': 0.74, 'USD_CAD': 0.97
});

In this example, the base currency is set to EUR, and exchange rates are provided for various currencies. The load_rates method is called to load the rates before converting currencies.

Step 3: Convert Currency

To convert a specific currency, you can call the CC_Convert method and pass in the base currency, and the target currency. Additionally, you can specify whether you want to convert both directions (i.e., convertBothDirections : true) or only forward direction (i.e., convertBothDirections : false). Here is an example:

var amount = 500;
var targetCurrency = "JPY";

converter.CC_Convert('EUR', targetCurrency, amount, {
    ConvertBothDirections: true // Whether to convert both direction
});

When the CC_Convert method is called, the plugin will perform the currency conversion and return an object containing the converted currency and its symbol.

Step 4: Formatting and Displaying the Conversion Result

To format the converted currency and display the result, you can make use of the CURRENCYSYMBOL property. Here's an example:

<p id=" converted-value">Converted value:</p>
<script>
var amount = 500;
var targetCurrency = "JPY";

converter.CC_Convert('EUR', targetCurrency, amount, {
    ConvertBothDirections: true // Whether to convert both direction
});

var convertedValue = converter.CC_Get_Latest_Currency_Value(converter.CC_Get_EUR_From_Base());
// formattedConvertedValue = jQuery(formatNumber(convertedValue)); // Optional: can format the number

$('converted-value').text(converter.CURRENCYSYMBOL + ' : ' + formattedConvertedValue + ' ' + $(convertedValue).text(); // Optional: can extract and format the currency from convertedValue
</script>

In the example above, the output is a paragraph with text displaying the converted value (CURRENCYSYMBOL) and the new converted amount.