django-xprez 0.3.14

Django CMS for presentation websites

Django Xprez

A flexible Django CMS with built-in modules and easy custom modules.

The backend works well with Django admin but can also be used standalone.

Features

• Structure
  • Containers — apply or extend in your own models (e.g. Page, Article).
  • Sections — rows with max-width, background (part of the structure).
  • Modules (content blocks)
    • Built-in: text, quote, gallery, files, video, numbers, code input, code template, anchor.
    • Custom: simply subclass Module in your app; they auto-register and appear in the same admin UI and frontend.
• Responsive
  • Layout (visibility, columns, padding, margin, colspan) per breakpoint.
  • Responsive images (srcset, breakpoint-aware sizes).
• Styles
  • Ready-made frontend CSS included.
  • Or import xprez SCSS into your build.
• Clipboard and symlinks — Copy modules or sections; paste into another page or paste as symlink to reuse the same content.

Quick start

1. Install django-xprez:

pip install django-xprez

2. Add following apps to your settings.INSTALLED_APPS:

INSTALLED_APPS = [
        ...
        'sorl.thumbnail',
        'xprez',
        ...
    ]

3. Run python manage.py migrate to create xprez models.

4. Make sure request context processor is enabled in settings:

TEMPLATES = [
        ...
        'OPTIONS': {
            'context_processors': [
                ...
                'django.template.context_processors.request',
                ...
            ]
        },
        ...
    ]

5. Include the xprez urls in your project urls.py like this:

path('xprez/', include('xprez.urls')),

6. Create models:

from xprez.models import Container

class Page(Container):
    title = models.CharField(max_length=255)
    slug = models.SlugField(max_length=255, unique=True)

    def __str__(self):
        return self.title

7. Register models in admin:

from django.contrib import admin
from xprez.admin import XprezAdmin
from .models import Page

@admin.register(Page)
class PageAdmin(XprezAdmin):
    pass

8. Render page in template:

{% load xprez %}
<link rel="stylesheet" href="{% url 'xprez:css_variables_global' %}">
{% xprez_front_media page %}
{% include 'xprez/container.html' with container=page %}

9. (optional) Add a custom module:

from xprez.models import Module

class MyModule(Module):
    title = models.CharField(max_length=200)
    count = models.PositiveIntegerField(default=0)
    is_featured = models.BooleanField(default=False)

    front_template_name = "myapp/modules/my.html"

    class Meta:
        verbose_name = "My module"

See the built-in modules source for more examples.

10. (optional) Change sorl thumbnail backend in settings — for SEO-friendly thumbnail filenames and deferred generation:

THUMBNAIL_BACKEND = "xprez.contrib.sorl_thumbnail.LazyNamingThumbnailBackend"

---

For user documentation, see docs/user/README.md.

For an example, see the example_app in this repository.

For development and contributing, see docs/development.md.