Skip to main content

Add a person and a persons index pages to Wagtail as well as a person block for StreamFields.

Project description

Wagtail Person

On a CMS, we regularly need to represent an author, a speaker, a person. To avoid repetition and duplication of datas about this, this app add a person model to Wagtail, with admin UI. Do not hesitate to use it on your blog or lectures appilaciton.

This model is accompanied by a Person page model and a Persons index page model. Each Person page is linked to a Person model to see it on your website.

This app also provide a basic CSS and templates, feel free to customize it.

Important

Since version 0.9.8, the Person Page model has been split in 2 models:

  • A Person model
  • A Person page model, with a many2one to a Person model

Install

Simply install it from pypi.org:

pip install wagtailperson

Add this app to django installed app in your settings.py:

INSTALLED_APPS = [
    # …
    'wagtailperson',
    # …
    'wagtail.contrib.modeladmin',
    # …
    ]

Then, finally, apply migration scripts:

./manage.py migrate wagtailperson

Use

This application add a new entry to the administration menu, called "Author or Person". From this menu, you can add a new author or person.

If you want to link one of your wagtail page models, or django models, to a person: Simply add a many2one field linked to wagtailperson.models.Person.

This application also provide 2 pages models:

  • A Person page: Show puplicly someone, can be used mostly everywhere in the pages tree
  • A Persons index page: A root page for Persons pages, it list each of Persons pages it had as children pages and can only have Person pages as children

The person index page can be useful to group persons, globally or per group.

A person got multiple fields:

  • Picture
  • Name
  • Tags
  • Introduction
  • Abstract

This application also provide a person block for StreamField, at wagtailperson.blocks.PersonBlock. Feel free to use it on your models StreamField.

Development

The source code repository provide a full Django project, so you can easily work with wagtailperson for testing you modifications.

Simply use these two steps in the source code working directory:

./manage.py migrate
./manage.py runserver

Licence

LGPLv3

Author

Sébastien Gendre <seb@k-7.ch>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for wagtailperson, version 0.12.0
Filename, size File type Python version Upload date Hashes
Filename, size wagtailperson-0.12.0-py3-none-any.whl (30.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size wagtailperson-0.12.0.tar.gz (20.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page