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”]

Le configurazioni degli stili sono personalizzabili utilizzando Personalizza di WordPress, in modo che le citazioni inserite siano conformi allo stile del tuo blog o sito WordPress.

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

  • 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 I/O

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”.

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

    • 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”.
  • “,” è il separatore tra un versetto e un altro. “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”.

INTERNATIONAL NOTATION:

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

  • “-” same as English notation

  • “.” è il separatore tra un versetto e un altro. “15,5.7.9” significa “capitolo 15, versetto 5 poi versetto 7 poi versetto 9”.

  • “;” same as English notation

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

Almeno la prima query (di una serie di query concatenate da punto e virgola) deve indicare il nome del libro biblico per la citazione;
il nome del libro si può scrivere completo in più di 20 lingue diverse, oppure si può usare la forma abbreviata.
Vedi la pagina Elenco di abbreviazioni dei libri.
Qualora una query che segue un punto e virgola non indichi il libro, si suppone che si intenda citare dallo stesso libro indicato nella query precedente.
Pertanto “Gen1:7-9;4:4-5;Es3:19” significa “Genesi capitolo 1, versetti da 7 a 9; poi ancora Genesi capitolo 4, versetti 4 e 5; e poi Esodo capitolo 3, versetto 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.

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.5

  • Fix: check GFonts for null value (like when Google Fonts previews are not installed or updated)

7.4

  • Fix: recent updates to the Block editor gave a fixed height to all select inputs, whether they had the multiple attribute or not, needed to override it for select[multiple] until it’s fixed in the Gutenberg repo
  • Enhancement: Bible versions are now grouped into option groups organized by language in the multiselect
  • Enhancement: functional font-picker added to the General Styles in the gutenberg block options, which also works with Google Fonts API key and font previews
  • Enhandement: add option for preferring Greek / Hebrew origin for those Bible texts that offer a choice
  • Enhancement: highlight accented search results matched against non accented keywords
  • Enhancement: allow for any kind of dash in formulation of the Bible citation query string
  • This is a duplicate of 7.3, required by the new Github to SVN workflow…

7.3

  • Fix: recent updates to the Block editor gave a fixed height to all select inputs, whether they had the multiple attribute or not, needed to override it for select[multiple] until it’s fixed in the Gutenberg repo
  • Enhancement: Bible versions are now grouped into option groups organized by language in the multiselect
  • Enhancement: functional font-picker added to the General Styles in the gutenberg block options, which also works with Google Fonts API key and font previews
  • Enhandement: add option for preferring Greek / Hebrew origin for those Bible texts that offer a choice
  • Enhancement: highlight accented search results matched against non accented keywords
  • Enhancement: allow for any kind of dash in formulation of the Bible citation query string

7.2

  • Fix: styling of poetic verses in NABRE version
  • Fix: error table not hidden to end user

7.1

  • Use POST requests for the ServerSideRender component if available (Gutenberg 8.8 plugin required)

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