Exploring the Mystery

A web key is required to use the ESV plugin. The default key of IP will work for most users, but if you get an error that you have exceeded the limit for daily passage retrievals, you may want to apply for a personal ESV Web Key. You can get one at the ESV Bible Web Service. If you have a personal key, enter it in the ESV Web Key input field.

The passage retrieval options change the way passages are retrieved from the ESV Web Service. You can mouse over the option name for a brief description of that option or get more information at the ESV Web Service API page. Changing these options will not affect passages that have already been retrieved and stored in the database. If you want all of your ESV references to reflect the changes you will need to clear all stored passages in the manage database/settings section below.

While you can specifically inform the plugin about Bible references in your post using the [esvbible] tag, it also has the ability to automatically find and format any Scripture references in your post. With the Format option you tell the plugin what you want it to do with any Scripture references it finds. Below are examples of the different options.

Examples:

Tooltip

John 3:16

Inline

John 3:16

16 “For God so loved the world, that he gave his only Son, that whoever believes in him should not perish but have eternal life. (ESV)

Block

John 3:16

16 “For God so loved the world, that he gave his only Son, that whoever believes in him should not perish but have eternal life. (ESV)

Link

John 3:16

Ignore

John 3:16

There are two ways the plugin can handle Bible references:

1. Process references at runtime Does not change the post in the database: The plugin will scan your posts when they are viewed by a visitor and will search for Bible references or the [esvbible] tag. This would be a little slower (probably not by much) than option two, and it does not change how your post is stored in the database.
2. Process references when saving posts Modifies posts in the database: The plugin will scan your posts when they are saved and will modify all references then, making them links that are easier for the plugin to recognize. The plugin will then scan posts when visitors view them and will look only for the specially formatted link. This will then be converted to the Bible text/tooltip/passage depending on your settings.

Option two is a little faster than option one, but option one provides the most flexibility.

For the option Search for and process Scripture references saved with Option Two: If a post has been modified using Option Two and you later switch to Option One, the runtime script will not automatically recognize the special link formed with Option Two. Select the checkbox next to Option One if you want the runtime script to also look for the special link. Only use this option if you have already had posts modified using Option Two.

Prior to version 3 of the ESV Plugin, various tags were used to tell the plugin how to display Bible passages ([bible], [biblelink], [bibleblock], [bibleignore]. These tags are not used by default in version 3, but if you are upgrading from an older version and you used those tags you may want to turn on backward compatibility by checking the box below. This will slow the plugin down a little since it will have to search the post for each tag, but this may be preferred if you used the old tags extensively.

If you clear stored passages it will remove all of the ESV passages that have been cached by the plugin. You might want to do this from time to time to keep the ESV database table from growing too large. Also, if you ever change the Passage Retrieval Options you might want to clear stored passages so that it will retrieve previously cached passages using the new settings.

If you decide to clear all, this will remove the ESV database table (will not effect any of your WordPress data) and will remove all ESV Plugin settings from the system. You might want to do this if you want to make a fresh start with plugin settings, or if you want to remove the plugin from the system.