Download

Bible Reading Plans

By drmikegreen

Description

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 ENGNAS.

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.

Screenshots

  • Sample input for page of Daily Light on the Daily Path -- Morning Plan.

  • Sample result for page of Daily Light on the Daily Path -- Morning Plan.

  • Settings page part 1.

  • Settings page part 1 open to French DBP versions.

  • Settings page part 2.

  • Sample result for page of a reading plan in French.

Installation

  1. Extract the embed-bible-passages folder and place in the wp-content/plugins folder. Enable the plugin.

  2. 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.

  3. Enter those Access Keys in their fields in the Bible Reading Plans Settings.

  4. Select whether or not to display plan names on pages.

  5. Select whether or not to provide the ability for users to select passages for days other than the current day by clicking on a calendar and where to place that calendar.

  6. Select whether or not to optionally show a “Powered by” attribution at the bottom of pages.

  7. Create pages and/or posts containing the 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"]. (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

Read all 1 review

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

2.2.2

Bug fix: Problem where both English and other language passage names were displayed when the language is not English fixed.

2.2.1

Bug fix: 16 places where there were contiguous passages in Book of Common Prayer, 2019, Anglican Church in North America reading plans which were be presented as separate ones are corrected. They are each now continuous passages.

2.2

This version:

  1. Options to display “Holy Days” and/or “Moveable Feasts” on pages above readingsare added.

  2. File loading is changed to ensure plugin works with multi-sites.

  3. Code is partially reorganized to improve readability.

  4. Bug fix: “ that was appearing in some texts is removed.

  5. Bug fix: Certain filenames are corrected.

2.1.5

Bug fixes:

1. DBP headers are corrected to include verse numbers.

1. Table of Contents is re-corrected so that it again displays in the language of the page. (This waa lost along the way.)

1. Scripture references are corrected for Book of Common Prayer, 2019, Anglican Church in North America -- Evening Prayer for 2 December and Morning Prayer for 13 and 17 January and 7 April.

2.1.4

Corrects bugs which were causing Scriptures obtained from the American Bible Society to always be in the King James version.

2.1.3

This version:

  1. Bug fix: Display Table of Contents is registered in Pages settings.

  2. Bug fix: Link to Create Bible Reading plans is corrected to https://sllwi.re/p/1Il.

2.1.2

This version:

  1. First day of week for the calendar is set to that of the first day of the week set in the WordPress options for English calendars (the script for the calendar for other languages set this).

  2. Screenshot of Create Bible Readings Plans plugin settings screen to text linking to that plugin is added.

  3. Bug fix: Table of Contents is corrected so that it now displays in the language of the page.

  4. Bug fix: Heading for first Scripture is corrected so that readings to be only for the language of the page, instead of a combination of that language and English.

  5. Bug fixes: Scripture references for Book of Common Prayer, 2019, Anglican Church in North America — Evening Prayer for 7 and 22 October are corrected.

  6. Bug fix: Table of Contents text is aligned center, as originally intended.

  7. Bug fix: Repetition of Apocryphal books is corrected.

2.1.1

The .pot languages file is updated.

2.1

This version:

  1. A floating table of contents is added.

  2. A typo on line 1460 of bible-reading-plans-class.inc.php of version 2.0.2 is corrected.

  3. Some code is restructured for easier maintenance.

2.0.2

This version:

  1. The call to the method which checks on whether or not there are any new reading plans is moved from the method which initializes the administrative settings to the __construct() method in order to make sure all new or corrected plans are available even if the administrative settings are not accessed after an upgrade.

  2. Scripture references in a number of places where the references were from a specific verse to the end of the chapter for the Book of Common Prayer, 2019, Anglican Church in North America for the ESV API are corrected.

2.0.1

This version:

  1. Problem with the AJAX call that was causing a conflict with some other plugins is corrected.

  2. Scripture reference for Book of Common Prayer, 2019, Anglican Church in North America — Evening Prayer for 23 June is corrected.

2.0

This version:

  1. Access to over 1700 versions in more than 1500 languages via the Bible Brain (aka the Digital Bible Platform) API is added.

  2. On-the-fly conversion of plans created by the Create Bible Reading Plans plugins to Version 4 of the Bible Brain (aka Digital Bible Platform) API is provided.

  3. The URL for the ESV Scriptures source is corrected.

  4. An error in CSS class brp-no-readings — there was a colon where there should have been a semi-colon is corrected.

  5. A statement to CSS class brp-no-readings — “padding-left: 10.5em !important;” is added to class eb-container .p1,

  6. Certain places that Scripture references were repeated are corrected.

1.1.3

  1. The

<

pre> tags some themes place around the shortcode, causing the text to not wrap, are removed.

1.1.2

  1. Yet another problem with rendering proper Scriptures when the reference is a book with only one chapter is corrected.

  2. Problem with rendering Jeremiah 35:1-36:32 properly on 20 October for the “Every Day In the Word” plan is corrected.

1.1.1

  1. An additional problem with rendering proper Scriptures when the reference is a book with only one chapter is corrected.

1.1

  1. Version 4 of the Bible Brain (aka Digital Bible Platform) API is implemented (requiring a significant code re-write).

  2. Problem with rendering proper Scriptures when the reference is a book with only one chapter is corrected.

  3. More appropriate formatting for poetic books from the Bible Brain (aka Digital Bible Platform) API is provided.

