/wagtail-personalisation

Rule-based personalisation for Wagtail CMS

Primary LanguagePythonMIT LicenseMIT

https://readthedocs.org/projects/wagtail-personalisation/badge/?version=latest https://travis-ci.org/wagtail/wagtail-personalisation.svg?branch=master http://codecov.io/github/wagtail/wagtail-personalisation/coverage.svg?branch=master

Wagxperience

Wagtail Personalisation

Wagtail Personalisation is a fully-featured personalisation module for Wagtail CMS. It enables editors to create customised pages - or parts of pages - based on segments whose rules are configured directly in the admin interface.

screenshot.png

Instructions

Wagtail Personalisation requires Wagtail 2.0 or 2.1 and Django 1.11 or 2.0.

To install the package with pip:

pip install wagtail-personalisation

Next, include the wagtail_personalisation, wagtail.contrib.modeladmin and wagtailfontawesome apps in your project's INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    'wagtail.contrib.modeladmin',
    'wagtail_personalisation',
    'wagtailfontawesome',
    # ...
]

Make sure that django.contrib.sessions.middleware.SessionMiddleware has been added in first, this is a prerequisite for this project.

MIDDLEWARE = [
    'django.contrib.sessions.middleware.SessionMiddleware',
    # ...
]

Documentation

You can find more information about installing, extending and using this module on Read the Docs.

Sandbox

To experiment with the package you can use the sandbox provided in this repository. To install this you will need to create and activate a virtualenv and then run make sandbox. This will start a fresh Wagtail install, with the personalisation module enabled, on http://localhost:8000 and http://localhost:8000/cms/. The superuser credentials are superuser@example.com with the password testing.