=== KWB Temple Directory for Khatu Shyam Temples ===
Contributors: khatuwalebaba
Tags: directory, listings, temple, search, shortcode
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A searchable, filterable directory of 844 Khatu Shyam Ji temples across India. Install, add one shortcode, done — data ships bundled.

== Description ==

KWB Temple Directory renders a fast, searchable, filterable directory of **844 Khatu Shyam Ji temple locations across India** via a single shortcode: `[kwbtd_temple_directory]`. The dataset ships bundled with the plugin itself — there is no upload step, no import wizard, and nothing to configure to get started.

Built for pilgrimage, devotional, and travel websites that want to give visitors a complete, region-wise view of Khatu Shyam mandirs — from the main Khatu Dham in Sikar (Rajasthan) to local temples in every state.

**Key features:**

* Live search box (matches temple name, address, and region)
* Region/state filter dropdown
* Sort by most-reviewed, name, or region
* Quick filter chips (All / Verified / 100+ reviews / 500+ reviews)
* "Show more" pagination for large datasets
* Every entry renders as static, crawlable HTML — fully visible to search engines even with JavaScript disabled
* Automatic Schema.org `ItemList` structured data (JSON-LD), including `GeoCoordinates` and `AggregateRating` where available
* Admin-configurable heading, subtitle, footer credit text, and colors (accent, dark accent, background tint) so the directory matches your theme
* Lightweight: one CSS file, one JS file, no jQuery dependency
* No external network requests, no tracking, no third-party font or script CDNs — everything loads from your own site
* Translation-ready (`.pot` file included)

**Privacy:** This plugin makes no external requests and collects no visitor data.

== Installation ==

1. Upload and activate the plugin through the WordPress Plugins screen.
2. Add the `[kwbtd_temple_directory]` shortcode to any page or post.
3. Optionally, go to Settings → Temple Directory to customize the heading, subtitle, footer credit text, and colors.

== Frequently Asked Questions ==

= How do I display the directory? =

Add the shortcode `[kwbtd_temple_directory]` to any page or post. That's all — the bundled dataset renders immediately.

= How do I update the temple data? =

The dataset lives in this plugin's own `data/kwb-temple-data.json` file. Updating it means updating the plugin itself — each new plugin version ships a refreshed data file, so keeping the plugin updated keeps the data current.

= Can visitors search and filter without page reloads? =

Yes. Search, region filter, sorting, and the quick filter chips all work instantly in the browser. The initial list is still rendered server-side as static HTML, so search engines index every entry.

= Does this load any external fonts or scripts? =

No. All CSS and JavaScript is bundled with the plugin and loaded from your own site. There are no calls to external CDNs, APIs, or tracking services.

= Can I change the colors to match my theme? =

Yes. Settings → Temple Directory includes color pickers for the accent color, dark accent, and background tint.

= Is the output SEO-friendly? =

Yes. Entries render as crawlable static HTML, and the plugin outputs Schema.org `ItemList` JSON-LD structured data automatically, with `GeoCoordinates` and `AggregateRating` included where the data provides them.

== Screenshots ==

1. The temple directory with live search, region filter, sorting, and quick filter chips.
2. A directory entry card with address, region, and review information.
3. Settings screen — heading, subtitle, footer credit, and color options.

== Changelog ==

= 3.2.0 =
* Default results-per-page changed from 60 to 50
* Fixed a script-tag injection risk in JSON-LD schema output (a location name/address containing "</script>" could previously break out of the script tag)
* Removed load_plugin_textdomain() call (WordPress.org auto-loads translations for hosted plugins since 4.6)
* register_setting() now uses explicit sanitize_callback array syntax
* Internal version constant synchronized with plugin version (asset cache-busting)

= 3.1.0 =
* Added admin-configurable colors (accent, dark accent, background tint) so the directory can match any site's own theme

= 3.0.0 =
* Simplified architecture: data now ships bundled with the plugin directly. No upload step, no custom post type, no per-entry database records.

= 2.0.0 =
* (Superseded by 3.0.0 — CPT-based approach retired in favor of a simpler bundled-data model.)

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 3.2.0 =
Security hardening in JSON-LD output plus minor fixes. Recommended for all users.
