الفعاليات والتسجيل والحضور — كيانات المحتوى وحالات الاستخدام
Package:
@vicacha-devs/strapi-plugin-events· Plugin ID:events· Admin Workspace:/admin/plugins/events
1. كيانات أنواع المحتوى ومواقعها ومخططاتها (strapi.documents)
Section titled “1. كيانات أنواع المحتوى ومواقعها ومخططاتها (strapi.documents)”Registers two Collection Types (plugin::events.event with draftAndPublish: true & i18n.localized: true, and plugin::events.registration) plus the plugin::events.rrule Custom Field. Also supports binding additional custom api::* event collections via sources[] and extending schemas via schemaExtensions in config/plugins.ts.
أين تجد كيانات أنواع المحتوى في Strapi v5
Section titled “أين تجد كيانات أنواع المحتوى في Strapi v5”- Content Manager:
/admin/content-manager/collection-types/plugin::events.event&/admin/content-manager/collection-types/plugin::events.registration(visible: true) - Content-Type Builder:
/admin/plugins/content-type-builderunder Collection Types (Event&Event Registration (RSVP)) + Custom Fieldplugin::events.rrule - Plugin Workspace & Settings:
/admin/plugins/events(Events Manager, RSVP Roster, Waitlist, Check-In) and/admin/settings/events - Database Tables:
plugin_events_itemsandplugin_events_registrations
plugin::events.event — Event
Section titled “plugin::events.event — Event”Recurring & single events managed by strapi-plugin-events
Kind:
collectionType· DB Table:plugin_events_items· Admin Location:/admin/content-manager/collection-types/plugin::events.event· Draft & Publish:Yes· i18n:Yes
| الحقل | النوع في Strapi | إلزامي | القيود / العلاقات |
|---|---|---|---|
title |
string |
Yes | max: 200 |
slug |
uid |
Yes | — |
summary |
text |
No | max: 500 |
description |
richtext |
No | — |
startDate |
datetime |
Yes | — |
endDate |
datetime |
No | — |
allDay |
boolean |
No | default: false |
timezone |
string |
No | default: "UTC" |
recurrence |
customField |
No | customField: plugin::events.rrule |
eventStatus |
enumeration |
Yes | enum: scheduled, cancelled, postponed, rescheduled; default: "scheduled" |
locationType |
enumeration |
No | enum: in_person, online, hybrid; default: "in_person" |
location |
string |
No | — |
virtualUrl |
string |
No | — |
category |
string |
No | default: "general" |
speaker |
string |
No | — |
speakerSlug |
string |
No | — |
color |
string |
No | default: "#0D9488" |
featured |
boolean |
No | default: false |
rsvpEnabled |
boolean |
No | default: false |
capacity |
integer |
No | — |
waitlistEnabled |
boolean |
No | default: true |
maxGuestsPerRegistration |
integer |
No | default: 5 |
registrationDeadline |
datetime |
No | — |
alternateDates |
json |
No | — |
poster |
media |
No | — |
actionLinks |
json |
No | — |
spotlightConfig |
json |
No | — |
metadata |
json |
No | — |
plugin::events.registration — Event Registration (RSVP)
Section titled “plugin::events.registration — Event Registration (RSVP)”Attendee RSVPs, waitlists, and check-ins managed by strapi-plugin-events
Kind:
collectionType· DB Table:plugin_events_registrations· Admin Location:/admin/content-manager/collection-types/plugin::events.registration· Draft & Publish:No· i18n:No
| الحقل | النوع في Strapi | إلزامي | القيود / العلاقات |
|---|---|---|---|
eventUid |
string |
Yes | default: "plugin::events.event" |
eventDocumentId |
string |
Yes | — |
eventTitle |
string |
No | — |
occurrenceDate |
string |
Yes | — |
attendeeName |
string |
Yes | max: 160 |
attendeeEmail |
email |
Yes | — |
attendeePhone |
string |
No | max: 50 |
guestsCount |
integer |
Yes | default: 1 |
status |
enumeration |
Yes | enum: confirmed, waitlisted, cancelled, checked_in; default: "confirmed" |
checkInToken |
string |
No | private: true |
checkedInAt |
datetime |
No | — |
locale |
string |
No | default: "es" |
notes |
text |
No | max: 2000 |
metadata |
json |
No | — |
التكامل مع مدير المحتوى في Strapi v5 (/admin/content-manager)
Section titled “التكامل مع مدير المحتوى في Strapi v5 (/admin/content-manager)”مجموعة الشريط الجانبي في مدير المحتوى:
Events, Scheduling & Bookings
الكيانات والمكونات المسجلة في مدير المحتوى
Section titled “الكيانات والمكونات المسجلة في مدير المحتوى”plugin::events.event(Event —/admin/content-manager/collection-types/plugin::events.event)plugin::events.registration(Event Registration (RSVP) —/admin/content-manager/collection-types/plugin::events.registration)- Custom Field
plugin::events.rrule

