isi-gach/django-taggit-jquery-tag-it

jQuery Tag-it for django-taggit

django-taggit-jquery-tag-it

About

This is a fork of django-taggit-autocomplete, which is in turn a fork of django-tagging-autocomplete.

They can be found in:

• http://code.google.com/p/django-tagging-autocomplete/
• https://github.com/Jaza/django-taggit-autocomplete

This fork make uses of Tag-it! a jQuery UI plugin:

• https://github.com/aehlke/tag-it

It enhances django-taggit by adding autocompletion and a nicer UI:

• https://github.com/alex/django-taggit

This app works also works with django-taggit-hvad, see:

• https://github.com/rasca/django-taggit-hvad

Installation

1. We recomend using pip and virtualenv:

   pip install -e git+git@github.com:rasca/django-taggit-jquery-tag-it.git#egg=django-taggit-autocomplete

2. Add 'tagging_autocomplete' to INSTALLED_APPS in your project's settings.py file:

   INSTALLED_APPS = (

   'tagging',
   'tagging_autocomplete',

   # ...

3. Add the following line in you project's urls.py file:

   (r'^taggit_autocomplete/', include('taggit_autocomplete.urls')),

4. You should provide jQuery and jQuery UI (and a theme). If they aren't available in the current context, set TAGGIT_AUTOCOMPLETE_CSS and TAGGIT_AUTOCOMPLETE_JS in your settings file. Both settings must be lists.

5. Enjoy

• Extra settings: TAGGIT_AUTOCOMPLETE_FILTERS - dictionary with filter over autocomplete tags, example {'name__icontains': 'fashion'}

Usage

The easiest solution is to user our subclass of taggit.managers.TaggableManager in the tagged models.

Example:

from django.db import models
from taggit_autocomplete.managers import TaggableManager

class SomeModel(models.Model):
    tags = TaggableManager()

Include form media in template after jquery.ui load: {{ someform.media }} or apply jquery tagit function to input fields. (See class Media in widget TagAutocomplete and tag-it.js button file code) More info: https://docs.djangoproject.com/en/1.0/topics/forms/media/