İçeriğe geç

Takvim ve Planlama — İçerik Türleri ve Kullanım Senaryoları

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

1. İçerik Türü Varlıkları, Konumları ve Şemaları (strapi.documents)

Section titled “1. İçerik Türü Varlıkları, Konumları ve Şemaları (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.

Strapi v5 İçinde İçerik Türü Varlıkları Nerede Bulunur?

Section titled “Strapi v5 İçinde İçerik Türü Varlıkları Nerede Bulunur?”
  • 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)

Bu eklenti, doğrudan mevcut Strapi içerik türü varlıkları (api::* ve plugin::*) üzerinde çalışır.

Strapi v5 İçerik Yöneticisi (Content Manager) Entegrasyonu (/admin/content-manager)

Section titled “Strapi v5 İçerik Yöneticisi (Content Manager) Entegrasyonu (/admin/content-manager)”

İçerik Yöneticisi Kenar Çubuğu Grubu: Events, Scheduling & Bookings

İçerik Yöneticisi Varlıkları ve Bileşenleri

Section titled “İçerik Yöneticisi Varlıkları ve Bileşenleri”
  • 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)

Takvim ve Planlama — Strapi v5 Content Manager Varlık ve Düzenleme Görünümü

Bu Eklenti Neden Content Manager Varlıkları Oluşturur?

Section titled “Bu Eklenti Neden Content Manager Varlıkları Oluşturur?”

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.

Strapi Content Manager İçinde Nasıl Kullanılır? (Adım Adım)

Section titled “Strapi Content Manager İçinde Nasıl Kullanılır? (Adım Adım)”
  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 ve Eklenti Çalışma Alanı Senkronizasyonu

Section titled “Content Manager ve Eklenti Çalışma Alanı Senkronizasyonu”

Content Manager Kullanım Senaryoları ve Editöryal İş Akışları

Section titled “Content Manager Kullanım Senaryoları ve Editöryal İş Akışları”

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”
  • Amacı ve Neden Kullanıldığı: 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.
  • Content Manager İçinde Uygulama Adımları: 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.

3. Uçtan Uca Kullanım Senaryoları ve İş Akışları

Section titled “3. Uçtan Uca Kullanım Senaryoları ve İş Akışları”

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).