=== Bg Bible References ===
Contributors: VBog
Donate link: http://bogaiskov.ru/about-me/donate/
Tags: bible, orthodoxy, Christianity, Библия, православие, христианство, Священное Писание, Завет, ορθοδοξία, χριστιανισμός, Αγία Γραφή
Requires PHP: 5.6
Requires at least: 3.0.1
Tested up to: 6.1.1
Stable tag: trunk
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
...will highlight the Bible references with hyperlinks to the Bible and interpretation by the Holy Fathers.
== Description ==
`[see also Russian description below]`
* The plugin will highlight references to the Bible with links.
* Parallel passages in the Bible.
* Interpretation of Holy Scripture by the Holy Fathers and Doctors of the Church.
* Convert references to normalized form.
* Excerpts from the Bible in the article.
* Random quote and quote of the day.
* Search in the Bible.
* List of Bible references contented in the article.
* You can add and delete folders with Bible books on your site.
* To customize the appearance of reference links, use class bg_bibrefs.
### Bible in 6 languages:
* Church Slavic (Elizabeth Bible)
* Russian (Synodal translation by Russian Orthodox Church)
* Ukrainian (translation by I.I.Ogienko)
* Belarusian (New Testament translated by Biblical Commission of the Belarusian Exarchate)
* Serbian (New Testament - synodal translation by Serbian Orthodox Church, Old Testament by Daničić, Karadžić)
* English (King James Version)
* French (La Sainte Bible de Machaira 2020).
### Shortcode:
* `[bible]` displays quotes from the Bible in the text of the page.
* `[bible_epigraph]` displays the quote in the format of epigraph.
* `[bible_search]` displays the search results of phrase (parameter 'context'). In the search query you can use wildcards: "$" - 1 аny letter, "%" - 0 or 1 аny letter, "*" - more any letters.
* `[bible_omnisearch]` displays a form element, allowing the user to enter a search query (see: [Bible_search]).
* `[references]` displays list of Bible references are finded in the article.
* `[norefs]...[/norefs]` prohibits highlighting the Bible references in the text enclosed with this shortcode.
### The plugin contains 3 widgets:
* *Bible References Widget* allows you to place the form in the sidebar to display Bible quotes on the page of your site.
* *Bible Search Widget* allows you to place the form in the sidebar to search for words or phrases in the Bible.
* *Bible Quote Widget* in the sidebar displays a Random Quote or Day's Quote from the Bible the same way as it makes the shortcode `[bible_epigraph]`.
-----
## Описание плагина
* Плагин подсвечивает ссылки на Библию с помощью гиперссылок.
* Параллельные места в Библии.
* Толкования Святого Писания Святыми отцами и Учителями Церкви.
* Преобразование ссылок к нормализованному виду.
* Отрывки из Библии в тексте статьи.
* Случайная цитата и Цитата дня.
* Поиск в Библии.
* Список библейских ссылок в статье.
* Вы можете добавлять и удалять папки с книгами Библии на вашем сайте.
* Для настройки вида ссылок используйте класс bg_bibrefs.
### Текст Библии на 6 языках:
* церковно-славянский (Елизаветинская Библия)
* русский (Синодальный перевод)
* украинский (перевод И.И.Огиенко)
* белорусский (Новый Завет в переводе Библейской Комиссии при Белорусском Экзархате)
* cербский (Новый Завет - синодальный перевод Сербской Православной Церкви, Ветхий Завет в переводе Даничича и Караджича)
* английский (King James Version)
* французский (La Sainte Bible de Machaira 2020)
### Шорт-коды:
* `[bible]` выводит цитаты из Библии в тексте страницы.
* `[bible_epigraph]` выводит на экран цитату в форме эпиграфа.
* `[bible_search]` выводит на экран результаты поиска фразы в Библии. В поисковом запросе можно использовать специальные символы: "$" - 1 любая буква, "%" - 0 или 1 любая буква, "*" - несколько любых букв.
* `[bible_omnisearch]` выводит на экран элемент формы, позволяющий пользователю вводить поисковый запрос.
* `[references]` выводит список ссылок на Библию, встречающиеся в статье.
* `[norefs]...[/norefs]` запрещает подсветку гиперссылок на Библию в тексте, ограниченном этим шорт-кодом.
### Плагин содержит 3 виджета:
* Виджет *"Ссылки на Библию"* позволяет разместить в сайдбаре форму для вывода текста цитат из Библии на странице Вашего сайта.
* Виджет *"Поиск в Библии"* позволяет разместить в сайдбаре форму для поиска слова или фразы Библии.
* Виджет *"Цитата из Библии"* выводит в сайдбаре Случайную Цитату или Цитату Дня из Библии, аналогично тому, как это делает шорт-код `[bible_epigraph]`.
-----
== Installation ==
1. Upload 'bg-biblie-references' directory to the '/wp-content/plugins/' directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
== Frequently Asked Questions ==
= How do I know that the script works? =
Any references to Bible verses on your page will be replaced by hyperlink.
= Why can't I use a script? =
* Make sure that your browser supports JavaScript, and JavaScript enabled in your browser.
* Verify that the reference to the Bible is framed in accordance with the generally accepted rules.
== Screenshots ==
1. An example work of the plugin - highlight references
2. Expanded tooltip.
3. Page of Bible verses
4. Interpretation of Holy Scripture
5. Search in the Bible
== Changelog ==
= 3.18.5 =
* Hosting the plugin on GitHub: https://github.com/VBog/Bg-Bible-References
= 3.18.4 =
* Replaced links http://azbyka.ru/biblia/... to https://azbyka.ru/biblia/... .
= 3.18.3 =
* Fixed bug.
= 3.18.2 =
* Fixed parsing of western notation.
= 3.18.1 =
* Fixed bug.
= 3.18 =
* Changed the setting format for the language of the Bible on the azbyka.ru website.
* New links to Bible interpretations on the azbyka.ru website.
= 3.17 =
* Added display multilanguage page with Bible verses.
= 3.16.3 =
* Fixed getting remote files.
= 3.16.1-2 =
* Fixed bug.
= 3.16 =
* Added Serbian translation. Many thanks to Tropinin Maxim.
* Allowed to upload Serbian version of the Bible.
= 3.15.4 =
* Allowed to set the maximum of character number of in references of Bible book.
= 3.15.3 =
* Fixed some bugs.
= 3.15.2 =
* Now you can upload your own Bible books on your site in `wp-content/uploads/bible/` folder, without risk lose them when plugin update.
= 3.15.1 =
* Some French language support add-ons.
= 3.15 =
* Added French translation. Many thanks to Mr. R.F. Bouthillette from Quebec.
= 3.14.4-5 =
* Changed format of links to interpretation of Bible by Lopuchin on the site azbyka.ru
= 3.14.3 =
* Added links to interpretation of deuterocanonical books by Lopuchin on the site azbyka.ru
= 3.14.1-2 =
* Fixed small bug.
= 3.14.0 =
* Improved algorithm to recognize the Bible references. Some settings have been changed.
= 3.13 =
* Added options that allow you to adjust the permissible deviations from the Eastern tradition in Bible references.
* In the book "Psalms" the word "Chapter" is replaced by "Psalm".
= 3.12 =
* Added option to disable links to interpretations.
* Allow shortcodes into `[bible]...[/bible]` tags.
* Added links to interpretation by Lopuchin on the site azbyka.ru
* Added file manager for Bible books.
* Now you can receive Bible verses from external AJAX Proxy.
* Functions - analogs of the shortcodes: `bg_bibrefs_bible ( (string) $ref='', (string) $book='', (string) $ch='1-999', (string) $type='verses', (string) $lang='',(string) $prll='' )` and `bg_bibrefs_bible_epigraph ( (string) $ref='rnd', (string) $lang='' )`.
= 3.11 =
* Plugin validates the references. Invalid references marks as errors.
* Added additional classes for display verses: `bg_bibrefs_`.
* Added delay in 0.2 sec. when you hover over the link to avoid loading theBible books, if you accidentally moved the cursor around the screen.
* Added object cache for downloaded books.
* Added option which allows you to upload Bible verses in links when plugin parse of the text (before display it on the screen).
* Added option to set the maximum execution time.
* Now plugin interface is available in the Belarusian language. Many thanks to Basil Matveev.
* Now you can easily add any edition of the Bible.
* Added missing in KJV apocryphal verses (Prov.4:28-29; Prov.13:14; Prov.18:8; Ps.151) from Brenton's Septuagint.
* Added apocryphal books and chapters and missing verses from the King James Bible (KJV).
* Fixed old typos: bg_bibfers to bg_bibrefs (in function names, in option names, in text domain neme, in class names, etc.).
= 3.10 =
* Now plugin highlight the Bible references in the post summary (field "Excerpt", see https://codex.wordpress.org/Excerpt).
* Added 'Hebrews' in Belarusian language.
* Added parameter 'prll' in shortcodes `[bible]` and `[bible_search]`.
* You can redirect the hyperlinks of references to your own website, or even turn off them.
* You can turn on references to parallel passages in the Bible.
= 3.9 =
* Added shortcode `[bible_omnisearch]`.
* Improved support for multilingual sites.
* Multilingual support of Readings in the plugin Bg Orthodox Calendar.
= 3.8 =
* Added "Bible Search" widget and shortcode `[bible_search]`.
= 3.7 =
* Added "Bible References" widget and "Bible Quote" widget.
* New plugin's site http://wp-bible.info .
* Fixed code of Church Slavonic language from "sc" to "cu" (in according with ISO 639-1). Please make the changes to your website!
= 3.6 =
* A random quote and quote of day.
* Added shortcode `[bible_epigraph]`.
* Added three books of the New Testament in the Belarusian language.
= 3.5 =
* Now you can define container (div ID or body tag), inside which will display tooltips.
* Added books of New Testament in Belarusian language.
* Added Kihg James Bible (English language).
* The plugin supports the old notation with Roman numerals in naming books and in chapters.
* Allow semicolons in the numbering of the chapters and verses.
* Minor bugs fixed.
= 3.4 =
* Optimized algorithm of main loop. Parsing of posts became faster.
* Debug option.
* To add a language, you can add a folder with the books into directory 'bible' of the plugin.
* Added support for Cyrillic characters ёіїєґўЁІЇЄҐЎ.
* Values of custom fields 'bible_lang' and 'norefs' you can select on edit page of posts and pages.
* Added Bible in Church Slavonic language.
= 3.3 =
* Added Four Gospels in the Belarusian language.
= 3.2 =
* Added option "Show original verse numbers".
* Now disabled highlighting of Bible references in links (tag ``).
= 3.1 =
* Bible in multiple languages in blog and posts.
* Button expand/hide now at left.
* Minor bugs fixed.
= 3.0 =
* Multilanguage Bible verses in tooltip.
* Added Ukrainian language.
= 2.10 =
* Added enclosing shortcode `[bible]...[/bible]`.
* Allowed references like (Ин. 3:16—4:6).
= 2.9 =
* New view of tooltips.
* Now you can expand tooltip for easy reading.
* Selection of text in tooltip for copying to the clipboard.
* Hyphen and other similar symbols (#8208-#8213) instead of the dash (#45) allowed to use in references.
= 2.8 =
* Added short-code `[norefs]...[/norefs]`.
* Option to disable highlighting of Bible references in the whole post.
* List of Bible references (short code `[references]`) displays in "normalized form" without repeats.
= 2.7 =
* Added option "Highlight references in the headers H1...H6". Thank you very much, Pozharko Andrej, for good idea.
* Added option "Convert references to the normalized form".
* For short code `[references type="list"]` specified additional parameter 'col' - the number of columns.
* Now you can specify a few books in row using semicolon as the separator (см.: Зах.4; 2Кор.1:21; 1Ин.2:27).
= 2.6 =
* Added short code `[references]` - displays quotes from the Bible in the text of the page. Thanks Pozharko Andrej for idea.
= 2.5 =
* To read Bible files used PHP-functions `cURL` or `file_get_contents()` or `fopen()`.
Plugin tries to read Bible files with one of this methods in the order listed.
To do the reading faster, disable unnecessary methods in settings - you need one only.
Warning: Some methods may not be available on your server.
* Allowed to use a semicolon instead of a comma in references.
* Added some new abbreviations of the Bible books.
* Added option "Preload Bible verses in tooltips". Try this option on a slow server, but can be problem with ajax-requests limiting on the server.
* Added links to the interpretation of Holy Scripture on the site of the monastery Optina Pustyn (http://bible.optina.ru).
* Allowed use in shortcode any valid (not only Latin) abbreviation of Bible books.
= 2.4 =
* New algoritm to get and display Bible verses.
* Added `type='t_verses' in shortcode `[bible]`.`
= 2.3 =
* Algorithm optimization.
* Fixed mp3 eq. `[Мр.3]` error (Lat/Cyr mixing).
* Other minor fixing.(Thanks, versusbassz)
* Some PHP E~Notices fixed and some corrections for compliance to Wordpress coding standards (Thanks, versusbassz)
* Allowed point instead of a colon (In.3.16-18) after first chapter number.
* Allowed to use references without brackets.
= 2.2 =
* Added `type='b_verses' in Short code `[bible]`.`
* Short code `[bible book='Mt' ch='2:3-6 'type='verses']` displays quotes from the Bible in the text.
= 2.1 =
* Fastest display page. The tooltip is created when you hover the cursor over it only.
= 2.0 =
* When you hover your mouse over the link displayed tooltip containing the Bible verses (only in Russian).
= 1.0 =
* The first stable version.
= 0.12 =
* Plugin internationalization (i18n).
= 0.11 =
* Added new options
= 0.10 =
* Fixed minor bugs in i18n
= 0.9 =
* Added Plugin's options
= 0.8 =
* Parsing algorithm of references was rewrite in PHP
= 0.7 =
* Trying to solve the conflict with the built-in script Yandex Maps
= 0.6 =
* Fixed a bug causing a conflict with other plugins
= 0.5 =
* Allowed см.:(see) just after the opening bracket. Options: см.: | см. | см: | см
* New: Pop-up window when you specify the cursor on the link contains the full title of the book of the Bible
* Fixed some bugs.
= 0.4 =
* Major changed algorithm. Now available complex references, such as (Ин. 3:16—18, 4:4—6)
* Added new abbreviations
= 0.3 =
* Optimized algorithm, added format of reference in brackets
* Script are uploaded before in footer ` ` tag. Loading of the script is independent the availability of wp_head and wp_footer in WP theme
= 0.2 =
* Added references (Ин.1:4,12-15), (Ин 1:4,12-15).
* Script are uploaded in the `