Description
This plugin provides the ability to embed Bible reading plans into a post or page using shortcode of the form [bible-reading-plan source="DBP" reading_plan="mcheyne" bible_id="ENGNAS" bible_all_audio_id="" bible_ot_audio_id="" bible_nt_audio_id=""]. The last three parameters are new in this version and provide access to audio versions of the Scriptures, this shortcode applies only to the DBP source and provides access to over 2000 Bible versions in nearly 1900 languages, with more versions and languages being added regularly. Three sources for the Scriptures displayed for each plan are available: American Bible Society API, Version 1 (API.Bible), The Bible Brain (aka Digital Bible Platform) API, Version 4 (faithcomesbyhearing.com/bible-brain/developer-documentation), and the ESV Bible Web Service API, Version 3 (api.esv.org). See the screenshots for an example of how to use this plugin.
The American Bible Society API provides more than 20 English language versions (with the potential for more via the Digital Bible Library to acquire the necessary licenses) and the potential of over 1600 languages in a future version of this plugin The Bible Brain API provides 10 English versions and access to over 2000 Bible versions in nearly 1900 languages. In addition, it has audio versions and the potential for video for many of the versions. The ESV Bible Web Service API, Version 3 also provides audio as well as better formatting control. Naturally it provides only the English Standard Version.
It is hoped that persons with skills in other languages will come forward to localize this plugin for the available languages. (I.e., Translate things like the instructions on the “Settings” page, the reading plan names, and copyright statements.)
The values of reading_plan can be:
back-to-the-bible-chronological - Back to the Bible Chronological
bcp19-acna-evening - Book of Common Prayer, 2019, Anglican Church in North America -- Evening Prayer
bcp19-acna-morning - Book of Common Prayer, 2019, Anglican Church in North America -- Morning Prayer
bcp19-acna-twoyear - Book of Common Prayer, 2019, Anglican Church in North America -- Two Year Plan
chronicles-and-prophets - Chronicles and Prophets
daily-light-on-the-daily-path-evening - Daily Light on the Daily Path -- Evening
daily-light-on-the-daily-path-morning - Daily Light on the Daily Path -- Morning
every-day-in-the-word - Every Day In the Word
gospels-and-epistles - Gospel and Epistles
heart-light-ot-and-nt - Heartlight Old and New Testament
lsb - Literary Study Bible
mcheyne - M'Cheyne One-Year Reading Plan
one-year-chronological - One Year Chronological
pentateuch-and-history-of-israel - Pentateuch and History of Israel
psalms-and-wisdom-literature - Psalms and Wisdom Literature
through-the-bible - Through the Bible in a Year
The default reading plan is M’Cheyne One-Year Reading Plan.
We may add more plans in the future, but have created a premium plugin “Create Bible Reading Plans” (https://sllwi.re/p/1Il) to make it possible to create one’s own Bible reading plan for use in this plugin.
The values of source can be:
ABS - American Bible Society (API.Bible)
DBP - Bible Brain (aka Digital Bible Platform) (faithcomesbyhearing.com/bible-brain/developer-documentation)
ESV - ESV Bible Web Service API (api.esv.org)
The default source is DBP.
(Note that, in order to use these sources, you must obtain Access Keys from the American Bible Society, the Bible Brain, and/or the ESV Bible Web Service API. Instructions for doing so are on the Settings page for the plugin.)
If the source is ABS, the values of version can, at present, be:
ASV - American Standard Version
LXXup - Brenton English Septuagint (Updated Spelling and Formatting)
Brenton - Brenton English translation of the Septuagint
KJVCPB - Cambridge Paragraph Bible of the KJV
DRA - Douay-Rheims American 1899
EMTV - English Majority Text Version
FBV - Free Bible Version
GNV - Geneva Bible
OJPS - JPS TaNaKH 1917 (Old Testament only)
KJV-E - King James (Authorised) Version, Ecumenical
KJV-P - King James (Authorised) Version, Protestant
RV - Revised Version 1885
F35 - The English New Testament According to Family 35
T4T - Translation for Translators
WEBBE-C - World English Bible British Edition, Catholic
WEBBE-E - World English Bible British Edition, Ecumenical
WEBBE-O - World English Bible British Edition, Orthodox
WEBBE-P - World English Bible British Edition, Protestant
WEB-C - World English Bible, Catholic
WEB-E - World English Bible, Ecumenical
WEB-O - World English Bible, Orthodox
WEB-P - World English Bible, Protestant
WMB - World Messianic Bible
WMBBE - World Messianic Bible British Edition
The default verson is KJV-P.
If the source is DBP, the English language values of the version can, at present, be:
ENGESH – English Standard Version? – Hear the Word Audio Bible – Formatted Text
ENGESHN1DA – English Standard Version? – Hear the Word Audio Bible – Audio (New Testament)
ENGESHN1SA – English Standard Version? – Hear the Word Audio Bible – Audio HLS stream (New Testament)
ENGASV – American Standard Bible – Plain Text
ENGESVN2DA – English Standard Version? – Dramatized Audio (New Testament)
ENGESVO2DA – English Standard Version? – Dramatized Audio (Old Testament)
ENGESVO_ET – English Standard Version? – Plain Text (Old Testament)
ENGESVO1DA – English Standard Version? – Audio (Old Testament)
ENGESVN_ET – English Standard Version? – Plain Text (New Testament)
ENGESVN1SA – English Standard Version? – Audio HLS stream (New Testament)
ENGESVN1DA – English Standard Version? – Audio (New Testament)
ENGEVD – English Version for the Deaf – Plain Text
ENGNAS – New American Standard Bible (NASB) – Plain Text
ENGNLHO1DA – New Living Translation? – hsvn ci -m “Version n.n, whicher.BIBLE (women’s voices) – Audio (Old Testament)
ENGNLHO_ET – New Living Translation? – her.BIBLE (women’s voices) – Plain Text (Old Testament)
ENGNLHN_ET – New Living Translation? – her.BIBLE (women’s voices) – Plain Text (New Testament)
ENGNLTO_ET – New Living Translation?, Holy Sanctuary version – Plain Text (Old Testament)
ENGNLV – New Life Version (Easy to Read) – Plain Text (New Testament)
ENGNRSN1DA – New Revised Standard Version – Audio (New Testament)
ENGNRSN2DA – New Revised Standard Version – Dramatized Audio (New Testament)
ENGNRSN2DA16 – New Revised Standard Version – Dramatized Audio (New Testament)
ENGNRSO2DA – New Revised Standard Version – Dramatized Audio (Old Testament)
ENGWM1 – World Messianic Version – Plain Text
ENGWMV – Wycliffe Modern – Plain Text
EN1WEB – – Formatted Text
The default version is ENGNAS.
If the source is ESV, the value of the version naturally can only be ESV.
The page opens with the plan reading for the current date, as set on the client computer. An optional date picker calendar is available to enable users to choose readings for other dates.
See Gospel and Epistles and other reading plans on that site, the Daily Office at Habits of Grace, and the test pages at Test Site for the Bible Reading Plans Plugin for example implementations of this plugin.
This plugin requires JavaScript to be active.
License
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Screenshots
Sample input page for English Standard Version? from DBP — Dramatized Audio Book of Common Prayer, 2019, Anglican Church in North America — Two Year Plan.
Sample result page for English Standard Version? from DBP — Dramatized Audio Book of Common Prayer, 2019, Anglican Church in North America — Two Year Plan.
Settings page part 1.
Settings page part 2.
Settings page part 1 open to French DBP text and audio versions.
Sample input page for a reading plan in French with audio.
Sample result for page of a reading plan in French with audio.
Installation
-
Go to the add plugins option in your WordPress dashboard, search for and then add and activate the plugin.
-
Request Access Keys from the American Bible Society, the Bible Brain, and/or the ESV Bible Web Service API using the links given on the settings page.
-
Enter those Access Keys in their fields in the Bible Reading Plans Settings.
-
Select whether or not to use the various options on the settings page.
-
Create pages and/or posts containing the shortcode of the form
[bible-reading-plan source="DBP" reading_plan="mcheyne" bible_id="ENGNAS" bible_all_audio_id="" bible_ot_audio_id="" bible_nt_audio_id=""]or[bible-reading-plan reading_plan="mcheyne" source="DBP" bible_id="ENGESV"]. (It is recommended that the shortcode be placed in a shortcode block when using the WordPress Gutenberg Editor.)
NOTE THAT THE COPYRIGHT NOTICE FROM THE SOURCE OF THE TEXT MUST BE KEPT ON THE PAGE.
Reviews
Contributors & Developers
“Bible Reading Plans” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Bible Reading Plans” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
See “Upgrade Notice” above.