Saltearse al contenido

Eventos, RSVP y Check-In — Guía de Desarrollo y Admin UI

Ventana de terminal
pnpm add @vicacha-devs/strapi-plugin-calendar @vicacha-devs/strapi-plugin-events

2. Configuración del Servidor (config/plugins.ts)

Sección titulada «2. Configuración del Servidor (config/plugins.ts)»

Agregue la configuración del plugin en el archivo config/plugins.ts de su aplicación Strapi v5:

config/plugins.ts
export default ({ env }: { env: (key: string, defaultValue?: string) => string }) => ({
"events": {
enabled: true,
config: {
defaultTimezone: env("CALENDAR_DEFAULT_TIMEZONE", "UTC"),
defaultCapacity: 100,
waitlistEnabledByDefault: true,
},
},
});

Eventos, RSVP y Check-In — Strapi v5 Settings Panel

3. Recorrido por la Interfaz de Administración (Strapi v5 Admin UI)

Sección titulada «3. Recorrido por la Interfaz de Administración (Strapi v5 Admin UI)»

Una vez habilitado, el plugin registra su espacio de trabajo y ajustes dentro del panel de administración de Strapi v5 utilizando Strapi Design System v2:

Eventos, RSVP y Check-In — Strapi v5 Admin UI

Etiquetas Localizadas de la Interfaz (Español)

Sección titulada «Etiquetas Localizadas de la Interfaz (Español)»
Clave de Traducción Texto en Interfaz
sidePanel.title Resumen de Evento y RSVP
sidePanel.secondaryCalendars Fechas en calendarios alternativos
sidePanel.rsvpStatus RSVP y Capacidad
sidePanel.full Lleno / Lista de espera
sidePanel.open Abierto
sidePanel.confirmedSeats Cupos confirmados
sidePanel.checkedIn Check-In realizados
sidePanel.waitlisted En lista de espera

4. Entidades Content-Type, Ubicación y Esquemas (strapi.documents)

Sección titulada «4. Entidades Content-Type, Ubicación y Esquemas (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.

Dónde Encontrar las Entidades Content-Type en Strapi v5

Sección titulada «Dónde Encontrar las Entidades Content-Type en 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-builder under Collection Types (Event & Event Registration (RSVP)) + Custom Field plugin::events.rrule
  • Plugin Workspace & Settings: /admin/plugins/events (Events Manager, RSVP Roster, Waitlist, Check-In) and /admin/settings/events
  • Database Tables: plugin_events_items and plugin_events_registrations

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

Atributo Tipo en Strapi Requerido Restricciones / Relación
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)

Sección titulada «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

Atributo Tipo en Strapi Requerido Restricciones / Relación
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 —

Integración con el Content Manager de Strapi v5 (/admin/content-manager)

Sección titulada «Integración con el Content Manager de Strapi v5 (/admin/content-manager)»

Grupo en la Barra Lateral del Content Manager: Events, Scheduling & Bookings

Entidades y Componentes en el Content Manager

Sección titulada «Entidades y Componentes en el Content Manager»
  • 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

Eventos, RSVP y Check-In — Vista de Entidades en el Content Manager de Strapi v5

Por Qué Este Plugin Crea e Integra Entidades en el Content Manager

Sección titulada «Por Qué Este Plugin Crea e Integra Entidades en el 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, Event records support rich-text descriptions, poster images, speaker relations (e.g., linking Staff, Scholar & Author api::leader.leader), virtual meeting URLs, and plugin::events.rrule recurrence rules.
  • Multilingual (i18n) Event Publishing: Author event pages across en, es, ar, and tr (?plugins[i18n][locale]=en) with independent draft/publish control per locale.
  • Injected Right-Sidebar Widgets: Opening an Event in Content Manager displays both the Calendar & Schedule widget (Hijri date + .ics export) 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.

Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)

Sección titulada «Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)»
  1. 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).
  2. Author & Localize Events: Click + Create new entry in Event, fill in title, slug, summary, description, startDate, endDate, rrule, capacity, and waitlistEnabled, then click Publish.
  3. Inspect RSVP Registrations: Open Event Registration (RSVP) in Content Manager to filter attendees by status, occurrenceDate, attendeeEmail, or linked event.
  4. 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.

Sincronización entre el Content Manager y el Espacio del Plugin

Sección titulada «Sincronización entre el Content Manager y el Espacio del Plugin»

