İslam Paketi (Namaz, Kıble, Hicri) (@vicacha-devs/strapi-plugin-islam)
Package:
@vicacha-devs/strapi-plugin-islam· Plugin ID:islam· Category:Community & Engagement· Version:1.1.1· Routes:24
Astronomik Namaz, Ezan ve Kamet motoru, küresel Kıble pusulası, Hilal gözlem onayı, Kur’an/Hadis/Dua merkezi ve Zekat/Nisap hesaplayıcıları.
pnpm add @vicacha-devs/strapi-plugin-islam

1. Temel Yetenekler ve Mimari Özellikler
Section titled “1. Temel Yetenekler ve Mimari Özellikler”- İçerik Türü Varlıkları ve Kullanım Senaryolarını İnceleyin (Diyagramlarla)
- Geliştirici Kılavuzu ve Admin UI Turunu İnceleyin
- Etkileşimli OpenAPI Referansını İnceleyin
2. İçerik Türü Varlıkları, Konumları ve Şemaları (strapi.documents)
Section titled “2. İçerik Türü Varlıkları, Konumları ve Şemaları (strapi.documents)”Registers two Collection Types (plugin::islam.hilal-announcement and plugin::islam.scripture-entry) paired with pure astronomical calculation engines (prayerEngine, qiblaEngine, hijriEngine, zakatEngine, inheritanceEngine).
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::islam.hilal-announcement&/admin/content-manager/collection-types/plugin::islam.scripture-entry(visible: true) - Content-Type Builder:
/admin/plugins/content-type-builderunder Collection Types (Islam Hilal Moon-Sighting Announcement&Islam Scripture & Dua Entry) - Plugin Workspace & Settings:
/admin/plugins/islam(Salah & Iqamah, Hilal Sighting, Scripture Hub, Zakat & Mirath) and/admin/settings/islam - Database Tables:
islam_hilal_announcementsandislam_scripture_entries
plugin::islam.hilal-announcement — Islam Hilal Moon-Sighting Announcement
Section titled “plugin::islam.hilal-announcement — Islam Hilal Moon-Sighting Announcement”Official Mosque Hilal Moon-Sighting confirmations for Ramadan, Eid al-Fitr, and Dhu al-Hijjah
Kind:
collectionType· DB Table:islam_hilal_announcements· Admin Location:/admin/content-manager/collection-types/plugin::islam.hilal-announcement· Draft & Publish:No· i18n:No
| Alan (Attribute) | Strapi Türü | Zorunlu | Kısıtlamalar / İlişki |
|---|---|---|---|
occasion |
enumeration |
Yes | enum: ramadan, eid_al_fitr, dhul_hijjah_eid_al_adha, monthly_hilal; default: "ramadan" |
hijriYear |
integer |
Yes | — |
hijriMonth |
integer |
Yes | — |
confirmedGregorianDate |
string |
Yes | — |
shiftingApplied |
string |
No | default: "0" |
approvedByImam |
string |
No | — |
notes |
json |
No | — |
broadcastDispatched |
boolean |
No | default: false |
plugin::islam.scripture-entry — Islam Scripture & Dua Entry
Section titled “plugin::islam.scripture-entry — Islam Scripture & Dua Entry”Custom curated Quranic Ayah, Prophetic Hadith, or Hisnul Muslim Dua/Adhkar entry
Kind:
collectionType· DB Table:islam_scripture_entries· Admin Location:/admin/content-manager/collection-types/plugin::islam.scripture-entry· Draft & Publish:No· i18n:No
| Alan (Attribute) | Strapi Türü | Zorunlu | Kısıtlamalar / İlişki |
|---|---|---|---|
entryKind |
enumeration |
Yes | enum: ayah, hadith, dua; default: "dua" |
slug |
string |
Yes | — |
referenceKey |
string |
Yes | — |
arabicText |
text |
Yes | — |
transliteration |
text |
No | — |
translations |
json |
Yes | — |
reflections |
json |
No | — |
gradingOrCategory |
string |
No | — |
recommendedRepetitions |
integer |
No | default: 1 |
audioUrl |
string |
No | — |
topicTags |
json |
No | — |
active |
boolean |
No | default: true |
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:
Islam, Liturgy & Scripture
İçerik Yöneticisi Varlıkları ve Bileşenleri
Section titled “İçerik Yöneticisi Varlıkları ve Bileşenleri”plugin::islam.scripture-entry(Islam Scripture & Dua Entry —/admin/content-manager/collection-types/plugin::islam.scripture-entry)plugin::islam.hilal-announcement(Islam Hilal Moon-Sighting Announcement —/admin/content-manager/collection-types/plugin::islam.hilal-announcement)