لماذا تنشئ هذه الإضافة كيانات داخل مدير المحتوى (Content Manager)؟
Section titled “لماذا تنشئ هذه الإضافة كيانات داخل مدير المحتوى (Content Manager)؟”@vicacha-devs/strapi-plugin-events registers Event (plugin::events.event, with i18n.localized: true and draftAndPublish: true) and Event Registration (RSVP) (plugin::events.registration) as primary Content Manager collection types so editorial teams can author rich multilingual event pages while operations staff manage RSVPs and check-ins:
- Rich Editorial & Speaker Relations: In Content Manager,
Eventrecords support rich-text descriptions, poster images, speaker relations (e.g., linkingStaff, Scholar & Authorapi::leader.leader), virtual meeting URLs, andplugin::events.rrulerecurrence rules. - Multilingual (
i18n) Event Publishing: Author event pages acrossen,es,ar, andtr(?plugins[i18n][locale]=en) with independent draft/publish control per locale. - Injected Right-Sidebar Widgets: Opening an
Eventin Content Manager displays both the Calendar & Schedule widget (Hijri date +.icsexport) and the Event & RSVP Summary panel alongside Editorial Notes. - Direct RSVP Roster Inspection: Inspect, filter, and search individual
Event Registration (RSVP)records (confirmed,waitlisted,checked_in,cancelled) directly in Content Manager.
كيفية الاستخدام داخل مدير المحتوى في Strapi (خطوة بخطوة)
Section titled “كيفية الاستخدام داخل مدير المحتوى في Strapi (خطوة بخطوة)”- Open in Content Manager: In the left sidebar, click Content Manager -> Collection Types -> Events, Scheduling & Bookings and select Event (
/admin/content-manager/collection-types/plugin::events.event?plugins[i18n][locale]=en) or Event Registration (RSVP) (/admin/content-manager/collection-types/plugin::events.registration). - Author & Localize Events: Click + Create new entry in Event, fill in
title,slug,summary,description,startDate,endDate,rrule,capacity, andwaitlistEnabled, then click Publish. - Inspect RSVP Registrations: Open Event Registration (RSVP) in Content Manager to filter attendees by
status,occurrenceDate,attendeeEmail, or linkedevent. - Workspace vs. Content Manager: Use Content Manager for rich multilingual event authoring, poster uploads, and speaker relations; use the Events Workspace (
/admin/plugins/events) for 1-click door check-in, waitlist promotion, and formula-sanitized CSV exports.
التزامن بين مدير المحتوى ومساحة عمل الإضافة
Section titled “التزامن بين مدير المحتوى ومساحة عمل الإضافة”حالات الاستخدام داخل مدير المحتوى ومسارات العمل التحريرية
Section titled “حالات الاستخدام داخل مدير المحتوى ومسارات العمل التحريرية”Content Manager Use Case 1 — Authoring Multilingual Recurring Classes & Community Dinners
Section titled “Content Manager Use Case 1 — Authoring Multilingual Recurring Classes & Community Dinners”- الغرض والأهمية: Create and translate recurring educational classes (
Classical Arabic Course), youth circles (Weekly Youth Circle), and scholarship announcements (Türkiye Bursları Scholarship Orientation) in Content Manager. - خطوات التنفيذ في مدير المحتوى: Open
/admin/content-manager/collection-types/plugin::events.event?plugins[i18n][locale]=en, edit the event attributes andrrulerecurrence, verify the Hijri date in the right sidebar, and publish across locales.
Content Manager Use Case 2 — Filtering Waitlisted or Checked-In Attendees Across Occurrences
Section titled “Content Manager Use Case 2 — Filtering Waitlisted or Checked-In Attendees Across Occurrences”- الغرض والأهمية: Search attendee registrations by email, occurrence date, or dietary/accessibility notes inside Content Manager.
- خطوات التنفيذ في مدير المحتوى: Open
/admin/content-manager/collection-types/plugin::events.registrationand filter bystatus = waitlistedorstatus = checked_in.
3. حالات الاستخدام ومسارات العمل المتكاملة
Section titled “3. حالات الاستخدام ومسارات العمل المتكاملة”Use Case 1 — Multilingual Recurring Events with Poster & Speaker Metadata
Section titled “Use Case 1 — Multilingual Recurring Events with Poster & Speaker Metadata”- What it is for: Publish localized single or recurring lectures, workshops, and community gatherings with speaker profiles and virtual/hybrid links.
- How it works: Author records in
plugin::events.event(usingplugin::events.rrulefor recurrence) and query expanded occurrences viaGET /api/events/upcomingorGET /api/events/calendar.

Use Case 2 — Capacity-Controlled Public RSVP & Automatic Waitlist Promotion
Section titled “Use Case 2 — Capacity-Controlled Public RSVP & Automatic Waitlist Promotion”- What it is for: Enforce seat limits (
capacity,maxGuestsPerRegistration) per occurrence date and automatically promote waitlisted guests when someone cancels. - How it works: Visitors submit
POST /api/events/rsvp(creatingplugin::events.registrationasconfirmedorwaitlisted);POST /api/events/rsvp/cancelcancels a seat and promotes the oldest waitlisted record.

Use Case 3 — 1-Click Door Check-In & Formula-Injection-Safe CSV Roster Export
Section titled “Use Case 3 — 1-Click Door Check-In & Formula-Injection-Safe CSV Roster Export”- What it is for: Check in attendees at the venue entrance and export clean attendee rosters for spreadsheets.
- How it works: Use
POST /events/registrations/{documentId}/check-inin/admin/plugins/eventsand download rosters viaGET /events/registrations/export.csv.
