Deckacy Neuro Inclusion Staff Portal — User Manual
A step-by-step guide for administrators, reviewers, and staff to set up, operate, and maintain the NISP Portal.
1. Introduction
The Deckacy Neuro Inclusion Staff Portal (NISP) is a WordPress plugin that streamlines the recruitment, vetting, approval, and presentation of neuro inclusion professionals aligned with the Dynamic Development Plan (DDP) framework. This manual explains how to install, configure, and use the portal across public and administrative workflows.
2. Roles & Permissions
| Role | Typical Capabilities |
|---|---|
| Administrator | Manage settings, approve/revert staff, view audit logs, manage assets and pages. |
| Reviewer (Admin or Editor) | Review pending applications, add reviewer comments, approve or revert to pending. |
| Applicant/Staff | Submit profile via public registration form (uploads DBS/qualifications, provides details). |
3. Installation & Activation
- In WordPress Admin, go to Plugins → Add New → Upload Plugin.
- Upload the NISP Portal ZIP and click Install Now.
- Click Activate. The plugin will register:
- Custom Post Types (e.g.,
nisp_staff,nisp_audit_log). - Shortcodes for public pages.
- Admin menus for approvals, settings, and audit logs.
- Custom Post Types (e.g.,
- Verify that permalinks are working: visit Settings → Permalinks and click Save.
4. Getting Started Checklist
- Create a public page called “Neuro Staff Directory” and add the shortcode
.Neuro Staff Directory
Search our directory of certified Neuro Staff who align with the strengths-based Dynamic Development Plan (DDP) approach.
- Create another public page for staff onboarding and add
.Neuro Staff Registration
Please complete all required fields and upload your documents to register your profile. All information is handled with GDPR compliance.
For technical assistance, contact: staff@deckacy.org.uk
- Open NISP Portal → Settings and configure:
- Max file size, allowed file types for uploads.
- Email notifications for new applications.
- Regions / roles (if provided via settings).
- Test the workflow: submit a dummy application, approve it, and confirm it appears in the public directory.
5. Public-Facing Features
5.1 Staff Registration Form
Embed the form with Please complete all required fields and upload your documents to register your profile. All information is handled with GDPR compliance.
For technical assistance, contact:
staff@deckacy.org.uk
. Applicants will provide:Neuro Staff Registration
- Full name, email, qualification/role, region.
- Short bio, availability (now or from date).
- Mandatory uploads: DBS and qualification documents (PDF/PNG/JPG).
- GDPR consent tick box.
5.2 Public Staff Directory
Embed the directory with
Search our directory of certified Neuro Staff who align with the
strengths-based Dynamic Development Plan (DDP) approach.
. This displays only approved (published) profiles and supports search/filters. The directory uses the internal REST API endpoint Neuro Staff Directory
/wp-json/nisp/v1/directory.
nisp/v1 namespace.6. Admin Area
6.1 Staff Approvals & Vetting
Navigate to NISP Portal → Staff Approvals to review all pending applications.
- Click a profile’s actions: Approve or Deny/Revert.
- Optionally add a reviewer comment (stored in the audit log and sent by email).
- On approval, status becomes Publish, and the profile appears in the public directory.
- On revert, status becomes Pending for re-review, and it is removed from the public directory.
6.2 All Approved Staff
Use NISP Portal → All Staff (if enabled) to view all published staff. You can revert to pending from here as well.
6.3 Audit Logs
Open NISP Portal → Audit Logs to view every approval and revert action. Click a row to see details in a modal (staff name, email, decision, reviewer, timestamp, comments). Export CSV when needed.
6.4 Portal Settings
Within NISP Portal → Settings you’ll find:
- Upload limits (size, types).
- Email notifications (recipient address, template lines).
- Optional region/role lists for filters.
7. Data Handling & Security
- Uploads: Limited to safe types (PDF/PNG/JPG). Maximum size is configurable.
- GDPR: Consent is mandatory. Do not process applications without explicit consent.
- Roles: Only users with sufficient capability (e.g., Administrators) can approve or revert submissions.
- Auditability: Every decision is recorded with reviewer name, timestamp, and optional notes.
- Backups: Include
wp-content/uploadsand the database in regular backups.
8. REST API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/wp-json/nisp/v1/register |
POST | Receives staff registration submissions (including uploads). |
/wp-json/nisp/v1/directory |
GET | Returns approved staff for the public directory (supports region, role, availability, search). |
nisp/v1 namespace.9. Troubleshooting
Directory shows no staff
- Ensure at least one profile is Published (approved).
- Confirm your public page uses
.Neuro Staff Directory
Search our directory of certified Neuro Staff who align with the strengths-based Dynamic Development Plan (DDP) approach.
- Check Settings → Permalinks and click Save to refresh rules.
- Visit
/wp-json/and confirm it loads JSON (no 403/404).
“Updating failed. The response is not a valid JSON response.”
- This is often caused by PHP output before headers. Ensure no stray
<script>or HTML is echoed in admin classes before redirects. - Disable conflicting plugins temporarily and test again.
REST API 404 for /nisp/v1/directory
- Make sure the plugin is active and your Data Handler registers routes on
rest_api_init. - Resave Permalinks.
- Check security plugins for blocked REST namespaces.
Uploads failing
- Increase max upload size in NISP settings or server/PHP settings.
- Verify allowed MIME types (PDF, PNG, JPG).
10. Glossary
- DDP: Dynamic Development Plan — a strengths-based framework.
- Audit Log: A record of every approval/revert action with context.
- CPT: Custom Post Type in WordPress, e.g.,
nisp_staff. - REST API: JSON endpoints used by the portal’s frontend components.
11. Appendix: Shortcodes & Code Snippets
Shortcodes
| Shortcode | Purpose |
|---|---|
| Displays the public registration form. |
| Displays the public staff directory. |
| Alias (optional) for staff directory. |
Quick REST checks
- Open
/wp-json/in a browser — you should see JSON. - Open
/wp-json/nisp/v1/directory— you should see asuccessresponse and data.
