BibleGet I/O

Descrizione

Once the plugin is installed, you will find a Bible quote block in the widgets section of the block editor.
Also available is a shortcode [bibleget] that you can use to insert Bible quotes in articles or pages from different versions of the Bible in different languages.

The text of the Bible quotes is retrieved from the BibleGet API https://query.bibleget.io.

Sample usage of the shortcode:

  • [bibleget query="Exodus 19:5-6,8;20:1-17" version="CEI2008"]
  • [bibleget query="Matthew 1:1-10,12-15" versions="NVBSE,NABRE"]

It is also possible to place the reference for the desired Bible quote in the contents of the shortcode:

  • [bibleget version="NABRE"]John 3:16;1 John 4:7-8[/bibleget]

The Plugin also has a settings page “BibleGet I/O” under “Settings” in the Administration area, 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 parameter 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:

  • [bibleget query=“1 Cor 13”]

The style settings are customizable using the WordPress Customizer, so you can make the Bible quotes fit into the style of your own blog / WordPress website.

The Bible quote block also has a number of customizable options in the block editor which allow you to set not only the style but also the layout of the elements that make up the Bible quote.

BibleGet Website
Subscribe to the Youtube channel!
Follow on Facebook!
Follow on Twitter!

Screenshot (schermate di esempio)

  • Inserting a Bible quote block into an article or page
  • Bible quote block: choose Bible version and insert Bible reference
  • Search results for search verses by keyword
  • Layout options for Bible version, Book and chapter reference...
  • Styling options with the WordPress Customizer

Blocchi

Questo plugin fornisce 1 blocco.

bibleget/bible-quote
Bible quote

Installazione

  1. Go to Administration Area -> Plugins -> Add new and search for bibleget, click on Install Now
  2. Activate the plugin once installation is complete
  3. Set the preferred Bible version or versions for your Bible quotes from the settings page Administration Area -> Settings -> BibleGet I/O
  4. Set your preferred styling in the WordPress Customizer -> BibleGet I/O or when you add a Bible quote block in the block editor
  5. Add Bible quotes to your articles and pages either with the Bible quote block or with the [bibleget] shortcode
  6. Check out the WordPress playlist on youtube!

FAQ

Come faccio a formulare una citazione Biblica?

The query parameter must contain a Bible reference formulated according to the standard notation for Bible citations (see Bible citation on Wikipedia).
Two different notations can be used, the English style notation and the International style notation.
ENGLISH 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:

    • da capitolo a capitolo: “15-16” significa “da capitolo 15 a capitolo 16”.
    • da capitolo,versetto a versetto (dello stesso capitolo): “15,1-5” significa “capitolo 15, dal versetto 1 al versetto 5”.
    • da capitolo,versetto a capitolo,versetto “15,1-16,5” significa “da capitolo 15,versetto 1 a capitolo 16,versetto 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”.

INTERNATIONAL NOTATION:

  • “,” is the chapter – verse separator. “15,5” means “chapter 15, verse 5”.

  • “-” same as English notation

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

  • “;” same as English notation

Either notation can be used, however they cannot be mixed within the same query.

At least the first query (of a series of queries chained by a semi-colon) must indicate the name of the book to quote from; 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 List of Book Abbreviations.
When a query following a semi-colon does not indicate the book name, it is intended that the same book as the previous query will be quoted.
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”.

Ho inviato una richiesta per una citazione Biblica lunga ma ci sono soltanto 30 versetti nella risposta

Se stai utilizzando una versione della Bibbia coperta da diritti, non potrai citare più di 30 versetti per volta. Se per esempio richiedi “Gen1” utilizzando la versione CEI2008, potresti aspettarti di trovare Gen1,1-31 nella risposta ma avrai invece Gen1,1-30. Questo è un limite imposto dagli accordi legali che permettono l’utilizzo di queste versioni, pertanto non si tratta di un bug ma piuttosto il motore è pensato proprio così. Se devi proprio avere più di 30 versetti quando fai una richiesta per una versione coperta da diritti, dovresti formulare la richiesta come una serie di citazioni divise in gruppetti di non più di 30 versetti ognuno, per esempio “Gen1,1-30;1,31”.