Bu Eklenti Neden Content Manager Varlıkları Oluşturur?
Section titled “Bu Eklenti Neden Content Manager Varlıkları Oluşturur?”@vicacha-devs/strapi-plugin-islam pairs its astronomical calculation engines (Salah, Qibla, Hijri, Zakat, Mirath) with two visible Content Manager collection types—Islam Scripture & Dua Entry (plugin::islam.scripture-entry) and Islam Hilal Moon-Sighting Announcement (plugin::islam.hilal-announcement)—so scholars and editors can curate verified religious texts and moon-sighting records with full editorial governance:
- Verified Arabic Scripture, Transliteration & Multilingual Translations: Curate Quran
ayah,hadith, andduarecords inplugin::islam.scripture-entrywith vocalizedarabicText,transliteration,translations(es,en,ar,tr),reference(Quran 2:255,Sahih al-Bukhari 1), and audio recitation URLs. - Historical Hilal Moon-Sighting Ledger: Maintain an auditable archive of official Ramadan, Shawwal (Eid al-Fitr), and Dhu al-Hijjah crescent confirmations in
plugin::islam.hilal-announcement(hijriYear,hijriMonth,dayOffset,gregorianStartDate,authority). - Scholar Review with Editorial Notes: Scholars can review Arabic diacritics and translations directly inside Content Manager and leave verification notes via
@vicacha-devs/strapi-plugin-notes.
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, expand Content Manager -> Collection Types -> Islam, Liturgy & Scripture and select Islam Scripture & Dua Entry (
/admin/content-manager/collection-types/plugin::islam.scripture-entry?plugins[i18n][locale]=en) or Islam Hilal Moon-Sighting Announcement (/admin/content-manager/collection-types/plugin::islam.hilal-announcement). - Curate Quran, Hadith & Dua Entries: Click + Create new entry in Islam Scripture & Dua Entry, choose
entryKind(ayah,hadith,dua), enterarabicText,transliteration,reference,category, and localizedtranslations, and togglefeaturedDaily. - Inspect or Edit Hilal Announcements: Open Islam Hilal Moon-Sighting Announcement to review or update official moon-sighting declarations and their lunar
dayOffset(-2to+2). - Workspace vs. Content Manager: Use Content Manager for bulk scripture curation, citation filtering, and scholar review; use the Islam Suite Workspace (
/admin/plugins/islam) for live astronomical Salah/Iqamah timetables, 1-click Hilal confirmation + Inbox alert bridging, and Zakat/Mirath calculators.
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 — Curating the Daily Ayah, Hadith & Hisnul Muslim Supplication Library
Section titled “Content Manager Use Case 1 — Curating the Daily Ayah, Hadith & Hisnul Muslim Supplication Library”- Amacı ve Neden Kullanıldığı: Manage verified Arabic scripture entries (
Ayat al-Kursi,Sahih al-Bukhari 1, mosque etiquette duas) with English, Spanish, and Turkish translations in Content Manager. - Content Manager İçinde Uygulama Adımları: Open
/admin/content-manager/collection-types/plugin::islam.scripture-entry?plugins[i18n][locale]=en, filter byentryKind = duaorfeaturedDaily = true, and edit the entry.
Content Manager Use Case 2 — Auditing Historical Hilal Moon-Sighting Confirmations
Section titled “Content Manager Use Case 2 — Auditing Historical Hilal Moon-Sighting Confirmations”- Amacı ve Neden Kullanıldığı: Maintain the institutional archive of Ramadan and Eid moon-sighting resolutions across Hijri years (
1446 AH,1447 AH). - Content Manager İçinde Uygulama Adımları: Open
/admin/content-manager/collection-types/plugin::islam.hilal-announcementto inspecthijriYear,hijriMonthName,dayOffset, andauthority.
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 — Daily & Monthly Astronomical Salah, Adhan & Iqamah Timetables
Section titled “Use Case 1 — Daily & Monthly Astronomical Salah, Adhan & Iqamah Timetables”- What it is for: Serve accurate Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, and Jumu’ah Iqamah schedules with high-latitude and Ramadan Imsak/Iftar rules.
- How it works: Configure coordinates,
calculationMethod(MWL,UmmAlQura,ISNA, etc.), and Iqamah offsets in/admin/settings/islam; queryGET /api/islam/prayers/todayorGET /api/islam/prayers/monthly.

