Metadata-Version: 1.0
Name: django-tagging-ext
Version: 0.3.1
Summary: Adds in new features to supplement django-tagging
Home-page: http://github.com/pydanny/django-tagging-ext/tree/master
Author: Daniel Greenfeld
Author-email: pydanny@gmail.com
License: MIT
Description: =======================================
        django-tagging-ext (Django Tagging EXT)
        =======================================
        
        `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
        
        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
        ============================================
        
        $ pinax-admin setup_project -b social my_pinax_project
        $ cd my_pinax_project
        $ python manage.py test tagging_ext
        
        
        .. _`django-tagging`: http://code.google.com/p/django-tagging
        .. _`Django`: http://djangoproject.com
        .. _`Pinax`: http://pinaxproject.com
        
        
        
        
        
Keywords: django,pinax
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Utilities
