=== Smart Masjid Prayer Timings ===
Contributors: futuriklabs
Tags: prayer times, masjid, mosque, salah, islamic
Requires at least: 5.6
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display daily prayer timings for your masjid using the Smart Masjid platform.

== Description ==

Smart Masjid Prayer Timings lets masjid administrators display accurate, up-to-date prayer and Jumuah timings on their WordPress site. Timings are fetched from the Smart Masjid API using your masjid's API key.

**Features:**

* Five daily salah times (Fajr, Dhuhr, Asr, Maghrib, Isha) with Adhan and Iqama times
* Jumuah timings (supports up to three Jumuah sessions)
* Sunrise and Shurooq times
* Hijri date display (uses PHP's intl extension — no external API needed)
* Three widget styles to choose from (two table styles and a card style)
* Customizable card colors, including separate colors for the active/current prayer card (background, icon, font)
* Translation-ready

== Third-Party Services ==

This plugin connects to the following external services to retrieve prayer timing data:

**Smart Masjid API**
Prayer and Jumuah timings are fetched from the Smart Masjid API using the API key you provide in the plugin settings.

* Service URL: [https://api.smartmasjid.app](https://api.smartmasjid.app)
* Website: [https://smartmasjid.app](https://smartmasjid.app)
* Terms of Use: [https://smartmasjid.app/terms](https://smartmasjid.app/terms)
* Privacy Policy: [https://smartmasjid.app/privacy](https://smartmasjid.app/privacy)

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress plugin screen.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Register your masjid at [smartmasjid.app/register](https://smartmasjid.app/register) to receive an API key.
4. Go to **Smart Masjid** in the admin menu.
5. Enter the API key and click **Validate**.
6. Copy the shortcode `[smpt_time_table]` and paste it into any page or post.

== Frequently Asked Questions ==

= Where do I get an API key? =

Register your masjid at [smartmasjid.app/register](https://smartmasjid.app/register) to receive an API key.

= Can I change the widget style? =

Yes. Go to **Smart Masjid > Advanced** in the admin panel to choose from three styles and customize colours.

= Does this plugin require any PHP extensions? =

The PHP `intl` extension is recommended for Hijri (Islamic calendar) date display. It is included with most PHP installations and enabled by default on nearly all WordPress hosting providers. If unavailable, prayer times will still display but the Hijri date will be blank.

= How often are prayer times refreshed? =

The plugin caches API responses until midnight (based on your WordPress timezone setting). You can manually clear the cache from the settings page.

== Screenshots ==

1. Admin settings page with API key validation.
2. Table style widget on the front end.
3. Card style widget on the front end.

== Changelog ==

= 1.1.0 =
* New: Active Card Icon Color and Active Card Font Color settings for the card widget style.
* Fix: Card icon color setting.
* Fix: Current-prayer highlighting (table and card styles).

= 1.0.0 =
* Initial release.
