Temple Directory Plugin — Setup & Usage Guide

KWB Temple Directory — Setup & Usage Guide

Documentation for the plugin powering the searchable temple directory on this site. v3.2.0

This page documents the KWB Temple Directory WordPress plugin, which renders the searchable, filterable temple directory found at khatuwalebaba.in/khatu-shyam-temple-directory/. If you’re a developer or site owner looking to understand how it works, customize it, or reuse the approach, this guide covers everything.

What it does

  • Displays a searchable, filterable directory of locations via a single shortcode
  • Every entry renders as static, crawlable HTML — fully visible to search engines and AI crawlers even with JavaScript disabled
  • Live search, region filter, sort (most-reviewed / name / region), and quick filter chips (Verified / 100+ reviews / 500+ reviews)
  • “Show More” pagination so large datasets don’t overwhelm the page on load
  • Automatic Schema.org ItemList structured data (JSON-LD), including GeoCoordinates and AggregateRating where available
  • No external network requests — all CSS and JavaScript is bundled and served from this site

Installation

  1. Upload and activate the plugin through the WordPress Plugins screen
  2. Add the shortcode [kwb_temple_directory] to any page or post
  3. That’s it — the dataset ships bundled with the plugin, so there’s no upload step or data entry required to get started

Customizing the display

Go to Settings → Temple Directory in the WordPress admin sidebar to configure:

Text

Setting Purpose
Heading The main title shown above the search box
Subtitle Supporting text below the heading. Use {count} as a placeholder — it’s replaced with the live entry count
Footer credit line Optional text shown at the bottom of the directory. Blank by default

Colors

Three color pickers let the directory match your site’s own theme instead of the default orange/maroon palette:

Setting Controls Default
Accent color Buttons and highlighted badges #D4521A
Dark accent color Header banner background and location name text #7B1E1E
Background tint Subtle background for info boxes #FFF3E7

Data format

The dataset ships as a bundled JSON file (data/kwb-temple-data.json inside the plugin folder). Each entry is a simple object:

{
  "n": "Location Name",
  "a": "Full address or description",
  "s": "Region or state label",
  "r": 4.5,
  "c": 1200,
  "lat": 28.7041,
  "lon": 77.1025,
  "route_url": "https://example.com/directions/",
  "train_url": "https://example.com/train-info/",
  "detail_url": "https://example.com/location-page/"
}

Only n (name) and a (address) are required. Every other field is optional — anything not provided is simply omitted from that entry’s card.

Field Meaning Required
n Name Yes
a Address / description Yes
s Region / state label (used to build the filter dropdown) No
r Rating (e.g. 4.5) No
c Review count No
lat, lon Coordinates, used for Schema.org GeoCoordinates No
route_url Link labeled “Plan Route” No
train_url Link labeled “Train Schedule” No
detail_url Link labeled “Details” No

Updating the dataset

Since the data ships bundled with the plugin rather than through an upload screen, updating it means replacing data/kwb-temple-data.json with a refreshed version and reinstalling/updating the plugin. There is no per-entry admin editing screen — this is intentional, keeping the plugin simple for its primary use case of displaying a maintained, externally-curated dataset.

Technical notes

  • No CPT, no per-entry database records. All entries are read directly from the bundled JSON file at render time.
  • No external requests. No font CDNs, no tracking, no third-party scripts.
  • Crawlable by design. All entries render as real HTML in the page source — nothing depends on JavaScript execution to be visible to search engines or AI crawlers.
  • Assets only load where needed. CSS/JS are only enqueued on pages that actually contain the [kwb_temple_directory] shortcode.

KWB Temple Directory plugin — built for KhatuWaleBaba.in.