People tool

The people tool allows you to easily manage lists of people.

While there are centralized sources of some people like the faculty profiles and the ClarkU people directory, sometimes it’s useful to manage people on a website independently. Reasons might be that you want better control over job titles or images. Or perhaps you want to list people like students or people unaffiliated with Clark.

With the people tool, you just add custom people posts, and that’s it. To display them, add the people block to a page, and pick the appropriate group. When you display them, you have the choice whether or not to link to them, so if they don’t have bios, that’s OK.

Tips

There’s a sort name field on each person to be able to list folks alphabetically. If you want the unit head, say, Jonas Clark, at the top of the list, add an a or two to the sort name. So instead of sort name: clark, use sort name: aa-clark.

Use groups to manage people. In addition to groups like students, faculty, staff, you can use groups to identify contacts for particular services. There might be a group for web support contacts, and people in that group appear on the web support page. Individual people can belong to many groups.

Advanced class names

The people block lets you specify class names that change the layout of people. The supported class names are: halves, thirds, and fourths. Thirds is the default, but if you want people to display two or four to a row, the class names let you do that.

The people archive

By default, the people tool creates an “archive page” on the site. It’ll be at /people. If you don’t want it there or want to control what’s on it, simply create a page with the same URL and design it as desired. It’s probably most intuitive for visitors if you include a list of all the people on it, but you might want to group them in a special way.

The people shortcode

For greater control over how your people display, there’s a shortcode that you can use as an alternative to the block.

Examples

Display a list of people in a “staff” group:

[clarku-people group="staff"]

Display a list of all people without links to people posts:

[clarku-people link="false"]

The full list of attributes for the shortcode are:

• group expects the slug of a valid peoplegroup category.
• group_operator Defaults to “OR” but can be set to “AND”
• posts_per_page expects a whole number. It limits the results to the specified amount. Default is 200
• link controls whether or not the card lists link to posts. Set to “false” to not link (default: true)
• email controls whether or not to display the email address on card lists (default: true)
• phone controls whether or not to display the phone number on card lists (default: true)
• thumbnail expects the name of an image format like “medium.” Set to “false” to hide thumbnails.
• before allows HTML to be inserted before the list of people. It defaults to <div class=”clarku-people-tool”>
• after allows HTML to be inserted after the list of people. It defaults to </div>