Publish a staff directory

Publish a staff directory

1. Decide who is public

Nobody appears on your site until you say so. In Essentials → People, open a
person and turn on Show in the public directory.

The People list has a Show filter, so you can check who is currently public
before you publish anything.

2. Put the directory on a page

Create the page, then add the shortcode:

[kenii_staff_directory]

That gives you every public person in one searchable table, sorted by last name.

3. Group it the way your college is organized

Most colleges want the leadership team as its own block:

[kenii_staff_directory grouped_by="section"]

Groups are ordered by the number set against each section in Essentials →
Departments. Give your leadership section order 1 and it sits first.
Sections with no order fall in alphabetically after the ones that have one.

Swap section for department to organize by where people work instead.

4. Keep the right people at the top

Alphabetical is right for most of a directory and wrong for a leadership list,
where the president should be first.

Open the person, turn on Pin to the top of their group, and give them a
position. Position 1 sits above position 2. Everyone unpinned stays
alphabetical below them.

It is fine for several people to share a position. They sort alphabetically
among themselves.

5. Choose the columns

The default is name, title, phone and credentials. Change it:

[kenii_staff_directory columns="name,title,department,email"]

Credentials is a multi-line field, one qualification per line, and it renders as
separate lines in its own column. Keep it separate from Suffix, which is
part of the name and renders after a comma, as in “Jane Doe, PhD”.

6. Make it look like your site

If your theme already styles tables, hand the directory your classes and it will
inherit them:

[kenii_staff_directory table_class="data-table" wrap_class="table-scroll"]

Your classes are added to Kenii’s rather than replacing them.

Naming one person somewhere else

Anywhere a page names an individual, use the person record instead of typing
their details:

[kenii_person slug="jane-doe"]

Their title changes in one place and every page follows. If a page names a
position rather than an individual, use a role instead, so the page survives the
person leaving:

[kenii_role slug="registrar"]

If nothing appears

Check in this order:

1. Is anybody marked Show in the public directory? An empty directory almost
   always means nobody is public yet.
2. If you filtered by section or department, does that slug exist? A slug
   with no match shows an empty directory rather than silently showing everyone.
3. If you used [kenii_person] or [kenii_role] and got nothing at all, the
   slug did not match. These print nothing rather than an error, so a broken
   reference never shows up on a live page as a warning.