تخطَّ إلى المحتوى

صندوق الوارد والنماذج والتنبيهات — كيانات المحتوى وحالات الاستخدام

Package: @vicacha-devs/strapi-plugin-inbox · Plugin ID: inbox · Admin Workspace: /admin/plugins/inbox

1. كيانات أنواع المحتوى ومواقعها ومخططاتها (strapi.documents)

Section titled “1. كيانات أنواع المحتوى ومواقعها ومخططاتها (strapi.documents)”

Registers three Collection Types (plugin::inbox.submission, plugin::inbox.subscriber, and plugin::inbox.alert-banner). Submissions capture dynamic form payloads and service-desk tickets; Subscribers manage double opt-in topic lists; Alert Banners drive time-bounded site-wide urgent tickers.

أين تجد كيانات أنواع المحتوى في Strapi v5

Section titled “أين تجد كيانات أنواع المحتوى في Strapi v5”
  • Content Manager: /admin/content-manager/collection-types/plugin::inbox.submission, plugin::inbox.subscriber, and plugin::inbox.alert-banner (visible: true)
  • Content-Type Builder: /admin/plugins/content-type-builder under Collection Types (Inbox Submission, Inbox Subscriber, Inbox Alert Banner)
  • Plugin Workspace & Settings: /admin/plugins/inbox (Service Desk Inbox, Subscribers, Alert Banners) and /admin/settings/inbox
  • Database Tables: inbox_submissions, inbox_subscribers, and inbox_alert_banners

plugin::inbox.alert-banner — Inbox Alert Banner

Section titled “plugin::inbox.alert-banner — Inbox Alert Banner”

Time-bounded multi-language urgent announcement ticker / banner

Kind: collectionType · DB Table: inbox_alert_banners · Admin Location: /admin/content-manager/collection-types/plugin::inbox.alert-banner · Draft & Publish: No · i18n: No

الحقل النوع في Strapi إلزامي القيود / العلاقات
code string Yes —
title string Yes —
message text Yes —
severity enumeration Yes enum: info, warning, urgent, celebration; default: "info"
ctaLabel string No —
ctaUrl string No —
dismissible boolean No default: true
active boolean No default: true
priority integer No default: 10
startsAt datetime No —
endsAt datetime No —
translations json No default: {}

plugin::inbox.submission — Inbox Submission

Section titled “plugin::inbox.submission — Inbox Submission”

Form submission & Service-Desk Casework ticket

Kind: collectionType · DB Table: inbox_submissions · Admin Location: /admin/content-manager/collection-types/plugin::inbox.submission · Draft & Publish: No · i18n: No

الحقل النوع في Strapi إلزامي القيود / العلاقات
referenceCode string Yes —
formSlug string Yes —
formTitle string No —
category enumeration No enum: contact, service_desk, inquiry, application, volunteer, custom; default: "contact"
status enumeration Yes enum: new, read, under_review, scheduled, completed, rejected, archived; default: "new"
priority enumeration Yes enum: low, normal, high, urgent; default: "normal"
department string No default: "general"
locale string No default: "es"
applicantName string No —
applicantEmail email No —
applicantPhone string No —
data json Yes default: {}
checklistItems json No default: []
staffNotes text No —
assignedTo string No —
linkedBookingId string No —
linkedCertificateNumber string No —
formBuilderSubmissionId integer No —
ipAddress string No private: true
userAgent string No private: true
submittedAt datetime Yes —
secondaryDate json No —

plugin::inbox.subscriber — Inbox Subscriber

Section titled “plugin::inbox.subscriber — Inbox Subscriber”

Double Opt-In newsletter and community topic subscriber

Kind: collectionType · DB Table: inbox_subscribers · Admin Location: /admin/content-manager/collection-types/plugin::inbox.subscriber · Draft & Publish: No · i18n: No

الحقل النوع في Strapi إلزامي القيود / العلاقات
email email Yes —
fullName string No —
phone string No —
locale string No default: "es"
topics json No default: ["announcements"]
status enumeration Yes enum: pending, confirmed, unsubscribed; default: "pending"
confirmToken string No private: true
unsubscribeToken string Yes private: true
confirmedAt datetime No —
unsubscribedAt datetime No —
sourceFormSlug string No —

التكامل مع مدير المحتوى في Strapi v5 (/admin/content-manager)

Section titled “التكامل مع مدير المحتوى في Strapi v5 (/admin/content-manager)”

مجموعة الشريط الجانبي في مدير المحتوى: Inbox & Omnichannel Broadcasts

الكيانات والمكونات المسجلة في مدير المحتوى

Section titled “الكيانات والمكونات المسجلة في مدير المحتوى”
  • plugin::inbox.submission (Inbox Submission — /admin/content-manager/collection-types/plugin::inbox.submission)
  • plugin::inbox.subscriber (Inbox Subscriber — /admin/content-manager/collection-types/plugin::inbox.subscriber)
  • plugin::inbox.alert-banner (Inbox Alert Banner — /admin/content-manager/collection-types/plugin::inbox.alert-banner)

صندوق الوارد والنماذج والتنبيهات — واجهة إدارة الكيانات في مدير المحتوى Strapi v5

لماذا تنشئ هذه الإضافة كيانات داخل مدير المحتوى (Content Manager)؟

Section titled “لماذا تنشئ هذه الإضافة كيانات داخل مدير المحتوى (Content Manager)؟”

