=== BibleGet I/O ===
Contributors: Lwangaman
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=HDS7XQKGFHJ58
Tags: bible,shortcode,quote,citation
Requires at least: 3.3
Tested up to: 4.7.5
Stable tag: 3.7
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Creates a shortcode [bibleget] for inserting Bible quotes in articles or pages using the BibleGet I/O Service endpoint https://query.bibleget.io

== Description ==

* [ENGLISH] 
This plugin creates a shortcode to use in articles and pages, that will inject Bible citations into your article or page,
by retrieving them from the BibleGet service endpoint at *https://query.bibleget.io*.
USAGE: [bibleget query="Exodus 19:5-6,8;20:1-17" version="CEI2008"] 
USAGE: [bibleget query="Matthew 1:1-10,12-15" versions="NVBSE,NABRE"] 

The Plugin also has a settings page “BibleGet I/O” under the “Settings” area in the Dashboard, 
where you can choose your preferred Bible versions from those available on the BibleGet server
so that you don’t have to use the “version” or “versions” option every time. 
After you have made your choices in the settings area, remember to click on “Save”!
Once the preferred version is set you can simply use:
USAGE: [bibleget query=“1 Cor 13”] 

The style settings are customizable using the Wordpress Customizer, 
so that the injected Bible quotes may fit into the style of your own blog / WordPress website.

* [ESPAÑOL] 
Este plugin crea un shortcode para ser utilizado en artículos o páginas, que puede inyectar citas Bíblicas en el artículo o página,
recuperando las citas desde el servidor de BibleGet en la dirección *https://query.bibleget.io*.
UTILIZACIÓN: [bibleget query="Esodo 19,5-6.8;20,1-17" version="CEI2008"]  
UTILIZACIÓN: [bibleget query="Mateo 1,1-10.12-15" versions="NVBSE,CEI2008,LUZZI"]  

El Plugin también tiene una página de opciones “BibleGet I/O” bajo el área “Configuración” en el cuadro de instrumentos (Dashboard), 
donde se puede elegir sus versiones biblicas preferidas entre las que son disponibles en el servidor de BibleGet 
en manera que no sea necesario utilizar siempre la opcion “version” o “versions”.
Después que has elegido sus versiones preferidas en el área de configuración, no olvide hacer clic en “Guardar”! 
Una vez que has ajustado la version preferida, puedes utilizar el shortcode en esta manera:
UTILIZACIÓN: [bibleget query="1 Cor 13"]  

Las preferencias estilísticas son personalizables utilizando Wordpress Customizer,
en manera que las citas bíblicas inyectadas pueden encajar en el estilo de su propio blog / sitio WordPress.

* [FRANÇAIS] 
Ce plugin crée un shortcode pour être utilisé dans des articles ou pages, qui peut injecter des citations Bibliques dans l'article ou la page,
en les récupérant du service BibleGet à *https://query.bibleget.io*.
UTILISATION: [bibleget query="Éxodo 19,5-6.8;20,1-17" version="CEI2008"]  
UTILISATION: [bibleget query="Mathieu 1,1-10.12-15" versions="NVBSE,CEI2008,LUZZI"]  

Le plugin a également une page de paramètres “BibleGet I/O” dans la zone “Paramètres” dans le tableau de bord (Dashboard), 
où vous pouvez choisir le préférence des versions bibliques entre quelles que son disponibles dans le serveur de BibleGet
de façon qu’il ne soit pas nécessaire d’utiliser toujours l’option « version » ou « versions ».
Après avoir fait vos choix dans la zone des paramètres, ne oubliez pas de cliquer sur “Enregistrer”!
Une fois que vous avez défini la version préférée, vous pouvez utiliser le shortcode de cette façon:
UTILISATION: [bibleget query="1 Cor 13"]  

Les préférences de style sont personnalisables en utilisant WordPress Customizer,
de façon que les citations bibliques injectées peuvent se intégrer dans le style de votre propre blog / site WordPress.

* [ITALIANO] 
Questo plugin crea uno shortcode da utilizzare all’interno di articoli o pagine, che può iniettare citazioni Bibliche nell’articolo o nella pagina,
recuperandole dal servizio BibleGet all'indirizzo *https://query.bibleget.io*. 
UTILIZZO: [bibleget query="Esodo 19,5-6.8;20,1-17" version="CEI2008"]  
UTILIZZO: [bibleget query="Matteo 1,1-10.12-15" versions="NVBSE,CEI2008,LUZZI"]  

