currency.converter

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.