Use this app to tag objects like you tag your friends on facebook, but using any objects as the tagger and the tagged. Think of a `User` tagging a `Friend` in a `Photo` all of them being different models.
Project description
Welcome to the documentation for django-o2o_tagging! Use this app to tag objects like you tag your friends on facebook, but using any objects as the tagger, the tagged and the tagged in. Think of a User tagging a Friend in a Photo all of them being different models.
Quick start
Install using pip:
pip install django-o2o_tagging
Add o2o_tagging to your INSTALLED_APPS setting like this:
INSTALLED_APPS = ( ... 'o2o_tagging', )
Usage
Models
Tag your objects:
... tag = O2OTag.objects.tag(tagger, tagged, tagged_in)
Get for tagged in objects:
... tags = O2OTag.objects.for_tagged_in(tagged_in)
Get for tagger objects:
... tags = O2OTag.objects.for_tagger(tagger)
Get for tagged objects:
... tags = O2OTag.objects.for_tagged(tagged)
You can then filter:
... tags.for_tagger(tagger).for_tagged(tagged)
URLs
You can add this views to your urls:
... ('^tagging/$', include('o2o_tagging')),
Views
o2o_taggin provides two views:
TagCreateView TagsCreateView
Templates
There are two templatetags available
for_tagged_in:
{% for_tagged_in object as tags %}
for_tagged_in_nodups:
{% for_tagged_in_nodups object as tags %}
Apply distinct on tagged_object_id in order to get only one tagged user.
Running the Tests
You can run the tests with via:
python setup.py test
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.