django-select2/README.md

Django-Select2
==============

This is a [Django](https://www.djangoproject.com/) integration of [Select2](http://ivaynberg.github.com/select2/).

The app includes Select2 driven Django Widgets and Form Fields.

More details can be found on my blog at - [http://blog.applegrew.com/2012/08/django-select2/](http://blog.applegrew.com/2012/08/django-select2/).

External Dependencies
=====================

* Django - This is obvious.
* jQuery - This is not included in the package since it is expected that in most scenarios this would already be available.

Example Application
===================
Please checkout `testapp` application. This application is used to manually test the functionalities of this component. This also serves as a good example.

You need only django 1.4 or above to run that.

Changelog Summary
=================

### v2.0

* Mostly major bug fixes in code and design. The changes were many, raising the possibility of backward incompatibilty. However, the backward incompatibilty would be subtle.

* Auto fields (sub-classes of AutoViewFieldMixin) now accepts `auto_id` parameter. This can be used to provide custom id for the field. The default is 'module.field_class_name'. Ideally only the first instance of an auto field is registered. This parameter can be used to force registration of additional instances by passing a unique value.
Enhanced Heavy fields. Added 'auto' fields. Some bug fixes. 2012-08-05 07:30:44 +00:00			`Django-Select2`
Readme update 2012-07-23 20:17:31 +00:00			`==============`

Enhanced Heavy fields. Added 'auto' fields. Some bug fixes. 2012-08-05 07:30:44 +00:00			`This is a [Django](https://www.djangoproject.com/) integration of [Select2](http://ivaynberg.github.com/select2/).`

			`The app includes Select2 driven Django Widgets and Form Fields.`

			`More details can be found on my blog at - [http://blog.applegrew.com/2012/08/django-select2/](http://blog.applegrew.com/2012/08/django-select2/).`

Added example section in Readme 2012-08-21 18:15:06 +00:00			`External Dependencies`
Enhanced Heavy fields. Added 'auto' fields. Some bug fixes. 2012-08-05 07:30:44 +00:00			`=====================`

			`* Django - This is obvious.`
			`* jQuery - This is not included in the package since it is expected that in most scenarios this would already be available.`
The changes in this code crashes Python 2.7.1 (OSX build) 2012-08-20 13:38:52 +00:00
Added example section in Readme 2012-08-21 18:15:06 +00:00			`Example Application`
			`===================`
			Please checkout `testapp` application. This application is used to manually test the functionalities of this component. This also serves as a good example.

			`You need only django 1.4 or above to run that.`

The changes in this code crashes Python 2.7.1 (OSX build) 2012-08-20 13:38:52 +00:00			`Changelog Summary`
			`=================`

Multi value bu fixes Many bugs ironed out of Multi value fields. Added many new tests for multi value fields. 2012-08-21 17:51:41 +00:00			`### v2.0`

More bug fixes. And added 'auto_id' parameter for auto fields. 2012-08-22 05:49:30 +00:00			`* Mostly major bug fixes in code and design. The changes were many, raising the possibility of backward incompatibilty. However, the backward incompatibilty would be subtle.`

			* Auto fields (sub-classes of AutoViewFieldMixin) now accepts `auto_id` parameter. This can be used to provide custom id for the field. The default is 'module.field_class_name'. Ideally only the first instance of an auto field is registered. This parameter can be used to force registration of additional instances by passing a unique value.