@vicacha-devs/strapi-plugin-inbox registers all three of its entities (Inbox Submission, Inbox Subscriber, and Inbox Alert Banner) with pluginOptions['content-manager'].visible = true so service-desk coordinators, newsletter managers, and editors can combine the operational triage board in /admin/plugins/inbox with Strapi v5’s native Content Manager:

  • Structured Casework & Cross-Entity Linking: In Content Manager, Inbox Submission (plugin::inbox.submission) exposes referenceCode, category, status, priority, department, checklistItems, linkedBookingId, and linkedCertificateNumber while keeping ipAddress and userAgent protected (private: true).
  • Subscriber Topic & GDPR Compliance Management: Filter Inbox Subscriber (plugin::inbox.subscriber) by status (pending, confirmed, unsubscribed), locale, and topics while confirmToken and unsubscribeToken remain private.
  • Time-Bounded Urgent Alert Authoring: Author and schedule Inbox Alert Banner (plugin::inbox.alert-banner) records (severity: info, warning, urgent, celebration, startsAt, endsAt, translations) directly in Content Manager.

كيفية الاستخدام داخل مدير المحتوى في Strapi (خطوة بخطوة)

Section titled “كيفية الاستخدام داخل مدير المحتوى في Strapi (خطوة بخطوة)”
  1. Open in Content Manager: In the left sidebar, navigate to Content Manager -> Collection Types -> Inbox & Omnichannel Broadcasts and select Inbox Submission, Inbox Subscriber, or Inbox Alert Banner.
  2. Manage Urgent Alert Banners: Open Inbox Alert Banner (/admin/content-manager/collection-types/plugin::inbox.alert-banner) to create or toggle site-wide announcements (RAMADAN-HILAL-1447, JUMUAH-LIVE-KHUTBAH, WINTER-BLANKET-CAMPAIGN).
  3. Filter & Assign Service-Desk Submissions: Open Inbox Submission (/admin/content-manager/collection-types/plugin::inbox.submission) to filter tickets by priority = urgent, department, or status = under_review, and update assignedTo and staffNotes.
  4. Workspace vs. Content Manager: Use Content Manager for bulk filtering, alert banner scheduling, and subscriber list audits; use the Inbox Workspace (/admin/plugins/inbox) for dynamic form schema design and interactive service-desk SLA triage.

التزامن بين مدير المحتوى ومساحة عمل الإضافة

Section titled “التزامن بين مدير المحتوى ومساحة عمل الإضافة”

حالات الاستخدام داخل مدير المحتوى ومسارات العمل التحريرية

Section titled “حالات الاستخدام داخل مدير المحتوى ومسارات العمل التحريرية”

Content Manager Use Case 1 — Scheduling Multilingual Urgent & Celebration Alert Banners

Section titled “Content Manager Use Case 1 — Scheduling Multilingual Urgent & Celebration Alert Banners”
  • الغرض والأهمية: Publish time-bounded header banners for Ramadan Hilal confirmation (severity: 'celebration'), Friday live khutbah streams (info), or emergency relief appeals (urgent).
  • خطوات التنفيذ في مدير المحتوى: Open /admin/content-manager/collection-types/plugin::inbox.alert-banner, click + Create new entry, set code, title, message, severity, startsAt, endsAt, and translations, and save.

Content Manager Use Case 2 — Auditing Service-Desk Submissions & Linking Bookings/Certificates

Section titled “Content Manager Use Case 2 — Auditing Service-Desk Submissions & Linking Bookings/Certificates”
  • الغرض والأهمية: Filter high-priority counseling or matrimonial requests in Content Manager and link them to an appointment (linkedBookingId) or certificate (linkedCertificateNumber).
  • خطوات التنفيذ في مدير المحتوى: Open /admin/content-manager/collection-types/plugin::inbox.submission, filter by priority = high, and update the record.

3. حالات الاستخدام ومسارات العمل المتكاملة

Section titled “3. حالات الاستخدام ومسارات العمل المتكاملة”

Use Case 1 — Dynamic Public Form Builder & Service-Desk Casework Triage

Section titled “Use Case 1 — Dynamic Public Form Builder & Service-Desk Casework Triage”
  • What it is for: Render multi-step contact, matrimonial, counseling, or volunteer forms on the frontend and triage submissions with SLA priorities and staff checklists.
  • How it works: Fetch form schemas via GET /api/inbox/forms/{slug}, submit via POST /api/inbox/submit (creating plugin::inbox.submission with a referenceCode), and track status via GET /api/inbox/track/{referenceCode}.

Inbox, Forms & Alert Banners — Strapi v5 Admin Workspace

Use Case 2 — Double Opt-In Newsletter & Topic Subscription Management

Section titled “Use Case 2 — Double Opt-In Newsletter & Topic Subscription Management”
  • What it is for: Collect GDPR-compliant newsletter and community topic subscribers with tokenized confirmation and 1-click unsubscribe.
  • How it works: POST /api/inbox/subscribe creates a plugin::inbox.subscriber in pending status; POST /api/inbox/confirm and POST /api/inbox/unsubscribe verify confirmToken / unsubscribeToken (private: true).

Inbox, Forms & Alert Banners — Strapi v5 Settings Panel

Use Case 3 — Time-Bounded Multilingual Site-Wide Alert Banners

Section titled “Use Case 3 — Time-Bounded Multilingual Site-Wide Alert Banners”
  • What it is for: Publish urgent announcements (e.g., Ramadan Hilal sighting, weather closure, live stream alert) in the website header ticker.
  • How it works: Create plugin::inbox.alert-banner records with severity (info, warning, urgent, celebration), startsAt, endsAt, and translations; fetch active banners via GET /api/inbox/alerts.

Inbox, Forms & Alert Banners — Strapi v5 Content Manager Entities