=== Bible Reading Plans ===
Contributors: drmikegreen
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3GNC36MKM6ADC&source=url
Tags: Bible reading plans, shortcode, Bible, daily readings, Digital Bible Platform, American Bible Society, API.Bible
Requires at least: 2.8
Tested up to: 5.6
Requires PHP: 5.6
Stable tag: trunk
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Provides the ability to embed Bible Reading Plans into a post or page using a shortcode.
== 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"]. Three sources for the Scriptures displayed for each plan are available: American Bible Society API, Version 1 (API.Bible), The Digital Bible Platform API, Version 2 (digitalbibleplatform.com), 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. 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 Digital Bible Platform API provides two versions for English and for more than 1000 languages, however, 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.
For the initial releases only the English language is available.
The values of reading_plan can, at present, be:
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
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
mcheyne - M'Cheyne One-Year Reading Plan
The default reading plan is M'Cheyne One-Year Reading Plan.
We hope to add other plans going forward and have also created a premium plugin "Create Bible Reading Plans" (http://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, at present, be:
ABS - American Bible Society (API.Bible)
DBP - Digital Bible Platform (digitalbibleplatform.com)
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 Digital Bible Platform, 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 values of version can, at present, be:
ESV - English Standard Version
KJV - King James Version
The default version is ESV.
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.
This plugin requires JavaScript to be active.
Copyright 2021 M.D. Green, SaeSolved:: LLC
== 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.
== Installation ==
1. Extract the embed-bible-passages folder and place in the wp-content/plugins folder. Enable the plugin.
1. Request Access Keys from the American Bible Society, the Digital Bible Platform, and/or the ESV Bible Web Service API using the links given on the settings page.
1. Enter those Access Keys in their fields in the Bible Reading Plans Settings.
1. Select whether or not to display plan names on pages.
1. 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.
1. Select whether or not to optionally show a "Powered by" attribution at the bottom of pages.
1. Create pages and/or posts containing the shortcode of the form [bible-reading-plan reading_plan="mcheyne" source="DBP" version="ESV"]. (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.
== Screenshots ==
1. Sample input for page of Daily Light on the Daily Path -- Morning Plan.
2. Sample result for page of Daily Light on the Daily Path -- Morning Plan.
3. Settings page part 1.
4. Settings page part 2.
== Upgrade Notice ==
= 0.7 =
This version:
1. adds reading plans from the Daily Office Lectionary of the _Book of Common Prayer, 2019_, Anglican Church in North America.
1. adds ability to use readings from the Apocrypha, 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.
1. restructures Scriptures output.
1. returns key lengths to 32 characters for ABS and DBP APIs and 40 characters for the ESV API.
= 0.6.3 =
This version:
1. allows longer key lengths for all APIs.
= 0.6.2 =
This version:
1. fixes problems with passages not displaying correctly when multiple chapters from same book were included in the readings for a day.
= 0.6.1 =
This version:
1. fixes bug that prevented reading plans created with the Create Bible Reading Plans plugin from working with the ESV Bible Web Service API.
1. improves formatting of Psalms by modifing .esv-text span.end-line-group in brp-esv-scripture-styles.css.
= 0.6 =
This version:
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.
1. 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 =
This version:
1. fixes bugs in the retrieval and storage sequencing of available Scripture versions.
1. adds code to ensure API keys are of the correct length.
= 0.5.1 =
This version fixes a bug in the error reporting of getting Scriptures from remote servers.
= 0.5 =
This version:
1. obtains correct array of Bible versions from API.Bible.
1. provides option for displaying or not displaying plan name on page.
1. fixes several places where arrays or objects are expected, but not present.
1. uses recommended methods for enqueuing JavaScript libraries.
1. displays error message when API key is missing or incorrect.
1. displays error message when JavaScript is deactivated in browser.
1. makes changes to the description and instructions to clarify a number of points.
= 0.4.1 =
This version implements addition of omitted style sheets.
= 0.4 =
This version implements:
1. An additional source of Scriptures has been added: API.Bible (American Bible Society).
1. Rationalization of function names.
= 0.3 =
This version implements:
1. Compatibility with the premium plugin "Create Bible Reading Plans" (http://sllwi.re/p/1Il).
1. Addition of another version of the Bible.
1. Storing of reading plan arrays in the database, rather than a directory.
1. Use of core WordPress CSS for Datepicker.
= 0.2 =
This version 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.
== Changelog ==
= 0.7 =
1. Reading plans from the Daily Office Lectionary of the _Book of Common Prayer, 2019_, Anglican Church in North America, are added.
1. 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.
1. Scriptures output restructured.
1. 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.
1. 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.
1. 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.
1. 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.
1. Option for displaying or not displaying plan name on page is provided.
1. Several places where arrays or objects are expected, but not present, are fixed.
1. Enqueues JavaScript libraries using recommended methods.
1. When API key is missing or incorrect an error message is displayed.
1. When JavaScript is deactivated in browser an error message is displayed.
1. 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.
1. Function naming rationalization.
= 0.3 =
1. Incorporates compatibility with the premium plugin "Create Bible Reading Plans" (http://sllwi.re/p/1Il).
1. Addition of another version of the Bible.
1. Incorporates storing of reading plan arrays in the database, rather than a directory.
1. 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.