2017 © Pedro Peláez
 

plugin codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

image

alessandrominoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  • Thursday, June 14, 2018
  • by AlessandroMinoccheri
  • Repository
  • 6 Watchers
  • 20 Stars
  • 103 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 12 Forks
  • 0 Open issues
  • 10 Versions
  • 3 % Grown

The README.md

codeigniter-currency-converter V 1.3.2

Code Quality Code Coverage Latest Stable Version License Build Status Total Downloads, (*1)

A Codeigniter library to convert your price from a currency to another, (*2)

Background

Is very frequently that inside your sites you need to convert your price from a currency to another. This library convert your price in every currency of the world., (*3)

It works with fixer.io api and store currency rates inside the site database if you want. User can configure in hour the time of currency rates update, if the user doesn't want to use database, rates are updated every time with the current conversion., (*4)

If you have set to use database, for example, user sets to update currency rates every hour, this library get the currency conversion from fixer.io the first time, store it inside the database and for the next hour it takes conversion rates from the database if exist. In this way reduce the request time to convert and every hour currency rates are updated., (*5)

If you haven't set to use database, instead, every time you call the library it makes a request to fixer.io api and gets the actual conversion rate. This solution is great if you have not a lot of request. Instead, if you have a lot of conversion request is better to use the database configuration., (*6)

Requirements

  • CodeIgniter 2.x or 3.x
  • PHP 5.3 or gretaer

Installation

With composer you can install this package:, (*7)

composer require alessandrominoccheri/codeigniter-currency-converter

Or Drag and drop the application/libraries/CurrencyConverter.php file into your application directories. Load it from your application/config/autoload.php using:, (*8)

$autoload['libraries'] = array('database', 'CurrencyConverter');

Or inside your model you can use:, (*9)

$this->CurrencyConverter = new CurrencyConverter();

It's important to have a valid database connection because the library saves conversion inside it if you want to use it., (*10)

Usage

To convert your price you can make a request like this from your model / controller:, (*11)

$result = $this->CurrencyConverter->convert('GBP', 'EUR', '2000.00', true, 1);

To get a list of currency code you can check here:, (*12)

List of available currency code, (*13)

Params

The function declaration to retrieve your converted price is:, (*14)

function convert($from_Currency, $to_Currency, $amount, $save_into_db = 1, $hour_difference = 1)
  • fromCurrency: is the actual price currency (Example: EUR, GBP)
  • toCurrency: is the currency that you want to convert your price (Example: EUR, GBP)
  • amount: is the price to convert (Example: 200, 20)
  • saveIntoDb: is the variable that configure to use the database or not, if not hour_difference params is escaped
  • hourDifference: is the hour difference to update your currency conversion. For example if you have set to update currency rates every hour, this library get the currency conversion from fixer.io the first time, store it inside the database and for the next hour it takes conversion rates from the database if exist.

Api KEY

To use this library you need to add your api key inside the configuration. to get your api key go to this site and generate it., (*15)

Generate your api key, (*16)

License

The MIT License (MIT), (*17)

Copyright (c) 2014 Alessandro Minoccheri, (*18)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:, (*19)

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software., (*20)

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE., (*21)

The Versions

14/06 2018

dev-master

9999999-dev https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Alessandro Minoccheri

codeigniter currency convert price

14/06 2018

v1.3.2

1.3.2.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Alessandro Minoccheri

codeigniter currency convert price

08/11 2017

v1.3.1

1.3.1.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Alessandro Minoccheri

codeigniter currency convert price

05/11 2017

v1.3.0

1.3.0.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Alessandro Minoccheri

codeigniter currency convert price

27/06 2017

v1.2.1

1.2.1.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Alessandro Minoccheri

codeigniter currency convert price

20/05 2017

v1.2.0

1.2.0.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Alessandro Minoccheri

codeigniter currency convert price

14/05 2017

v1.1.2

1.1.2.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Alessandro Minoccheri

codeigniter currency convert price

14/05 2017

dev-feature/improve_code

dev-feature/improve_code https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Alessandro Minoccheri

codeigniter currency convert price

07/05 2015

v1.1.1

1.1.1.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Alessandro Minoccheri

codeigniter currency convert price

01/02 2015

v1.1.0

1.1.0.0 https://github.com/AlessandroMinoccheri/codeigniter-currency-converter

A Codeigniter library to convert your price from a currency to another

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Alessandro Minoccheri

codeigniter currency convert price