BibleGet I/O

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

POLISH TRANSLATION: Ula Gnatowska ula.gnatowska@gmail.com WEBSITE: comunità delle beatitudini

GREEK TRANSLATION: anonymous user contribution

BibleGet I/O

Screenshots

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

Installation

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

FAQ

Installation Instructions
  1. Upload the bibleget-io folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
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):
* “:”: 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.
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.
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″.

Contributors & Developers

“BibleGet I/O” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

3.9

  • Remove leftover dependencies on external jquery-ui

3.8

  • Fix Portuguese language translation after 3.6

3.7

  • Fix main language translations after 3.6 overhaul (Italian, French, Spanish, German)

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

2.6

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