django-simple-currencies 0.1

django-simple-currencies
===

django-simple-currencies 允许您定义不同的货币，并包括模板标签/过滤器，以允许轻松地在它们之间进行转换。

[](https://pypi.python.org/pypi/django-simple-currencies/)
[](https://pypi.python.org/pypi/django-simple-currencies/)
[](https://pypi.python.org/pypi/django-simple-currencies/)

## 安装

您可以将此存储库克隆到您的项目中，或者使用 ```pip install django-simple-currencies``` 安装

您需要在项目的 ``settings.py`` 文件中将 ```currencies``` 添加到 ```INSTALLED_APPS```

```python
INSTALLED_APPS = (
...
'currencies',
)
```

将 ```currencies.middleware.CurrencyMiddleware``` 添加到 ```MIDDLEWARE_CLASSES```，必须在 ```django.contrib.sessions.middleware.SessionMiddleware``` 之后

```python
MIDDLEWARE_CLASSES = (
...
'django.contrib.sessions.middleware.SessionMiddleware',
'currencies.middleware.CurrencyMiddleware', # 必须在 'SessionMiddleware' 之后
...
)
```

如果您打算使用网站级别的缓存，请添加 ```currencies.middleware.CacheCurrencyMiddleware```，但在 ```django.middleware.cache.FetchFromCacheMiddleware``` 之前

```python
MIDDLEWARE_CLASSES = (
...
'currencies.middleware.CacheCurrencyMiddleware', # 必须在 'FetchFromCacheMiddleware' 之前
'django.middleware.cache.FetchFromCacheMiddleware',
)
```

确保在 ```TEMPLATE_CONTEXT_PROCESSORS``` 中列出 `django.core.context_processors.request` 上下文处理器

```python
TEMPLATE_CONTEXT_PROCESSORS = [
...
"django.core.context_processors.request"
]
```

并且不要忘记将此行添加到您网站的根URLConf中

```python
url(r'^currencies/', include('currencies.urls')),
```

然后运行 ```./manage.py syncdb``` 以创建所需的数据库表


## 配置

django-simple-currencies 内置了与 [Open Exchange Rates](http://openexchangerates.org/) 的集成

您需要在您的 ``settings.py`` 文件中指定您的API密钥

```python
OPENEXCHANGERATES_APP_ID = "c2b2efcb306e075d9c2f2d0b614119ea"
```

然后您将能够使用管理命令“currencies”和“update_rates”。前者将导入在[Open Exchange Rates](http://openexchangerates.org/)上定义的任何货币。您可以有选择地导入货币，例如以下命令仅导入USD和EUR货币：

```shell
./manage.py currencies --import=USD --import=EUR
```

“update_rates”管理命令将根据[Open Exchange Rates](http://openexchangerates.org/)返回的汇率更新您的所有货币。任何缺失的货币将保持不变。

## 使用方法

首先，在您想使用它的每个模板中加载```currencies

{% load currencies %}

以获取活动货币列表

{% get_currencies as CURRENCIES %}

以获取当前设置的货币

{% get_current_currency as CURRENCY %}

然后转换到指定的货币

{% change_currency [amount] [currency_code] %}

或使用过滤器

{{ [amount]|currency:[currency_code] }}

请参阅```example```应用程序。此应用程序用于手动测试此包的功能。这也是一个好例子。

您只需要Django 1.4或更高版本才能运行它。它可能在较旧版本上运行，但没有经过测试。