Skip to content

This Django reusable app extends djang-tagging and provides you with a tab editing widget and autocompletion. Forked from django-tagging-autocomplete, uses jQuery Tag-IT (jQuery UI widget).

License

Notifications You must be signed in to change notification settings

nemesifier/django-tagging-autocomplete-tag-it

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

django-tagging-autocomplete-tag-it

Fork of django-tagging-autocomplete that works with a modified version (another fork) jQuery UI Tag-it.

This is not stable. If you would like to use this widget please share your ideas (and code) on how to improve it.

Demo:

To see the jQuery UI widget in action its demos: http://aehlke.github.com/tag-it/ The forked repository for the javascript is: https://github.com/nemesisdesign/tag-it

Features:

  • Tag editing
  • Autocompletition
  • Customizable minimum amount of letters before the autocompletition starts
  • Customizable maximum tags number
  • Costomizable max length of each tag
  • Aims to be flexible

Available settings:

TAGGING_AUTOCOMPLETE_MIN_LENGTH defaults to 1
TAGGING_AUTOCOMPLETE_REMOVE_CONFIRMATION defaults to True
TAGGING_AUTOCOMPLETE_ANIMATE defaults to True
TAGGING_AUTOCOMPLETE_MAX_TAGS defaults to 20 - this general setting can be overriden in each field if needed
TAGGING_AUTOCOMPLETE_JS_BASE_URL defaults to 'STATIC_URL/js/jquery-tag-it/'
TAGGING_AUTOCOMPLETE_JQUERY_UI_FILE defaults to 'https://ajax.googleapis.com/ajax/libs/jqueryui/1.8.12/jquery-ui.min.js'
TAGGING_AUTOCOMPLETE_CSS is a list of CSS files and defaults to ['TAGGING_AUTOCOMPLETE_JS_BASE_URL/css/ui-autocomplete-tag-it.css']

Usage

I wrote these instructions quickly, don't trust this completely.

###Usage in models:

# models.py
from django.db import models
from tagging_autocomplete_tagit.models import TagAutocompleteTagItField

class SomeModel(models.Model):
        # max_tags defaults to TAGGING_AUTOCOMPLETE_MAX_TAGS
        # If max_tags is specified it will override the value specified in TAGGING_AUTOCOMPLETE_MAX_TAGS
        tags = TagAutocompleteTagItField(max_tags=False)

###Using the form widget:

Alternatively you can use the TagAutocomplete form widget while creating your form. For example:

# forms.py
from django import forms
from tagging.forms import TagField
from tagging_autocomplete_tagit.widgets import TagAutocompleteTagIt

class SomeForm(forms.Form):
    # max_tags defaults to TAGGING_AUTOCOMPLETE_MAX_TAGS
    # If max_tags is specified it will override the value specified in TAGGING_AUTOCOMPLETE_MAX_TAGS
    tags = TagField(widget=TagAutocompleteTagIt(max_tags=5))

##Instalation

  1. You need to have django-tagging already installed

  2. Download django-tagging-autocomplete-tag-it and use setup.py to install it on your system: python setup.py install (NOT SURE THIS WORKS NOW)

  3. Copy "jquery-tag-it" folder of this repository to the 'js' folder specified in your project's STATIC_URL setting. If you want to put it somewhere else add TAGGING_AUTOCOMPLETE_JS_BASE_URL to your project settings.

  4. Add "tagging_autocomplete_tagit" to installed apps in your project's settings.

  5. Add the following line to your project's urls.py file:

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

About

This Django reusable app extends djang-tagging and provides you with a tab editing widget and autocompletion. Forked from django-tagging-autocomplete, uses jQuery Tag-IT (jQuery UI widget).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 64.7%
  • Python 26.6%
  • CSS 8.7%