1.0.8

  1. Bug which was inhibiting plugin activation fixed.

  2. Plugin URI added to help with potential conflicts with other plugins.

  3. Changed Text Domain to bible-reading-plans (from bible_reading_plans).

1.0.7

  1. Problem with rendering proper Scriptures when the reference spans more than one chapter (e.g, 2 Kings 8:1-9:13) is corrected.

  2. Scripture reference for Book of Common Prayer, 2019, Anglican Church in North America — Morning Prayer for 2 June is corrected.

1.0.6

  1. Problem of Firefox not playing audio is corrected.

  2. Scripture reference for Book of Common Prayer, 2019, Anglican Church in North America — Morning Prayer for 17 May is corrected.

  3. Further improvements to the spacing of headings and wrapping of text around calendar in Scriptures from esv.org are made.

  4. Bug-fixes — Scripture references which are just book and chapter (no verses specified) and undefined variable “$heading.”

1.0.5

  1. Conflict with the Elementor plugin is fixed.

  2. A Scripture reference for Book of Common Prayer, 2019, Anglican Church in North America — Morning Prayer for 5 May is corrected.

  3. Wrapping of Psalm titles around calendar (when calendar in text option is selected) is improved for Scriptures from esv.org.

1.0.4

  1. Issue with calendar not appearing on mobile phones or above Scriptures (when that option is selected) is fixed.

  2. Wrapping of text around calendar (when calendar in text option is selected) is corrected for Scriptures from esv.org.

  3. Scripture references for Every Day in the Word Psalms for 27 April is corrected.

1.0.3

  1. Conflict with WordFence firewall blocks when Yoast SEO plugin is also active is fixed.

1.0.2

  1. The corrected Every Day in the Word reading plan is actually uploaded.

1.0.1

  1. Errors in the Every Day in the Word reading plan are corrected.

1.0

  1. The reading plans “Chronicles and Prophets,” “Gospel and Epistles,” “Pentateuch and History of Israel,” and “Psalms and Wisdom Literature” are added.

  2. Text from esv.org is enhanced by including passage headings.

  3. One of the Scripture references in the Daily Office Lectionary of the Book of Common Prayer, 2019, Anglican Church in North America is corrected.

0.9

  1. The reading plans “Heartlight Old and New Testament,” “One Year Chronological,” and”Through the Bible in a Year” are added.

  2. Copyright statements are restructured and the way they are stored and output is standardized, while rewording them for completeness and clarity.

0.8

  1. The reading plans “Every Day In the Word,” “Literary Study Bible,” and “Back to the Bible Chronological” are added.

  2. Logic to prevent the calendar from being displayed more than once is added.

0.7

  1. Reading plans from the Daily Office Lectionary of the Book of Common Prayer, 2019, Anglican by including passage headingsChurch in North America, are added.

  2. Ability to use readings from the Apocrypha added, defaulting to the Apocrypha of the American Bible Society’s King James Version, Ecumenical, if no books from the Apocrypha are available in the version used for the readings.

  3. Scriptures output restructured.

  4. Key lengths returned to 32 characters for ABS and DBP APIs and to 40 characters for the ESV API.

0.6.3

  1. Key lengths increased for all APIs.

0.6.2

  1. Fixed problems with passages not displaying correctly when multiple chapters from same book were included in the readings for a day.

0.6.1

  1. Fixed bug that prevented reading plans created with the Create Bible Reading Plans plugin from working with the ESV Bible Web Service API.

  2. Modified .esv-text span.end-line-group in brp-esv-scripture-styles.css to improve formatting of Psalms.

= 0.6

  1. Adds the the ESV Bible Web Service API as a source of Scriptures, which includes audio for the Scriptures as well as the ability to format the text better than that from the DBP API.

  2. Retrieves list of versions from APIs only when the settings screen is used, at which time they are stored in the database. All other times the list is retrieved from the database.

0.5.2

  1. Fixes bugs in the retrieval and storage sequencing of available Scripture versions.

  2. Code added to ensure API keys are of the correct length.

0.5.1

Fixes bug in error reporting of getting Scriptures from remote servers.

0.5

  1. Correct array of Bible versions from API.Bible is obtained.

  2. Option for displaying or not displaying plan name on page is provided.

  3. Several places where arrays or objects are expected, but not present, are fixed.

  4. Enqueues JavaScript libraries using recommended methods.

  5. When API key is missing or incorrect an error message is displayed.

  6. When JavaScript is deactivated in browser an error message is displayed.
    by including passage headings

  7. Instructions are clarified.

0.4.1

Addition of omitted style sheets.

0.4

  1. API.Bible (American Bible Society) added as an additional source of Scriptures.

  2. Function naming rationalization.

0.3

  1. Incorporates compatibility with the premium plugin “Create Bible Reading Plans” (https://sllwi.re/p/1Il).

  2. Addition of another version of the Bible. by including passage headings

  3. Incorporates storing of reading plan arrays in the database, rather than a directory.

  4. Incorporates use of core WordPress CSS for Datepicker.

0.2

Incorporates changes that require each user of the plugin to register at the Digital Bible Platform and get their own Access Key.

0.1

Initial release.

Meta

Ratings

See all
Log in to submit a review.

Support

Issues resolved in last two months:

1 out of 1

View support forum

Donate

Would you like to support the advancement of this plugin?

Donate to this plugin