Skip to content
This repository has been archived by the owner on Jun 21, 2021. It is now read-only.
/ wp-currencyr Public archive

A simple yet advance currency converter plugin for WordPress

Notifications You must be signed in to change notification settings

firmanw/wp-currencyr

Repository files navigation

=== Currencyr ===
Author: Firman Wandayandi
Contributors: firmanw
Author URI: http://firmanw.com
Plugin URI: http://firmanw.github.com/wp-currencyr
Donate Link: http://firmanw.com/donate
Tags: money, currency, conversion, ecommerce, shop, store
Requires at least: 3.3
Tested up to: 3.3
Stable tag: 1.0.4

A simple yet advanced, intuitive, easy-to-use and complete currency converter plugin with a beautiful unique converter tooltip.

== Description ==

Instead of traditional "calculator" looks converter, Currencyr take the advance of "tooltip" and sit right at the amount to allow user convert it. Support various exchange rates provider API running as WP Cron task and able to auto-determinate local currency of visitor. Currencyr also offers currency converter widget, shortcode and function.

Visit plugin homepage at http://firmanw.github.com/wp-currencyr or head over the demo at http://demo.firmanw.com/wp/currencyr.

= Features =

* Inline converter using Currencyr for jQuery
* Various exchange rates providers - Yahoo!, Google, Open Exchange Rates, European Central Bank and FoxRates
* Support database cache driven for fast response
* WP Cron task scheduler enabled
* Shortcode quick conversion support
* Currency table and converter widget
* Function for theme developer
* Auto-determinate local currency via IP detection using [IP2C](http://firestats.cc/wiki/ip2c)
* Support integration with various ecommerce plugins - WooCommerce, WP-eCommerce, Shopp and Easy Digital Downloads
* Translation support

*Note: This plugin requires at least PHP 5.3.0 and do not ever try to install if you running older version of PHP.*

= Shortcode =

To enable the shortcode simply use [currencyr] and use the following syntax:

`[currencyr amount=$amount <from=$code> to=$code<|$code>]`

* **amount** - The number that you wish to convert.
* **to** - The currency code. Use "|" as separator for multiple conversion.
* **from** (optional) - The currency code. If omitted the Base Currency from setting will be use.

Examples:
`[currencyr amount=99.99 to=gbp]`

`[currencyr amount=99.99 from=aud to=gbp]`

`[currencyr amount=99.99 to=gbp|eur|cad]`

= Function Call =

The conversion feature is available to call within templates or codes using either currencyr_exchange() or the_currencyr_exchange(). Both functions share the same arguments, the diferrent is the_currencyr_exchange() is only echoes the result automatically. You can call the functions as WordPress style or PHP with the following arguments:

* **amount** - The number that you wish to convert.
* **to** - The currency code.
* **from** (optional) - The currency code. If omitted the Base Currency from setting will be use.

`<?php echo currencyr_exchange( 'amount=99.99&to=cad'); ?>`

The code above is similar to:

`<?php echo currencyr_exchange( array( 'amount' => 99.99, 'to' => 'cad' ) ); ?>`

Also similar to:

`<?php echo currencyr_exchange( 99.99, 'cad' ); ?>`

= Roadmap =

* Add exchange rates table page
* Add custom currency support

= Feedback =
If you have any feedback, any at all, tweet [@firmanw](http://twitter.com/firmanw), or head over to the [support forum](http://wordpress.org/support/plugin/currencyr) or [github repository](https://github.com/firmanw/wp-currencyr) and create a new issue.

== Installation ==

1. Upload the "currencyr" folder to the "/wp-content/plugins" directory
2. Activate the Currencyr through the "Plugins" menu in WordPress
3. Go to Currencyr menu to get started

== Screenshots ==

1. Converter tooltip
2. The settings page
3. The widget

== Changelog ==

= 1.0.4 =

* Fixed wpdb error while retrieving WP e-Commerce configuration.

= 1.0.3 =

* Fixed menu and page icon for HiDPI screen.
* Fixed some URLs

= 1.0.2 =

* Added functions to able to use conversion within templates/codes
* Added handler when conversion return no result

= 1.0.1 =

* Fixed settings page capability typo
* Fixed widget number format
* Fixed plugin URI

= 1.0 =

Initial release

About

A simple yet advance currency converter plugin for WordPress

Resources

Stars

Watchers

Forks

Packages

No packages published