Bible Reading Plans (bible-reading-plans) free WordPress plugin

This plugin provides the ability to embed Bible reading plans into a post or page using shortcode of the form [bible-reading-plan reading_plan="mcheyne" source="DBP" version="ESV"] or [bible-reading-plan reading_plan="mcheyne" source="DBP" bible_id="ENGESV"]. The latter form is new in this version, applies only to the DBP source, and provides access to over 1700 Bible versions in more than 1500 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.

This plugin is a fork of the Embed Bible Passages plugin (https://wordpress.org/plugins/embed-bible-passages/) made necessary by changes in the ESV Bible Web Service API. (Version 2 included Bible reading plans, but is deprecated and was terminate completely on 15 April 2021. Version 3 is the only version available to new users, but does not include Bible reading plans.) Since 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 over 1600 languages and the Bible Brain API provides 10 English versions and access to over 1700 Bible versions in more than 1500 languages. In addition it has the potential for audio and video for many of the versions. We hope this fork promises a much broader future than did the Embed Bible Passages plugin. The ESV Bible Web Service API, Version 3, however, has also been included in this plugin because it provides audio directly with the texts as well as better formatting control, even though it naturally provides only the English Standard Version.

If the “Display Plan Name on Pages” on the settings page is unchecked, the page displayed to the public will all be in the language of the bible_id used in the shortcode, with the exception of the copyright information and potentially the calendar.

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:

ENGASV - American Standard Bible
ENGESV - English Standard Version®
ENGEVD - English Version for the Deaf
ENGKJV - King James Version
ENGNAS - New American Standard Bible (NASB)
ENGNLV - New Life Version (Easy to Read) (New Testament)
ENGREV - Revised Version 1885
ENGWEB - World English Bible
ENGWM1 - World Messianic Version
ENGWMV - Wycliffe Modern

The default version is ENGESV.

In addition DBP source provides over 1700 Bible versions in more than 1500 languages, with more versions and languages being added regularly.

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 SaeSolved:: Software 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.