Currency Converter

Currency Converter

Project Description

Introduction

Overview

currency.converter package fetches currency rate data from European Central Bank for about recent 3 months. Once the data is fetched, the data is persisted in ZODB in case of whatever difficulty to fetch the data again. There are currency converter page and portlet included in this package and several methods you can use for your own applications.

Log in as a manager and go to the page, "your_portal/@@manage-currency". By visiting the page, the current currency data will be fetched if possible and automatically persisted.

Features

Site manager can give two different variables in addition to currencies, days and margin.

Days
This amout is used to caclulate average of currencies. For example, if you input 10 to this field, 10 recent days are used to calculate average currency rate. This keeps currency rate fluctuation smaller than using everyday plain rate. If nothing or 0 is input there, it doesn't calculate average, but uses current rate.
Margin
Margin adds % of rate to the currency rate. 0 is 0 % margin where is no margin.

Changelog

0.5.5 (2010-08-27)

  • Path to sample-90d.xml fixed for test.

0.5.4 (2010-08-24)

  • Added IPortalCurrency to adapt currency to portal.
  • Tested with Plone-4.0rc1.

0.5.3 (2010-06-03)

  • currency-converter view updated.
  • Deprecated import updated.
  • Tested with Plone-4.0b3.

0.5.2 (2010-05-02)

  • Minor visual updates.
  • Tested with Plone-4.0b2.

0.5.1 (2009-08-27)

  • Polish currency name changed to avoid UnicodeEncodeError.
  • Tested with Plone-3.3.

0.5.0 (2009-08-13)

  • Sample xml file added for test.
  • Tested with Plone-3.3rc5.

0.4.4 (2009-06-18)

  • Translations updated.

0.4.2 (2009-06-09)

  • Currency code and name vocabulary added.

0.3.6 (2009-01-18)

  • Initial release

Installation

If you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, just do this:

  • Add currency.converter to the list of eggs to install, e.g.:

    [buildout]
    eggs =
    currency.converter
  • Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

    [instance]
    recipe = plone.recipe.zope2instance
    zcml =
    currency.converter
  • Re-run buildout, e.g. with:

    $ ./bin/buildout

Setting Time Server

To fetch the currency data regularly like every day, describe to the instance section of buildout.cfg the next way.

[instance]
zope-conf-additional =
<clock-server>
method /your_portal/@@get-currency
period 86400
user admin
password admin_pass
host localhost
</clock-server>
  • Change your_portal to your plone site id
  • Period is seconds between eache fetch of the currency data. 86400 seconds are the 24 hour. The data is usually updated daily on week days.
  • Describe admin name to admin and its password to admin_pass.
  • host is host name of your server.

Self-Certification

[X] Internationalized

[X] Unit tests

[ ] End-user documentation

[X] Internal documentation (documentation, interfaces, etc.)

[X] Existed and maintained for at least 6 months

[ ] Installs and uninstalls cleanly

[ ] Code structure follows best practice

Current Release
currency.converter 0.5.5

Released Aug 27, 2010

Download file Get Currency Converter for all platforms
currency.converter-0.5.5.tar.gz
If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.

All Releases

Version Released Description Compatibility Licenses Status
0.5.5 Aug 27, 2010 More about this release… GPL final
0.5.4 Aug 25, 2010 More about this release… GPL final
0.5.3 Jun 02, 2010 More about this release… GPL final
0.5.2 May 04, 2010 More about this release… GPL final
0.5.1 Aug 27, 2009 More about this release… final
0.4.4 Jun 18, 2009 Japanese translations updated. More about this release…
Plone 3
GPL final
0.4.2 Jun 08, 2009 Currency code and name vocabulary added. More about this release…
Plone 3
GPL final