Troubleshooting

This guide covers common issues with CP Staff and how to resolve them.

Staff Archive Page Not Showing

1. Check archive setting: Navigate to Staff > Settings > Staff and ensure Disable Archive Page is unchecked
2. Flush permalinks: Go to Settings > Permalinks and click Save Changes (no changes needed — just saving flushes the rewrite rules)
3. Check for conflicts: Temporarily switch to a default WordPress theme to rule out theme conflicts
4. Check the URL: The archive URL matches your plural label setting. If you changed it to “Our Team”, the URL is yoursite.com/our-team/

Contact Form Emails Not Being Received

1. Check email configuration: Install WP Mail SMTP or a similar plugin to ensure WordPress can send emails reliably
2. Verify staff email: Edit the staff member and confirm an email address is set in the Staff Details box
3. Check spam folder: Contact form emails may be filtered as spam by the recipient’s email provider
4. Check From Address: In Staff > Settings > Advanced, set the From Address to an email on a domain you control with proper SPF/DKIM records
5. Test with CAPTCHA disabled: Temporarily disable CAPTCHA to rule out reCAPTCHA configuration issues

CAPTCHA Not Working

1. Verify keys: Ensure both the Site Key and Secret Key are correctly entered in Staff > Settings > Advanced
2. Check reCAPTCHA version: CP Staff requires reCAPTCHA v3 keys. Keys from v2 (checkbox CAPTCHA) are not compatible
3. Check domain registration: Your site’s domain must be registered in the reCAPTCHA admin console
4. Check browser console: Look for JavaScript errors related to reCAPTCHA loading

Staff Cards Not Clickable

1. Check click action: Navigate to Staff > Settings > Advanced and verify Staff click action is set to “Link to single staff page” or “Display popup modal”
2. Check static mode: If using the [cp_staff_list] shortcode, ensure static="true" is not set
3. Check for JavaScript errors: Open your browser’s developer console and look for errors that may prevent the click handler from working

Department Ordering Issues

1. Default ordering: Departments sort alphabetically by name by default
2. Install ordering plugin: Use WP Term Order for drag-and-drop department ordering
3. Staff ordering: Staff sort by Menu Order, then by Name. Set the order value in the Page Attributes box when editing a staff member

Rate Limiting Blocking Legitimate Submissions

1. Adjust the limit: In Staff > Settings > Advanced, increase the Max submissions per day value (up to 10)
2. Clear rate limit data: The rate limit resets daily. If a user is blocked, they can try again the next day
3. Check for shared IPs: Users behind the same network (e.g., church office) share an IP address and collectively count toward the limit

Template Overrides Not Working

1. Check directory name: The theme directory must be named exactly cp-staff (not cpstaff or cp_staff)
2. Check file path: The file structure in your theme must mirror the plugin’s templates/ directory
3. Clear cache: If using a caching plugin, clear all caches after adding or modifying template overrides

For additional help, see Getting Help.