Skip to main content

Adds in new features to supplement django-tagging

Project description

django-tagging gives you tagging. django-tagging-ext gives you enhanced displays of tags. All rendered HTML is done via templates so you can customize the displays as needed.

Future releases of Django Tagging EXT will include these features:

  • More comprehensive tests

  • Tag dispatching so you can control tagging more tightly. For example, limiting tags to just one model.

  • Tag Auto-complete

Dependencies

django-tagging

Optional Dependencies

Pinax 0.7.x Pinax 0.9+

Installation

Tagged release:

pip install django-tagging-ext

Development version:

pip install -e git+git://github.com/pydanny/django-tagging-ext.git#egg=django-tagging-ext

Add to your Django settings.py file:

INSTALLED_APPS = (
    ...
    'tagging_ext',
)

View rendering via root url_conf

django-tagging-ext is designed so all the work is done in the root urls file.

In the project url_conf (urls.py):

# django-tagging-ext url definitions
from blog.models import Post
from bookmarks.models import BookmarkInstance
from photos.models import Image
from tagging.models import TaggedItem

tagged_models = (
  dict(title="Blog Posts",
    query=lambda tag : TaggedItem.objects.get_by_model(Post, tag).filter(status=2),
  ),
  dict(title="Bookmarks",
    query=lambda tag : TaggedItem.objects.get_by_model(BookmarkInstance, tag),
  ),
  dict(title="Photos",
    query=lambda tag: TaggedItem.objects.get_by_model(Image, tag).filter(safetylevel=1),
  ),
)

tagging_ext_kwargs = {
  'tagged_models':tagged_models,
  # You can add your own special template to be the default
  #'default_template':'custom_templates/special.html'
}

urlpatterns += patterns('',
  url(r'^tags/(?P<tag>.+)/(?P<model>.+)$', 'tagging_ext.views.tag_by_model',
        kwargs=tagging_ext_kwargs, name='tagging_ext_tag_by_model'),
  url(r'^tags/(?P<tag>.+)/$', 'tagging_ext.views.tag',
        kwargs=tagging_ext_kwargs, name='tagging_ext_tag'),
  url(r'^tags/$', 'tagging_ext.views.index', name='tagging_ext_index'),
)

View rendering of Pinax objects via root url_conf

In the pinax project url_conf (urls.py) we use the custom_template field to explicitly tell Django Tagging EXT to fetch views customized for use in Pinax:

# django-tagging-ext url definitions
from blog.models import Post
from bookmarks.models import BookmarkInstance
from photos.models import Image
from tagging.models import TaggedItem

tagged_models = (
  dict(title="Blog Posts",
    query=lambda tag : TaggedItem.objects.get_by_model(Post, tag).filter(status=2),
    content_template="pinax_tagging_ext/blogs.html",
  ),
  dict(title="Bookmarks",
    query=lambda tag : TaggedItem.objects.get_by_model(BookmarkInstance, tag),
    content_template="pinax_tagging_ext/bookmarks.html",
  ),
  dict(title="Photos",
    query=lambda tag: TaggedItem.objects.get_by_model(Image, tag).filter(safetylevel=1),
    content_template="pinax_tagging_ext/photos.html",
  ),
)

tagging_ext_kwargs = {
  'tagged_models':tagged_models,
  # You can add your own special template to be the default
  #'default_template':'custom_templates/special.html'
}

urlpatterns += patterns('',
  url(r'^tags/(?P<tag>.+)/(?P<model>.+)$', 'tagging_ext.views.tag_by_model',
        kwargs=tagging_ext_kwargs, name='tagging_ext_tag_by_model'),
  url(r'^tags/(?P<tag>.+)/$', 'tagging_ext.views.tag',
        kwargs=tagging_ext_kwargs, name='tagging_ext_tag'),
  url(r'^tags/$', 'tagging_ext.views.index', name='tagging_ext_index'),
)

Running tests from within your Pinax project

For fun and profit:

$ pinax-admin setup_project -b social my_pinax_project
$ cd my_pinax_project
$ python manage.py test tagging_ext

Project details


Download files

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

Source Distribution

django-tagging-ext-0.3.5.tar.gz (14.4 kB view details)

Uploaded Source

File details

Details for the file django-tagging-ext-0.3.5.tar.gz.

File metadata

File hashes

Hashes for django-tagging-ext-0.3.5.tar.gz
Algorithm Hash digest
SHA256 026004b5a1fa631075ebfb1ff16b2ae1b723ecd4f94da24ff97c22e945b82429
MD5 6ad988af6349654c15cd724c9d260ad9
BLAKE2b-256 aef7090b6d22be103d0566625253a42d470cb52451acde723653de6b8c6f1cd7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page