=== Aistore Bhagavad Gita ===
Contributors: susheelhbti
Plugin URI: http://www.aistore2030.com/
Author URI: http://www.aistore2030.com/
Tags: bhagavad gita, gita, hinduism, scripture, verse of the day, spiritual
Requires at least: 5.6
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 2.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish the complete Bhagavad Gita on your WordPress website with chapters, verses, audio, search, favorites, social sharing, and daily email.

== Description ==

**Aistore Bhagavad Gita** is a feature-rich WordPress plugin that brings the timeless wisdom of the Bhagavad Gita to your website visitors.

= Features =

* 📖 Full Chapter & Verse Browser — Navigate all 18 chapters and 700 verses with an attractive card grid
* 🎵 Audio Recitation — Plays MP3 audio for each verse (add your own audio files)
* 🕉 Verse of the Day — A new verse automatically featured every day
* 🎲 Random Verse — Display a random verse with one-click refresh
* 🔍 Live Search — Instant AJAX search across all verse text AND chapter names
* ★ Favorites — Logged-in users can save and revisit favorite verses
* 📱 Social Sharing — Share verses on Facebook, Twitter, WhatsApp, and Telegram
* 📬 Daily Email Subscription — Visitors subscribe to receive the daily verse by email, with working unsubscribe
* 🗂️ Multiple Translations — Side-by-side translation tabs
* 🖼️ Chapter Images — Attractive card images for each chapter
* 📋 Commentary — Display commentary/purport for each verse
* 🔗 Sidebar Widget — Verse of the Day or Random Verse in any widget area
* 📱 Fully Responsive — Optimised for all screen sizes
* 🔒 Secure — CSRF protection, capability checks, proper output escaping throughout

= Shortcodes =

* [AistoreBhagavadGita] — Full chapter & verse browser
* [AistoreVerseOfDay]   — Verse of the day block
* [AistoreRandomVerse]  — Random verse with refresh button
* [AistoreSearch]       — Standalone live-search box
* [AistoreFavorites]    — User's saved verses (requires login)
* [AistoreSubscribe]    — Email subscribe form for daily verse

== Installation ==

1. Upload the aistore-bhagavad-gita folder to wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Dashboard > Bhagavad Gita to configure settings
4. Create a page and add the shortcode [AistoreBhagavadGita]
5. Select that page in Settings so share links and email links work correctly

= Adding Your Data Files =

Place your JSON data files inside the plugin's data/ folder:

* data/chapters.json     - Chapter list
* data/verse.json        - All verses
* data/commentary.json   - Commentaries (optional, empty fallback included)

= Adding Audio =

Place MP3 files at: data/verse_recitation/{chapter_id}/{verse_number}.mp3
Example: data/verse_recitation/1/1.mp3

= Adding Chapter Images =

Place JPG files at: images/chapter1.jpg through images/chapter18.jpg
Also add images/default.jpg as a fallback for missing chapter images.

== Changelog ==

= 2.0.1 =
* FIX: file_exists() now correctly uses filesystem path (not URL) for audio check
* FIX: rawurlencode() used for social share links (security improvement)
* FIX: Capability check added to all admin pages
* FIX: Email cron schedules from tomorrow 08:00, not immediately on activation
* FIX: commentary.json empty fallback included so missing file causes no errors
* NEW: Transient caching for JSON files (24-hour cache, greatly improves performance)
* NEW: Search now searches chapter names in addition to verse text
* NEW: Secure tokenised unsubscribe handler
* NEW: Loading state on nav buttons and subscribe button
* NEW: nl2br() applied to verse text to preserve line breaks
* NEW: Database indexes for performance
* NEW: Stats panel in admin sidebar

= 2.0.0 =
* Complete rewrite with all new features

= 1.0.0 =
* Initial release