SCRIPTURIZER PLUGIN FOR WORDPRESS 1.2+ Glen Davis - www.glenandpaula.com http://dev.wp-plugins.org/wiki/Scripturizer for the latest documentation ********************************************************************************************* 1.0 WHAT IT DOES ********************************************************************************************* Scripturizer will convert Bible references in your posts and comments into hyperlinks to online Bibles. For example, it will change John 3:16 into something like John 3:16 Online Bibles currently supported are * Bible Gateway http://www.biblegateway.com/ * Bible.org http://www.bible.org/ (the NET Bible) * The English Standard Version http://www.gnpcb.org/esv/ * Oremus Bible Browser http://bible.oremus.org/ (the New Revised Standard Version) * Nestle-Aland 26th edition Greek New Testament http://www.zhubert.com * The Septuagint Greek Old Testament http://www.zhubert.com You can customize the plugin to use your favorite Bible translation or to include links useful for users of Logos Bible Software by editing scripturizer.php and adjusting the configuration parameters near the top of the file. ********************************************************************************************* 2.0 CREDIT ********************************************************************************************* This plugin was derived from Heal Your Church Website's Scripturizer plugin for Movable Type. http://www.healyourchurchwebsite.com/archives/001176.shtml additional information is in credits.txt ********************************************************************************************* 3.0 FILES ********************************************************************************************* scripturizer.php LibronixLink.gif scripturizer_test.php readme.txt credits.txt ********************************************************************************************* 4.0 REPORT ERRORS ********************************************************************************************* http://dev.wp-plugins.org/newticket ********************************************************************************************* 5.0 INSTALLATION ********************************************************************************************* 5.1 Basic: 1) download scripturizer.php and put it in your Wordpress plugins directory: - Assuming Wordpress is installed in http://yoursite/wordpress http://yoursite/wordpress/wp-content/plugins 2) edit the file to change the default translation (initially NIV) and other basic options: - Default translation: - Translation to which scripturizer defaults if no translation is detected in the Scripture reference - Look for the following line: "define('DEFAULT_BIBLE_TRANSLATION','NIV');" - Change 'NIV' to any of the recognized translation acronyms (see Section 6.2 below) - Dynamic substitution - Controls whether scripturizer adds links: - Each time a post is viewed (dynamic) - At the time a post is created or edited (static, permanently edits post) - Look for the following line: "define('DYNAMIC_SUBSTITUTION',TRUE);" - TRUE: Dynamic substitution (recommended) - FALSE: Static/permanent substitution - Note that Dynamic Substitution allows for changes in default translation as well as changes in linked website interfaces - Libronix Support - Determines whether or not scripturizer adds Libronix Links - http://www.logos.com/support/lbs/weblinking - Look for the following line: "define('LIBRONIX_LINKS',FALSE);" - TRUE: Libronix Links added - FALSE: Libronix Links not added 3) activate the plugin using the Wordpress administration interface - From the Wordpress Dashboard: Manage / Plugins 5.2 Libronix Users: 1) download LibronixLink.gif and put it in your wp-content directory. 2) download scripturizer.php and put it in your wp-content/plugins directory. 3) change define('LIBRONIX_LINKS',FALSE) to TRUE 4) change the other defines, if you are so inclined 5) activate the plugin using the Wordpress administration interface 5.3 Developer: 1) If you see a feature you want to add (or a bug you want to fix), download scripturizer.php to a web-accessible directory 2) Also download scripturizer_test.php and put it in the same directory 3) Hack away and check your work by viewing scripturizer_test.php in your browser 4) Submit any improvements at http://www.wp-plugins.org/ (also submit improvements to the admittedly rudimentary scripturizer_test.php) ********************************************************************************************* 6.0 HOW TO USE SCRIPTURIZER ********************************************************************************************* 6.1 How Scripturizer Recognizes Scripture References: 1) Scripturizer will recognize Scripture references that conform to somewhat loose conventions: - [Book] [Chapter] - [Book] [Chapter]:[Verse] - [Book] [Chapter]:[Verse]-[verse] 2) Where [Book] can be a full name or an abbreviation, with prefix as applicable. Note that prefixes can be in several formats: - 1, 2, 3 - I, II, II - First, Second, Third - 1st, 2nd, 3rd 3) Scripturizer will recognize most common book abbreviations. - NOTE: All abbreviated references to Judges should include the letter 'g' in order to differentiate between Judges and Jude. 4) Scripturizer can also recognize translation acronyms following Scripture references: - [Reference] [Translation] - [Reference] ([Translation]) 6.2 How Scripturizer Determines Scripture Translation: 1) If no translation reference is found, Scripturizer uses the default translation (see Section 5.1 above) 2) If a recognized translation reference is found, Scripturizer uses the referenced translation. Recognized translations/acronyms include the following: - NIV (New International Version) - NASB (New American Standard Bible) - HCSB (Holman Christian Standard Bible) - AMP (Amplified Version) - NLT (New Living Translation) - KJV (King James Version) - CEV (Contemporary English Version) - NKJV (New King James version) - KJ21 (21st Century King James Version) - ASV (American Standard Version) - WE (Worldwide English New Testament) - YLT (Young's Literal Translation) - DARBY (Darby Translation) - Darby (Darby Translation) - WYC (Wycliffe New Testament) - NIV-UK (New International Version - United Kingdom) - MSG (The Message Bible) - NIRV (New International Reader's Version) - NRSV (New Revisted Standard Version) - NET (NET Bible) - ESV (English Standard Version) - NA26 (Nestle-Aland 26th edition Greek New Testament) - LXX (Septuagint Greek Old Testament)