Metadata-Version: 2.0
Name: django-tag-tools
Version: 0.2.0-alpha
Summary: Tag cloud for django tagging and django-taggit.
Home-page: https://github.com/kaleissin/django-tag-tools
Author: kaleissin
Author-email: kaleissin@gmail.com
License: UNKNOWN
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules

=========
Tag tools
=========

This currently provides a tag cloud generator for django-tagging and
django-taggit.

Optional settings
-----------------

TAGTOOLS_PREFERRED_APP_ORDER
    If TAGTOOLS_TAG_APP is not set, it will attempt to import the
    tag-apps in the order defined here. **Default:** ('taggit', 'tagging')

TAGTOOLS_TAG_APP
    Force what app to use. **Default:** pick first found entry in
    TAGTOOLS_PREFERRED_APP_ORDER

TAGTOOLS_CLOUD_STEPS
    How many different sizes of tags for the cloud. **Default:** 6

TAGTOOLS_CLOUD_MIN_COUNT
    Minimum frequency of a tag before it is included. **Default:** 1

Usage
-----

There's a view ``tagged_object_list`` if you want to devote an entire
page to a tag-cloud. In your url-conf:

    tags_dict= {
            'queryset_or_model': YorTaggedModel,
            'template_name': 'sometemplate.html',
            }

    urlpatterns = patterns('tagtools.views',
        (r'^tag/(?P<tag>[-\w\d]+)/$', 'tagged_object_list', tags_dict),
    )

You can generate lists of tags in a view with the function
``tagtools.get_tagcloud_for_model``.

You can set tags for a model with ``tagtools.set_tags_for_model``.


:Version: 0.2.0-alpha


