İçeriğe geç

İslam Paketi (Namaz, Kıble, Hicri) — İçerik Türleri ve Kullanım Senaryoları

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

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

Section titled “1. İç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-builder under 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_announcements and islam_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)

İslam Paketi (Namaz, Kıble, Hicri) — 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?”

@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, and dua records in plugin::islam.scripture-entry with vocalized arabicText, 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)”
  1. 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).
  2. Curate Quran, Hadith & Dua Entries: Click + Create new entry in Islam Scripture & Dua Entry, choose entryKind (ayah, hadith, dua), enter arabicText, transliteration, reference, category, and localized translations, and toggle featuredDaily.
  3. Inspect or Edit Hilal Announcements: Open Islam Hilal Moon-Sighting Announcement to review or update official moon-sighting declarations and their lunar dayOffset (-2 to +2).
  4. 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 by entryKind = dua or featuredDaily = 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-announcement to inspect hijriYear, hijriMonthName, dayOffset, and authority.

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; query GET /api/islam/prayers/today or GET /api/islam/prayers/monthly.

Islam Suite (Salah, Qibla, Hijri) — Strapi v5 Admin Workspace

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/confirm creates a plugin::islam.hilal-announcement record, updates the Umm al-Qura shifting offset (-2 to +2), and optionally publishes a plugin::inbox.alert-banner.

Islam Suite (Salah, Qibla, Hijri) — Strapi v5 Settings Panel

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 to Mishari Rashid al-\Afasy, ID 7`), and daily rotation.
  • How it works: Store records in plugin::islam.scripture-entry and serve them via GET /api/islam/scripture/daily, GET /api/islam/scripture/duas, and GET /api/islam/quran/resources.

Islam Suite (Salah, Qibla, Hijri) — Strapi v5 Content Manager Entities

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, and POST /api/islam/inheritance/calculate.