Included widgets

ForeignKeySearchInput: An ajax auto-complete widget that replaces the normal select input.

Included for the admin

ExtendedModelAdmin: An extension of django.admin.ModelAdmin that make it easy to use the included widgets in the admin view.

Example usage:

from jquery_widgets.admin import ExtendedModelAdmin
from myapp.models import MyModel

class MyModelAdmin(ExtendedModelAdmin):
     ...
     # Use the ForeignKeySearchInput widget for the field 'user'. Let the
     # search_fields be 'username' and 'email':
     related_search_fields = {'user': ('username', 'email'),}

Using pip (or easy_install):

Stable:

$ sudo pip install django-jquery-widgets

Development:

$ sudo pip install -e git://github.com/smyrman/django-jquery-widgets.git#egg=django-jquery-widgets

Getting the source repository:

If you want to include the code with your django project, rather then installing it to your system, you can download a recent version and copy the jquery_widgets folder into your django project.

Git:

$ git clone git://github.com/smyrman/django-jquery-widgets.git

Quick guide

If you use a Unix-flavoured OS and Django >= 1.2, this is all the required steps to get django-jqury-widgets working:

1 Add ‘jquery_widgets’ to your settings.INSTALLED_APPS

2 Add This line to your urlconf:

url(r'^jqw/', include('jquery_widgets.urls', namespace='jquery-widgets')),

3 Symlink static media into your media-root by issuing:

$ python manage.py syncdb

If Django >= 1.2 and ADMIN_MEDIA_PREFIX is configured in settings, you are done.

Explained

1 Add ‘jquery_widgets’ to your settings.INSTALLED_APPS.

2 Add This line to your urlconf (replace ‘jqw’ with whatever you like):

url(r'^jqw/', include('jquery_widgets.urls', namespace='jquery-widgets')),

3 Include application static media:

Unix: Issue ‘python manage.py syncdb’. This will create a symlink to ‘<path>/jquery_widgets/media’, in your MEDIA_ROOT. The symlink will be named: ‘jquery_widgets’.

Windows: You will have to manually copy the media directory form jquery_widgets to your MEDIA_ROOT, and renamed it to jquery_widgets.

4 Include jQuery:

Django <= 1.2: You can configure settings.JQUERY_URL to point to your jQuery library.

If the JQURY_URL setting is not given, the jquery_widgets app will default to think that jQuery is located at ‘<MEDIA_URL>js/jquery.min.js’.

Django >= 1.2: if the JQURY_URL setting is not given and ADMIN_MEDIA_PREFIX is found in your setings, the jqury_widgets will default to think that jQuery is located at ‘<ADMIN_MEDIA_PREFIX>js/jquery.min.js’. It will also take some steps to make sure that jquery is copied back into the global javascript namespace (Django admin puts jQury in the ‘django.jquery’ namespace).