=== JW Prayer Times ===
Contributors: joinwebs
Donate link: https://joinwebs.com/
Tags: prayer times, islamic, namaz, salat, worldwide prayer
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Professional bilingual (English & Urdu) prayer times plugin with auto-location detection, live clock, and SEO-friendly worldwide country pages.

== Description ==

JW Prayer Times is a powerful and lightweight WordPress plugin designed to provide accurate prayer timings for any location in the world. It uses the Aladhan API to deliver precise results and features an intuitive, bilingual interface suitable for both English and Urdu speaking users.

One of the standout features of this plugin is its **Dynamic Country Routing**. Unlike static plugins, JW Prayer Times allows you to create a custom page that can dynamically display prayer times for any country in the world via clean, SEO-friendly URLs.

= Key Features =
* **Auto Location Detection:** Automatically detects the user's city and country via IP to show relevant timings immediately.
* **Bilingual Support:** Full support for English and Urdu with an instant language switcher.
* **Live Animated Clock:** Displays current date and time with a professional pulse-glow effect.
* **Worldwide Coverage:** Access prayer times for over 190 countries and thousands of cities.
* **Popular Cities Access:** Automatically fetches and displays popular cities for the selected country using the CountriesNow API.
* **SEO Optimized:** Dynamic sub-pages for countries help in ranking for regional prayer time searches.
* **12-Hour Format:** All timings are displayed in a user-friendly AM/PM format.
* **Backend Settings:** Easily set your website's default city and country from the WordPress admin dashboard.

== Installation ==

1. Upload the `jw-prayer-times` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Navigate to **Settings > Prayers Settings** to configure your default location.
4. Go to **Settings > Permalinks** and click **Save Changes** (this is required to enable country sub-pages).
5. Use the shortcode `[jw_prayer_times]` on any page or post.

== Frequently Asked Questions ==

= How do I enable country pages? =
After installing the plugin, you must go to **Settings > Permalinks** and click the **Save Changes** button. This flushes the rewrite rules and enables URLs like `/your-page/country/pakistan/`.

= Does it support 12-hour AM/PM format? =
Yes, the plugin automatically converts 24-hour API data into a readable 12-hour AM/PM format.

= How does auto-location work? =
The plugin uses a free IP-based API to detect the user's city. If detection fails, it falls back to the default city set in the admin settings.

== Screenshots ==

1. Main prayer times card with live clock and Urdu/English labels.
2. Worldwide country links section for SEO.
3. Popular cities grid that updates timings on click.
4. Admin settings page to configure default city and country.

== External Services ==

This plugin relies on the following third-party services to function:

1. Aladhan API: Used to fetch accurate prayer timings based on city and country.
   - Data sent: User-selected city and country names.
   - Purpose: Displaying localized prayer times.
   - Links: [Terms of Service](https://aladhan.com/credits-and-terms)

2. CountriesNow API: Used to retrieve lists of popular cities for country-specific pages.
   - Data sent: User-selected country name.
   - Purpose: Providing city navigation for users.
   - Links: [Terms of Service](https://countriesnow.space/) | [Privacy Policy](https://countriesnow.space/)

== Changelog ==

= 1.0.0 =
* Initial release.
* Basic prayer time fetching and Urdu/English support.

== Upgrade Notice ==

= 1.0.0 =
Highly recommended for better UI/UX and for live clock alignment.