currency.converter 0.5.0

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.

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

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.

Upgrading/reinstalling

When you reinstall or upgrade to new version, the persisted data is not migrated to new environment, so please visit your_portal/@@manage-currency after reinstall or upgrade to get the current data or if you have set the time server, you can wait till the server fetches those values for you.