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.
- Sphinx based docs folder
- Tag Auto-complete
- Integration with Pinax style tasks
django-tagging
Pinax 0.7.x Pinax 0.9+
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', )
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'), )
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'), )