Deckacy Neuro Inclusion Staff Portal — User Manual (Powered by NeuroLearn)

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.

Powered by NeuroLearn
Document type: User Manual

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.

📸 Screenshot: NISP Dashboard (cover)

2. Roles & Permissions

RoleTypical 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

  1. In WordPress Admin, go to Plugins → Add New → Upload Plugin.
  2. Upload the NISP Portal ZIP and click Install Now.
  3. 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.
  4. Verify that permalinks are working: visit Settings → Permalinks and click Save.
📸 Screenshot: WordPress → Plugins (NISP installed)

4. Getting Started Checklist

  1. 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.

    Loading staff profiles...

    Need help? Contact staff@deckacy.org.uk for assistance connecting with a qualified professional.

    .
  2. 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.

    Upload DBS certificate and primary qualification (Max 2MB each, PDF/PNG/JPEG).

    Extra references, certifications, or qualifications.

    For technical assistance, contact: staff@deckacy.org.uk

    .
  3. 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).
  4. Test the workflow: submit a dummy application, approve it, and confirm it appears in the public directory.
Tip: Keep the directory page public and ensure caching doesn’t block REST API calls.

5. Public-Facing Features

5.1 Staff Registration Form

Embed the form with

Neuro Staff Registration

Please complete all required fields and upload your documents to register your profile. All information is handled with GDPR compliance.

Upload DBS certificate and primary qualification (Max 2MB each, PDF/PNG/JPEG).

Extra references, certifications, or qualifications.

For technical assistance, contact: staff@deckacy.org.uk

. Applicants will provide:

  • 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.
📸 Screenshot: Registration form (fields and uploads)

5.2 Public Staff Directory

Embed the directory with

Neuro Staff Directory

Search our directory of certified Neuro Staff who align with the strengths-based Dynamic Development Plan (DDP) approach.

Loading staff profiles...

Need help? Contact staff@deckacy.org.uk for assistance connecting with a qualified professional.

. This displays only approved (published) profiles and supports search/filters. The directory uses the internal REST API endpoint /wp-json/nisp/v1/directory.

📸 Screenshot: Directory grid/cards with search and filters
Note: If your site restricts the REST API, whitelist the nisp/v1 namespace.

6. Admin Area

6.1 Staff Approvals & Vetting

Navigate to NISP Portal → Staff Approvals to review all pending applications.

  1. Click a profile’s actions: Approve or Deny/Revert.
  2. Optionally add a reviewer comment (stored in the audit log and sent by email).
  3. On approval, status becomes Publish, and the profile appears in the public directory.
  4. On revert, status becomes Pending for re-review, and it is removed from the public directory.
📸 Screenshot: Staff Approvals table with actions

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.

📸 Screenshot: All Staff list/table

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.

📸 Screenshot: Audit Log list and “View Details” modal

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.
📸 Screenshot: Settings page

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/uploads and the database in regular backups.
Tip: Use strong hosting security, HTTPS, and maintain current WordPress and plugin versions.

8. REST API Endpoints

EndpointMethodDescription
/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).
Note: If a security plugin limits REST access, whitelist the 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.

    Loading staff profiles...

    Need help? Contact staff@deckacy.org.uk for assistance connecting with a qualified professional.

    .
  • 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

ShortcodePurpose

Neuro Staff Registration

Please complete all required fields and upload your documents to register your profile. All information is handled with GDPR compliance.

Upload DBS certificate and primary qualification (Max 2MB each, PDF/PNG/JPEG).

Extra references, certifications, or qualifications.

For technical assistance, contact: staff@deckacy.org.uk

Displays the public registration form.

Neuro Staff Directory

Search our directory of certified Neuro Staff who align with the strengths-based Dynamic Development Plan (DDP) approach.

Loading staff profiles...

Need help? Contact staff@deckacy.org.uk for assistance connecting with a qualified professional.

Displays the public staff directory.

Neuro Staff Directory

Search our directory of certified Neuro Staff who align with the strengths-based Dynamic Development Plan (DDP) approach.

Loading staff profiles...

Need help? Contact staff@deckacy.org.uk for assistance connecting with a qualified professional.

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 a success response and data.
© 2025 Deckacy. “Deckacy Neuro Inclusion Staff Portal User Manual — Powered by NeuroLearn”. This document is provided “as is” for operational guidance.