django-cep 1.1.2

安装

要安装django-cep，只需运行：

pip install django-cep

配置

我们需要将django-cep挂接到我们的项目中。

将cep放入设置模块中的INSTALLED_APPS：

INSTALLED_APPS = (
   ...
   'cep',
)

将cep urls.py绑定到main urls.py中，方法如下：

url(r'^cep/', include('cep.urls')),

使用量

目前唯一支持的语法是在cep字段的小部件中设置地址字段的id。有关设置此项的其他方法，请参见下一步文件。

1. 在表单中导入django cep小部件cepinput.py:

   from cep.widgets import CEPInput
   

2. 使用cepinut设置cep字段，并使用正确的地址字段id，例如：

   my_cep_field = ChangeToMyCEPFieldModelName(label=u"CEP",
                           help_text="Format: XXXXX-XXX",
                           widget=CEPInput(address={
                                                    'street': 'id_street_field',
                                                    'district': 'id_district_field',
                                                    'city': 'id_city_field',
                                                    'state': 'id_state_field'
                                                    }))
   

That stands for a street field ID equals id_street_field, district field ID equals id_district_field, city field ID equals id_city_field and a state field ID equals id_state_field.

还要注意，这个应用程序中使用的javascript需要JQuery才能正常运行。

强烈建议使用Django Localflavor的brstatechoicefield作为state字段，使其从列表中呈现正确的巴西状态。