Archive Page

CP Staff provides an automatic archive page that displays all staff members organized by department. This page serves as your primary staff directory.

Default Archive

The archive page is accessible at:

https://yoursite.com/staff/

If you changed the Plural Label in settings (e.g., to “Our Team”), the URL updates to match (e.g., yoursite.com/our-team/).

The archive page:

• Groups staff by department, respecting hierarchical parent-child relationships
• Shows staff cards with name, title, photo, and contact icons
• Orders staff by menu order first, then alphabetically by name
• Supports click actions (link to single page, open modal, or disabled)

Hierarchical Departments

The archive page supports nested department structures. Parent departments display first, with child departments nested beneath:

• Each department level uses appropriate heading levels (h3, h4, etc.)
• Departments without directly assigned staff still display their child departments
• The starting heading level defaults to h3 and can be customized with the cp_staff_archive_starting_heading_level filter

// Start department headings at h2 instead of h3
add_filter( 'cp_staff_archive_starting_heading_level', function( $level ) {
    return 2;
});

Archive Title

The archive page title defaults to the plural label set in Staff > Settings > Staff. Customize it with:

add_filter( 'cp_staff_archive_title', function( $title ) {
    return 'Meet Our Team';
});

Disabling the Archive

If you prefer to display staff using shortcodes on a custom page:

1. Navigate to Staff > Settings > Staff
2. Check Disable Archive Page
3. Create a new page and use the [cp_staff_archive] or [cp_staff_list] shortcode

You can also disable the archive programmatically:

add_filter( 'cp_staff_disable_archive', '__return_true' );

Single Staff Pages

When Staff click action is set to “Link to single staff page” in Staff > Settings > Advanced, clicking a staff card opens the individual staff page showing:

• Larger photo (alternate image if set, otherwise featured image)
• Name and title
• Full biography
• Social media links
• Email contact option (if contact forms are enabled)

Click Action Options

Control visitor interaction via Staff > Settings > Advanced > Staff click action:

Option	Behavior
None	Staff cards are not clickable
Link to single staff page	Opens the staff member’s dedicated page
Display popup modal	Shows staff details in a modal overlay

Staff cards are only clickable when the staff member has biography content. If the content editor is empty, the card displays without a link regardless of the click action setting.

For shortcode-based staff display, see Shortcodes. For template customization, see Template Overrides.