Installation

Prerequisites

django-treebeard needs at least Python 2.7/3.4 to run, and Django 1.7 or better.

Installing

You have several ways to install django-treebeard. If you’re not sure, just use pip

pip (or easy_install)

You can install the release versions from django-treebeard’s PyPI page using pip:

$ pip install django-treebeard

or if for some reason you can’t use pip, you can try easy_install, (at your own risk):

$ easy_install --always-unzip django-treebeard

setup.py

Download a release from the treebeard download page and unpack it, then run:

$ python setup.py install

.deb packages

Both Debian and Ubuntu include django-treebeard as a package, so you can just use:

$ apt-get install python-django-treebeard

or:

$ aptitude install python-django-treebeard

Remember that the packages included in linux distributions are usually not the most recent versions.

Configuration

Add 'treebeard' to the INSTALLED_APPS section in your django settings file.

Note

If you are going to use the TreeAdmin class, you need to add the path to treebeard’s templates in TEMPLATE_DIRS. Also you need to enable django.core.context_processors.request in the TEMPLATE_CONTEXT_PROCESSORS setting in your django settings file.