Metadata-Version: 1.0
Name: django-treenav
Version: 0.5.0
Summary: Extensible, hierarchical, and pluggable navigation system for Django sites
Home-page: http://http://github.com/caktus/django-treenav
Author: Caktus Consulting Group
Author-email: solutions@caktusgroup.com
License: LICENSE.txt
Description: django-treenav
        ==============
        
        Extensible, hierarchical, and pluggable navigation system for Django sites
        
        Features
        ========
        
        - Generic functionality with multiple URL specifications: get_absolute_url(), reverse(), or raw URLs
        - Packaged with templates to render the tree hierarchy with nested `<ul>`'s, but can easily be overridden with custom templates
        - Useful css classes for flexible UI customization
        - Automatically sets "active" on item and item's parents if PATH_INFO is equal to item.href
        - Efficient: minimizes database access with django-mptt functionality
        
        Requirements
        ============
        - `django-mptt
          <http://code.google.com/p/django-mptt/>`_
        
        Installation
        ============
        1) Download the app through SVN and add it to your Python path:
        
        ::
        
            svn co http://django-treenav.googlecode.com/svn/trunk/treenav treenav
        
        2) Add to your INSTALLED_APPS and run syncdb
        
        ::
        
            INSTALLED_APPS = (
                ...,
                'mptt',
                'treenav',
            )
        
        
        Setup
        =====
        1) Login to the admin and build your menu item hierarchy
        2) Load the treenav_tags in your template and render the menu, e.g.
        
            ::
        
                {% load treenav_tags %}
                {% show_treenav 'primary-nav' %}
        
        
        3) Add treenav urls into your url patterns, e.g.
        
            ::
        
                (r'^%streenav/' % settings.URL_PREFIX, include('treenav.urls.admin')),
        
        Test Suite
        ==========
        The treenav.tests package is set up as an application which holds a test settings module and defines models for use in testing django-trenav. You can run the tests from the command-line while specifying the test settings module:
        
            ::
        
                ./manage.py test --settings=treenav.tests.settings
        
        Development sponsored by `Caktus Consulting Group, LLC
        <http://www.caktusgroup.com/services>`_.
        
Platform: UNKNOWN
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