Il Plugin offre anche una pagina di opzioni “BibleGet I/O” sotto “Impostazioni” nella Dashboard, 
che permette di scegliere le versioni bibliche preferite tra quelle disponibili dal server di BibleGet
in modo che non sia necessario utilizzare ogni volta l’opzione “version” o “versions”.
Dopo aver cambiato le preferenze, ricòrdati di cliccare sul pulsante “Salva le modifiche”!
Una volta impostata la versione preferita, potete usare lo shortcode in questo modo:
UTILIZZO: [bibleget query="1 Cor 13"]  

Le preferenze di stile sono personalizzabili utilizzando il Customizer di Wordpress,
in modo che le citazioni iniettate nelle pagine abbiano uno stile confacente al proprio blog / sito WordPress.

* [DEUTSCH] 
Das Plugin erzeugt eine shortcode die in Artikeln oder Seiten verwendet werden können, und welche die Bibelzitate in dem Artikel oder Seite injizieren können,
indem sie sie aus dem BibleGet Service Endpunkt bei *https://query.bibleget.io* abrufen.
VERWENDUNG: [bibleget query="Exodus 19,5-6.8;20,1-17" version="CEI2008"]
VERWENDUNG: [bibleget query="Matthäus 1,1-10.12-15" versions="NVBSE,CEI2008,LUZZI"]

Das Plugin hat auch eine Einstellungsseite „BibleGet I/O“ im Bereich „Einstellungen“ im Dashboard, 
wodurch es möglich ist, die bevorzugten Bibel-Versionen zu wählen, unter den zur Verfügung auf dem Server von BibleGet
so dass es nicht notwendig ist, jedes Mal, wenn die „version“ oder „versions“ Option zu verwenden.
Nachdem Sie Ihre Auswahl im Bereich Einstellungen vorgenommen haben, denken Sie daran, auf „Speichern“ klicken!
Sobald Sie die bevorzugte Version gesetzt haben, sie können die „shortcode“ auf diese Weise verwenden:
VERWENDUNG: [bibleget query="1 Kor 13"]

Die Stileinstellungen können angepasst werden mit die Wordpress Customizer,
so dass die injizierten Bibelzitaten kann in den Stil Ihrer eigenen Blog / Wordpress-Website passen.
_________
THE AUTHOR WOULD LIKE TO THANK THE FOLLOWING USERS FOR CONTRIBUTED TRANSLATIONS:

