Metadata-Version: 1.0
Name: currency.converter
Version: 0.5.5
Summary: Currency Converter
Home-page: http://pypi.python.org/pypi/currency.converter
Author: Taito Horiuchi
Author-email: taito.horiuchi@abita.fi
License: GPL
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.
        
Platform: UNKNOWN
Classifier: Framework :: Plone
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
