Download the PHP package davidyell/currency-exchange without Composer
On this page you can find all versions of the php package davidyell/currency-exchange. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download davidyell/currency-exchange
More information about davidyell/currency-exchange
Files in davidyell/currency-exchange
Package currency-exchange
Short Description A CakePHP 2 helper for displaying prices in various currencies
License
Homepage https://bitbucket.org/ukwm/campaigns-plugins-currencyexchange/overview
Informations about the package currency-exchange
Currency Exchange
A helper for CakePHP 3 which will display a currency in a different currency using current exchange rates.
It will cache the result and check the response before invalidating the cache to ensure that your site always serves some currency data, even if it's a little stale. The data is cached for a year and updated using a shell.
Requirements
- CakePHP 3.x
- PHP 5.4.16+
- Currencylayer.com api account
Installation
You can require it with composer require "davidyell/currency_exchange:3.x-dev"
Set your Currency Layer API key.
Configure::write('currencyLayer.apikey', "YourApiKeyGoesHere");
Helper
The helper is provided to do the front-end conversion when displaying prices in different currencies. The helper takes a number of options to configure its behaviour.
Helper configuration
When you are adding the helper to your $helpers
array in your controller, you can pass an array of options. The defaults
are shown below as an example. If you're happy with the defaults you don't need to pass any configuration.
Shell
A shell is provided to allow updating of the cached exchange rate data via a cron job. This prevents the request having to wait to see if the remote api is available before returning data to the user.
Instead you can set the shell to run on a cron as often as you need and it will update the data in the background, keeping your front-end quick for your users and your data fresh.
Updating the cache
The frequency at which the cache is updated is controller by how often you chose to run the shell task. I'd recommend setting a cron job which runs once a week to update the cache.