MasjidOS

MasjidOS is an all-in-one mosque management plugin for WordPress. It gives your mosque a dedicated admin dashboard and a full set of public shortcodes — covering everything from daily prayer times to a fullscreen TV display, Duas & Azkar, Quran verses, Hadith of the Day, Islamic calendar, community events, and scheduled announcements.

Designed for mosques of all sizes, MasjidOS performs prayer time calculations locally on your server — no external prayer API required by default. Everything runs offline, with no telemetry or visitor tracking.

🕌 Prayer Times

• Local, offline prayer-time calculation using saved coordinates, timezone, and calculation method
• Optional Aladhan.com API integration for cloud-sourced monthly timetables
• Supports all major calculation methods (Karachi, ISNA, MWL, Egypt, Makkah, Tehran, Kuwait, Qatar, Singapore, and more)
• Hanafi and standard Asr methods
• Per-prayer minute adjustments to match your local mosque timetable
• Iqamah (Jamaat) times display
• Qibla direction with live browser compass API
• Hijri date display with adjustable offset for local moon-sighting calendars
• Responsive widgets in English, Bangla, and Arabic

📅 Monthly Timetable

• Full month prayer timetable with Hijri date column
• Month navigation, current-month return button, and print support
• Compact and classic layout designs

🗓️ Islamic Calendar

• Gregorian calendar with Hijri dates overlaid on every day
• Highlights important Islamic dates (Ramadan, Eid, Laylat al-Qadr, and more)
• Shows mosque community events as calendar markers
• Supports Bangla and English languages
• Available as a shortcode and as a Gutenberg block

📺 TV Display (Fullscreen Mosque Screen)

• Dedicated fullscreen display at /masjidos-display/
• Shows live prayer times, upcoming prayer countdown, Hijri date, announcements ticker, and mosque name
• Multiple themes (Dark, Light, Green)
• Configurable font size and announcement scroll speed
• Custom logo support

🤲 Duas & Azkar

• Built-in collection of authentic Duas and Azkar with Arabic text, transliteration, and Bangla/English meanings
• Source labels (Quran reference or Hadith source) for every dua
• Filter by category: Morning, Evening, Food, Sleep, Home, Masjid, Travel, Rain, Forgiveness, Quran, Protection
• Local recitation counter stored in the visitor’s browser
• Share button for each dua
• Custom Duas Library: add your own Duas from the admin and assign categories

📖 Quran & Hadith

• Daily Quran verse shortcode with Arabic, English, and Bangla translation
• Daily Hadith widget with source reference
• Audio Quran shortcode — play any Surah directly on the page (streamed from QuranicAudio.com)
• 99 Names of Allah shortcode with Arabic, transliteration, and meaning

🕋 Jumuah Management

• Multiple Jumuah sessions per Friday (first Jumuah, second Jumuah)
• Khatib profile with name, photo, and bio
• Khutbah topic, language, and special notice fields
• Recurring auto-creation of Friday Jumuah entries
• Jumuah Khutbah Archive with audio player and date filtering

📢 Mosque Announcements

• Scheduled notices with start and end dates/times
• Display styles: Ticker, Banner, List, and Popup Modal
• Priority ordering for notices
• Ramadan gold ticker theme auto-activates during Ramadan

📆 Community Events

• Upcoming events list with title, date, location, description, and featured image
• “Remaining days” badge for each event
• iCal download so visitors can add events to their personal calendars
• Islamic recurring events (Eid, Ramadan, Milad, Muharram) generated automatically with Hijri date conversion

⚙️ Administration

• Dedicated MasjidOS dashboard in the WordPress admin
• Role-based access: Imam and Muazzin roles with tailored capabilities
• REST API under masjidos/v1 with capability-based permission checks
• Built-in Features page with live shortcode previews and a shortcode generator
• Full shortcode documentation under MasjidOS > Docs
• Multisite compatible (uninstall cleans all sites)

🌐 Multilingual

• Translation-ready (.pot file included)
• Built-in Bangla (Bangladesh) translation
• Shortcode language attribute supports en, bn, and ar

External Services

MasjidOS connects to the following third-party services in specific situations:

Aladhan Prayer Times API

When the prayer source is set to “Aladhan” in Settings, the plugin fetches monthly prayer timetables from api.aladhan.com. The city, country, calculation method, and Asr school are sent as query parameters. This setting defaults to “Local” (offline calculation); the API is only contacted when you explicitly choose “Aladhan” as the source. Service: https://aladhan.com | Privacy: https://aladhan.com/privacy

Google Fonts (TV Display)

The TV Display page loads Cairo, Outfit, and Noto Sans Bengali fonts from Google Fonts CDN (fonts.googleapis.com). This request is made in the visitor’s browser when the TV Display page is opened. Service: https://fonts.google.com | Privacy: https://policies.google.com/privacy

Quranic Audio (Audio Quran widget)

The Audio Quran widget generates playback URLs pointing to download.quranicaudio.com. The audio file is streamed directly in the visitor’s browser; no data is sent from your server. Service: https://quranicaudio.com

Privacy

MasjidOS does not include analytics, telemetry, advertising, or any automatic requests to a MasjidOS-owned service. See the External Services section above for third-party services that may be contacted under specific conditions.

Public widgets display only information that an administrator has explicitly configured: prayer settings, Khatib profiles, announcements, and events.