Staffer is a staff-management solution for WordPress-based sites. It uses WP’s custom-post type feature to add a new “Staff” section to the admin panel, from which you can add and manage staff members as easily as blog posts.
Staffer is 100% free, and is released under a GPL license, so it can be used on commercial or non-commercial projects. The plugin features a robust options panel, including:
- Staff layout options (grid or list)
- Listings per page
- Custom titles and URL slugs
- Experimental sidebar
- Custom CSS
- Staff profile fields and contact links
- Custom content wrappers
- Default content wrappers for popular themes
Installation and Set Up
- Upload the ‘staffer’ folder to the /wp-content/plugins/ directory, or install via the WP plugin panel
- Activate via the Dashboard>Plugins menu.
- Visit Dashboard>Settings>Staffer Options to set it up
Options Panel Overview
Check this option to use the staff grid layout. If left unselected, the staff list (blog-style) format is used.
Listings per page
Choose the number of staff listings per page. If you want to show all listings on a single page, set this value arbitrarilly high (e.g. 99).
Staffer Page Title
Choose the page title displayed on your staffer archive page. The default title is “Staff.” This title is also used in the individual staff breadcrumbs.
Staffer URL slug
Set the URL slug for your staff profiles. The default value is “staff.”
Check this if you want to disable all Staffer CSS. You can then add your own CSS either via your theme’s stylesheet or the Custom CSS box below.
Use custom wrappers
Check this box to activate custom content wrappers. Try this out, and then input your custom wrappers below, if Staffer doesn’t flow well with your theme.
Custom start wrapper
Input the custom content wrappers you want to use, if any (above feature must be activated). Use this for your opening HTML wrappers.
Custom end wrapper
Use this for your closing HTML wrappers.
Enable Staff sidebar
Check this box to enable the sidebar. This feature is currently experimental, and probably won’t work with most themes. For advanced sidebar usage, set up a custom Staffer template (see the FAQ).
Use this for any custom CSS you want to use to override the Staffer defaults.
Frequently Asked Questions
How Do I Set Up a Custom Template?
Staffer uses two main templates: archive-staff.php and single-staff.php. If these files are present within your theme directory, Staffer will load your custom files rather than the plugin’s default files. So, to create a custom template, you might start by copying archive-staff.php and single-staff.php into your theme’s template. Then you could proceed to customize the template to your satisfaction. Some basic HTML/PHP skills will generally be needed for this. If you aren’t comfortable with this, I suggest reaching out to a competent developer. I’m also available for paid support and customization, so please contact me through my website should you need assistance.
Using some combination of custom templates and custom wrappers, Staffer should work with most any WordPress theme.
How Do I Use Staffer’s Shortcodes?
There are two ways to use shortcodes: 1) standard method. 2) manual method.
In the default method, you can use shortcodes while keeping Staffer’s archive pages enabled. If you want to use shortcodes exclusively, check the “Manual Method” option in the Staffer Options panel to disable the main “Staff” page.
Follow this format for shortcodes:
The above example would output all of the staff listings in default order.
To fine-tune, you can use parameters:
[staffer number="5" department="slug"]
In the above example, “number” refers to the number of entries to retrieve, and “department” refers to the department name slug. For instance, if you only wanted to show a list of members in department term with the “management” slug, you would pass “management” as a parameter.
Other parameters include “order” and “orderby” — and all parameters are optional.
Using the extra parameters, you could reorder the entries using WP_Query’s order and orderby parameters.
For example, if you wanted to display 50 staff members, ordered by name alphabetically, you would do the following:
[staffer number="50" order="ASC" orderby="name"]
How Can I Set the Order of Staff Profiles?
For now, use a custom ordering plugin, such as Post Types Order, available in the WordPress plugin repository. I plan on adding this functionality to Staffer in the future.
How Do I Use Custom Content Wrappers?
Custom content wrappers are used when Staffer doesn’t flow well with your theme. Due to the incredible diversity of WordPress themes, I’ve included this option for folks that find the default wrappers do not work for them. You will need to utilize Chrome’s Developer Tools or a Firefox add-on like Firebug to inspect the page elements to find your theme’s content wrappers. For example, here is the start of the content wrapper for the Twenty-Twelve theme:
<div id="primary" class="site-content"><div id="content" role="main">
And here is the end wrapper:
What Size Should the Staff Images Be?
The ideal size, as shown in the plugin screenshots, is 250×200. However a variety of image sizes will work. To preserve the formatting, make sure all your images are uniform in size, particularly if you are using the Staffer grid layout.
Where Can I Get Support?
You may seek community support within the WordPress.org forums. I will try to monitor and assist as needed. If you need immediate, hands-on, paid support, please contact me.