django-magneto 0.9.0

Overview

Magneto is a content and template management application built for the Django framework.

A Template represents a web page on your site. Within the template can be used any built-in Template Tags, as well as custom installed ones. Beyond HTML pages, a Template can also represent content types such as CSS, Javascript, JSON, and XML. When using template inheritance, templates can be marked for use strictly by the template loader and not for display as a web page.

Admin Pages

Sandbox Installation

An example application is provided to make this application easy to download and demo in a sandboxed environment. Use the following commands to run it:

$ hg clone http://bitbucket.org/prestontimmons/django-magneto
$ cd django-magneto
$ python bootstrap.py
$ bin/buildout
$ cp -r magneto/media/ example/media/magneto
$ bin/django syncdb
$ bin/django migrate
$ bin/django loaddata html5boilerplate.json
$ bin/django runserver 0.0.0.0:8000

Visit http://localhost:8000/admin/ and update your domain in Site settings to match the server your running on. Now you can view and edit the templates that were loaded in.

Site Installation

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.

Configurable Settings

MAGNETO_MEDIA_DIRECTORY

The url of the root folder where the magneto media files are. This defaults to a folder called magneto in the directory specified by the MEDIA_URL setting.

Notes

Built for Python 2.6, Django 1.2 according to PEP8 and the Django Style Guide. If you’re using previous versions of Python or Django your mileage may vary. Let me know if anything doesn’t work.