Che succede se metto una chiave per l’API di Google Fonts?

Se aggiungi una chiave dell’API di Google Fonts, il plugin BibleGet farà immediatamente un test per verificarne la validità. Se valida, la ricorderà come valida per 3 mesi. Ogni tre mesi a partire da questo momento il plugin BibleGet dialogherà con l’API di Google Fonts per avere la lista più recente dei Google Fonts disponibili, e scaricherà in una cartella locale una versione compressa di ognuno di questi per poterli vedere in anteprima nell’interfaccia del Personalizza.
Ci vorrà un po’ di pazienza la prima volta in quanto ci vorrà qualche minuto per completare il processo di scaricamento. Una barra di avanzamento indicherà a che punto sta il processo di scaricamento. Se la tua connessione è un po’ lenta, l’avanzamento potrebbe andare in stallo per qualche secondo ogni tanto durante questo processo (per esempio intorno al 25%, al 50%, e al 75%), basta portare un po’ di pazienza e lo scaricamento dovrebbe proseguire fino alla fine. Poi in futuro, ogni volta che il plugin dialogherà con l’API di Google Fonts, il processo dovrebbe avanzare molto più velocemente visto che dovrà scaricare soltanto i font più recenti.
Verrà generato anche un foglio di stile che serve a caricare l’anteprima dei font quando apri l’interfaccia del Personalizza. L’anteprima di tutti i font di Google ha chiaramente un certo impatto sulle prestazioni, soprattutto la prima volta che apri il Personalizza potrebbe metterci un minuto per caricare. Dopo dovrebbe essere un po’ più veloce in quanto il browser dovrebbe effettuare un cache degli elementi dell’anteprima dei font. Se però non rimani soddisfatto dell’impatto sulle prestazioni, ti conviene non utilizzare la chiave per l’API di Google Fonts.

Ho aggiunto la chiave dell’API di Google Fonts ma la lista dei font disponibili non è aggiornata

Il plugin BibleGet registra la validità della chiave per un periodo di 3 mesi. Questo significa che non cercherà di aggiornare la lista dei font dall’API di Google Fonts se non quando scade il transient. Se nel frattempo fosse uscito un nuovo font che vorresti vedere e utilizzare nell’interfaccia del Personalizza del plugin BibleGet, e non vuoi aspettare la scadenza del transient nell’arco di quei 3 mesi, puoi fare clic sull’opzione “forza l’aggiornamento” sotto la tua chiave API.

Ho aggiunto la chiave dell’API di Google Fonts ma mentre stava processando lo scaricamento si è bloccato con un errore http status 504

Se ricevi un errore di stato http 504, significa che la connessione al server dell’API di Google Fonts è caduta per qualche motivo. Il plugin BibleGet cerca di gestire la situazione forzando un riavvio del processo, se però il processo si dovesse bloccare avvisa l’autore del plugin all’indirizzo email admin@bibleget.io in modo che possa investigare meglio la situazione. In ogni modo puoi tranquillamente riavviare la pagina e usare l’opzione “forza l’aggiornamento” che si trova sotto la tua chiave API, e il processo riprenderà da dove aveva lasciato.

I updated the plugin to version 5.4 or later, but the new ‘Bible quote’ block doesn’t seem to be cooperating

In order to allow for new layout options, the BibleGet I/O API itself was slightly updated, and there is a little more information in the response from the server.
However Bible quotes are cached by the BibleGet plugin for a seven day period, which means that from the time of the update until about a week later the cached Bible quotes will not have the necessary information for them to work with the ‘Bible quote’ block.
If you do not want to wait seven days or until the cache expires, there is a new option in the BibleGet Settings page since version 5.7 which allows to flush the cache.
A word of caution however: the more recent updates to the BibleGet service endpoint have started imposing hard limits on the number of requests that can be issued from any given domain, IP address or referer. No more than 30 requests for one same Bible quote can be issued in a two day period, and no more than 100 requests for different Bible quotes can be issued in a two day period. If you have many Bible quotes on your website and you risk hitting the limit, it may be best not to flush the cache all at once but rather wait out the seven days until the cache expires.

