Etkinlikler, LCV ve Giriş — Geliştirici Kılavuzu ve Yönetim Arayüzü
1. Kurulum ve Bağımlılıklar
Section titled “1. Kurulum ve Bağımlılıklar”pnpm add @vicacha-devs/strapi-plugin-calendar @vicacha-devs/strapi-plugin-events2. Sunucu Yapılandırması (config/plugins.ts)
Section titled “2. Sunucu Yapılandırması (config/plugins.ts)”Strapi v5 projenizin config/plugins.ts dosyasına eklenti yapılandırmasını ekleyin:
export default ({ env }: { env: (key: string, defaultValue?: string) => string }) => ({ "events": { enabled: true, config: { defaultTimezone: env("CALENDAR_DEFAULT_TIMEZONE", "UTC"), defaultCapacity: 100, waitlistEnabledByDefault: true, }, },});
3. Strapi v5 Yönetim Arayüzü (Admin UI) Turu
Section titled “3. Strapi v5 Yönetim Arayüzü (Admin UI) Turu”Etkinleştirildiğinde eklenti, Strapi Design System v2 bileşenlerini kullanarak çalışma alanını ve ayarlarını yönetim paneline kaydeder:

Yerelleştirilmiş Arayüz Etiketleri (Türkçe)
Section titled “Yerelleştirilmiş Arayüz Etiketleri (Türkçe)”| Çeviri Anahtarı | Arayüz Metni |
|---|---|
sidePanel.title |
Etkinlik ve RSVP Özeti |
sidePanel.secondaryCalendars |
Alternatif Takvim Tarihleri |
sidePanel.rsvpStatus |
RSVP ve Kontenjan |
sidePanel.full |
Dolu / Yedek Liste |
sidePanel.open |
Açık |
sidePanel.confirmedSeats |
Onaylanan Koltuk |
sidePanel.checkedIn |
Giriş Yapanlar |
sidePanel.waitlisted |
Yedek Listede |
4. İçerik Türü Varlıkları, Konumları ve Şemaları (strapi.documents)
Section titled “4. İçerik Türü Varlıkları, Konumları ve Şemaları (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 İçinde İçerik Türü Varlıkları Nerede Bulunur?
Section titled “Strapi v5 İçinde İçerik Türü Varlıkları Nerede Bulunur?”- 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
| Alan (Attribute) | Strapi Türü | Zorunlu | Kısıtlamalar / İlişki |
|---|---|---|---|
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
| Alan (Attribute) | Strapi Türü | Zorunlu | Kısıtlamalar / İlişki |
|---|---|---|---|
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 İç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”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

Bu Eklenti Neden Content Manager Varlıkları Oluşturur?
Section titled “Bu Eklenti Neden Content Manager Varlıkları Oluşturur?”@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 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)”- 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.
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 Multilingual Recurring Classes & Community Dinners
Section titled “Content Manager Use Case 1 — Authoring Multilingual Recurring Classes & Community Dinners”- Amacı ve Neden Kullanıldığı: 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. - Content Manager İçinde Uygulama Adımları: 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”- Amacı ve Neden Kullanıldığı: Search attendee registrations by email, occurrence date, or dietary/accessibility notes inside Content Manager.
- Content Manager İçinde Uygulama Adımları: Open
/admin/content-manager/collection-types/plugin::events.registrationand filter bystatus = waitlistedorstatus = checked_in.
5. Uçtan Uca Kullanım Senaryoları ve İş Akışları
Section titled “5. Uçtan Uca Kullanım Senaryoları ve İş Akışları”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.

6. REST API Uç Noktaları (content-api ve admin)
Section titled “6. REST API Uç Noktaları (content-api ve admin)”| Metot | Uç Nokta Yolu | Kapsam | Denetleyici (Handler) | Kimlik Doğrulama |
|---|---|---|---|---|
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. Sunucu Tarafı Programatik Kullanım (strapi.plugin ve strapi.documents)
Section titled “7. Sunucu Tarafı Programatik Kullanım (strapi.plugin ve 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 APIconst records = await strapi.documents("plugin::events.event").findMany({ limit: 25, sort: "createdAt:desc",});8. Sorun Giderme ve Doğrulama
Section titled “8. Sorun Giderme ve Doğrulama”- Yönetim paneli değişiklikleri görünmüyor:
config/plugins.tsdosyasını güncelledikten sonrapnpm strapi buildkomutunu çalıştırın. - Strapi bağımlılık izolasyonu: React bağlam çakışmalarını önlemek için
pnpm-workspace.yamliçindehoistPattern: ["*", "!@strapi/*"]ayarını koruyun. - Sıkı TypeScript kontrolü: Hem
adminhem deserverpaketlerini doğrulamak içinpnpm checkkomutunu çalıştırın.