djangoshop-currencies 0.1.0

Django-SHOP integration with django-currencies

Django-SHOP integration with django-currencies

Introduction

This module allows Django-SHOP implementations to integrate live currency feeds. This will allow you to offer your shop product prices in the user’s chosen currency. The module is currently compatible with Django v1.10.7 and Django-SHOP v0.10.2. This documentation assumes a working knowledge of Django and Django-SHOP.

TODO

Please let us know of you have any feature suggestions, or wish to implement any of the below:

• Tests.

• Continuous build integration including compatibility testing with various python, Django and Django-SHOP versions.

Configuration

Follow the Readme for django-currencies. Install this module through pip: pip install djangoshop-currencies.

The Django-SHOP Money system has been extended to use django-currencies as a currency conversion backend. To enable this functionality your currencies configuration must satisfy the following requirements:

1. ISO4217Exponent and symbol populating using manage.py currencies iso (This automatically imports the currencies set in the SHOP_CURRENCIES setting)

2. Currency factors populating using manage.py updatecurrencies <source> (This also sets the base currency to SHOP_DEFAULT_CURRENCY)

3. Some currencies set to active in the admin interface

Usage

Replace the DefaultCartModifier with the provided CurrencyCartModifier in your shop settings:

SHOP_CART_MODIFIERS = (
    # provides the default cart lines
    'shop_currencies.modifiers.CurrencyCartModifier',
    ...

Use the Money conversion extension which provides the to(code) function like so:

from django.db import models
from currencies.utils import get_currency_code
from shop_currencies.money.fields import MoneyField

class MyModel(models.Model):
    unit_price = MoneyField()
    ...

    def get_price(self, request):
        session_currency_code = get_currency_code(request)
        return self.unit_price.to(session_currency_code)