Creating a Staff Directory
Staff Directories are a SportsPress Pro feature. Navigate to Staff → Directories → Add New Staff Directory to create one.
Title
Enter a descriptive name for the directory in the title field. This name appears on the directory's public page.
Layout Format
The Layout sidebar meta box offers two format choices:
List — Displays staff in a table with columns for name, job, phone, and email.
Gallery — Displays staff as a photo grid with name captions.
The format selection also determines which shortcode appears in the Shortcode panel: [staff_list id="X"] for List format, or [staff_gallery id="X"] for Gallery format.
Details Sidebar
The Details sidebar meta box controls which staff members appear in the directory:
League — Filter to staff assigned to a specific league. Leave unset to include all leagues.
Season — Filter to staff assigned to a specific season. Leave unset to include all seasons.
Job — Filter to staff assigned to a specific job. Leave unset to include all jobs.
Team — Filter to staff who belong to a specific team. Leave unset to include all teams. After selecting a team, choose an era:
All — Include all staff associated with the team.
Current — Only staff whose
sp_current_teammatches the selected team.Past — Only staff whose
sp_past_teammatches the selected team.
Staff Directory Data Table
The main Staff Directory meta box (full-width) previews which staff members will appear. The data table shows each staff member's name, job, phone, and email. Drag the handle icon to manually reorder staff within the directory.
Column checkboxes above the table toggle the visibility of the Phone and Email columns in the directory output.
Editor
An optional content editor above the data table can hold introductory text or other content that appears before the directory on the public page.
Displaying on a Page
After publishing the directory, copy the shortcode from the Shortcode sidebar panel and paste it into any post, page, or text widget. The shortcode format is:
[staff_list id="X"]
or, for gallery format:
[staff_gallery id="X"]
Replace X with the directory's post ID.
Alternatively, the directory has its own public URL at yourdomain.com/directory/your-directory-name/ which renders the directory template directly.
Pagination and Row Limits
Default pagination and row limits for all directories are configured under SportsPress → Settings → Staff → Staff Directories:
Paginate — Enable or disable pagination globally.
Limit — Default number of staff per page (default: 10).
These defaults can be overridden per-directory using shortcode parameters.