What Does It Do?
The "BLB ScriptTagger" is a free tool that you can integrate into your website or blog to automatically create a hover-over display for all Bible references on the page. The hover-over reveals the verse text and provides a link for further study at the Blue Letter Bible website.
This script will scan the text of your webpage for verse references such as this: Romans 1:16-18 or Jhn 3:16. It will then link them and automatically create and enable the hover-over.
You can set your preferred translation and various other settings. The script will also detect valid translation abbreviations connected with the reference, such as: Zephaniah 3:17 ESV
Other reference styles that this will automatically catch are: Deut 8:2-6, 10, 17-18 and Genesis 1:26-28; 3:15.
1. Website / Non-Wordpress Blog Installation
Copy the following lines of code into the <head> tag or footer of your webpage. If you use an include or template for your website, insert these lines of code into that template.
* The first line (bold portion) is the only required code to copy and paste into your webpage. The remaining lines represent the "additional settings" for BLB ScriptTagger operation.
BLB.Tagger.Translation = 'NKJV';
BLB.Tagger.HyperLinks = 'all'; // 'all', 'none', 'hover'
BLB.Tagger.HideVersions = false;
BLB.Tagger.TargetNewWindow = true;
BLB.Tagger.Style = 'par'; // 'line' or 'par'
For an explanation of the additional settings that you can define between the second set of <script> and </script> tags, see the table below:
|BLB.Tagger.Translation||'NKJV'||What default translation should we display the verses in?|
What should we do with references that are already links with an <a> tag?
|BLB.Tagger.HideVersions||false||Do you want to hide version tags attached to the references?|
|BLB.Tagger.TargetNewWindow||true||When a link in the hover-over is clicked, should it open in a new window?|
Do you want the verses to show up line-by-line, or in paragraphs?
2. WordPress Plugin Installation
We have created a WordPress plugin for those who have created a website or blog through WordPress.org.
To implement this plugin, you will need to follow just a few, simple steps:
|1. Click here to download the BLB WordPress plugin|
|2. Login to manage your WordPress site or blog|
|3. From the Dashboard, navigate to "Plugins"|
|4. Find the "Add New" button near the top of the page|
|5. Click on "Upload"|
|6. "Browse" for the .ZIP file you just downloaded via the above link. Upload this file. You should then see a message telling you that the upload was successful|
|7. Finally, looking at your list of plugins, find "BLB ScriptTagger" and click "Activate"|
You can then adjust the settings (your preferences) for how the BLB ScriptTagger plugin will work by following these steps:
|1. From the Dashboard, navigate to "Settings"|
|2. Find "BLB ScriptTagger" in your list of plugins|
|3. Adjust your settings as you see fit|
|4. Click "Save Changes" when finished|
Additional Notes on Usage & Linking
Note that pre-anchored references that do not contain the full reference will not get a hover tooltip. For example, in the following link, the "25" will not have a tooltip:
<a href="./Bible.html">Romans 1:16-18</a>, <a href="./Verse.html">25</a>
To resolve this issue, either:
1. Remove the anchor tags
2. Add "Rom 1:" in front of the "25" (for this example)
- The tooltip will only return up to seven (7) verses. If a verse range is longer than seven verses, then a "More »" link will be displayed, linking the reader to the whole chapter on the Blue Letter Bible website. For example, hover over the following reference: Psalm 119 NLT.
- For verse display in Spanish, specify "RVR" as the value for BLB.Tagger.Translation. Or, add "RVR" at the end of a verse reference, like this: Mark 10:45 RVR
- The Greek and Hebrew texts are not available at this time.