Skip to content

Calendar & Scheduling — Content Types & Use Cases

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

1. Content-Type Entities, Locations & Schemas (strapi.documents)

Section titled “1. Content-Type Entities, Locations & Schemas (strapi.documents)”

Acts as a multi-collection scheduler engine that binds to any Strapi Content-Type entity (api::* or plugin::*) configured in collections[] or registered dynamically via calendar.service('registry').registerSource(). Also registers the plugin::calendar.rrule Custom Field (json) for RFC 5545 RRULE + RFC 7529 RSCALE recurrence rules.

Where to Find Content-Type Entities in Strapi v5

Section titled “Where to Find Content-Type Entities in Strapi v5”
  • Bound Content-Type Entities: Any Content Manager collection mapped in /admin/settings/calendar (e.g., plugin::events.event, plugin::bookings.booking, api::article.article)
  • Custom Field in Content-Type Builder: Add the plugin::calendar.rrule custom field to any collection type in /admin/plugins/content-type-builder
  • Plugin Workspace & Settings: /admin/plugins/calendar (FullCalendar v6 Month/Week/Day/Agenda workspace) and /admin/settings/calendar (General, Prayer & Islamic, Bookings & Availability tabs)

This plugin operates dynamically across existing Strapi api::* and plugin::* Content-Type entities without creating separate collection tables.

Strapi v5 Content Manager Integration (/admin/content-manager)

Section titled “Strapi v5 Content Manager Integration (/admin/content-manager)”

Content Manager Sidebar Group: Events, Scheduling & Bookings

  • Custom Field plugin::calendar.rrule (RFC 5545 RRULE + RFC 7529 RSCALE Recurrence Field inside any Content Manager edit view)
  • Bound Content Manager Collections (plugin::events.event, plugin::bookings.booking, and any configured api::* collection)

Calendar & Scheduling — Strapi v5 Content Manager Entities & Editorial View

Why This Plugin Creates & Integrates Content Manager Entities

Section titled “Why This Plugin Creates & Integrates Content Manager Entities”

Instead of locking schedules inside an isolated table, @vicacha-devs/strapi-plugin-calendar embeds directly into the Strapi v5 Content Manager edit view of any mapped collection (plugin::events.event, plugin::bookings.booking, or custom api::* entities) via its plugin::calendar.rrule Custom Field and right-sidebar Calendar & Schedule widget:

  • In-Place Secondary Calendar Preview in Content Manager: When editing an event in Content Manager, the right-sidebar Calendar & Schedule panel automatically computes and displays the corresponding Hijri (Umm al-Qura), Hebrew, or Persian date (4 Jumada I 1448 AH) plus 1-click .ics download and Open in Calendar View buttons.
  • Visual RFC 5545 RRULE + RFC 7529 RSCALE Authoring: The plugin::calendar.rrule custom field lets editors configure Gregorian or lunar recurrence rules directly inside any Content Manager form.
  • Zero Data Duplication: Dragging an event in /admin/plugins/calendar or editing start/end dates in /admin/content-manager/collection-types/plugin::events.event mutates the exact same Strapi v5 Document Service record.

How to Use in Strapi Content Manager (Step-by-Step)

Section titled “How to Use in Strapi Content Manager (Step-by-Step)”
  1. Open a Bound Collection in Content Manager: Navigate to Content Manager -> Collection Types -> Events, Scheduling & Bookings -> Event (/admin/content-manager/collection-types/plugin::events.event?plugins[i18n][locale]=en) and open any entry.
  2. Configure Start/End Dates & Recurrence: Edit startDate, endDate, allDay, timezone, and the rrule custom field directly inside the Content Manager form.
  3. Use the Right-Sidebar Calendar Panel: In the right column of the Content Manager edit view, inspect the live Alternative Calendar Dates badge, click Download .ics Invite, or click Open in Calendar View to jump to /admin/plugins/calendar.
  4. Bind Additional Content Manager Collections: In /admin/settings/calendar, map any api::* collection’s titleField, startField, endField, and rruleField to project its Content Manager entries onto the unified calendar grid.

Content Manager & Plugin Workspace Synchronization

Section titled “Content Manager & Plugin Workspace Synchronization”

Content Manager Use Cases & Editorial Workflows

Section titled “Content Manager Use Cases & Editorial Workflows”

Content Manager Use Case 1 — Authoring a Localized Recurring Course with Live Hijri Date Preview

Section titled “Content Manager Use Case 1 — Authoring a Localized Recurring Course with Live Hijri Date Preview”
  • Why & What it is for: Edit a weekly Arabic course (Classical Arabic Course) in Content Manager while verifying its Umm al-Qura Hijri date and downloading its .ics invite from the right sidebar.
  • How to use in Content Manager: Open /admin/content-manager/collection-types/plugin::events.event/{documentId}?plugins[i18n][locale]=en, set startDate and rrule, and verify the Calendar & Schedule panel on the right.

Use Case 1 — Aggregating Multiple Strapi Collections into One Calendar

Section titled “Use Case 1 — Aggregating Multiple Strapi Collections into One Calendar”
  • What it is for: Display Events, Bookings, Courses, and Editorial Deadlines from different Content-Type entities on a single color-coded FullCalendar grid.
  • How it works: Map each collection’s uid, titleField, startField, endField, and rruleField in /admin/settings/calendar or config/plugins.ts, then query GET /api/calendar/occurrences?start=...&end=....

Calendar & Scheduling — Strapi v5 Admin Workspace

Use Case 2 — Sacred & Lunar Recurrence (RRULE + RSCALE=ISLAMIC-UMALQURA)

Section titled “Use Case 2 — Sacred & Lunar Recurrence (RRULE + RSCALE=ISLAMIC-UMALQURA)”
  • What it is for: Schedule annual or monthly recurring events that follow the Hijri, Hebrew, or Persian calendar and automatically project onto Gregorian dates.
  • How it works: Attach plugin::calendar.rrule to your Content-Type entity to author RFC 7529 rules (RSCALE=ISLAMIC-UMALQURA;FREQ=YEARLY;BYMONTH=9;BYMONTHDAY=1).

Calendar & Scheduling — Strapi v5 Settings Panel

Use Case 3 — Drag-and-Drop Rescheduling & Quick-Create into Target Entities

Section titled “Use Case 3 — Drag-and-Drop Rescheduling & Quick-Create into Target Entities”
  • What it is for: Let editors drag an event on the calendar grid or click a date cell to create/update the underlying Strapi document directly.
  • How it works: Uses POST /calendar/quick-create and POST /calendar/reschedule to mutate the mapped strapi.documents(uid) record in place.

Calendar & Scheduling — Strapi v5 Content Manager Entities

Use Case 4 — Public RFC 5545 iCal (.ics) Subscription Feeds

Section titled “Use Case 4 — Public RFC 5545 iCal (.ics) Subscription Feeds”
  • What it is for: Allow users to subscribe to live calendar feeds in Google Calendar, Apple Calendar, or Outlook.
  • How it works: Subscribe to GET /api/calendar/ical.ics (all sources) or GET /api/calendar/ical/{collectionId}.ics (single source).