Saltearse al contenido

Suite Islámica (Salah, Qibla, Hijri) — Guía de Desarrollo y Admin UI

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

2. Configuración del Servidor (config/plugins.ts)

Sección titulada «2. Configuración del Servidor (config/plugins.ts)»

Agregue la configuración del plugin en el archivo config/plugins.ts de su aplicación Strapi v5:

config/plugins.ts
export default ({ env }: { env: (key: string, defaultValue?: string) => string }) => ({
"islam": {
enabled: true,
config: {
defaultLat: 4.6685,
defaultLon: -74.0758,
method: "3",
quranFoundation: {
defaultScript: "uthmani",
defaultReciterId: 7, // Mishari Rashid al-`Afasy
defaultChapterReciterId: 7, // Mishari Rashid al-`Afasy
},
enableInboxAlertBridge: true,
},
},
});

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

3. Recorrido por la Interfaz de Administración (Strapi v5 Admin UI)

Sección titulada «3. Recorrido por la Interfaz de Administración (Strapi v5 Admin UI)»

Una vez habilitado, el plugin registra su espacio de trabajo y ajustes dentro del panel de administración de Strapi v5 utilizando Strapi Design System v2:

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

Etiquetas Localizadas de la Interfaz (Español)

Sección titulada «Etiquetas Localizadas de la Interfaz (Español)»
Clave de Traducción Texto en Interfaz
page.ui.islam_liturgical_scriptural_fiqh_cockpit Panel Litúrgico, Escritural y de Fiqh Islámico
page.ui.1_salah_adhan_iqamah Salah, Adhan e Iqamah
page.ui.2_hilal_ramadan_eid Hilal, Ramadán y Eid
page.ui.3_quran_hadith_dua Corán, Hadiz y Dua
page.ui.4_zakat_nisab_qibla Zakat, Nisab y Qibla
page.ui.refresh Actualizar
page.ui.prayer_salah Oración (Salah)
page.ui.adhan_time Hora del Adhan

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

Sección titulada «4. 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
GET /api/islam/hijri/convert content-api content-api.convertDate Bearer JWT
GET /api/islam/scripture content-api content-api.getScriptureHub Bearer JWT
GET /api/islam/scripture/daily content-api content-api.getDailyInspiration Bearer JWT
GET /api/islam/daily-inspiration content-api content-api.getDailyInspiration Bearer JWT
GET /api/islam/quran/chapters content-api content-api.getQuranChapters Bearer JWT
GET /api/islam/quran/chapters/{chapterNumber} content-api content-api.getQuranChapterVerses Bearer JWT
GET /api/islam/quran/chapters/{chapterNumber}/info content-api content-api.getQuranChapterInfo Bearer JWT
GET /api/islam/quran/chapters/{chapterNumber}/audio content-api content-api.getQuranChapterAudio Bearer JWT
GET /api/islam/quran/verses/{verseKey} content-api content-api.getQuranVerseByKey Bearer JWT
GET /api/islam/quran/verses/{verseKey}/hadiths content-api content-api.getQuranAyahHadiths Bearer JWT
GET /api/islam/quran/resources content-api content-api.getQuranResources Bearer JWT
GET /api/islam/nisab content-api content-api.getNisab Bearer JWT
POST /api/islam/zakat/calculate content-api content-api.calculateZakat Bearer JWT
POST /api/islam/fitrana-fidyah/calculate content-api content-api.calculateFitranaFidyah Bearer JWT

7. Uso Programático en el Servidor (strapi.plugin y strapi.documents)

Sección titulada «7. Uso Programático en el Servidor (strapi.plugin y strapi.documents)»
// Registered services on plugin "islam": "settings", "islamService"
const pluginService = strapi.plugin("islam")?.service("islamService");
// Querying records via the Strapi v5 Document Service API
const records = await strapi.documents("plugin::islam.hilal-announcement").findMany({
limit: 25,
sort: "createdAt:desc",
});
  • Cambios no visibles en el panel Admin: Ejecute pnpm strapi build después de editar config/plugins.ts.
  • Aislamiento de dependencias peer: Mantenga hoistPattern: ["*", "!@strapi/*"] en pnpm-workspace.yaml para evitar colisiones de contexto en React.
  • Verificación estricta de TypeScript: Ejecute pnpm check para validar admin/tsconfig.json y server/tsconfig.json.