Skip to content

AgriLife/AgriLife-People

Repository files navigation

AgriLife People

Plugin URI: https://github.com/AgriLife/AgriLife-People

Description: People custom post type with some other goodies

Version: 1.1

Author: J. Aaron Eaton, Zachary Watkins

License: GPL2.0+

Usage

The AgriLife People plugin allows you to display the faculty and staff of your department in a structured, easy-to-use manner. To get started you will need to activate the plugin on your site or submit a First Call ticket to have our support staff activate it for you. Once the plugin is activated you're ready to create your first person in the database.

Creating a Person

  1. To begin creating a new person, click on 'People' in the dashboard then click the 'Add New' link.

Add New Person

  1. The first few fields are fairly standard for people directories. Only the first and last name fields are required.

Person Fields

  1. Adding an image is simple. Just click the 'Add Image' button and upload your image. Don't forget to add a title and alt. text. You can also attach a resume/CV to the person's profile. See the video for more details.

  2. The next few fields are Undergraduate Education, Graduate Education, Courses & Awards. These special fields allow you to create as many entries as necessary. The next video shows you how they work.

  3. At the bottom of the page you have a content field to display text, images and galleries in each person page in a flexible manner. The content fields can even be reordered by dragging and dropping. Check out the video.

  4. Each person can be categorized by type for easy display on your site. You can add them in the person edit page or on People -> Types. Check out the video.

  5. Just click 'Publish' and the person will be shown on the website. Click 'View Person' to see the results.

Buzz Lightyear Profile

Viewing People

The first and most common method of viewing your list of people is the automatically generated 'People' page. You can find this at <your-site-url>/people. In order for this view to work, you must not have an existing page named 'People'.

People Page

You can also view people by each type. This page is also automatically created and can be found at <your-site-url/people/<type-slug>. In this case our type slug is 'heroes'. It is the lowercase version of the type 'Heroes'.

Heroes Type Page

Lastly, you can insert a list of people in any post or page you like by using the shortcode [people_listing]. You can even filter by type and choose whether or not to show the search form.

[people_listing] Show Everyone

[people_listing type="heros"] Show only Heroes

Shortcodes

Requirements

The following plugins must be installed and activated:

  • Advanced Custom Fields PRO, version 5 or higher

To set up the repo for development for the first time, navigate to the directory in the console and run "npm run once".

To watch for changes to Sass files, run "npm watch".

To manually compile Sass files, run "npm build".

Notices

  • This is a fork of the now deprecated AgriLife Staff plugin. You may continue to use AgriLife Staff, but updates will not be made.

Changelog

1.0

  • Fixed resume link to be conditional
  • Forcing reduced font size on email addresses
  • Flushing rewrite rules on activation/deactivation
  • Alerts users if required plugins are not installed/activated
  • Commented and cleaned up code

0.9.5

  • Fixed search not working with new templates
  • Added "search" parameter to people_listing shortcode

0.9.4

  • Fixed query
  • Placed query in static method for easy reuse
  • Added Resume/CV field

0.9.3

  • Fixed archive template title
  • Fixed name going blank when using quick edit

0.9.2

  • Allowing shortcode to filter by Type
  • Fixed taxonomy archive template

0.9.1

  • Fixed people search box not displaying on some themes
  • Added blurb field to Featured Person widget

0.9

  • Forked AgriLife Staff plugin
  • Updated to use Advanced Custom Fields
  • Added flexible content areas for people pages
  • Tweaked default styles

About

People custom post type with some other goodies.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 8