Casos de Uso en el Content Manager y Flujos Editoriales

Sección titulada «Casos de Uso en el Content Manager y Flujos Editoriales»

Content Manager Use Case 1 — Authoring Multilingual Recurring Classes & Community Dinners

Sección titulada «Content Manager Use Case 1 — Authoring Multilingual Recurring Classes & Community Dinners»
  • Para qué sirve y por qué usarlo: 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.
  • Cómo ejecutarlo en el Content Manager: Open /admin/content-manager/collection-types/plugin::events.event?plugins[i18n][locale]=en, edit the event attributes and rrule recurrence, 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

Sección titulada «Content Manager Use Case 2 — Filtering Waitlisted or Checked-In Attendees Across Occurrences»
  • Para qué sirve y por qué usarlo: Search attendee registrations by email, occurrence date, or dietary/accessibility notes inside Content Manager.
  • Cómo ejecutarlo en el Content Manager: Open /admin/content-manager/collection-types/plugin::events.registration and filter by status = waitlisted or status = checked_in.

Use Case 1 — Multilingual Recurring Events with Poster & Speaker Metadata

Sección titulada «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 (using plugin::events.rrule for recurrence) and query expanded occurrences via GET /api/events/upcoming or GET /api/events/calendar.

Events, RSVP & Check-In — Strapi v5 Admin Workspace

Use Case 2 — Capacity-Controlled Public RSVP & Automatic Waitlist Promotion

Sección titulada «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 (creating plugin::events.registration as confirmed or waitlisted); POST /api/events/rsvp/cancel cancels a seat and promotes the oldest waitlisted record.

Events, RSVP & Check-In — Strapi v5 Settings Panel

Use Case 3 — 1-Click Door Check-In & Formula-Injection-Safe CSV Roster Export

Sección titulada «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-in in /admin/plugins/events and download rosters via GET /events/registrations/export.csv.

Events, RSVP & Check-In — Strapi v5 Content Manager Entities

Método Ruta del Endpoint Ámbito Controlador Autenticación
GET /events/settings admin admin.getSettings Bearer JWT
PUT /events/settings admin admin.updateSettings Bearer JWT
GET /events/calendar admin admin.getCalendar Bearer JWT
POST /events/calendar/reschedule admin admin.reschedule Bearer JWT
POST /events/calendar/quick-create admin admin.quickCreate Bearer JWT
GET /events/stats/{documentId} admin admin.getEventStats Bearer JWT
GET /events/registrations admin admin.listRegistrations Bearer JWT
GET /events/registrations/export.csv admin admin.exportRegistrationsCsv Bearer JWT
POST /events/registrations/{documentId}/status admin admin.updateRegistrationStatus Bearer JWT
POST /events/registrations/{documentId}/check-in admin admin.checkIn Bearer JWT
GET /api/events/occurrences content-api content-api.listOccurrences Bearer JWT
GET /api/events/spotlights content-api content-api.listSpotlights Bearer JWT
GET /api/events/feed.ics content-api content-api.downloadFeedIcs Bearer JWT
GET /api/events/{documentId}/invite.ics content-api content-api.downloadEventInviteIcs Bearer JWT
GET /api/events/{documentId}/stats content-api content-api.getEventStats Bearer JWT
POST /api/events/{documentId}/register content-api content-api.registerAttendee Bearer JWT
POST /api/events/registrations/{token}/cancel content-api content-api.cancelRegistration Bearer JWT

7. Uso Programático en el Servidor (strapi.plugin y strapi.documents)

Sección titulada «7. Uso Programático en el Servidor (strapi.plugin y strapi.documents)»
// Registered services on plugin "events": "settings", "occurrence", "rsvp", "ical"
const pluginService = strapi.plugin("events")?.service("occurrence");
// Querying records via the Strapi v5 Document Service API
const records = await strapi.documents("plugin::events.event").findMany({
limit: 25,
sort: "createdAt:desc",
});
  • Cambios no visibles en el panel Admin: Ejecute pnpm strapi build después de editar config/plugins.ts.
  • Aislamiento de dependencias peer: Mantenga hoistPattern: ["*", "!@strapi/*"] en pnpm-workspace.yaml para evitar colisiones de contexto en React.
  • Verificación estricta de TypeScript: Ejecute pnpm check para validar admin/tsconfig.json y server/tsconfig.json.