Django tagging with multilingual, synonyms and hierarchy!
Python Shell
Latest commit 7eb9676 Nov 29, 2015 @svetlyak40wt Merge pull request #18 from flebel/add_support_for_django16
Set the Django 1.6+ mandatory 'fields' attribute.
Permalink
Failed to load latest commit information.
tagging Set the Django 1.6+ mandatory 'fields' attribute. Nov 24, 2015
.gitignore Added utility function 'tagging.utils.merge, which merges two tags an… Sep 24, 2009
CHANGELOG.txt Version 0.3.1, changelog updated. Aug 21, 2009
INSTALL.txt Docs reorganization with a focus in provide a quickstart in README Sep 19, 2014
LICENSE.txt
MANIFEST.in Fixed MANIFEST.in recursive-includes Jan 12, 2008
OVERVIEW.txt Docs reorganization with a focus in provide a quickstart in README Sep 19, 2014
README.txt Quickstart inaccuracies fixed Sep 19, 2014
runtests.sh Added utility function 'tagging.utils.merge, which merges two tags an… Sep 24, 2009
setup.py Version 0.3.3 Apr 6, 2010

README.txt

=================
Django Tagging NG
=================

This is a enhanced tagging application for Django projects

- For installation instructions, see the file "INSTALL.txt" in this directory

- For detailed instructions on how to configure and know all possibilities of this application, see the file "OVERVIEW.txt"


Rquirements
-----------
Note that this application requires Python 2.3 or later, and Django 0.96 or later. You can obtain Python from http://www.python.org/ and Django from http://www.djangoproject.com/.


Quickstart
----------

1.- Register a model:

   from django.db import models
   import tagging
   from shop.apps.products.models import Widget

   class Widget(models.Model):
       name = models.CharField(max_length=50)

   tagging.register(Widget)

2.- Use it

   w = Widget.objects.get(...)

   from tagging.models import Tag, TaggedItem
   house_tag = Tag.objects.get(name='house')
   thing_tag = Tag.objects.get(name='thing')

    - Set tags for instance:
    w.tags = 'tag1 tag2'

    - Get tag for instance:
    w.tags
     [<Tag: tag1>, <Tag: tag2>]

    - Retrive instances with tag1 AND tag2
   TaggedItem.objects.get_by_model(Widget, [house_tag, thing_tag])
   [<Widget: pk=1>]

    - Retrieve filtered instances with 'tag1'
   TaggedItem.objects.get_by_model(Widget.objects.filter(price__lt=50), 'house')


    - Get all tags for a model:
   Widget.tags.all()
   [<Tag: tag1>, <Tag: tag2>>]

    - Get tags for a model with usage counts:
    Widget.tags.count()

    - Get related tags (retrieve tags used by model instances which are also tagged with tag1 and tag2)
    Widget.tags.related('tag1', min_count=1)
    [<Tag: tag2>]
    Widget.tags.related(['tag1', 'tag2'], min_count=1)
    []


Authors
-------

This application is based on the original code, written by:
    Jonathan Buchanan <jonathan.buchanan@gmail.com>

Enhanced by:
    Alexander Artemenko <svetlyak.40wt@gmail.com>
    Antti Kaihola <akaihol+django@ambitone.com>
    GW [http://gw.tnode.com/] <gw.2012@tnode.com>
    Concha Labra https://github.com/clabra

Sources
-------

Django-tagging-ng: http://github.com/svetlyak40wt/django-tagging-ng/
Django-tagging:    http://code.google.com/p/django-tagging/