Skip to main content

Django app for creating hierarchical URLs associated with django-MPTT models.

Project description


This reusable app helps to create arbitrary-depth Clean URLs which correspond to MPTT tree hierarchy of model instances, like these:

As you can see, the links are quite different - they have different depth of hierarchy. When users see these URLs they can easily discover where they are located. They can either delete some part of the URL and thus move up in the hierarchy.

Django-mptt-urls is just a simple view that knows how to resolve hierarchical urls.


The simpliest way to understand how django_mptt_urls works is to clone this GitHub project, create virtual environment and run test_project (no extra settings required, except sqlite3 database support):

git clone
pyvenv django-mptt-urls
source django-mptt-urls/bin/activate
pip install django-mptt-urls/
python django-mptt-urls/test_project/ runserver

And visit in your browser.


django-mptt-urls uses django-mptt. It will be automatically installed as a requirement.


First of all, you should already be using django-mptt, something like this:

from mptt.models import MPTTModel, TreeForeignKey

class Category(MPTTModel):
    parent = TreeForeignKey('self', null=True, blank=True)
    slug = models.SlugField()
    class Meta:
        unique_together = ('slug', 'parent')

Install django-mptt-urls:

pip install django-mptt-urls

Then, in your, replace one or more views with special mptt_urls.view:

import mptt_urls

urlpatterns = patterns('',
    url(r'^gallery/(?P<path>.*)', mptt_urls.view(model='gallery.models.Category', view='gallery.views.category', slug_field='slug', trailing_slash=True), {'extra': 'You may also pass extra options as usual!'}, name='gallery'),

Here is what we've done:

  • We are capturing (?P<path>.*), which will be passed to mptt_urls.view when url resolution is fired. You can define path whatever you like (for example (?P<path>[\d/]+)), but don't forget to include '/' in the regex.
  • Replace your view with special mptt_urls.view.

mptt-urls.view works like a decorator to a view: it gets fired when url resolution is performed, calculates an instance the path is poining to, and passes it to original view.

So, if you write

url(r'^gallery/(?P<path>.*)', 'gallery.views.category', name='gallery'),

the gallery.views.category view will receive path variable and will have to make object resolution. With mptt_urls.view, you will get the resolved object automatically - gallery.views.category view will receive path and instance variables:

url(r'^gallery/(?P<path>.*)', mptt_urls.view(model='gallery.models.Category', view='gallery.views.category', slug_field='slug'), name='gallery'),

mptt_urls.view options are:

  • model - your model derived from MPTTModel.
  • view - a view which will process the request. Don't forget to capture path and instance (def category(request, path, instance):). If resolution fails, instance will be None.
  • slug_field - the field where model instance's slug is stored


Well, url(...) defines direct url resolution. To define reverse url resolution, add to your model:

class Category(MPTTModel):
    def get_absolute_url(self):
        return reverse('gallery', kwargs={'path': self.get_path()})

Here, we use Category.get_path() which is available since using mptt_urls.view.

If you use namespaced url routing, don't forget to add namespace specifier like this:

return reverse('namespace:gallery', kwargs={'path': self.get_path()})


MIT. Do whatever you like. View license file for details.

Project details

Download files

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

Files for django-mptt-urls, version 2.0.4
Filename, size File type Python version Upload date Hashes
Filename, size django-mptt-urls-2.0.4.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page