Title: Currencyr
Author: Firman Wandayandi
Published: <strong>Decembro 17, 2012</strong>
Last modified: Januaro 4, 2013

---

Priserĉi kromprogramojn

![](https://ps.w.org/currencyr/assets/banner-772x250.jpg?rev=644662)

Tiu ĉi kromprogramo **ne estis testita en la 3 lastaj gravaj eldonoj de WordPress**.
Eble ĝi ne plu estas prizorgata kaj ĝi eble havus kongruajn problemojn en novaj 
versioj de WordPress.

![](https://s.w.org/plugins/geopattern-icon/currencyr_414449.svg)

# Currencyr

 De [Firman Wandayandi](https://profiles.wordpress.org/firmanw/)

[Elŝuti](https://downloads.wordpress.org/plugin/currencyr.zip)

 * [Detaloj](https://eo.wordpress.org/plugins/currencyr/#description)
 * [Pritaksoj](https://eo.wordpress.org/plugins/currencyr/#reviews)
 *  [Instalo](https://eo.wordpress.org/plugins/currencyr/#installation)
 * [Programado](https://eo.wordpress.org/plugins/currencyr/#developers)

 [Helpo](https://wordpress.org/support/plugin/currencyr/)

## Priskribo

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.

See it in action at http://demo.firmanw.com/wp/currencyr.

_Note: This plugin requires PHP 5.3.0 or later, do not ever try to install if you
running the older version._

#### Features

 * Inline converter using [Currencyr for jQuery](http://firmanw.github.com/jquery-currencyr)
 * 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

#### 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.

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, tweet [@firmanw](http://twitter.com/firmanw) for fast 
response, or head over to the [support forum](https://wordpress.org/support/plugin/currencyr).

## Ekrankopioj

 * [[
 * Converter tooltip
 * [[
 * The settings page
 * [[
 * The widget

## Instalo

 1. Install Currencyr either via the WordPress.org plugin directory, or by uploading
    the files to your server
 2. Activate the Currencyr through the Plugins menu in WordPress
 3. Go to Currencyr menu to get started
 4. You need to update rates to populate cache immediately, or let WP Cron do it

## Pritaksoj

There are no reviews for this plugin.

## Kontribuantoj k. programistoj

“Currencyr” estas liberkoda programo. La sekvaj homoj kontribuis al la kromprogramo.

Kontribuantoj

 *   [ Firman Wandayandi ](https://profiles.wordpress.org/firmanw/)

[Traduki “Currencyr” en vian lingvon.](https://translate.wordpress.org/projects/wp-plugins/currencyr)

### Ĉu interesita en programado?

[Browse the code](https://plugins.trac.wordpress.org/browser/currencyr/), check 
out the [SVN repository](https://plugins.svn.wordpress.org/currencyr/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/currencyr/) by [RSS](https://plugins.trac.wordpress.org/log/currencyr/?limit=100&mode=stop_on_copy&format=rss).

## Ŝanĝprotokolo

#### 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

## Metadatumoj

 *  Version **1.0.4**
 *  Last updated **antaŭ 13 jaroj**
 *  Active installations **100+**
 *  WordPress version ** 3.3 or higher **
 *  Tested up to **3.3.2**
 *  Language
 * [English (US)](https://wordpress.org/plugins/currencyr/)
 * Tags
 * [conversion](https://eo.wordpress.org/plugins/tags/conversion/)[currency](https://eo.wordpress.org/plugins/tags/currency/)
   [ecommerce](https://eo.wordpress.org/plugins/tags/ecommerce/)[money](https://eo.wordpress.org/plugins/tags/money/)
   [shop](https://eo.wordpress.org/plugins/tags/shop/)
 *  [Altnivela rigardo](https://eo.wordpress.org/plugins/currencyr/advanced/)

## Pritaksoj

 4.1 out of 5 stars.

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/currencyr/reviews/?filter=5)
 *  [  2 4-star reviews     ](https://wordpress.org/support/plugin/currencyr/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/currencyr/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/currencyr/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/currencyr/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/currencyr/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/currencyr/reviews/)

## Kontribuantoj

 *   [ Firman Wandayandi ](https://profiles.wordpress.org/firmanw/)

## Helpo

Got something to say? Need help?

 [Vidi helpforumon](https://wordpress.org/support/plugin/currencyr/)

## Donaci

Ĉu vi volas subteni la pluevoluigon de tiu ĉi kromprogramo?

 [ Donaci al tiu ĉi kromprogramo ](http://firmanw.com/donate)