=== The Word Widget ===

Author: Helmut Steeb
Author URI: https://jsteeb.de
Tags: bible, bibel, losung, devotional, verse of the day, votd, sidebar, widget, An Bíobla Naofa, Bibelen, Bibel für Schwoba, Biblia Tysiąclecia, Bybel in Afrikaans, Chinese Union Version, English Standard Version, Hoffnung für Alle, Jubiläums-Bibel, Karoli, Kutsal Kitap, Leonberger Bibel, Neue Evangelistische Übersetzung, Modern Hebrew, New Arabic Version, Ketab el Hayat, Neue Evangelistische Übersetzung, Nuova Riveduta, O‘zbek tilidagi Muqaddas Kitob, Reina-Valera, Schlachter, Segond, Thai Holy Bible, Portuguese Bíblia Livre, Bible Thianghlim
Stable tag: trunk
Version: 0.9
Tested up to: 5.8
Requires at least: 4.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Contributors: HSteeb
Requires PHP: 5.3

Shows two Bible sayings per day: "The Word" by project Bible 2.0, available in ca. 20 languages, got remotely for each day

== Description ==

The plugin provides a widget which you can place into one of the widget areas provided by your theme (in the WordPress admin area: Appearance | Widgets).

The widget configuration retrieves the list of available Bible editions of the current year remotely from <https://bible2.net> and lets you select one Bible edition. On each day, the widget retrieves the two sayings for the day from bible2.net and displays them.

### Project Bible 2.0

Project [Bible 2.0](https://bible2.net/) collects cross-references between selected Bible verses, formats the verses nicely and publishes two cross-referenced verses ("sayings") for each day of the year in ca. 20 languages, available for free download and as a remote service.

### Bible Editions Available

Dated 2021-07-17 – for latest information, see <https://bible2.net/download/bible-editions-available/>.

For **2021**, The Word is available in the following Bible editions and languages:

* af Bybel in Afrikaans (1983-vertaling)
* ar كتاب الحياة : الترجمة العربية الجديدة (Holy Bible, New Arabic Version, Ketab El Hayat)
* cfm Bible Thianghlim (Chin Standard Bible), see <https://bible2.net/cfm>
* cim Zimbrisch (German Cimbrian dialect), see <https://bible2.net/cim>
* da Bibelen (Danish)
* de Hoffnung für Alle (German)
* de Leonberger Bibel (German)
* de Neue Evangelistische Übersetzung (German)
* de Schlachter 2000 (German)
* en English Standard Version
* es Reina-Valera 1995 (Spanish)
* fr Segond 21 (French)
* ga An Bíobla Naofa 1981 (Gaelic)
* he ספר הבריתות 2004 (Hebrew)
* hu Karoli 1990 (Hungarian)
* it Nuova Riveduta 1994 (Italian)
* pfl-x-suedsaar Südsaarländisch (Southern Saarlandian, a kind of Pfälzisch = Palatinate), see <https://bible2.net/pfl-x-suedsaar>
* pl Biblia Tysiąclecia (Polski Polish)
* pt Portuguese Bíblia Livre (Portuguese)
* ro Cornilescu 2014 (Romanian), see <https://bible2.net/ro>
* ru Юбилейная Библия Jubiläums-Bibel (русский Russian)
* swg Bibel für Schwoba (Schwäbisch Swabian swg), see <https://bible2.net/swg>
* th สมาคมพระคริสตธรรมไทย 1971 (Thai Holy Bible 1971)
* tr Kutsal Kitap 2001
* uz-Cyrl Ўзбек тилидаги Муқаддас Китоб 2012
* uz-Latn O‘zbek tilidagi Muqaddas Kitob 2012
* zh-Hans 中文标准译本(简化字) (Simplified Chinese)
* zh-Hant 中文标准译本(繁體字) (Traditional Chinese)

### System Requirements

* PHP: tested with 7.4.3. Using an anonymous function requires 5.3.
* SimpleXML: the widget needs the "SimpleXML" PHP library. If it is not available, the widget configuration (see "Appearance | Widgets" in the Installation chapter) will show an error message. For PHP 5.6, the commands `sudo apt-get install php5.6-xml` and `service apache2 restart` may help (use `php7.0-xml` for PHP 7.0).

### Adapting the Layout 

The widget output uses the following CSS classes which you may adapt in your stylesheet (CSS):

* TheWord
* TL
* Parol
* IL
* L
* SL
	
An example css file is included in the plugin zip file. It includes CSS to either show the verses with line breaks (on a wider display) or without the line breaks (on a smaller display). You may need to adapt the rules, depending on the actual width of your widget area.

### Plugin License

The WordPress plugin is licensed under GPLv2 or later.

### License for Bible Texts (got remotely per day)

The license conditions for the Bible texts (verses) are defined by the publisher of the respective Bible edition. They are contained in the .twd XML files, and are also shown in <https://bible2.net/copyright/>.

### License for Related Bible References (got remotely per day)

The project Bible 2.0 provides pairs of related Bible references.

The Word associates one pair of Bible references with a certain day, respectively.

The association of Bible references into pairs and of such pairs to days of a certain year is subject to

    License “Creative Commons 4.0”
    <https://creativecommons.org/licenses/by-sa/4.0/>
    (Attribution, ShareAlike)

With each publication, the following statement with a link to <https://bible2.net> must be available for the user (e.g. by adding a link to the copyright page):

    Association of Bible references by project Bible 2.0


== Installation ==

1. unpack the zip file into your WordPress plugin folder `/wp-content/plugins/`;
2. in the WordPress admin area, in Plugins | Installed Plugins, activate the plugin;
3. in the WordPress admin area, in Appearance | Widgets, put the widget "The Word" into one of your widget areas;
4. in the widget area, in "The Word" widget, select a Bible edition, press the "Save" button.

== Screenshots ==

1. The widget configuration
2. The widget in a wider widget area (line breaks preserved)
3. The widget in a small widget area (no line breaks)

== Changelog ==

= 0.9 =
* for use in a WP 5.8 Legacy Widget Block, moved the static method `html` from includes/admin-form.php into the-word-widget.php
* dropped the empty the-word-widget-admin.php
* tested with PHP 7.4.3 and WordPress 5.8 RC4

= 0.8 =
* use anonymous function (available since PHP 5.3.0) instead of create_function (deprecated in PHP 7.2)
* tested with PHP 7.2.15 and WordPress 5.1 RC2

= 0.7 =
* use https protocol to access bible2.net
* tested up to WordPress 4.8

= 0.6 =
* if the SimpleXML module is missing, the widget configuration form shows a detailed info.

= 0.5 =
* if the widget form (for admin) fails to retrieve the list of Bible editions from bible2.net, the form shows a detailed log of its actions, and some environment info (`allow_url_fopen`, `php_version()`, `$wp_version`, `$required_php_version`).

= 0.4 =
* on restricted server configurations,
* the plugin now falls back to a safer method to retrieve data from bible2.net
* (if PHP setting allow_url_fopen=Off, simplexml_load_file fails,
*  then the plugin uses the WordPress method wg_remote_get)

= 0.3 =
* the widget does not store a .twd file per year but uses the daily online service

= 0.2 =
* the widget form (for admin) retrieves the list of Bible editions from bible2.net,
* ... lets admin select the Bible edition
* ... and retrieves The Word .twd file for the selected Bible edition from bible2.net.
* the widget shows The Word from the Bible edition selected in the widget form.

= 0.1 =
* initial version

== Upgrade Notice ==