Sometimes the Bible quote block is giving an error ‘Error loading block: The response is not a valid JSON response.’

If you sometimes see this error, one possible situation is that your server configuration needs to allow for a larger buffer for proxy requests. You can check that that is the case if you open your browser’s Inspector Tools (for example CTRL-SHIFT-I in Google Chrome) and you see a failed GET request by the api-fetch.min.js script to a wp-json endpoint something like this: /wp-json/wp/v2/block-renderer/bibleget/bible-quote?…
You can further inspect the Network tab of the browser’s Inspector Tools (this may require reloading the page and retrying the request). If you see a similar request in the Network tab with a response of ‘502 Bad Gateway’, this could be an indication that you may need a larger buffer for your server.
If for example you have an nginx server, you may need to edit your /etc/nginx/nginx.conf and set ‘proxy_buffer_size’ to a larger value (see for example this thread).

I’m not able to use some options in the Gutenberg block such as positioning of the Bible version

There was recently an update to the BibleGet I/O API which slightly changed the structure of the html that comprises the Bible quotes. It is necessary to update the plugin to v5.9 in order to be compatible with these changes.

Recensioni

18 Maggio 2018
Plugin produced the following, preventing me from gaining access to the login page to the admin panel. Deprecated: Methods with same name as their class will not be constructors in a future version of PHP; SMTheme has a deprecated constructor in /home1/wvtwopac/public_html/wp-content/themes/monamour/inc/library.php on line 2 I couldn't do anything to rid my site of the error until I finally deactivated, but now it won't actually delete, so I can't get rid of it completely.
Leggi tutte le recensioni di 4

Contributi e sviluppo

“BibleGet I/O” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.

Collaboratori

“BibleGet I/O” è stato tradotto in 1 lingua. Grazie ai traduttori per i loro contributi.

Traduci “BibleGet I/O” nella tua lingua.

Ti interessa lo sviluppo?

Esplora il Codice segui il Repository SVN iscriviti al Log delle Modifiche. Puoi farlo tramite RSS con un lettore di feed.

Changelog (registro delle modifiche)

7.0

  • Compatibility with WordPress 5.5

6.9

  • Fix regression in shortcode function: version attribute not working correctly

6.8

  • Fix color picker icons that weren’t showing
  • Fix positioning of search button next to search input field on first load of gutenberg block

6.7

  • Fix search for Bible verses to work with the latest updates to the BibleGet search endpoint
  • Add filter and order functionality to the search results window
  • Add possibility of inserting Bible verses from the search results into the Gutenberg block directly from the search results window

6.6

  • Fix sanitization function which was failing in some cases

6.5

  • Fix error message : Illegal string offset ‘PARAGRAPHSTYLES_FONTFAMILY’ in options.php
  • Fix typo in PHP get_option function

6.4

  • Ensure “version” attribute is preserved during transform bibleget shortcode to Bible quote block
  • Ensure Bible versions set in settings will become default and stay such, even when Bible version is changed in the Bible quote block options

6.3

  • Fix typo in PHP function

6.2

  • Better type checks on saved options when building default options
  • Ensure shortcodes will be rendered same as Gutenberg blocks

6.1

  • Fix typo in PHP update_option function

6.0

  • Ensure that default options are defined on activation

5.9

  • Gutenberg block now has all possible options in the sidebar, which are in synchronized to Customizer options
  • Customizer has better UI, even though it doesn’t have all the layout options that the Gutenberg block has
  • An update to the html output from the BibleGet server requests required an update to the plugin handling logic of the html structure
  • Better handling both from the BibleGet endpoint and from the plugin for rendering of Bible book names in WP interface language when using non catholic versions with different book numbering

5.8

  • once a traditional shortcode is transformed into a block shortcode, allow transforming the block shortcode into a ‘Bible quote’ block

5.7

  • better handling of bible quotes cache by prefixing the transients
  • added option to flush bible quotes cache from settings page

5.6

  • turn off PHP error reporting!

5.5

  • Bugfix: fixed a cleanup error on removal of the plugin

5.4

  • created Gutenberg block

