=== Hindi Quran Viewer ===
Contributors: devcv
Tags: quran, hindi quran, arabic quran, islam, religious, translation, offline
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.2
Stable tag: 1.2
License: GPL2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin to display Quranic verses in Arabic, Hindi, and English, stored locally for offline access.

== Description ==
Hindi Quran Viewer allows you to embed Quranic verses in Arabic, Hindi, and English into your WordPress site. The plugin stores all data locally in a database, enabling offline access after an initial import. Key features include:
- Display verses using the `[hindi_quran_viewer]` shortcode.
- Verses shown in Arabic, Hindi, and English.
- Real-time search for Surahs and verses with result counts.
- Light/dark theme toggle with user preference persistence.
- Responsive design for mobile and desktop.
- Local database storage for offline access.
- Admin interface to import Quranic data.
- Secure AJAX requests with nonce verification.
- Search history stored locally.

== Installation ==
1. Upload the `hindi-quran-viewer` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to Settings > Quran Viewer to import Quranic data into the database.
4. Use the shortcode `[hindi_quran_viewer]` to display Quranic verses.

== Frequently Asked Questions ==
= How do I use this plugin? =
Use the shortcode `[hindi_quran_viewer]` in any post or page. Ensure you import data first via the admin settings.

= How do I import data? =
Go to Settings > Quran Viewer and click "Start Data Import" to populate the database with Surahs and verses.

= Can I customize the styling? =
Yes, edit the CSS file in the `assets/` folder.

= Does it support dark mode? =
Yes, toggle between light and dark themes using the button in the UI.

= Does it work offline? =
Yes, after importing data, the plugin works offline as all data is stored locally.

== Screenshots ==
1. Quran Viewer interface with Surah list and verse display (Arabic, Hindi, English).
2. Dark mode view with search functionality.
3. Admin settings page for data import.

== Changelog ==
= 1.2 =
* Added Arabic translations for verses, displayed before Hindi and English.
* Updated local database schema to store Arabic text.
* Enhanced verse search to include Arabic text.

= 1.1 =
* Added local database storage for Surahs and verses.
* Implemented admin settings page for data import.
* Enabled offline access after data import.
* Added theme toggle for light/dark modes.
* Implemented real-time Surah and verse search with result counts.
* Added search history storage.
* Improved caching with WordPress transients.
* Enhanced responsive design.

= 1.0 =
* Initial release.

== Upgrade Notice ==
= 1.2 =
Adds Arabic translations, displayed before Hindi and English, with updated database schema and search functionality.

= 1.1 =
Adds local database storage, offline access, and an admin interface for data import, along with theme toggle, enhanced search, and responsive design.

== External Services ==
This plugin requires a one-time import from the following third-party APIs to populate the local database. After import, no external services are used:

1. **AlQuran Cloud API**  
   - Purpose: Fetches Surahs and Ayahs in Arabic, Hindi, and English for initial import.  
   - API Endpoint: `https://api.alquran.cloud/v1/surah/`  
   - Data sent: Only Surah ID.  
   - No personal data is collected.  
   - Terms of Use: [https://alquran.cloud/privacy](https://alquran.cloud/privacy)

2. **Quran.com API**  
   - Purpose: Retrieves the list of Quran Surahs for initial import.  
   - API Endpoint: `https://api.quran.com/api/v4/chapters`  
   - Data sent: None (GET request only).  
   - No personal data is collected.  
   - Terms of Use: [https://quran.com/privacy](https://quran.com/privacy)