django-taggit-templatetags 0.2.1

Just install django-taggit-templatetags via pip:<br /><br />$ pip install django-taggit-templatetags<br /><br />After installing and configuring django-taggit, just add taggit_templatetags to your INSTALLED_APPS in your settings.py:<br /><br />INSTALLED_APPS = (<br />...<br />'taggit_templatetags',<br />...<br />)<br /><br />Usage<br /><br />Now there are some templatetags enabled, at the moment only to create lists of tags and tag-clouds.<br /><br />In your templates, you need to load taggit_extras:<br /><br />...<br />{% load taggit_extras %}<br />...<br /><br />Taglists<br /><br />After 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).<br /><br />For the tags of a project, just do:<br /><br />{% get_taglist as tags %}<br /><br />For the tags of an app, just do:<br /><br />{% get_taglist as tags for 'yourapp' %}<br /><br />For the tags of an model, just do:<br /><br />{% get_taglist as tags for 'yourapp.yourmodel' %}<br /><br />No matter what you do, you have a list of tags in the tags template variable. You can now iterate over it:<br /><br /><ul><br />{% for tag in tags %}<br /><li>{{tag}} ({{tag.num_times}})</li><br />{% endfor %}<br /><ul><br /><br />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.<br />Inclusion-Tag<br /><br />For convenience, there's an inclusion-tag. It's used analogue. For example, for a taglist of a model, just do:<br /><br />{% include_taglist 'yourapp.yourmodel' %}<br /><br />Tagclouds<br /><br />A very popular way to navigate through tags is a tagcloud. This app provides some tags for that:<br /><br />{% get_tagcloud as tags %}<br /><br />or:<br /><br />{% get_tagcloud as tags for 'yourapp' %}<br /><br />or:<br /><br />{% get_tagcloud as tags for 'yourapp.yourmodel' %}<br /><br />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.<br />Inclusion-Tag<br /><br />Even for the tagcloud there's an inclusion-tag. For example, for a tagcloud of a model, just do:<br /><br />{% include_tagcloud 'yourapp.yourmodel' %}<br /><br />Settings<br /><br />There are a few settings to be set:<br />TAGGIT_TAGCLOUD_MIN (default: 1.0)<br /> This specifies the minimum of the weight attribute of a tagcloud's tags.<br />TAGGIT_TAGCLOUD_MAX (default: 6.0)<br /> This specifies the maximum of the weight attribute of a tagcloud's tags.<br /><br />If you want to use the weight as font-sizes, just do as follows:<br /><br /><font size={{tag.weight|floatformat:0}}>{{tag}}</font><br /><br />So the weights are converted to integer values.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Attribute,  Django,  Django Taggit,  Inclusiontag,  Install,  Maximum,  Minimum,  Model,  Project,  Sense,  Settings,  Specifies,  Tagcloud,  Taggit,  Taggit Extras,  Taggit Templatetags,  Taglist,  Templatetags,  There039s,  Weight,  Yourapp,  Yourappyourmodel
Users rating:	0/10