Skip to main content

Extensible, hierarchical, and pluggable navigation system for Django sites

Project description


Extensible, hierarchical, and pluggable navigation system for Django sites


  • 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



  1. Download the app through SVN and add it to your Python path:

svn co treenav
  1. Add to your INSTALLED_APPS and run syncdb



  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:

./ test --settings=treenav.tests.settings

Development sponsored by Caktus Consulting Group, LLC.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-treenav-0.5.0.tar.gz (11.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page