Skip to main content

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

Build Status

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

  1. Install using pip:

    pip install django-o2o_tagging
    
  2. Add o2o_tagging to your INSTALLED_APPS setting like this:

    INSTALLED_APPS = (
        ...
        'o2o_tagging',
    )
    

Usage

  1. 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)
    
  2. URLs

    You can add this views to your urls:

    ...
    ('^tagging/$', include('o2o_tagging')),
    
  3. Views

    o2o_taggin provides two views:

    TagCreateView
    
    TagsCreateView
    
  4. Templates

    There are two templatetags available

    1. for_tagged_in:

      {% for_tagged_in object as tags %}
      
    2. 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


Release history Release notifications

This version
History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-o2o_tagging-0.2.3.tar.gz (20.2 kB) Copy SHA256 hash SHA256 Source None Feb 13, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page