=== Bible Reference Tooltips ===
Contributors: jasoneugenegarrison
Tags: bible, scripture, references, tooltips, verses
Requires at least: 6.0
Tested up to: 7.0.1
Requires PHP: 7.4
Stable tag: 1.1.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detect Bible references in WordPress content and show local hover cards from open Bible texts stored in your own database.

== Description ==

Bible Reference Tooltips scans WordPress content for Bible references such as John 3:16, Romans 8:28, or James 1:5. Detected references can be underlined and shown with hover or keyboard-focus tooltip cards.

Verse text is looked up from local open/public-domain Bible texts installed into your WordPress database. The plugin currently supports World English Bible, King James Version, American Standard Version, and Young's Literal Translation imports from eBible VPL packages.

Features include:

* Public-site Bible reference detection.
* Optional WordPress admin Bible reference detection.
* Hover and focus tooltip cards.
* Local verse storage with no remote lookup required during page views.
* Multiple installed translations with quick-switch tabs in the card.
* Configurable scan selectors, skipped tags, comment scanning, tooltip theme, and verse range limit.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate Bible Reference Tooltips in WordPress.
3. Open Settings > Bible Reference Tooltips.
4. Install one or more open Bible texts.
5. Adjust scanning and tooltip settings as needed.

== Frequently Asked Questions ==

= Does this require an external Bible API? =

No. Public page views use local verse rows stored in your WordPress database. The admin import tool downloads open Bible text packages when you choose to install or update a translation.

= Which translations are included? =

The plugin can import WEB, KJV, ASV, and YLT from open eBible VPL packages. Modern commercial translations generally require separate licensing and are not bundled.

= Does it work without a specific theme? =

Yes. The plugin is standalone and appears under Settings in the WordPress admin.

== Changelog ==

= 1.1.5 =

* Added the public workspace conventions and tracked Docker test lab as the bounded release workflow.
* Added a settings migration that removes retired external-link options while preserving current tooltip settings.
* Updated the standalone changelog to match the public 1.1.x transition history.

= 1.1.4 =

* Removed external Biblia, ref.ly, and Logos link generation from the public plugin.
* Added optional WordPress admin scanning with separate admin scan selectors.
* Improved matching-rule defaults for capitalization, chapter-only references, and public comments.
* Generalized the open text policy language.

= 1.1.3 =

* Fixed browser REST lookups when WordPress provides a query-string REST route.
* Improved local test-page layout and removed native browser title tooltips from test references.

= 1.1.2 =

* Split eBible VPL source-code resolution from human Bible reference parsing.
* Added exact source-code handling for compact eBible book identifiers such as SOL, EZE, MAR, JOH, JAM, 1JO, 2JO, and 3JO.
* Improved compact reference detection for forms such as Mark10:45 and 2Jn1:6.

= 1.1.1 =

* Added exact eBible VPL aliases for source abbreviations that were not standard display abbreviations.
* Fixed imports for books such as Mark and Ezekiel when VPL source files use compact book codes.

= 1.1.0 =

* Forked the internal package into a standalone public plugin.
* Renamed the plugin, slug, text domain, REST namespace, handles, options, and local table for public distribution.
* Removed internal menu placement and logging dependencies.
* Added public release metadata and WordPress.org-oriented readme.
