Using the contrib.people module¶

Manage people/authors and link them to content via M2M relations.

Installation¶

INSTALLED_APPS = [
    "djangocms_custom_content",
    "djangocms_custom_content.contrib.people",
]

python manage.py migrate

Models¶

Person - The grouper. Optionally linked to a User via a one-to-one field. PersonContent - The versioned content holding the person’s details

Content fields: name, slug, role, description, phone, mobile, fax, email, website, visual (a Filer image).

Usage¶

Creating people:

from djangocms_custom_content.contrib.people.models import Person, PersonContent

person = Person.objects.create()
PersonContent.objects.create(
    person=person,
    slug="john-doe",
    name="John Doe",
    role="Author",
    description="Author bio...",
)

Linking people as authors:

People are linked through a RelationField declared on the grouper that wants authors. The bundled blog does exactly this on BlogPost (see contrib/blog/models.py):

class BlogPost(AbstractCustomGrouper):
    authors = RelationField(
        "djangocms_custom_content_people.Person",
        related_name="authored_posts",
        ordered=True,
    )

blog_post = BlogPost.objects.first()
blog_post.authors.add(person)   # accepts a Person grouper or PersonContent
blog_post.authors.all()         # Person groupers, in their stored order

# Reverse accessor invited by related_name:
person.authored_posts.all()     # BlogPost groupers authored by this person

In templates (authors.all yields Person groupers, so reach the content via get_admin_content):

{% for person in blog_post.authors.all %}
    {% with profile=person.get_admin_content %}
        <div class="author">
            <h4>{{ profile.name }}</h4>
            <p>{{ profile.description }}</p>
        </div>
    {% endwith %}
{% endfor %}

Plugins¶

PersonTeaserPlugin (“Person teaser”, model PersonTeaser) - Display a single selected person, with an optional bio toggle

Admin¶

PersonAdmin is a GrouperModelAdmin (see Register the grouper admin) using content_model = PersonContent.

What this app demonstrates¶

Person is a versioned grouper without a language field — proof that versioning does not require multi-language content. It is also the canonical target of a relation (BlogPost.authors).