Metadata-Version: 1.0
Name: django-treenav
Version: 0.9.0
Summary: Extensible, hierarchical, and pluggable navigation system for Django sites
Home-page: http://github.com/caktus/django-treenav
Author: Caktus Consulting Group
Author-email: solutions@caktusgroup.com
License: BSD
Description: django-treenav
        ==============
        
        An extensible, hierarchical, and pluggable navigation system for Django sites.
        
        *django-treenav* was designed from the start to live independent of a CMS
        implementation. As a separate application, treenav can easily be integrated
        into existing, custom setups and does not enforce or require users to use a
        particular content management system.
        
        Sharing the same principles,
        `django-pagelets <http://readthedocs.org/projects/django-pagelets/>`_
        integrates seamlessly with treenav and can be used together to create a flexible
        CMS product.
        
        For complete documentation checkout, `<http://django-treenav.readthedocs.org>`_
        
        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
        - Caches the tree so that repeated page views to not hit the database.
        - Simple links in the `MenuItem` list view for refreshing the cache and href
          from the database.
        
        Requirements
        ------------
        - `django <https://github.com/django/django/>`_ >= 1.3
        - `django-mptt <http://github.com/django-mptt/django-mptt/>`_ >= 0.5.2
        
        Using the demo
        --------------
        
        For a quick demo, follow these steps::
        
            $ mkvirtualenv --distribute --no-site-packages django-treenav
            (django-treenav)$ git clone git://github.com/caktus/django-treenav.git
            (django-treenav)$ cd django-treenav/
            (django-treenav)~/django-treenav$ python setup.py develop
            (django-treenav)~/django-treenav$ cd sample_project/
            (django-treenav)~/django-treenav/sample_project$ pip install -r requirements.txt
            (django-treenav)~/django-treenav/sample_project$ ./manage.py syncdb
            (django-treenav)~/django-treenav/sample_project$ ./manage.py runserver
        
        Visit http://localhost:8000/ in your browser and follow the instructions.
        
        Installation
        ------------
        
        #. Install the app with pip::
        
            pip install django-treenav
        
        
        #. Add to your `INSTALLED_APPS` and run syncdb::
        
            INSTALLED_APPS = (
                ...,
                'mptt',
                'treenav',
            )
        
        
        #. Include these context processors::
        
            TEMPLATE_CONTEXT_PROCESSORS = (
                "django.core.context_processors.request",
                "treenav.context_processors.treenav_active",
            )
        
        
        #. Add these urls::
        
            urlpatterns = patterns('',
                (r'^treenav/', include('treenav.urls')),
            )
        
        
        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
