Skip to main content

Adds support for multiple currencies as a Django application.

Project description

Introduction

django-currencies allows you to define different currencies, and includes template tags/filters to allow easy conversion between them. Usage

Once you have everything set up (read the included INSTALL.txt and docs/), you will be able to use the following code in your templates:

{% change_currency [price] [currency_code] %}

# i.e:

{% change_currency product.price "USD" %}

# or if we have the currencies.context_processors.currencies
# available:

{% change_currency product.price CURRENCY.code %}

or use the filter:

{{ [price]|currency:[currency] }}

# i.e.:

{{ product.price|currency:"USD" }}

or set the CURRENCY context variable with a POST to the included view:

{% url currencies_set_currency [currency] %}

OpenExchangeRates integration

django-currencies has builtin integration with openexchangerates.org.

You will need to specify your API key in your settings file:

OPENEXCHANGERATES_APP_ID = "c2b2efcb306e075d9c2f2d0b614119ea"

You will then be able to use the management commands “initcurrencies” and “updatecurrencies”. The former will create any currency that exists on openexchangerates.org with a default factor of 1.0. It is completely optional and does not require an API key.

The updatecurrencies management command will update all your currencies against the rates returned by openexchangerates.org. Any missing currency will be left untouched.

Source Code

The source is kept under git version control at https://github.com/panosl/django-currencies

You can get it by cloning the repository:

git://github.com/panosl/django-currencies.git

Documentation

You can browse it online here: http://readthedocs.org/projects/django-currencies/

Running Tests

I’m using nose along with nosedjango

The settings.py is inside the tests/ directory, so you’ll need to cd to it, and:

nosetests -v --with-django

Project details


Release history Release notifications

History Node

0.4.0

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

This version
History Node

0.3.0

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-currencies-0.3.0.tar.gz (13.4 kB) Copy SHA256 hash SHA256 Source None Oct 19, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page