SERBIAN TRANSLATION: Ogi Djuraskovic <ognjend@firstsiteguide.com> WEBSITE: [firstsiteguide](http://firstsiteguide.com "firstsiteguide")

POLISH TRANSLATION: Ula Gnatowska <ula.gnatowska@gmail.com> WEBSITE: [comunità delle beatitudini](http://beatitudini.it/ "comunità delle beatitudini")

GREEK TRANSLATION: anonymous user contribution

[BibleGet I/O](
http://www.bibleget.io/
 "BibleGet IO Website")

== Installation ==

1. Upload the `bibleget-io` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress

== Frequently Asked Questions ==

= How do I formulate a Bible citation? =
[ENGLISH]
The query parameter must contain a citation that is formulated following the standard notation for Bible citations (see [Bible citation notation](http://en.wikipedia.org/wiki/Bible_citation "http://en.wikipedia.org/wiki/Bible_citation")):
   * “:”: is the chapter – verse separator. “15:5” means “chapter 15, verse 5”.

   * “-”: is the from – to separator, and it can be used in one of three ways:

      1. from chapter to chapter: “15-16″ means “from chapter 15 to chapter 16”.
      2. from chapter,verse to verse (of the same chapter): “15:1-5” means “chapter 15, from verse 1 to verse 5”.
      3. from chapter,verse to chapter,verse “15:1-16:5” means “from chapter 15,verse 1 to chapter 16,verse 5”.

   * “,”: is the separator between one verse and another. “15:5,7,9” means “chapter 15,verse 5 then verse 7 then verse 9”.

   * “;”: is the separator between one query and another. “15:5-7;16:3-9,11-13” means “chapter 15, verses 5 to 7; then chapter 16, verses 3 to 9 and verses 11 to 13”.

At least the first query (of a series of queries chained by a semi-colon) must indicate the name of the book upon which to make the request;
 the name of the book can be written in full in more than 20 different languages, or written using the abbreviated form.
 See the page [Lista di Abbreviazioni di Libri](http://www.bibleget.io/come-funziona/lista-abbreviazioni-libri/ "Lista di Abbreviazioni di Libri").
 When a query following a semi-colon does not indicate the book name, it is intended that the request be made upon the same book as the previous query.
 So “Gen1:7-9;4:4-5;Ex3:19” means “Genesis chapter 1, verses 7 to 9; then again Genesis chapter 4, verses 4 to 5; then Exodus chapter 3, verse 19”.

[ITALIANO]
Il parametro "query" deve contenere una citazione formulata seguendo la notazione standard per le citazioni della Sacra Scrittura: 

   * “,”: è il separatore capitolo – versetto. “15,5” significa “capitolo 15, versetto 5”.

   * “-”: è il separatore da – a, e può essere utilizzato in tre modi diversi:

      1. da capitolo a capitolo: “15-16″ significa “da capitolo 15 a capitolo 16”.
      2. da capitolo,versetto a versetto (dello stesso capitolo): “15,1-5” significa “capitolo 15, dal versetto 1 al versetto 5”.
      3. da capitolo,versetto a capitolo,versetto: “15,1-16,5” significa “dal capitolo 15,versetto 1 al capitolo 16,versetto 5”.

   * “.”: è il separatore tra versetto e versetto. “15,5.7.9” significa “capitolo 15,versetto 5 poi versetto 7 poi versetto 9”.

   * “;”: è il separatore tra una query e l’altra. “15,5-7;16,3-9.11-13” significa “capitolo 15, versetti 5 a 7; poi capitolo 16, versetti 3 a 9 e versetti 11 a 13”.

Almeno la prima query deve indicare il nome del libro sul quale effettuare la ricerca;
 il nome del libro si può indicare per intero oppure utilizzando la forma abbreviata
 come indicata alla pagina [Lista di Abbreviazioni di Libri](http://www.bibleget.io/come-funziona/lista-abbreviazioni-libri/ "Lista di Abbreviazioni di Libri").
 Quando le query successive non hanno indicazione di nome di libro,
 è sottinteso che la query viene effettuata sullo stesso libro indicato precedentemente.
 "Gen1,7-9;4,4-5;Es3,19" significa “Genesi capitolo 1, versetti 7 a 9; poi ancora Genesi capitolo 4, versetti 4 a 5; poi Esodo capitolo 3, versetto 19″.

== Screenshots ==

1. A Bible Quote produced from usage of the shortcode in an article (screenshot-1.png).
2. Options page - font and style settings (screenshot-2.png).
3. Options page - edit the CSS stylesheet directly (screenshot-3.png).
4. Options page - information from the BibleGet server about available versions and supported languages (screenshot-4.png).

== Changelog ==

= 3.7 =
* Fix some language translations after 3.6 overhaul

= 3.6 =
* Complete overhaul of the style settings to use the Wordpress customizer
* Fix bug that prevented favourite versions option from being used when versions option not used in shorttag
* Change internal function names to be more specific, avoiding any possible conflicts with other plugins 
* Better rendering of spacing in Bible Book names and between verse numbers and verse text
* Update language files

= 3.5 =
* Fix possible vulnerability in the script that saves the custom css file

= 3.4 =
* Better error handling: server errors from the BibleGet server will only be shown in backend notifications, and will not be saved in any transients. (this update is thanks to user feedback from Mr. D.N., user feedback is very helpful!)

= 3.3 =
* Fix languages array's German translation

= 3.2 =
* Further enhancements on CSS styling, especially for the NABRE text
* Added a few more localized button images
* Small bugfix in url-encoding of parameters

= 3.1 =
* Further enhancements on CSS styling, especially for the NABRE text

= 3.0 =
* Updated for compatibility with Wordpress 4.3
* Added Greek translation thanks to a user contribution on the translation project website
* Added French and German translations using automatic translation tools with a minimum quality check (probably can be made better)
* Enhancement: cache query results locally for 24 hours using the Wordpress Transients API
* Bugfix: some code that was used for debugging in the testing process, and that created a debug file 'debug.txt', had not been commented out, and debug.txt file was ending up in the current theme folder (can be deleted if present!)
* A few enhancements on CSS styling, especially for the now released NABRE text  

= 2.9 =
* Updated for compatibility with latest Wordpress 4.2.2
* Fixed small bug in css file

= 2.8 =
* Added specific functionality for parsing NABRE text and applying NABRE specific styles

= 2.7 =
* Added Polish translation thanks to Ula Gnatowska Ula Gnatowska <ula.gnatowska@gmail.com> [comunità delle beatitudini](http://beatitudini.it/ "comunità delle beatitudini")
* Added Serbian translation thanks to Ogi Djuraskovic <ognjend@firstsiteguide.com> [firstsiteguide](http://firstsiteguide.com "firstsiteguide")

= 2.6 =
* Minor bugfix undeclared variable on options page
* Added Serbian translation thanks to Ogi Djuraskovic <ognjend@firstsiteguide.com> [firstsiteguide](http://firstsiteguide.com "firstsiteguide") 

= 2.5 =
* Bugfix for older versions of PHP that require a third parameter in preg_match_all

= 2.4 =
* Bugfix for older versions of PHP that don't seem to work correctly with mb_substr
* Initialize default values for when options haven't been set yet

= 2.3 =
* Bugfix for versions of PHP < 5.4 that don't support short array syntax

= 2.2 =
* Bugfix for jquery-ui dependencies on certain Wordpress installations

= 2.1 =
* Fix missing images that weren't included correctly in 2.0 release

= 2.0 =
* Major version release
* Use the new engine of the BibleGet I/O service, which supports multiple versions, dynamic indexes, multiple languages both western and eastern
* Store locally the index information for the versions, for local integrity checks on the queries
* Better and more complete local integrity checks on the queries, using the index information for the versions and supporting both western and eastern languages
* Better and more complete interface for the settings page

= 1.5 =
* Compatible with Wordpress 4.0 "Benny"
* Added local checks for the validity and integrity of the queries
* Corrected a bug that created an error on preg_match_all for versions of PHP < 5.4
* Use the new and definitive domain for the BibleGet I/O service http://query.bibleget.io

= 1.4 =
* Corrected a bug that created an error when the server has safe_mode or open_basedir set (such as some servers with shared hosting)

= 1.3 =
*

= 1.2 =
* 

= 1.1 =
* Corrected a bug that created an error when there is a space in the query

= 1.0 =
* Plugin created


== Upgrade Notice ==

= 3.7 =
While 3.6 was a Major update with complete overhaul of style settings and other bugfixes, this update fixes some language translations

= 3.6 =
Major update with complete overhaul of style settings and other bugfixes, update is mandatory

= 3.5 =
This is a minor update with a bugfix for a possible vulnerability

= 3.4 =
Minor update with better error handling, errors from the bibleget server will only show in backend

= 3.3 =
Minor update with bugfix for incorrect entries in languages array for German language

= 3.2 =
Minor update with further CSS styling enhancements especially for the NABRE text plus small bugfix

= 3.1 =
This is a minor update from v3.0 with CSS styling enhancements especially for the NABRE text

= 3.0 =
Bugfixes (please read changelog), compatibility with Wordpress 4.3, caching enhancements

= 2.9 =
Minor update for compatibility with Wordpres 4.2.2

= 2.8 =
Added Serbian and Polish translations, added specific functionality for parsing NABRE text and applying NABRE specific styles.

= 2.7 =
Added Serbian and Polish translations.

= 2.6 =
Minor bugfix from version 2.5, added Serbian translation.

= 2.5 =
This is a major release which uses the new and upgraded BibleGet I/O service engine. Must update. (plus Bugfixes)

= 2.4 =
This is a major release which uses the new and upgraded BibleGet I/O service engine. Must update. (plus Bugfixes)

= 2.3 =
This is a major release which uses the new and upgraded BibleGet I/O service engine. Must update. (plus Bugfixes)

= 2.2 =
This is a major release which uses the new and upgraded BibleGet I/O service engine. Must update.

= 2.1 =
This is a major release which uses the new and upgraded BibleGet I/O service engine. Must update.

= 2.0 =
This is a major release which uses the new and upgraded BibleGet I/O service engine. Must update.

= 1.5 =
Si prega aggiornare alla versione 1.5, compatibile con Wordpress 4.0.

= 1.4 =
Si prega effettuare l'upgrade alla versione 1.4 che corregge un paio di bug (errori con server che hanno il safe_mode attivato oppure la direttiva open_basedir settata).

= 1.3 =

= 1.2 =

= 1.1 =
Si prega effettuare l'upgrade alla versione 1.1 che corregge un paio di bug (errori con gli spazi bianchi).

= 1.0 =
Versione iniziale, non pienamente testato.