=== Literal Word BibleTagger ===
Contributors: literalword
Tags: bible, scripture, verse popup, bible verses, bible references
Requires at least: 5.2
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bible references in your content become links that show the verse text in a popup, powered by Literal Word.

== Description ==

BibleTagger scans your posts and pages for Bible references ("John 3:16", "Rom 5:8-10", "1 Cor 13") and turns each one into a link to the passage on [Literal Word](https://literalword.com), a clean, fast, distraction-free Bible website. Hovering (or tapping) a tagged reference shows the verse text in a small popup, so readers can see the passage without leaving your page.

Features:

* Recognizes standard reference formats, including abbreviations ("Rom", "1 Cor") and verse ranges
* Hover popup with the verse text; links open the full passage in context
* Choose the translation: NASB (1995), LSB, ESV, NKJV, or KJV
* Light, dark, or system popup theme
* Skips references inside headings, links, and code, and any areas you exclude
* No account, no API key, nothing to configure on the Literal Word side

Try it before installing: [live demo](https://literalword.com/bible-tagger-demo.html), a sample church page with every reference tagged. The snippet generator for non-WordPress sites is at [literalword.com/bibletagger](https://literalword.com/bibletagger).

== External services ==

This plugin is a client of the BibleTagger service provided by Literal Word. On every page of your site it loads the tagging script from `https://literalword.com/bible-tagger.js`. When a visitor hovers a tagged reference, the verse text is fetched from `https://literalword.com/api/verse`. Once per page load the script sends an anonymous usage signal to `https://literalword.com/api/tagger-ping` containing only your site's hostname (so Literal Word can see which sites use the widget); no visitor-identifying data is collected or stored. Tagged links point to passages on literalword.com.

The service is operated by Literal Word: [about and contact](https://literalword.com/about), [terms of service](https://literalword.com/terms), [privacy policy](https://literalword.com/privacy).

== Installation ==

= Easy install =

1. In your WordPress admin, go to Plugins, then Add New.
2. Search for BibleTagger.
3. Click Install Now, then Activate.

= Manual install =

1. Download the plugin.
2. Unzip it into your WordPress plugins directory (`/wp-content/plugins/`).
3. Activate Literal Word BibleTagger on the Plugins page.

That's it. References in your content are tagged automatically on every page. To pick your preferred Bible translation and options, go to Settings, then BibleTagger.

== Frequently Asked Questions ==

= Does it work with any theme or page builder? =

Yes. The script scans the rendered page, so it works with any theme and any editor that outputs normal HTML. Content rendered by JavaScript after the page loads is not scanned.

= Does it slow my site down? =

No. The script is small (under 40 KB), loads in the footer without blocking rendering, and fetches verse text only when a visitor hovers a reference.

= Can I keep it out of certain parts of my site? =

Yes. Add comma-separated CSS selectors to the Excluded areas setting; anything inside matching elements is left untouched. Headings, existing links, and code blocks are always skipped.

= Which Bible translations are available? =

NASB (1995), LSB, ESV, NKJV, and KJV.

== Screenshots ==

1. Pick your translation and options under Settings, then BibleTagger.
2. Every Bible reference on the page becomes a link, automatically.
3. Hover a tagged reference to read the verse in place.

== Changelog ==

= 1.0.0 =
* Initial release.
