django-taggit-templatetags Templatetags for django-taggit
Download

django-taggit-templatetags Ranking & Summary

django-taggit-templatetags Tags

template Tags template tags django-taggit templatetags django-taggit

django-taggit-templatetags Description

Templatetags for django-taggit django-taggit-templatetags is a reusable Django app which adds some templatetags to django-taggit.InstallationJust install django-taggit-templatetags via pip:pip install django-taggit-templatetagsAfter installing and configuring django-taggit, just add taggit_templatetags to your INSTALLED_APPS in your settings.py:INSTALLED_APPS = (...'taggit_templatetags',...)UsageNow there are some templatetags enabled, at the moment only to create lists of tags and tag-clouds.In your templates, you need to load taggit_extras:...{% load taggit_extras %}...TaglistsAfter loading taggit_extras you can create a list of tags for the whole project (in the sense of djangoproject), for an app (in the sense of djangoapp), for a model-class (to get a list for an instance of a model, just use its tag-field).For the tags of a project, just do:{% get_taglist as tags %}For the tags of an app, just do:{% get_taglist as tags for 'yourapp' %}For the tags of an model, just do:{% get_taglist as tags for 'yourapp.yourmodel' %}No matter what you do, you have a list of tags in the tags template variable. You can now iterate over it:< ul >{% for tag in tags %}< li >{{tag}} ({{tag.num_times}})< /li >{% endfor %}< ul >As you can see, each tag has an attribute num_times which declares how many times it was used. The list of tags is sorted descending by num_times.Inclusion-TagFor convenience, there's an inclusion-tag. It's used analogue. For example, for a taglist of a model, just do:{% include_taglist 'yourapp.yourmodel' %}TagcloudsA very popular way to navigate through tags is a tagcloud. This app provides some tags for that:{% get_tagcloud as tags %}or:{% get_tagcloud as tags for 'yourapp' %}or:{% get_tagcloud as tags for 'yourapp.yourmodel' %}respectivly. The resulting list of tags is ordered by their name attribute. Besides the num_items attribute, there's a weight attribute. Its maximum and minimum may be specified as the settings section reads.Inclusion-TagEven for the tagcloud there's an inclusion-tag. For example, for a tagcloud of a model, just do:{% include_tagcloud 'yourapp.yourmodel' %}SettingsThere are a few settings to be set:TAGGIT_TAGCLOUD_MIN (default: 1.0) This specifies the minimum of the weight attribute of a tagcloud's tags.TAGGIT_TAGCLOUD_MAX (default: 6.0) This specifies the maximum of the weight attribute of a tagcloud's tags.If you want to use the weight as font-sizes, just do as follows:< font size={{tag.weight|floatformat:0}} >{{tag}}< /font >So the weights are converted to integer values. Requirements: · Python · Django

django-taggit-templatetags Related Software