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.
Examples
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.
Installation Instructions
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.
<script src="http://www.blueletterbible.org/scripts/blbToolTip/BLB_ScriptTagger-min.js" type="text/javascript"></script>
<script type="text/javascript">
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'
</script>
For an explanation of the additional settings that you can define between the second set of <script> and </script> tags, see the table below:
| Attribute | Default | Description |
| BLB.Tagger.Translation | 'NKJV' | What default translation should we display the verses in? |
| BLB.Tagger.HyperLinks | 'all' |
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? |
| BLB.Tagger.Style | 'par' |
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.
