PostBox – Advanced User Feedback, Complaint & Support Management Plugin for Sngine

PostBox is a powerful, plugin-based feedback and support management system designed specifically for Sngine-powered social networks. It enables your users to easily submit complaints, suggestions, bug reports, and feedback—while giving administrators a complete dashboard to manage, respond, and track every submission efficiently.

Built with a modular, no-core-edit architecture, PostBox integrates seamlessly into your platform via hooks, ensuring clean installation, easy updates, and maximum compatibility.

🚀 Frontend User Experience

PostBox provides a smooth and intuitive interface for users:

• Dedicated submission page: /postbox
• Submit reports with:
  • Category (Complaint, Suggestion, Bug Report, Feedback)
  • Subject & detailed description (rich-text editor)
  • Optional file attachments
• Auto-generated report IDs (e.g., PBX-1001)
• Default tracking status: Pending
• Users can view all their submissions with:
  • Status badges
  • Admin replies
  • Submission date
• Detailed report view via unique link
  (e.g., /postbox?report=PBX-xxxx)

🛠️ Powerful Admin Dashboard

Manage everything from a centralized admin panel:

• Dashboard route: /admincp/helptor/postbox
• View and manage all reports in one place
• Advanced filtering:
  • By status, category, or search
• Update report status:
  • Pending, In Progress, Resolved, Rejected
• Add or edit admin replies
• Secure delete with confirmation flow
• CSRF protection & secure action validation

🔔 Smart Notifications & Email System

Keep users informed in real time:

• In-app notifications on report updates
• Single consolidated email (no duplicates)
• Email includes:
  • Report ID & subject
  • Category
  • Status change (old → new)
  • Admin reply
  • Direct “View Report” link
• Uses user’s registered email automatically

📌 Seamless UI Integration

PostBox blends perfectly into your Sngine UI:

• Sidebar menu link injection (hook-based)
• Feed sidebar widget with:
  • Call-to-action button
  • Custom heading & bullet content
• Admin-configurable widget text
• Toggle visibility from plugin settings

⚙️ AdminCP Integration

• Adds PostBox Dashboard directly into AdminCP support section
• Fully integrated using hooks (no core modifications required)

🗄️ Database & Storage

• Dedicated reports table: postbox_reports
• Plugin settings table: postbox_settings
• Secure file storage under:
  • /content/helptor/postbox/uploads/

🔒 Security & Validation

Built with security-first principles:

• Login & admin role validation
• Input validation for all fields
• Rich-text sanitization
• File upload validation (type, size, MIME)
• Safe output escaping
• CSRF protection on all actions

🧱 Plugin Architecture

• 100% plugin-based (no core edits required)
• Clean, maintainable structure:
  • init.php
  • routes.php
  • controllers/
  • templates/
  • uploads/
• Hook-driven rendering for seamless integration

💡 Why Choose PostBox?

• Turn your social network into a fully interactive support system
• Improve user engagement & trust
• Track issues, feedback, and bugs in one place
• Clean integration with zero risk to core files