5.3

  • Interfaccia più pulita per la chiave dell’API di Google Fonts e migliore gestione dei vari scenari con un maggiore controllo nell’interfaccia di amministrazione

5.2

  • Piccola correzione a una istruzione javascript vagante che generava un errore sulla pagina
  • Piccola correzione ai nuovi elementi html e ai loro stili sulla pagina

5.1

  • verificata la compatibilità con WordPress 5.4
  • Corretto un errore nella funzione di disinstallazione, che non teneva conto delle nuove modalità ajax e poteva prevenire la disinstallazione del plugin
  • Aggiornate le traduzioni

5.0

  • verificata la compatibilità con WordPress 5.3.2
  • Aggiunta un’opzione per la chiave dell’API di Google Fonts

4.9

  • Risoluzione di errore: corretta la valutazione dei parametri dello shortcode per la corretta implementazione delle versioni e della funzionalità della finestra a comparsa
  • verificiata la compatibilità con WordPress 4.9

4.8

  • Miglioramento: aggiunto parametro “popup” allo shortocode, per permettere di nascondere i contenuti della citazione biblica e mostrarli in una finestra a comparsa con un clic

4.7

  • Corretto un errore con un menu a comparsa di jQuery Fontselect che non si apriva in corrispondenza dell’ultimo font selezionato
  • Corretto un errore con il plugin jQuery Fontselect che non processava i font in corsivo o in neretto
  • Corretto un errore di battitura di una variable PHP che generava errore

4.6

  • Miglioramenti: è stato modificato e implementato in modo liberale il plugin jQuery Fontselect di Tom Moor, con la sua lista fissa dei WebFonts di Google, in modo da accomodare anche la lista dei Fonts ritenuti websafe

4.5

  • Miglioramento: una verifica ulteriore per ambienti server non corretti dove non c’è una versione recente di curl che punti correttamento su un percorso ‘cainfo’ di certificati
  • Miglioramento: il menu a comparsa dei fonts ora effettua l’anteprima del font stesso

4.4

  • Compatibilità con WordPress 4.8
  • Risoluzione di errore minimale: corrette le opzioni predefinite per le impostazioni degli stili prescelti dell’indicatore di versione biblica nel Customizer

4.3

  • Miglioramento: aggiunto un a-capo prima del numero di versetto per alcuni versetti poetici formattati in modo specifico nella versione NABRE della Bibbia
  • Miglioramento: aggiunta opzione nel Personalizza di WordPress per lo stile dell’indicatore di versione biblica
  • Miglioramento: ri-organizzazione delle opzioni per gli stili nel Customizer in sottosezioni

4.2

  • Aggiunta una verifica di compatibilità della versione curl e openssl preferendo il protocollo TLS v1.2 per comunicazioni più sicure,
    anche nel caso di aggiornamenti dei metadati con si rinnovano i dati dal server BibleGet

4.1

  • Aggiunta una verifica per la compatibilità delle versioni di curl e openssl disponibili preferendo il protocollo TLS v1.2 per comunicazioni più sicure;
    se non compatibili si tenterà una richiesta di tipo http quando si prelevano i versetti biblici, altrimenti verrà fatta sempre una richiesta https al server BibleGet
  • Aggiunto un indicatore grafico di processamento per una migliore esperienza utente quando si rinnovano i metadati dal server BibleGet

4.0

  • Altra risoluzione di errore, il miglioramento della spaziatura tra un numero di versetto e il testo del versetto rimuoveva anche la formattazione specifica del testo della versione NABRE

3.9

  • Rmuovere rimasugli di dipendenze da una versione esterna di jquery-ui

3.8

  • Aggiornamento della traduzione in portoghese dopo il rilascio della versione 3.6

3.7

  • Aggiornamento delle traduzioni in lingua dopo la completa revisione della versione 3.6 (Italiano, Francese, Spagnolo, Tedesco)

3.6

  • Completa revisione delle impostazioni degli stili per iniziare l’utilizzo del Customizer di WordPress
  • Risoluzione di errore che preveniva l’utilizzo delle versioni preferite impostate nella pagina di amministrazione quando il parametro “versions” non è utilizzato nello shortcode
  • Cambiati i nomi delle funzioni interne per renderli più specifici, onde evitare la possibilità di un conflitto con altri plugin
  • Migliore renderizzazione degli spazi nei nomi dei libri biblici e tra i numeri dei versetti e il testo dei versetti
  • Aggiornati i file delle lingue

