Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple tagging for django
branch: master

This branch is 28 commits ahead, 193 commits behind alex:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
docs
taggit
.gitignore
AUTHORS.txt
LICENSE.txt
MANIFEST.in
README.rst
setup.py
tox.ini

README.rst

django-taggit

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

Getting Started

You can simply install it with pip:

$ pip install django-taggit

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.

Requirements

django-taggit requires Django 1.1 or greater.

Further Infos

For more info checkout out the documentation.

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

Something went wrong with that request. Please try again.