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.HideTanslationAbbrev = 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:
| 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?
- 'all' - Point all linked references to the verse on Blue Letter Bible and create the hover-over effect.
- 'hover' - Leave the reference links alone, but still create the hover-over effect.
- 'none' - Leave the reference links alone altogether.
|
| BLB.Tagger.HideTranslationAbbrev |
false |
If a Scripture reference is followed by a translation abbreviation (e.g., John 1:1 ESV), do you want to hide the abbreviation?
Note: the BLB ScriptTagger will not automatically show translation abbreviations. This simply determines whether you want explicitly stated abbreviations hidden.
|
| 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?
- 'line' - Line-by-Line
- 'par' - Paragraph
|
2. WordPress Plugin Installation
We have created a WordPress plugin for those who have created a website or blog through WordPress.org.
Note: Plugins are only applicable to privately-hosted blogs and web sites using the WordPress.org software. Plugins are not permitted on WordPress.com for various security reasons.
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 RVR60.
- The Greek and Hebrew texts are not available at this time.
KJV - King James Version NKJV - New King James Version NLT - New Living Translation NIV - New International Version ESV - English Standard Version HCSB - Holman Christian Standard Bible NASB - New American Standard Bible RSV - Revised Standard Version ASV - American Standard Version YLT - Young's Literal Translation DBY - Darby Translation WEB - Webster's Bible HNV - Hebrew Names Version
Verse-Reference
Reference-Verse
Sort Canonically
Abbreviate Books
