Title: Adawat Tools: Prayer Times & Hijri Date – أدوات Author: mnsarl Published: 2026 年 10 月 9 日 Last modified: 2026 年 10 月 9 日 --- 搜尋外掛 ![](https://ps.w.org/adawat-tools/assets/banner-772x250.png?rev=3736093) ![](https://ps.w.org/adawat-tools/assets/icon-256x256.png?rev=3736093) # Adawat Tools: Prayer Times & Hijri Date – أدوات 由 [mnsarl](https://profiles.wordpress.org/mnsarl/) 開發 [下載](https://downloads.wordpress.org/plugin/adawat-tools.1.0.0.zip) * [詳細資料](https://tw.wordpress.org/plugins/adawat-tools/#description) * [使用者評論](https://tw.wordpress.org/plugins/adawat-tools/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/adawat-tools/#installation) * [開發資訊](https://tw.wordpress.org/plugins/adawat-tools/#developers) [技術支援](https://wordpress.org/support/plugin/adawat-tools/) ## 外掛說明 A lightweight Arabic (RTL) plugin by [adawat.org](https://adawat.org/). It adds four ready-made widgets through simple shortcodes that work in the block editor ( inside a Shortcode block), the classic editor and text widgets: * `[adawat_hijri_date]` — today’s Hijri date in the **Umm al-Qura** calendar, computed locally on your server from the full Umm al-Qura month table (1300–1600 AH) in your site’s timezone — **no external requests, no JavaScript**. Add `gregorian ="yes"` to also show the matching Gregorian date. * `[adawat_prayer_times city="riyadh"]` — today’s prayer times for any of 188 cities, with a live next-prayer countdown. Times are computed astronomically in the visitor’s browser through the adawat.org widget — no API keys, no accounts. Options: `method`( mkk, egy, mwl, …), `asr` (1 standard, 2 Hanafi) and `theme`. * `[adawat_ramadan_countdown]` — days and hours left until Ramadan; `event="fitr |adha|arafah|hijri"` covers Eid al-Fitr, Eid al-Adha, Arafah day and the Hijri new year. * `[adawat_zakat]` — a mini zakat calculator (2.5% with the gold nisab); `gold` sets the gold gram price and `cur` the currency label. From **Settings أدوات** you choose the default city and theme (auto / light / dark) for all widgets at once, and `theme="light|dark"` on any shortcode overrides it. Every widget renders a small “مدعوم من أدوات” credit line linking to the matching adawat.org tool page; you can switch it off on the settings page. #### Privacy * `[adawat_hijri_date]` runs entirely on your server and never contacts any external service. * The other shortcodes embed an iframe from adawat.org; the visitor’s browser loads the widget from there like any normal iframe (the visitor’s IP reaches adawat. org as a standard web request). The widgets use no accounts and no ad tracking, and prayer times are computed inside the visitor’s own browser. #### بالعربية إضافة عربية خفيفة من موقع [أدوات](https://adawat.org/) تضيف لموقعك أربع ودجات جاهزة عبر شورت كودات بسيطة: التاريخ الهجري بتقويم أم القرى (محسوب على خادمك بدون أي طلب خارجي)، ومواقيت الصلاة لـ188 مدينة مع عدّاد للصلاة القادمة، وعدّاد رمضان والأعياد، وحاسبة زكاة المال. تعمل في محرر المكوّنات والمحرر الكلاسيكي وودجات النص. التفاصيل الكاملة بالإنجليزية فوق. ## 安裝方式 1. In your dashboard go to **Plugins Add New**, search for “Adawat Tools”, or upload the ZIP from **Upload Plugin**. 2. Activate the plugin. 3. Open **Settings أدوات** and pick the default city and theme. 4. Put any shortcode in a post, a page or a text widget, for example: `[adawat_prayer_times city="makkah" theme="dark"]`. ## 常見問題集 ### Where do city slugs like riyadh and makkah come from? They are the same identifiers used by the city pages on adawat.org: the URL `https:// adawat.org/prayer-times-riyadh.html` means the slug is `riyadh`. The full list of all 188 cities is in the dropdown on **Settings أدوات**, and you can also pass the Arabic name directly, for example `city="جدة"`. ### Does the Hijri date need an internet connection? No. `[adawat_hijri_date]` is computed in PHP on your own server from the bundled Umm al-Qura month table (1300–1600 AH / 1882–2174 CE) — the same Umm al-Qura data that ICU ships and that adawat.org itself uses. ### Does the conversion match the official Umm al-Qura calendar? Yes, within the range of the table (1300–1600 AH). The conversion was tested automatically against the `islamic-umalqura` calendar in ICU over thousands of random dates and matched every one of them day for day. ### Which prayer time calculation methods are supported? Through the `method` attribute: Umm al-Qura `mkk`, Egyptian General Authority `egy`, Muslim World League `mwl`, Karachi `kar`, Jordan `jo`, ISNA `isna`, Dubai and the Gulf `dub`, Kuwait `kw`, Qatar `qa`, Morocco `ma`, South East Asia `sea`, France` fr`. If you do not set one, the official method of the city’s country is used automatically. For the Hanafi Asr add `asr="2"`. ### Can the “مدعوم من أدوات” credit line be hidden? Yes. Turn the option off on **Settings أدوات**, or do it in code with the `adawat_tools_show_credit` filter. ### Does it work on non-Arabic (LTR) sites? Yes. The widgets are self-contained RTL iframes and the Hijri date is plain text, so they render correctly on any site regardless of the theme’s language or direction. ## 使用者評論 這個外掛目前沒有任何使用者評論。 ## 參與者及開發者 以下人員參與了開源軟體〈Adawat Tools: Prayer Times & Hijri Date – أدوات〉的開發相關 工作。 參與者 * [ mnsarl ](https://profiles.wordpress.org/mnsarl/) [將〈Adawat Tools: Prayer Times & Hijri Date – أدوات〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/adawat-tools) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/adawat-tools/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/adawat-tools/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/adawat-tools/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/adawat-tools/)。 ## 變更記錄 #### 1.0.0 * First release: Hijri date shortcode (local Umm al-Qura port in PHP), prayer times for 188 cities, Ramadan countdown, zakat calculator. * Settings page: default city, light/dark theme, credit line toggle. * Sandboxed iframe embeds that resize themselves automatically and load lazily. ## 中繼資料 * 版本 **1.0.0** * 最後更新 **5 天前** * 啟用安裝數 **少於 10 次** * WordPress 版本需求 ** 5.3 或更新版本 ** * 已測試相容的 WordPress 版本 **7.1.3** * PHP 版本需求 ** 7.2 或更新版本 ** * 語言 * [English (US)](https://wordpress.org/plugins/adawat-tools/) * 標籤: * [arabic](https://tw.wordpress.org/plugins/tags/arabic/)[hijri](https://tw.wordpress.org/plugins/tags/hijri/) [Prayer Times](https://tw.wordpress.org/plugins/tags/prayer-times/)[Ramadan](https://tw.wordpress.org/plugins/tags/ramadan/) [zakat](https://tw.wordpress.org/plugins/tags/zakat/) * [進階檢視](https://tw.wordpress.org/plugins/adawat-tools/advanced/) ## 評分 這個項目尚無任何評論記錄。 [撰寫評分](https://wordpress.org/support/plugin/adawat-tools/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/adawat-tools/reviews/) ## 參與者 * [ mnsarl ](https://profiles.wordpress.org/mnsarl/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/adawat-tools/) ## 贊助 想要支援這個外掛的發展嗎？ [ 贊助這個外掛 ](https://adawat.org/)