WAQTUNA Prayer Times

WAQTUNA adds prayer time widgets to your WordPress site through simple shortcodes. It is built for mosques and Islamic centers that want accurate, maintainable prayer times without manual daily updates.

Prayer times are loaded from the vaktija.eu API. Choose a location in the admin, and times are fetched and cached automatically. You can also import a CSV file as the primary source or as a fallback when the API is unavailable.

This plugin is not affiliated with vaktija.eu. It uses their public API as a data source.

Features

• Full prayer times widget with Gregorian and Hijri dates, plus key Islamic dates (Eid, Jumu’ah, Laylat al-Qadr, and more on the Hijri calendar)
• Next prayer widget with live countdown
• Location picker connected to api.vaktija.eu
• WordPress timezone check on the Location tab (warns when site time does not match the selected city)
• CSV import as an alternative or fallback data source
• Custom congregation times (Fajr Jamah, Jumuah summer/winter, Isha/Tarawih)
• Multiple layouts: grid, list, compact grid, and compact list
• Responsive layouts: set a different layout for mobile, tablet, and desktop
• Light, dark, and system theme modes
• Custom labels, Hijri month names, and weekday names — with primary and optional secondary language overrides for bilingual sites
• Highlight colors and optional background patterns
• Masjid full-screen display for TV and kiosk screens with orientation and rotation support
• Monthly prayer timetables (Gregorian or Hijri month) with logo, heading, overlapping month(s) from the other calendar, Islamic key dates column (desktop/print), up to 3 footer text lines, print, and PNG export
• Custom background image fit and opacity for widget and masjid display
• Translation-ready; language packs are provided via WordPress translations (translate.wordpress.org). English defaults when no language pack is installed

Shortcodes

[waqtuna_prayer_times] — full prayer times display with date navigation.

[waqtuna_prayer_times date="2026-09-17"] — show prayer times for a specific date.

[waqtuna_next_prayer] — show the next upcoming prayer.

[waqtuna_next_prayer style="compact"] — compact next-prayer display.

[waqtuna_prayer_times style="masjid"] — full-screen masjid display for TV or kiosk screens.

[waqtuna_prayer_times style="masjid" orientation="vertical" rotation="90-right"] — portrait TV with 90° clockwise rotation.

[waqtuna_prayer_times style="gregorian-month"] — full-month timetable for the current Gregorian month.

[waqtuna_prayer_times style="hijri-month"] — full-month timetable for the current Hijri month.

[waqtuna_prayer_times style="gregorian-month" month="4" year="2026"] — optional month and year attributes for monthly views.

External services

This plugin connects to the vaktija.eu API at https://api.vaktija.eu/v3 to obtain location lists and daily prayer times. This is required when the API data source is enabled and the frontend widget loads or changes dates.

Data sent: selected location ID and requested Gregorian date. No WordPress user accounts, personal data, or site credentials are transmitted.

Requests are made over HTTPS when an administrator selects or refreshes a location, when the widget is first rendered, and when visitors change the date in the widget. If the API is unavailable and CSV import is configured, the plugin can use locally stored CSV data instead.

Service provider: vaktija.eu (third-party prayer times API; not affiliated with this plugin).

Terms of use: https://vaktija.eu/
Privacy policy: https://vaktija.eu/ (contact the service operator for current privacy information)

Hijri dates are calculated locally using an embedded Umm al-Qura month table (1990–2040). Dates outside that range fall back to PHP intl when available.

Credits

Prayer time data provided by vaktija.eu.

Month timetable PNG export uses the bundled html-to-image library (MIT license, ~20 KB). It runs in the browser only when a visitor uses Save as image on a monthly timetable. No additional npm or Composer packages are required on the server.