/WSUWP-Content-Syndicate-People

A WordPress plugin to retrieve and display people from people.wsu.edu.

Primary LanguagePHPOtherNOASSERTION

WSUWP Content Syndicate People

Build Status

A WordPress plugin to retrieve and display people from people.wsu.edu.

Shortcode attributes

This plugin adds the following attributes to shortcodes registered with or extended from WSUWP Content Syndicate:

  • classification - Classification slug to retrieve people by.
  • display_fields - A comma-separated list of fields to display for each profile. Defaults to photo,name,title,office,email. Additional fields include degree, address, phone, bio, bio-unit, bio-university, and website.
  • filters - A comma-separated list of filtering options. Allowed values include search, location, organization, classification, tag, and category. The category value combines terms from university categories and site categories. Labels for each filter option can be adjusted using the attributes below:
    • category_filter_label - Defaults to Filter by category.
    • classification_filter_label - Defaults to Filter by classification.
    • location_filter_label - Defaults to Filter by location.
    • organization_filter_label - Defaults to Filter by organization.
    • search_filter_label - Defaults to Type to search.
    • tag_filter_label - Defaults to Filter by tag.
  • exclude_term_values - A comma-separated list of term values to exclude when filtering - uses the option value from the filter drop down to exclude a term.
  • photo_size - Specify the size of the photo to display for each profile. Defaults to thumbnail. Other allowed values include medium and large.
  • link - Link a person's name and photo to their full profile. Works only when the host attribute is being used.
  • website_link_text - Link text to display for the website field when it is being output. Defaults to Website.
  • nid - Displays an individual person associated with the given WSU Network ID.
  • profile_page_url - (Legacy: see view profile) Link to dynamic profile page. Allows you to show profiles on your site instead of linking out.
  • view_proflie - Show profile on page
  • heading_tag - HTML tag to use for the profile title. Defaults to h2.
  • display_first - List of comma-separated nids to display first in order.

Example usage

Basic usage: [wsuwp_people count="10"].

Display only name, title, and phone: [wsupw_people display_fields="name,title,phone"].

Display single profile: [wsuwp_people output="profile" nid="-person-nid-here-"].

Dynamic profile pages

  • Create a dynamic profile page [wsuwp_people output="profile"].
    • Do not set the nid attribute.
    • You can use the bio options in display_fields to choose a bio to display on the profile display_fields="....,bio-unit".
    • Copy the URL to to this page.
  • Create a gallery/directory page using the profile_page_url and link attributes [wsuwp_people link="has-bio" profile_page_url="-copied-url-from-above"].