{"id":380614,"date":"2026-10-09T07:12:47","date_gmt":"2026-10-09T07:12:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/adawat-tools-prayer-times-hijri-date\/"},"modified":"2026-10-09T07:12:38","modified_gmt":"2026-10-09T07:12:38","slug":"adawat-tools","status":"publish","type":"plugin","link":"https:\/\/br.wordpress.org\/plugins\/adawat-tools\/","author":23579545,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.3","requires":"5.3","requires_php":"7.2","requires_plugins":null,"header_name":"Adawat Tools: Prayer Times & Hijri Date \u2013 \u0623\u062f\u0648\u0627\u062a","header_author":"\u0623\u062f\u0648\u0627\u062a","header_description":"Today's Hijri (Umm al-Qura) date computed locally in PHP with no external request, plus prayer times for 188 cities, a Ramadan countdown and a zakat calculator from adawat.org \u2014 as ready-made shortcodes that work in the block editor, the classic editor and text widgets.","assets_banners_color":"3d9084","last_updated":"2026-10-09 07:12:38","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/adawat.org\/","header_plugin_uri":"https:\/\/adawat.org\/widgets.html","header_author_uri":"https:\/\/adawat.org\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":74,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"mnsarl","date":"2026-10-09 07:12:38","revision":3736093}},"upgrade_notice":{"1.0.0":"<p>First release.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3736093,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3736093,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3736093,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"The prayer times widget with the next-prayer countdown (light and dark themes).","2":"Today's Hijri date inside a post.","3":"The settings page: default city and theme.","4":"The Ramadan countdown and the zakat calculator."}},"plugin_section":[],"plugin_tags":[1113,10957,22604,43956,43925],"plugin_category":[],"plugin_contributors":[285276],"plugin_business_model":[],"class_list":["post-380614","plugin","type-plugin","status-publish","hentry","plugin_tags-arabic","plugin_tags-hijri","plugin_tags-prayer-times","plugin_tags-ramadan","plugin_tags-zakat","plugin_contributors-mnsarl","plugin_committers-mnsarl"],"banners":{"banner":"https:\/\/ps.w.org\/adawat-tools\/assets\/banner-772x250.png?rev=3736093","banner_2x":"https:\/\/ps.w.org\/adawat-tools\/assets\/banner-1544x500.png?rev=3736093","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/adawat-tools\/assets\/icon-256x256.png?rev=3736093","icon_2x":"https:\/\/ps.w.org\/adawat-tools\/assets\/icon-256x256.png?rev=3736093","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>A lightweight Arabic (RTL) plugin by <a href=\"https:\/\/adawat.org\/\">adawat.org<\/a>. 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:<\/p>\n\n<ul>\n<li><code>[adawat_hijri_date]<\/code> \u2014 today's Hijri date in the <strong>Umm al-Qura<\/strong> calendar, computed locally on your server from the full Umm al-Qura month table (1300\u20131600 AH) in your site's timezone \u2014 <strong>no external requests, no JavaScript<\/strong>. Add <code>gregorian=\"yes\"<\/code> to also show the matching Gregorian date.<\/li>\n<li><code>[adawat_prayer_times city=\"riyadh\"]<\/code> \u2014 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 \u2014 no API keys, no accounts. Options: <code>method<\/code> (mkk, egy, mwl, \u2026), <code>asr<\/code> (1 standard, 2 Hanafi) and <code>theme<\/code>.<\/li>\n<li><code>[adawat_ramadan_countdown]<\/code> \u2014 days and hours left until Ramadan; <code>event=\"fitr|adha|arafah|hijri\"<\/code> covers Eid al-Fitr, Eid al-Adha, Arafah day and the Hijri new year.<\/li>\n<li><code>[adawat_zakat]<\/code> \u2014 a mini zakat calculator (2.5% with the gold nisab); <code>gold<\/code> sets the gold gram price and <code>cur<\/code> the currency label.<\/li>\n<\/ul>\n\n<p>From <strong>Settings \u2192 \u0623\u062f\u0648\u0627\u062a<\/strong> you choose the default city and theme (auto \/ light \/ dark) for all widgets at once, and <code>theme=\"light|dark\"<\/code> on any shortcode overrides it.<\/p>\n\n<p>Every widget renders a small \"\u0645\u062f\u0639\u0648\u0645 \u0645\u0646 \u0623\u062f\u0648\u0627\u062a\" credit line linking to the matching adawat.org tool page; you can switch it off on the settings page.<\/p>\n\n<h4>Privacy<\/h4>\n\n<ul>\n<li><code>[adawat_hijri_date]<\/code> runs entirely on your server and never contacts any external service.<\/li>\n<li>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.<\/li>\n<\/ul>\n\n<h4>\u0628\u0627\u0644\u0639\u0631\u0628\u064a\u0629<\/h4>\n\n<p>\u0625\u0636\u0627\u0641\u0629 \u0639\u0631\u0628\u064a\u0629 \u062e\u0641\u064a\u0641\u0629 \u0645\u0646 \u0645\u0648\u0642\u0639 <a href=\"https:\/\/adawat.org\/\">\u0623\u062f\u0648\u0627\u062a<\/a> \u062a\u0636\u064a\u0641 \u0644\u0645\u0648\u0642\u0639\u0643 \u0623\u0631\u0628\u0639 \u0648\u062f\u062c\u0627\u062a \u062c\u0627\u0647\u0632\u0629 \u0639\u0628\u0631 \u0634\u0648\u0631\u062a \u0643\u0648\u062f\u0627\u062a \u0628\u0633\u064a\u0637\u0629: \u0627\u0644\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u0647\u062c\u0631\u064a \u0628\u062a\u0642\u0648\u064a\u0645 \u0623\u0645 \u0627\u0644\u0642\u0631\u0649 (\u0645\u062d\u0633\u0648\u0628 \u0639\u0644\u0649 \u062e\u0627\u062f\u0645\u0643 \u0628\u062f\u0648\u0646 \u0623\u064a \u0637\u0644\u0628 \u062e\u0627\u0631\u062c\u064a)\u060c \u0648\u0645\u0648\u0627\u0642\u064a\u062a \u0627\u0644\u0635\u0644\u0627\u0629 \u0644\u0640188 \u0645\u062f\u064a\u0646\u0629 \u0645\u0639 \u0639\u062f\u0651\u0627\u062f \u0644\u0644\u0635\u0644\u0627\u0629 \u0627\u0644\u0642\u0627\u062f\u0645\u0629\u060c \u0648\u0639\u062f\u0651\u0627\u062f \u0631\u0645\u0636\u0627\u0646 \u0648\u0627\u0644\u0623\u0639\u064a\u0627\u062f\u060c \u0648\u062d\u0627\u0633\u0628\u0629 \u0632\u0643\u0627\u0629 \u0627\u0644\u0645\u0627\u0644. \u062a\u0639\u0645\u0644 \u0641\u064a \u0645\u062d\u0631\u0631 \u0627\u0644\u0645\u0643\u0648\u0651\u0646\u0627\u062a \u0648\u0627\u0644\u0645\u062d\u0631\u0631 \u0627\u0644\u0643\u0644\u0627\u0633\u064a\u0643\u064a \u0648\u0648\u062f\u062c\u0627\u062a \u0627\u0644\u0646\u0635. \u0627\u0644\u062a\u0641\u0627\u0635\u064a\u0644 \u0627\u0644\u0643\u0627\u0645\u0644\u0629 \u0628\u0627\u0644\u0625\u0646\u062c\u0644\u064a\u0632\u064a\u0629 \u0641\u0648\u0642.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>In your dashboard go to <strong>Plugins \u2192 Add New<\/strong>, search for \"Adawat Tools\", or upload the ZIP from <strong>Upload Plugin<\/strong>.<\/li>\n<li>Activate the plugin.<\/li>\n<li>Open <strong>Settings \u2192 \u0623\u062f\u0648\u0627\u062a<\/strong> and pick the default city and theme.<\/li>\n<li>Put any shortcode in a post, a page or a text widget, for example: <code>[adawat_prayer_times city=\"makkah\" theme=\"dark\"]<\/code>.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20city%20slugs%20like%20riyadh%20and%20makkah%20come%20from%3F\"><h3>Where do city slugs like riyadh and makkah come from?<\/h3><\/dt>\n<dd><p>They are the same identifiers used by the city pages on adawat.org: the URL <code>https:\/\/adawat.org\/prayer-times-riyadh.html<\/code> means the slug is <code>riyadh<\/code>. The full list of all 188 cities is in the dropdown on <strong>Settings \u2192 \u0623\u062f\u0648\u0627\u062a<\/strong>, and you can also pass the Arabic name directly, for example <code>city=\"\u062c\u062f\u0629\"<\/code>.<\/p><\/dd>\n<dt id=\"does%20the%20hijri%20date%20need%20an%20internet%20connection%3F\"><h3>Does the Hijri date need an internet connection?<\/h3><\/dt>\n<dd><p>No. <code>[adawat_hijri_date]<\/code> is computed in PHP on your own server from the bundled Umm al-Qura month table (1300\u20131600 AH \/ 1882\u20132174 CE) \u2014 the same Umm al-Qura data that ICU ships and that adawat.org itself uses.<\/p><\/dd>\n<dt id=\"does%20the%20conversion%20match%20the%20official%20umm%20al-qura%20calendar%3F\"><h3>Does the conversion match the official Umm al-Qura calendar?<\/h3><\/dt>\n<dd><p>Yes, within the range of the table (1300\u20131600 AH). The conversion was tested automatically against the <code>islamic-umalqura<\/code> calendar in ICU over thousands of random dates and matched every one of them day for day.<\/p><\/dd>\n<dt id=\"which%20prayer%20time%20calculation%20methods%20are%20supported%3F\"><h3>Which prayer time calculation methods are supported?<\/h3><\/dt>\n<dd><p>Through the <code>method<\/code> attribute: Umm al-Qura <code>mkk<\/code>, Egyptian General Authority <code>egy<\/code>, Muslim World League <code>mwl<\/code>, Karachi <code>kar<\/code>, Jordan <code>jo<\/code>, ISNA <code>isna<\/code>, Dubai and the Gulf <code>dub<\/code>, Kuwait <code>kw<\/code>, Qatar <code>qa<\/code>, Morocco <code>ma<\/code>, South East Asia <code>sea<\/code>, France <code>fr<\/code>. If you do not set one, the official method of the city's country is used automatically. For the Hanafi Asr add <code>asr=\"2\"<\/code>.<\/p><\/dd>\n<dt id=\"can%20the%20%22%D9%85%D8%AF%D8%B9%D9%88%D9%85%20%D9%85%D9%86%20%D8%A3%D8%AF%D9%88%D8%A7%D8%AA%22%20credit%20line%20be%20hidden%3F\"><h3>Can the \"\u0645\u062f\u0639\u0648\u0645 \u0645\u0646 \u0623\u062f\u0648\u0627\u062a\" credit line be hidden?<\/h3><\/dt>\n<dd><p>Yes. Turn the option off on <strong>Settings \u2192 \u0623\u062f\u0648\u0627\u062a<\/strong>, or do it in code with the <code>adawat_tools_show_credit<\/code> filter.<\/p><\/dd>\n<dt id=\"does%20it%20work%20on%20non-arabic%20%28ltr%29%20sites%3F\"><h3>Does it work on non-Arabic (LTR) sites?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: Hijri date shortcode (local Umm al-Qura port in PHP), prayer times for 188 cities, Ramadan countdown, zakat calculator.<\/li>\n<li>Settings page: default city, light\/dark theme, credit line toggle.<\/li>\n<li>Sandboxed iframe embeds that resize themselves automatically and load lazily.<\/li>\n<\/ul>","raw_excerpt":"Today's Hijri (Umm al-Qura) date computed locally, prayer times for 188 cities, a Ramadan countdown and a zakat calculator from adawat.org.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/380614","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=380614"}],"author":[{"embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mnsarl"}],"wp:attachment":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=380614"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=380614"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=380614"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=380614"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=380614"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=380614"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}