People

• Overview
• Who Can Do What?
• Prepare your Request for the People Extension
• Adding Departments and Associations
• Adding People
• Creating a Grid Page
• Reset Permalinks
• Using Shortcodes
  • People Shortcode Attributes
    • Filter Attributes
    • Order Attributes
    • Display Attributes
    • Source Site Attribute

Overview

People Listing is a Theme Extension available in the University of Maine System theme. The extension allows content editors to create and publish individual People profiles and can create listings of People on pages that are part of specific departments or have specific associations. People items are best managed in a centralized fashion with a single subsite designated as the primary source for People content (though this is not a requirement). People content can be displayed on the primary site using the People Grid page template, and on any subsite using a shortcode. Below is an example of this feature in the Maine Law site.

The icons used in the People Listing display page are from v5 Fontawesome and can be changed to meet your needs. This would usually (and preferably) be added by Web Technologies team as part of your project style definitions.

The above sample People Listing is from Maine Law – Full Time Faculty page. Note the names of each faculty member are linked to the detailed profile page.

Who Can Do What?

• Editors & Admins can create/edit categories, approve pending listings, delete listings, and edit/update listings. They can also create new listings.
• Contributors can create people/directory listings, but can only select already created categories (can’t create new ones). They can create a listing (can not edit it later). They can not publish their listing though. An editor/admin would need to approve it for publication.
• Authors can create people/directory listings, but can only select already create categories (can’t create new ones). They can create a listing, publish, and edit/update other listings.

Prepare your Request for the People Extension

1. First, you must identify or request creation of the subsite where the (primary) People Listing will reside – e.g.: https://umf.maine.edu/faculty/.
2. Make your configuration choices for various options:
   1. Individual bio page permalink (URL / web address) if different from the subsite path – e.g.: “profile” would make the faculty bio address look something like: “https://www.example.com/faculty/profile/jane-doe”
   2. Dashboard entry label (If “People” is not desired) – e.g.: “Faculty Profiles”
   3. Decide which additional fields you will expose on the person bio pages:
      1. Company
      2. Territory/Specialty
      3. Sport
      4. Curriculum Vitae
      5. Address
      6. Expertise
      7. Selected Publications
      8. Additional Publications
      9. Education
      10. Current Courses
      11. Research Interests
      12. Research Blog
      13. In The Media
3. Decide on the detailed profile page display layout. The profiles can be 2 columns (just the person’s info and content on left, image on right) or 3 columns to include a sidebar option. Placement of the sidebar depends on Theme Options > Main Settings > Sidebar (can choose left or right). The layout to choose 2 columns or 3 columns is under Theme Options > People Settings at the bottom.
4. Work with your primary campus Web Site Administrator to submit your request to webtech.support@maine.edu
5. Web Technologies team will activate the feature and configure your desired options / fields to expose.

Adding Departments and Associations

Departments and Associations are taxonomies used to categorize People items. Terms may be added to these taxonomies when creating or editing a People item, or they can be managed from their configuration pages which are accessed under the People menu. Terms can be arranged in parent-child hierarchies as needed. Multiple terms can be applied to People items.

To add a new Department or Association term:

1. Select People > Departments (or People > Associations)
2. Add the Name of the Department or Association term (example: Student Affairs).
3. Add a Slug for the term, using lowercase letters, numbers, and hyphens (example: student-affairs).
4. Select a Parent department (or association), if applicable.
5. Include a Description, if desired (this does not display publicly).
6. Click Add New Department (or Add New Association).

Adding People

1. Select People > Add New Listing.
2. Add the person’s name as the title.
3. Add biographical content in the main content area, as needed.
   
4. Include additional information in the Listing Details fields (below), as needed.
5. Select or add Departments the person is affiliated with (right-side), as needed.
6. Select or add Associations the person is affiliated with (right-side), as needed.
7. Set a Page Attributes > Order value if a custom ordering is needed on a display page.
8. Select or upload a Featured Image (right-side).

For best results when displaying people photos in various contexts, use images that are at least 570 pixels wide and that all images are of consistent height of 570px+.

Creating a Grid Page

Grid pages work in subsites that have the People theme extension enabled. If you need to display People in a different subsite, use a shortcode instead.

1. Select Pages > Add New.
2. Give the page a title.
3. Add any content that will appear before the grid listing in the content field.
4. In the right column, under Page Attributes > Template, select “People Grid.”
5. Publish the page.
6. Scroll down to the People Page Options section and configure the following settings:
   
   1. Columns: determines the number of columns in the grid layout
   2. Column Layout: determines whether content will flow horizontally or vertically
   3. Primary Sort: sets the primary sort options as follows:
      1. Last Name: (default) orders by last name, then first name
      2. Menu Order: sets the order according to each individual People item’s Page Attributes > Order value; negative values are allowed
      3. Title
      4. Date: sets the order by the date the People item was created
      5. Random
   4. Primary Sort Order
   5. Secondary Sort: sets the secondary sort options as follows:
      1. None: (default)
      2. Last Name: orders by last name, then first name
      3. Menu Order: sets the order according to each individual People item’s Page Attributes > Order value; negative values are allowed
      4. Title
      5. Date: sets the order by the date the People item was created
      6. Random
   6. Secondary Sort Order
   7. Limit to Department: determines the Department filter criteria
   8. Limit to Association: determines the Association filter criteria
   9. Listings Per Page
   10. Crop Images to Equal Height
   11. Set Image Height if Cropping: sets the image pixel height
   12. Content Source: sets the source for each item’s content as follows:
       1. None
       2. Excerpt
       3. Excerpt if available, otherwise truncated content
       4. Truncated content
       5. Full content
   13. Make images and title link to single post: sets whether and how to link each People item as follows:
       1. No, no link
       2. Yes, link to single post: links to the individual People profile
       3. Image link to lightbox: links to the image displayed in a lightbox overlay

Reset Permalinks

At times, the permalink settings will need to be reset in order for People profile pages to be accessible. If individual People pages return a 404 error, reset permalinks as follows:

1. Navigate to the site’s Settings > Permalinks page.
2. Change one of the settings and save the change.
3. Return the setting to its previous state and save the change again.

Using Shortcodes

People shortcodes can be added to any page content area and will automatically display as a grid listing of People items when the page is viewed.

The base shortcode for People is:

This will return an unfiltered listing of all People items from the primary People site.

Additional display and filter options can be set with attributes as listed below. If attributes are not explicitly added, default values are used.

Example:

The above shortcode would display a 3-column grid of people assigned to the ‘admissions’ department, with each item linking to the individual’s profile page, and with each image cropped to a height of 300 pixels.

People Shortcode Attributes

Filter Attributes

people_department

people_association

people_department
people_association

Order Attributes

orderby

order

orderby_secondary

order_secondary

Display Attributes

columns

columns_layout

link

crop

crop_height

content

items

offset

Source Site Attribute

source_site_id