Saltearse al contenido

Suite Islámica (Salah, Qibla, Hijri) (@vicacha-devs/strapi-plugin-islam)

Package: @vicacha-devs/strapi-plugin-islam · Plugin ID: islam · Category: Community & Engagement · Version: 1.1.1 · Routes: 24

Motor astronómico de Salah, Adhan e Iqamah, brújula esférica de Qibla, confirmación de avistamiento de Hilal, centro de Corán/Hadiz/Dua y calculadoras de Zakat/Nisab.

Ventana de terminal
pnpm add @vicacha-devs/strapi-plugin-islam

Suite Islámica (Salah, Qibla, Hijri) — Strapi v5 Admin UI

Suite Islámica (Salah, Qibla, Hijri) — Strapi v5 Settings Panel

1. Características Principales y Arquitectura

Sección titulada «1. Características Principales y Arquitectura»

2. Entidades Content-Type, Ubicación y Esquemas (strapi.documents)

Sección titulada «2. Entidades Content-Type, Ubicación y Esquemas (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).

Dónde Encontrar las Entidades Content-Type en Strapi v5

Sección titulada «Dónde Encontrar las Entidades Content-Type en Strapi v5»
  • 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

Sección titulada «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

Atributo Tipo en Strapi Requerido Restricciones / Relación
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

Sección titulada «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

Atributo Tipo en Strapi Requerido Restricciones / Relación
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

Integración con el Content Manager de Strapi v5 (/admin/content-manager)

Sección titulada «Integración con el Content Manager de Strapi v5 (/admin/content-manager)»

Grupo en la Barra Lateral del Content Manager: Islam, Liturgy & Scripture

Entidades y Componentes en el Content Manager

Sección titulada «Entidades y Componentes en el Content Manager»
  • 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)

Suite Islámica (Salah, Qibla, Hijri) — Vista de Entidades en el Content Manager de Strapi v5

Por Qué Este Plugin Crea e Integra Entidades en el Content Manager

Sección titulada «Por Qué Este Plugin Crea e Integra Entidades en el Content Manager»

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

Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)

Sección titulada «Cómo Usarlo en el Content Manager de Strapi (Paso a Paso)»
  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.

Sincronización entre el Content Manager y el Espacio del Plugin

Sección titulada «Sincronización entre el Content Manager y el Espacio del Plugin»

Casos de Uso en el Content Manager y Flujos Editoriales

Sección titulada «Casos de Uso en el Content Manager y Flujos Editoriales»

Content Manager Use Case 1 — Curating the Daily Ayah, Hadith & Hisnul Muslim Supplication Library

Sección titulada «Content Manager Use Case 1 — Curating the Daily Ayah, Hadith & Hisnul Muslim Supplication Library»
  • Para qué sirve y por qué usarlo: Manage verified Arabic scripture entries (Ayat al-Kursi, Sahih al-Bukhari 1, mosque etiquette duas) with English, Spanish, and Turkish translations in Content Manager.
  • Cómo ejecutarlo en el Content Manager: 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

Sección titulada «Content Manager Use Case 2 — Auditing Historical Hilal Moon-Sighting Confirmations»
  • Para qué sirve y por qué usarlo: Maintain the institutional archive of Ramadan and Eid moon-sighting resolutions across Hijri years (1446 AH, 1447 AH).
  • Cómo ejecutarlo en el Content Manager: Open /admin/content-manager/collection-types/plugin::islam.hilal-announcement to inspect hijriYear, hijriMonthName, dayOffset, and authority.

Use Case 1 — Daily & Monthly Astronomical Salah, Adhan & Iqamah Timetables

Sección titulada «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

Sección titulada «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

Sección titulada «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

Sección titulada «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.
Método Ruta del Endpoint Ámbito Controlador Autenticación
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