=== BibleAsk - Verse Tooltip ===

Contributors: bibleask
Tags: bible, references, scripture, links, tooltip
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turns Bible references in posts and pages into links to BibleAsk.org, with optional hover tooltips showing the verse.

== Description ==

BibleAsk - Verse Tooltip transforms plain Bible references in your content (e.g. "Genesis 1:1", "Colossians 3:3", "Psalm 23") into clickable links that point to the corresponding passage on BibleAsk.org. References in parentheses like (Colossians 3:3) are also supported.

**Features:**

* Auto-links common formats: book + chapter, book + chapter:verse, book + chapter:verse-verse
* Does not linkify references that already appear inside an HTML link or (optionally) inside a heading
* Supports references in parentheses, e.g. (John 3:16)
* Optional hover tooltip with reference and link (and optional verse text fetched from BibleAsk.org)
* Settings: open in new tab or same tab; apply to posts and/or pages; enable tooltip; show verse text in tooltip; tooltip can show BibleAsk logo and branding (logo files are bundled with this plugin)
* All JavaScript and CSS are included locally; no third-party CDNs for plugin assets
* Uses WordPress transients and in-memory cache to speed up tooltip verse loading

**Link behavior:**

* Control whether links open in a new tab
* Choose to apply linking to posts, pages, or both
* Optionally skip linking inside headings (h1–h6)
* Toggle the hover tooltip on or off
* Optionally show the full verse text in the tooltip (fetched from BibleAsk.org and cached)
* Optionally show BibleAsk logo and "BibleAsk" in the tooltip link text (credits default to hidden)

== External services ==

This plugin relies on **BibleAsk.org** (operated by BibleAsk), an external website that hosts Bible reading pages and related content.

**What it is used for**

* **Links:** Detected Bible references in your content become links to the matching passage pages on BibleAsk.org (HTTPS). When a visitor follows a link, their browser requests that page from BibleAsk.org like any normal website visit.
* **Optional verse text in the tooltip:** If you enable “Show verse text in tooltip,” your WordPress site requests the same passage URL from BibleAsk.org over HTTPS (server-side, using WordPress `wp_remote_get`). The response HTML is parsed to extract verse text for display in the tooltip. That request is only made when a visitor triggers the tooltip flow and the verse is not already cached. The URL contains only the passage location (book/chapter/verse path). This plugin does not send your users’ names, email addresses, WordPress account details, or other personal data to BibleAsk.org as part of that request.
* **Branding:** The settings screen and optional tooltip can display BibleAsk logos supplied as **image files inside this plugin** (they are not loaded from BibleAsk.org’s servers by default).

**Legal links for the service**

* Terms of Use: https://bibleask.org/terms-of-use/
* Privacy Policy: https://bibleask.org/privacy/

== Installation ==

1. Install from WordPress.org or upload the zip. The plugin directory matches the WordPress.org slug `bibleask-verse-tooltip`.
2. Activate "BibleAsk - Verse Tooltip" under Plugins.
3. Go to Bible References (sidebar) or Settings → Bible References to configure options.

== Frequently Asked Questions ==

= Where do the links go? =

Links point to BibleAsk.org (https://bibleask.org/bible/...) using their URL structure, e.g. /bible/genesis/1/1/ for Genesis 1:1.

= Is the verse text in the tooltip cached? =

Yes. Verse text is cached on the server (WordPress transients, 7 days) and in the browser for the current page, so repeat hovers load quickly.

== Changelog ==

= 1.0.6 =
* Setting to skip linking Bible references inside headings (h1–h6).
* Do not linkify references that already appear inside an HTML link.

= 1.0.5 =
* Readme: document external service BibleAsk.org (links, optional server-side verse fetch, branding), with Terms of Use and Privacy Policy links.
* Text domain aligned with plugin slug `bibleask-verse-tooltip` for translations and Plugin Check.

= 1.0.4 =
* Temporary text domain alignment while the directory slug was in transition (superseded by 1.0.5).

= 1.0.3 =
* Readme notes about plugin directory, reinstalling, and Plugin Check expectations (superseded by 1.0.4 text-domain alignment).

= 1.0.2 =
* Rely on WordPress automatic translation loading for hosted plugins (removes discouraged load_plugin_textdomain call).

= 1.0.1 =
* Load plugin translations via load_plugin_textdomain on plugins_loaded.

= 1.0.0 =
* Initial release. Auto-linking of Bible references, optional tooltips, optional verse text, BibleAsk branding in tooltip.

== Upgrade Notice ==

= 1.0.6 =
Optional heading exclusion and safer link handling inside existing anchors.

= 1.0.5 =
Documentation and text domain updated for WordPress.org review.

= 1.0.4 =
Interim release during slug transition (see 1.0.5).

= 1.0.3 =
Readme notes about plugin directory and Plugin Check.

= 1.0.2 =
Maintenance release: i18n loading aligned with WordPress.org / Plugin Check expectations.

= 1.0.1 =
Maintenance release: proper translation domain loading.

= 1.0.0 =
Initial release.