內容簡介
WAQTUNA Prayer Times 外掛為 WordPress 網站提供準確的祈禱時間小工具，特別適合清真寺和伊斯蘭中心使用。透過簡單的短碼，使用者可輕鬆顯示祈禱時間，並自動從 vaktija.eu API 獲取資料，無需每日手動更新。
【主要功能】
• 全功能祈禱時間小工具，顯示公曆與伊斯蘭曆日期
• 即時倒數的下一次祈禱小工具
• 位置選擇器連接至 api.vaktija.eu
• 支援 CSV 檔案匯入作為備用資料來源
• 多種佈局選擇：網格、列表、緊湊網格
• 可自訂顏色與背景圖案
外掛標籤
開發者團隊
原文外掛簡介
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.