Use Case 2 — Official Hilal Moon-Sighting Confirmation & Cross-Plugin Sync
Section titled “Use Case 2 — Official Hilal Moon-Sighting Confirmation & Cross-Plugin Sync”- What it is for: Record official local/regional crescent moon sightings for Ramadan, Eid al-Fitr, and Dhu al-Hijjah and immediately adjust Hijri dates across the platform.
- How it works:
POST /islam/hilal/confirmcreates aplugin::islam.hilal-announcementrecord, updates the Umm al-Qurashiftingoffset (-2to+2), and optionally publishes aplugin::inbox.alert-banner.

Use Case 3 — Curated Multilingual Quran Ayah, Hadith & Hisnul Muslim Dua Hub
Section titled “Use Case 3 — Curated Multilingual Quran Ayah, Hadith & Hisnul Muslim Dua Hub”- What it is for: Manage verified Arabic scripture entries (
entryKind: 'ayah' | 'hadith' | 'dua') with transliteration, translations (es,en,ar,tr), audio recitations (defaulting toMishari Rashid al-\Afasy, ID7`), and daily rotation. - How it works: Store records in
plugin::islam.scripture-entryand serve them viaGET /api/islam/scripture/daily,GET /api/islam/scripture/duas, andGET /api/islam/quran/resources.

Use Case 4 — Qibla Great-Circle Compass, Zakat Nisab & Faraid Inheritance Calculators
Section titled “Use Case 4 — Qibla Great-Circle Compass, Zakat Nisab & Faraid Inheritance Calculators”- What it is for: Provide interactive liturgical and Fiqh utilities via stateless REST endpoints.
- How it works: Call
GET /api/islam/qibla?lat=...&lng=...,POST /api/islam/zakat/calculate, andPOST /api/islam/inheritance/calculate.
4. REST API Uç Noktaları (content-api ve admin)
Section titled “4. REST API Uç Noktaları (content-api ve admin)”| Metot | Uç Nokta Yolu | Kapsam | Denetleyici (Handler) | Kimlik Doğrulama |
|---|---|---|---|---|
GET |
/islam/overview |
admin |
admin.getOverview |
Bearer JWT |
GET |
/islam/settings |
admin |
admin.getSettings |
Bearer JWT |
PUT |
/islam/settings |
admin |
admin.updateSettings |
Bearer JWT |
POST |
/islam/hilal/confirm |
admin |
admin.confirmHilal |
Bearer JWT |
POST |
/islam/scripture/pins |
admin |
admin.updateDailyPins |
Bearer JWT |
GET |
/api/islam/prayer-times |
content-api |
content-api.getPrayerTimes |
Bearer JWT |
GET |
/api/islam/prayer-times/monthly |
content-api |
content-api.getMonthlyPrayerTimes |
Bearer JWT |
GET |
/api/islam/prayer-times/calendar.ics |
content-api |
content-api.getPrayerCalendarIcs |
Bearer JWT |
GET |
/api/islam/qibla |
content-api |
content-api.getQibla |
Bearer JWT |
GET |
/api/islam/hijri |
content-api |
content-api.getHijriAndObservances |
Bearer JWT |