django-taggit python

Simple tagging for django

django-taggit

django-taggit is a simpler approach to tagging with Django.

Differences between this fork and original django-taggit

  • some bugfixes
  • added ability to have more tag fields for one model
  • dropped support of Django < 1.3

Getting Started

This is unofficial fork of django-taggit, you have to install it from github: pip::

$ pip install git+git://github.com/yedpodtrzitko/django-taggit.git

Add "taggit" to your INSTALLED_APPS then just add a TaggableManager to your model and go::

from django.db import models

from taggit.managers import TaggableManager

class Food(models.Model):
    # ... fields here

    tags = TaggableManager()

Then you can use the API like so::

>>> apple = Food.objects.create(name="apple")
>>> apple.tags.add("red", "green", "delicious")
>>> apple.tags.all()
[<Tag: red>, <Tag: green>, <Tag: delicious>]

>>> apple.tags.remove("green")
>>> apple.tags.all()
[<Tag: red>, <Tag: delicious>]

>>> Food.objects.filter(tags__name__in=["red"])
[<Food: apple>, <Food: cherry>]

Tags will show up for you automatically in forms and the admin.

If you want to enforce lowercase tags everywhere (recommended, to avoid ending up with tags ‘Music’ and ‘music’ which are functionally identical but show up in different taxonomies), add to settings.py:

TAGGIT_FORCE_LOWERCASE = True

If you want to prevent certain words from being added as tags (such as English articles to, from, the, of, etc.) add to settings.py:

TAGGIT_STOPWORDS = [u'a', u'an', u'and', u'be', u'from', u'of']

Requirements

This django-taggit fork requires Django 1.3 or greater.

Further Infos

For more info about official django-taggit:

you can checkout out the documentation

And for questions about usage or development you can contact the mailinglist

Related Repositories

django-taggit

django-taggit

Simple tagging for django ...

django-taggit-autocomplete

django-taggit-autocomplete

Autocomplete for django-taggit ...

django-taggit-serializer

django-taggit-serializer

The Django Taggit Serializer Created for the Django REST Framework ...

taggit-selectize

taggit-selectize

Auto-complete/auto-suggestion for django-taggit (django-taggit + selectize.js) ...

django-taggit

django-taggit

Simple tagging for django ...


Top Contributors

alex carljm yedpodtrzitko henrikalmer thinkingpotato hcarvalhoalves frankwiles sorhus chuwy-bot fdintino shacker dekkers ptone gvangool arneb epicserve uruz jezdez marcofucci maccesch fin mcroydon vdboor lsemel ortsed robhudson MichalMaM dcharbonnier thebjorn bkonkle

Releases

-   0.9.3 zip tar
-   0.9.2 zip tar
-   0.9.1 zip tar
-   0.9.0 zip tar
-   0.8.0 zip tar
-   0.6.0 zip tar
-   0.4.0 zip tar
-   0.2.0 zip tar