Key Features

• Because templates and web pages are synonymous you can use template tags and filters in your pages.

• Manage content types like html, css, javascript, xml, json, and text.

• Database queries can be minimized with the use of a cached template loader that caches pre-rendered templates.

• Use CodeMirror in the admin for template editing.

• Know who changed what and when with built-in support for Reversion. Easily go back to older versions of the content.

• Group related templates with Template Groups. Useful when you have a large number of templates.

• HTML5 Boilerplate fixtures included to get started quickly.

• Support for South migrations.

Admin Pages

Configure your settings.py

1. Make sure django.contrib.sites and django.contrib.admin are installed. Add magneto and reversion to INSTALLED_APPS. Optionally add south for migration support.

   Example:

   INSTALLED_APPS = (
       'django.contrib.admin',
       'django.contrib.admindocs',
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.sites',
   
         ...
   
       'magneto',
       'reversion',
   
         ...
   
       'south', # optional for migrations
   )

2. Add magneto.loader.CachedTemplateLoader to TEMPLATE_LOADERS.

   Example:

   TEMPLATE_LOADERS = (
       'magneto.loader.CachedTemplateLoader',
   
         ...
   
       'django.template.loaders.filesystem.load_template_source',
       'django.template.loaders.app_directories.load_template_source',
   )

3. Copy media files to where they can be found by the admin pages. * See the notes on the MAGNETO_MEDIA_DIRECTORY setting below for more information.

4. Add a url entry in your site urls.py.

   Example:

   urlpatterns = patterns('',
       (r'^admin/', include(admin.site.urls)),
       (r'^accounts/login/$', 'django.contrib.auth.views.login'),
   
         ...
   
       # Mount it at a specific url
       (r'^pages/', include('magneto.urls')),
   
       # Or mount it at your root url
       (r'^', include('magneto.urls')),
   )

5. Run python manage.py syncdb.

6. Run python manage.py runserver 0.0.0.0:8000 to start the Django devserver.

Standing on the shoulders of giants

This application is like a combined version of Django DB Templates and the built-in Flatpages application. Thanks to Jannis Leidel for open-sourcing the DB Templates app and for everyone who contributed to Django.