Overview¶
What is blanc-basic-pages?¶
blanc-basic-pages is a simple Django package which acts as a replacement for
flatpages
.
Certain features of flatpages have been removed to make administration easier, and other features have been added.
Design notes¶
Page Tree¶
Pages uses the django-mptt package to organise the page tree hierarchy. By using a page tree it allows site managers to use the Django admin to organise the navigation used on the site without having to edit any templates.
Sites framework removed¶
To remove complexity, the sites
framework dependency
has been removed. This removes the risk of the same URL being used multiple
times and causing a MultipleObjectsReturned
exception, as well as making
it easier to use a page tree.
Templates configurable as a setting¶
The admin for pages limits the options for templates to the choices available in the select box. Site staff can pick a defined template instead of having to enter the filename of a template.
This list of templates is configurable as PAGE_TEMPLATES
in your project
settings file.
Errors will generate exceptions¶
Flatpages catches any exceptions and serves an error 404 page, which is a sane default given that site staff can cause problems by choosing an invalid template. As the pages admin restricts this, any exceptions for pages will be raised and not ignored.