crdist 0.1.7

crdist
=========

.. image:: https://travis-ci.org/solvo/crdist.svg
:target: https://travis-ci.org/solvo/crdist

为Django模型管理员提供的哥斯达黎加地理分布。

现在与django 1.11兼容。

.. note:
数据是西班牙语。

所有源代码均为英语，并当然有西班牙语翻译。

安装
-------------

在您的Python环境中安装crdist

1- 下载并安装包

.. code:: bash

$ pip install crdist

通过Github

.. code:: bash

$ pip install git+https://github.com/solvo/crdist.git


将crdist放入您的INSTALLED_APPS

.. code:: python

INSTALLED_APPS = (
...
'crdist',
)

Include crdist in your urls.py

.. code:: python

from django.conf.urls import url, include
urlpatterns = [
url(r'^crdist/', include("crdist.urls")),
]


运行迁移

.. code:: bash

$ python manage.py migrate


用法
---------

在您的模型中，在*models.py*文件中创建与District的外部关系。

.. code:: python

from crdist.models import District
class Test(models.Model)
name = models.CharField(max_length=64)
location = models.ForeignKey(District)


我们提供了一个表单小部件，特别用于在同一个小部件中选择省、县和区。例如。

.. code:: python

from crdist.widgets import DistrictSelect
from crdist.models import District

class CRForm(forms.Form)
district = forms.ModelChoiceField(queryset=District.objects.all(),
widget=DistrictSelect)


它也可以与admin界面一起使用，您可以在*admin.py*文件中添加一些代码。

.. code:: python

class TestAdminForm(forms.ModelForm)
class Meta
model = Test
fields = '__all__'
widgets = {
'district': DistrictSelect(attrs={"class": "form-control"}),
}


类 TestAdmin(admin.ModelAdmin)
表单 = TestAdminForm

admin.site.register(Test, TestAdmin)

我们也支持同一模型中的多个关系，因此您可以在同一页面上显示多个小部件。

JavaScript 触发器
-------------------------

- load_canton { "dist": 'div_district_' + name, "canton": 'div_canton_' + name }
- load_district { "dist": 'div_district_' + name }

.. 代码:: javascript

document.addEventListener("load_canton", function(e) {
console.log(document.cantoncrdist.dist);
console.log(document.cantoncrdist.canton); // divs 的 id
});