3.5

  • Corretta una possibile vulnerabilità nello script che salva il foglio di stili personalizzato

3.4

  • Migliore gestione degli errori: eventuali errori a livello server restituiti dal server BibleGet verranno visualizzati nelle notifiche del backend, e non verranno salvate nei transient. (questo aggiornamento grazie al feedback dell’utente D.N. – il feedback degli utenti è molto utile!)

3.3

  • Risoluzione di errore negli array per la traduzione in Tedesco

3.2

  • Altri miglioramenti per gli stili CSS, soprattutto per il testo NABRE
  • Aggiunte altre immagini per i pulsanti in lingua
  • Risoluzione di errore minimale nella codificazione url dei parametri

3.1

  • Altri miglioramenti per gli stili CSS, soprattutto per il testo NABRE

3.0

  • Aggiornamento per la compatibilità con WordPress 4.3
  • Aggiunta una traduzione in greco grazie al contributo di un utente sul sito del progetto di traduzione
  • Aggiunte traduzioni francese e tedesco utilizzando strumenti di traduzione automatica con una minimale verifica di qualità (probabilmente possono essere migliori)
  • Miglioramento: i risultati delle query verranno salvati nella cache locale per 24 ore utilizzano l’API per i Transients di WordPress
  • Risoluzione di errore: codice che veniva utilizzato in fase di sviluppo per il debug, e che creava un file ‘debug.txt’, non era stato rimosso e il file ‘debug.txt’ andava a finire nella cartella del tema (si può cancellare se lo si trova presente!)
  • Alcuni miglioramenti negli stili CSS, specialmente per il testo NABRE che ora è disponibile

2.9

  • Aggiornata per la compatibilità con WordPress 4.2.2
  • Corretto un piccolo errore nel foglio di stile css

2.8

  • Aggiunta una specifica funzionalità per l’analisi del testo NABRE e l’applicazione dei suoi stili specifici

2.7

2.6

2.5

  • Risoluzione di errore per vecchie versioni di PHP che richiedono un terzo parametro nella funzione preg_match_all

2.4

  • Risoluzione di errore per vecchie versioni di PHP che non funzionano correttamente con mb_substr
  • Inizializzare valori predefiniti quando le opzioni non sono state ancora impostate

2.3

  • Risoluzione di errore per le versioni di PHP < 5.4 che non supportano la sintassi breve per gli array

2.2

  • Risoluzione di errore per le dipendenze jquery-ui in alcune installazioni di WordPress

2.1

  • Corrette le immagini mancanti del rilascio 2.0

2.0

  • Rilascio di versione maggiore
  • Utilizzo del nuovo motore per il servizio BibleGet I/O, che supporta versioni multiple, indici dinamiche, lingue multiple sia occidentali che asiatiche
  • Mantenere in locale le informazioni per le versioni, con verifiche locali per l’integrità delle queries
  • Migliori e più complete verifiche locali per l’integrità delle queries, utilizzano l’informazione delle indici per le versioni bibliche e con supporto per le lingue sia occidentali che asiatiche
  • Interfaccia migliorata e più completa per la pagina delle impostazioni

1.5

  • Compatibilità con WordPress 4.0 “Benny”
  • Aggiunte verifiche in locale per la validità e l’integrità delle queries
  • Risoluzione di un possibile errore nell’utilizzo della funziona preg_match_all per versioni di PHP < 5.4
  • Utilizzare il dominio nuovo e definitivo per il servizio BibleGet I/O https://query.bibleget.io

1.4

  • Risoluzione di un errore quando il è impostato il safe_mode o open_basedir nel server (per esempio molti server di hosting condiviso)

1.3

  • cercando di capire come funziona la procedura di aggiornamento…

1.2

  • cercando di capire come funziona la procedura di aggiornamento…

1.1

  • Risoluzione di un errore quando c’era uno spazio nella query

1.0

  • Creazione del plugin