=== TBS Scripture Tagger ===
Contributors: thebiblesays
Donate link: https://thebiblesays.com
Tags: bible, scripture, tooltip, references, theology
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically converts plain-text Bible references into interactive links with hoverable verse previews from The Bible Says.

== Description ==

TBS Scripture Tagger scans your website content and transforms plain-text Bible references (like “John 3:16” or “Genesis 1:1”) into interactive links.  
When users hover or tap on a reference, a clean tooltip appears with the verse text retrieved directly from *The Bible Says API*.

This plugin is inspired by tools like Blue Letter Bible’s ScriptTagger, but fully optimized for modern browsers and multilingual usage (English, Portuguese, and Chinese).

**External Services**
This plugin can connect to *The Bible Says API* to fetch verse previews. You must explicitly enable this in **Settings → TBS Scripture Tagger** before any external requests are made.

* Service: The Bible Says API
* Service URL: https://content-api.thebiblesays.com
* Data sent: the Bible reference and detected language code. The browser may also include the page URL as a standard referrer header.
* Terms of Use & Privacy Policy: https://thebiblesays.com/about

**Key Features**
* Automatically detects and links Bible references.
* Displays hoverable tooltips with verse previews.
* Ignores already linked references (optional).
* Excludes specific HTML tags and CSS classes.
* Detects user language for correct book name and API.
* Lightweight and fast — no external dependencies.
* Compatible with all major WordPress themes.

**Example**
> Add “John 3:16” or “Genesis 1:1” to any post or page, and the plugin will instantly make it interactive.

== Installation ==

1. Upload the `tbs-scripture-tagger` folder to your `/wp-content/plugins/` directory, or install it through the WordPress admin (“Plugins → Add New → Upload Plugin”).
2. Activate the plugin through the “Plugins” menu in WordPress.
3. Go to **Settings → TBS Scripture Tagger** to configure:
   * Hyperlink Mode (convert all, hover-only, or none)
   * Open links in a new tab
   * Ignore existing hyperlinks
   * Exclude specific HTML tags or CSS classes
   * Dark/light/auto tooltip theme
4. Add any Bible reference (e.g., “Romans 8:28”) to a post or page — the plugin will automatically tag it.

== Frequently Asked Questions ==

= Does this plugin use any external services? =
Yes. It can fetch Bible verses from The Bible Says API at https://content-api.thebiblesays.com, but only after you enable external requests in the plugin settings.

= Where can I find the Terms and Privacy Policy for the external service? =
https://thebiblesays.com/about

= Can I use it in other languages? =
Yes, it automatically detects if your website is in English (`en`), Portuguese (`pt`), or Chinese (`zh`) and adjusts accordingly.

= Will it overwrite my existing hyperlinks? =
No — by default, the plugin ignores existing `<a>` tags that already contain Bible references.  
You can toggle this behavior from the settings page.

= Does it slow down my website? =
Not at all. The script is lightweight, async-loaded, and optimized for minimal impact on page performance.

== Changelog ==

= 1.0.0 =
* Initial public release.
* Added automatic verse detection and hover tooltip.
* Added admin settings for tag exclusions, dark mode, and hyperlink behavior.
* Multilingual support (English, Portuguese, Chinese).

== Upgrade Notice ==

= 1.0.0 =
First stable version of TBS Scripture Tagger.

== License ==

This plugin is open-source software licensed under the GPLv2 or later.  
You are free to modify and redistribute it under the same license.

