django-selectable 0.7.0

Auto-complete selection widgets using Django and jQuery UI.

Tools and widgets for using/creating auto-complete selection widgets using Django and jQuery UI.

Features

• Works with the latest jQuery UI Autocomplete library

• Auto-discovery/registration pattern for defining lookups

Installation Requirements

• Python 2.6 or Python 2.7

• Django >= 1.3

• jQuery >= 1.4.4

• jQuery UI >= 1.8

Note

Begining with version django-selectable version 0.6, Django 1.2 is no longer supported. While it may continue to work, bugs related to Django 1.2 support will not be fixed.

Version 0.7 adds experimental support for Python 3.2+ when used with Django 1.5+.

To install:

pip install django-selectable

Next add selectable to your INSTALLED_APPS to include the related css/js:

INSTALLED_APPS = (
    'contrib.staticfiles',
    # Other apps here
    'selectable',
)

The jQuery and jQuery UI libraries are not included in the distribution but must be included in your templates. See the example project for an example using these libraries from the Google CDN.

Once installed you should add the urls to your root url patterns:

urlpatterns = patterns('',
    # Other patterns go here
    (r'^selectable/', include('selectable.urls')),
)

Documentation

Documentation for django-selectable is available on Read The Docs.

Additional Help/Support

You can find additional help or support on the mailing list: http://groups.google.com/group/django-selectable

Contributing

If you think you’ve found a bug or are interested in contributing to this project check out our contributing guide.

If you are interested in translating django-selectable into your native language you can join the Transifex project.