=== Adadat – Saudi Countdowns & Prayer Times ===
Contributors: adadat
Tags: countdown, prayer times, hijri, saudi arabia, arabic
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live countdowns to Saudi salary, Citizen Account, Ramadan and Eid dates, today's Hijri date, and prayer times for Saudi and Gulf cities.

== Description ==

Adadat adds three shortcodes for Arabic sites that write about dates people in Saudi Arabia and the Gulf check every day.

* `[adadat_countdown event="salary"]` shows a live countdown (days, hours, minutes, seconds) to the next government salary date. Other events include `citizen-account`, `social-security`, `retirement`, `housing-support`, `ramadan`, `eid-al-fitr`, `eid-al-adha`, `arafah`, `hijri-new-year`, `national-day`, `founding-day` and the school holidays.
* `[adadat_prayer city="riyadh"]` shows today's six prayer times for one of 85 Saudi and Gulf cities, calculated with each country's official method.
* `[adadat_hijri]` prints today's Hijri date from the Umm al-Qura calendar. `[adadat_hijri show="both"]` adds the Gregorian date.

The boxes are right-to-left, need no configuration, and update by themselves every day. Add `title="..."` to a countdown to change its heading.

The full list of event and city names is at [adadat.com/wordpress](https://adadat.com/wordpress/).

= Credit link =

The plugin shows no link to adadat.com unless you switch it on under Settings → Adadat.

== External services ==

This plugin reads dates from adadat.com, which calculates them. Without that data the shortcodes have nothing to show.

* What is requested: `https://adadat.com/api/countdowns.json` (next date of every event and today's Hijri date) and `https://adadat.com/prayer/{city}.json` (prayer times for the city you chose).
* When: from your server, when a page with a shortcode is viewed and the saved copy is older than six hours. Your visitors' browsers never contact adadat.com.
* What is sent: a normal HTTP request from your server, with a User-Agent containing the plugin version and your site address. No visitor data is sent.

The service is provided by Adadat: [terms of use](https://adadat.com/terms/), [privacy policy](https://adadat.com/privacy/).

== Installation ==

1. Install and activate the plugin.
2. Put a shortcode in any post, page or Shortcode block, for example `[adadat_countdown event="ramadan"]`.

== Frequently Asked Questions ==

= Where do the dates come from? =

Salary and support dates follow the rules published by the Saudi authorities, including the shift when a date falls on a weekend. Hijri dates use the Umm al-Qura calendar. The method is described at [adadat.com/editorial](https://adadat.com/editorial/). Official announcements remain the reference, especially for months that depend on moon sighting.

= What happens if adadat.com cannot be reached? =

The plugin keeps the last data it received and continues to show it.

= Does it slow my site down? =

Data is fetched at most once every six hours per shortcode type and stored in your database. The front end loads one small stylesheet and one small script, only on pages that use a countdown or prayer box.

== Changelog ==

= 1.0.0 =
* First release: countdown, prayer times and Hijri date shortcodes.
