Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple CMS for Django projects
Failed to load latest commit information.
docs Fix package version
pagelets Fix package version
sample_project Added python 3.3 and django 1.5/1.6 to tox settings
.gitignore Small change to find tests pre django 1.6
LICENSE.txt Bump year in license
MANIFEST.in Change manifest dir.
README.rst Feedback from release/0.10.0 review
run_tests.py
setup.py Remove Python 2.6 classifier
tox.ini Drop non-1.7 from tox

README.rst

django-pagelets

django-pagelets is a simple, flexible app for integrating static, unstructured content in a Django site.

For complete documentation, checkout http://django-pagelets.readthedocs.org

Features

  • "Pagelets" for adding small pieces of content to otherwise static templates
  • CMS "pages" which include any number of pagelets and, if needed, attachments
  • Different pagelet content types including HTML and Markdown
  • An integrated WYSIWYG editor (WYMeditor) which can be selectively enabled/disabled

Changes in 0.10.0

Pagelets 0.10.0 includes a number of changes to support Django 1.7 and the new migration framework. You should be aware of these changes if you are upgrading from the latest 0.9.x release of pagelets. If you are using pagelets in a project for the first time with version 0.10.0 or newer, you should not need to worry about any of these changes.

Pagelets no longer users django-tagging, which did not support Django 1.7 migrations and is no longer maintained. We now use django-taggit. At the moment there is no migration to move tags from django-tagging to django-taggit.

Required Dependencies

  • Django 1.7
  • Python 2.7 or 3.3
  • Django admin site
  • django-taggit 0.12.1 or greater
  • django-selectable 0.9.0 or greater
  • The django.core.context_processors.request context processor

Optional Dependencies

Support for Django 1.4 through 1.6

If you require support for a Django release before 1.7, you can use a release from the 0.9 line of Pagelets, which supports Django 1.3, 1.4, 1.5, and 1.6. This release is also compatible with Python 3.3 for appropriate Django versions. At this time we will continue to support security updates to this version of Pagelets.

Installation and Setup

  1. django-pagelets is available on PyPI, so the easiest way to install it is to use pip:

    pip install django-pagelets
    
  2. Add pagelets to INSTALLED_APPS in settings.py and run syncdb:

    INSTALLED_APPS = (
        ...,
        'pagelets',
        ...
    )
    
  3. Add django.core.context_processors.request to TEMPLATE_CONTEXT_PROCESSORS:

    TEMPLATE_CONTEXT_PROCESSORS = (
        "django.contrib.auth.context_processors.auth",
        "django.core.context_processors.debug",
        "django.core.context_processors.i18n",
        "django.core.context_processors.media",
        "django.core.context_processors.static",
        "django.contrib.messages.context_processors.messages",
        "django.core.context_processors.request", # <----
    )
    
  4. Add the pagelets URLs to urls.py, e.g.:

    urlpatterns += patterns('',
        url(r'^selectable/', include('selectable.urls')),
        url(r'^pagelets-management/', include('pagelets.urls.management')),
        url(r'^', include('pagelets.urls.content')),
    )
    
  5. Visit the admin site, add and save a new page, and click the View on site link. If everything is setup correctly, you should be able to see and edit the content you just added.

Development sponsored by Caktus Consulting Group, LLC..

Something went wrong with that request. Please try again.