BibleGet I/O

Descripción

Una vez que el plugin esté instalado, encontrarás un bloque de Cita bíblica en la sección de widgets del editor de bloques.
También está disponible un shortcode [bibleget] que puedes usar para insertar citas bíblicas de diferentes versiones de la Biblia en diferentes idiomas en tus artículos o tus páginas.

El texto de las citas de la Biblia se recupera de la API de BibleGet https://query.bibleget.io.

Ejemplo de uso del shortcode:

  • [bibleget query="Éxodo 19:5-6,8;20:1-17" version="BLPD"]
  • [bibleget query="Mateo 1:1-10,12-15" versions="NVBSE,BLPD"]

También es posible colocar la referencia para la cita deseada de la Biblia en el contenido del shortcode:

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

El plugin también tiene una página de ajustes “BibleGet I/O” en “Ajustes” en el área de administración, donde puedes elegir tus versiones de la Biblia preferidas de las disponibles en el servidor de BibleGet para que no tengas que usar el parámetro version o versions cada vez.
Después de hacer tus elecciones en el área de ajustes, ¡recuerda hacer clic en “Guardar”!
Una vez establecida la versión preferida, simplemente puedes usar:

  • [bibleget query="1 Cor 13"]

Otros parámetros disponibles para el shortcode son:

  • popup: puede tener un valor de true o false. Determinará si el texto de la cita bíblica se mostrará en un bloque completo, o en cambio en una ventana emergente al hacer clic en la cita bíblica. Ejemplo: [bibleget query="Romanos 8:28" popup="true"]
  • preferorigin: puede tener un valor de GREEK o HEBREW, útil en aquellos casos en los que hay múltiples textos para el mismo libro, capítulo o versículo en la misma edición de la Biblia, como en el Libro de Ester donde se incluyen ambas versiones, una basada en el texto original griego y la otra basada en el texto original hebreo. Ejemplo: [bibleget query="Ester 1:1" preferorigin="HEBREW"]
  • layoutprefs_showbibleversion: puede tener un valor de true o false. Ejemplo: [bibleget query="Ezequiel 25:17" layoutprefs_showbibleversion="false"]
  • layoutprefs_bibleversionalignment: puede tener un valor de LEFT, CENTER, RIGHT o JUSTIFY. Ejemplo: [bibleget query="Salmo 149:3" layoutprefs_bibleversionalignment="LEFT"]
  • layoutprefs_bibleversionposition: puede tener un valor de TOP, BOTTOM o BOTTOMINLINE. Ejemplo: [bibleget query="2 Samuel 6:14" layoutprefs_bibleversionposition="BOTTOM"]
  • layoutprefs_bibleversionwrap: puede tener un valor de NONE, PARENTHESES o BRACKETS. Ejemplo: [bibleget query="Eclesiastés 3:1-4" layoutprefs_bibleversionwrap="BRACKETS"]
  • layoutprefs_bookchapteralignment: puede tener un valor de LEFT, CENTER, RIGHT o JUSTIFY. Ejemplo: [bibleget query="Gálatas 5:7-10" layoutprefs_bookchapteralignment="RIGHT"]
  • layoutprefs_bookchapterposition: puede tener un valor de TOP, BOTTOM o BOTTOMINLINE. Ejemplo: [bibleget query="Marcos 13:35-37" layoutprefs_bookchapterposition="BOTTOMINLINE"]
  • layoutprefs_bookchapterwrap: puede tener un valor de NONE, PARENTHESES o BRACKETS. Ejemplo: [bibleget query="Juan 8:12" layoutprefs_bookchapterwrap="PARENTHESES"]
  • layoutprefs_bookchapterformat: puede tener un valor de USERLANG, BIBLELANG, USERLANGABBREV o BIBLELANGABBREV. Ejemplo: [bibleget query="Salmos 144:1-2" layoutprefs_bookchapterformat="USERLANGABBREV"]
  • layoutprefs_bookchapterfullquery: puede tener un valor de true o false. Ejemplo: [bibleget query="Isaías 6:8" layoutprefs_bookchapterfullquery="true"]
  • layoutprefs_showversenumbers: puede tener un valor de true o false. Ejemplo: [bibleget query="1 Juan 2:15-17" layoutprefs_showversenumbers="false"]

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.

El bloque Cita bíblica también tiene varias opciones personalizables en el editor de bloques que te permiten establecer no solo el estilo, sino también la estructura de los elementos que componen la cita bíblica.

Sitio web de BibleGet
¡Suscríbete al canal de Youtube!
¡Síguenos en Facebook!
¡Síguenos en Twitter!

Capturas

  • Inserción de un bloque de cita de la Biblia en un artículo o página
  • Bloque de cita de la Biblia: elige la versión de la Biblia e inserta la referencia bíblica
  • Resultados de búsqueda de versículos por palabra clave
  • Opciones de estructura para la versión de la Biblia, la referencia del libro y del capítulo...
  • Opciones de estilo con el Personalizador de WordPress

Bloques

Este plugin proporciona 1 bloque.

  • Bible quote Insert Bible quotes from a choice of Bible versions into your articles or pages

Instalación

  1. Ve a Área de Administración -> Plugins -> Añadir nuevo y busca bibleget, haz clic en Instalar ahora
  2. Activar el plugin una vez que la instalación esté completa
  3. Establece la versión preferida o versiones preferidas de la Biblia para tus citas bíblicas desde la página de ajustes Área de Administración -> Ajustes -> BibleGet I/O
  4. Establece tu estilo preferido en el Personalizador de WordPress -> BibleGet I/O o cuando añades un bloque Cita bíblica en el editor de bloques
  5. Añadir citas de la Biblia a tus artículos y páginas ya sea con el bloque Cita biblica o con el shortcode [bibleget]
  6. ¡Echa un vistazo a la lista de reproducción de WordPress en YouTube!

FAQ

¿Cómo puedo formular una cita bíblica?

El parámetro query debe contener una referencia bíblica formulada según la notación estándar para citas bíblicas (ver Cita bíblica en Wikipedia).
Se pueden utilizar dos notaciones diferentes, la notación inglés (Manual de Estilo de Chicago) y la notación de estilo internacional.

NOTACIÓN INGLÉS:

  • “:” es el separador de capítulo – versículo. “15:5” significa “capítulo 15, versículo 5”.

  • «-«: es el separador de – a, y puede ser utilizado en una de tres maneras:

    • De capítulo a capítulo: «15-16» significa «del capítulo 15 al capítulo 16».
    • de capítulo,versículo a versículo (del mismo capítulo): «15:1-5» significa «capítulo 15, del versículo 1 al versículo 5».
    • de capítulo,versículo a capítulo,versículo «15:1-16:5» significa «desde el capítulo 15, versículo 1 hasta el capítulo 16, versículo 5».
  • «.»: Es el separador entre un versículo y otro. «15,5.7.9» significa «capítulo 15, versículo 5 luego versículo 7 luego versículo 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”.

NOTACIÓN INTERNACIONAL:

  • «,» es el separador de capítulo – versículo. «15,5» significa «capítulo 15, versículo 5».

  • “-” igual que la notación inglés

  • «.»: Es el separador entre un versículo y otro. «15,5.7.9» significa «capítulo 15, versículo 5 luego versículo 7 luego versículo 9».

  • «;» igual que la notación inglés

Se puede usar cualquiera de las notaciones, pero no se pueden mezclar en la misma consulta.

La notación de estilo MLA (que utiliza un punto «.» como separador de capítulo y versículo, y solo es compatible con rangos de versículos consecutivos, no con versículos no consecutivos) no es compatible.

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

Estoy pidiendo una cita larga de la Biblia pero solo estoy recibiendo 30 versículos

Si estás utilizando una versión de la Biblia que está cubierta por copyright, no podrás citar más de 30 versículos a la vez. Así que si solicitas, por ejemplo, «Gén1» usando la versión BLPD, podrías esperar recibir Gén1:1-31 pero en cambio solo recibirás Gén1:1-30. Este es un límite impuesto por los acuerdos legales para el uso de estas versiones, no es un fallo, es intencional. Si necesitas más de 30 versículos al solicitar una versión cubierta por copyright, formula la solicitud como citas múltiples divididas en no más de 30 versículos cada una, por ejemplo «Gén1:1-30;1:31».

What happens if I add a Google Fonts API key?

Si añades una clave de API de Google Fonts, el plugin BibleGet la probará inmediatamente para comprobar su validez. Si es válida, recordará que tienes una clave y que es válida durante 3 meses. Cada tres meses a partir de este momento, el plugin BibleGet se comunicará con la API de Google Fonts para obtener la última lista de fuentes de Google disponibles, y descargará en las carpetas del plugin una copia comprimida local de cada una de esas fuentes con el fin de previsualizarlas en la interfaz del Personalizador.
La primera vez necesitarás ser un poco paciente, ya que tardará un par de minutos en completar el proceso de descarga. Una barra de progreso te indicará cómo avanza la descarga. Si tienes una conexión lenta, es posible que la barra de progreso se detenga durante unos segundos de vez en cuando (alrededor del 25%, 50% y 75%), simplemente ten paciencia y debería continuar hasta el final. En el futuro, cada vez que el plugin se comunique con la API de Google Fonts, el proceso debería ser mucho más rápido, ya que solo necesitará descargar las fuentes nuevas.
También generará un archivo css que cargará la previsualización de las fuentes cuando abras la interfaz del Personalizador. Esto tiene un impacto en el rendimiento, y especialmente la primera vez que abras el Personalizador podría tardar un minuto en cargarse. Después de esto, debería ir un poco más rápido, ya que las previsualizaciones de las fuentes deberían estar en la caché del navegador. Si no estás contento con el impacto en el rendimiento, te sugeriría borrar la clave de API de Google Fonts.

He añadido la clave de la API de Google Fonts pero la lista de fuentes disponibles no está actualizada

El plugin BibleGet recordará que tu clave es válida durante 3 meses. Esto significa que no buscará la lista de fuentes en la API de Google Fonts hasta que caduque el dato transitorio correspondiente. Si ha salido una nueva fuente que te gustaría ver y usar en la interfaz del Personalizador para el plugin BibleGet, y no quieres tener que esperar hasta que caduque el dato transitorio en ese período de 3 meses, entonces puedes hacer clic en la opción «forzar actualización» debajo de tu clave API.

Añadí la clave de la API de Google Fonts pero mientras estaba procesando la descarga se detuvo con un error de estado http 504

Si recibes un error de estado http 504 significa que la conexión con la API de Google Fonts se agotó por alguna razón. El plugin BibleGet intenta manejar esta situación forzando el proceso a comenzar de nuevo, pero si en cambio el proceso se detiene, por favor avisa al autor del plugin en admin@bibleget.io para investigar más a fondo el manejo de esta situación. En cualquier caso, puedes recargar la página y usar la opción de «actualización forzada» debajo de tu clave de API y el proceso continuará donde se quedó.

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.

No puedo usar algunas opciones en el bloque de Gutenberg, como la posición de la versión de la Biblia

Recientemente hubo una actualización en la API de BibleGet I/O que cambió ligeramente la estructura del html que compone las citas bíblicas. Es necesario actualizar el plugin a la v5.9 para ser compatible con estos cambios.

Reseñas

18 de mayo de 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.
Leer todas las 4 reseñas

Colaboradores y desarrolladores

«BibleGet I/O» es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

«BibleGet I/O» está traducido en 2 idiomas. Gracias a los traductores por sus contribuciones.

Traduce «BibleGet I/O» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

8.3

  • Fix: Google Fonts preview data was not persisting between updates

8.2

  • Fix: focus lost from block controls making it almost impossible to use them
  • Enhancement: create fallback for Google Fonts when API key not used, and which works for the Font select control both in the Customizer and the Block editor
  • Enhancement: clean up js code using more arrow functions

8.1

  • Fix: Font Select in Customizer was still broken after modernizing the plugin’s javascript

8.0

  • Fix: bug when downloading previews for Google Fonts (typo in curl variables)
  • Fix: bug in using popup option for Bible quotes (incorrect loading of external javascripts)

7.9

  • Fix: newer parameters such as preferorigin not working correctly for the shortcode
  • Better organized codebase, better readability and maintainability
  • Spaces to tabs in codebase as per WP coding convention
  • Use composer on plugin build step to include external scripts while excluding unnecessary files
    (getting this to behave correctly with the github to svn actions is the reason why there’s a jump from v7.5 to v7.9)
  • Load external javascript scripts from cdn rather than checking into the repo
  • verified compatibility with WordPress 6.4

7.8

  • see v7.9

7.7

  • see v7.9

7.6

  • see v7.9

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

  • Cleaner interface for the Google Fonts API key and better handling of different scenarios with more control in the admin interface

5.2

  • Small bugfix where a stray javascript debugging line was throwing an error
  • Small fix to new html elements and their styling on the page

5.1

  • verified compatibility with WordPress 5.4
  • Bugfix: uninstall was not taking into account the newer ajax requests and could have prevented the plugin from being uninstalled
  • Updated translations

5.0

  • verified compatibility with WordPress 5.3.2
  • added option for Google Fonts API key

4.9

  • Bugfix: corrected evaluation of shortcode parameters for correct implementation of versions and popup functionality
  • verified compatibility with WordPress 4.9

4.8

  • Enhancement: added «popup» parameter to shortcode, to allow hiding the contents of the bible quote and show it only on click in a popup

4.7

  • Minor bugfix: the jQuery Fontselect dropdown was not always opening in correspondance with the last selected font
  • Minor bugfix: the jQuery Fontselect plugin was not processing italic or bold styled fonts
  • Bugfix: typo in a PHP variable was causing an error

4.6

  • Enhancement: freely modified and implemented the jQuery Fontselect plugin by Tom Moor with it’s hardcoded list of Google WebFonts to accomodate both regular websafe fonts and google fonts

4.5

  • Enhancement: further check for incorrect server environments where a recent version of curl does not however have a correct cainfo path set with a certificate bundle
  • Enhancement: font-family selection now previews the font itself in the dropdown

4.4

  • Compatibility with WordPress 4.8
  • Minor bugfix: fixed defaults for Bible version indicator styling settings in customizer

4.3

  • Enhancement: add newline before verse number of specific formatted poetic verses in the NABRE version
  • Enhancement: add option in the WordPress Customizer for styling the Version Indicator
  • Enhancement: re-organize styling options in the customizer into subsections

4.2

  • Added check for compatibility of curl and openssl version on each website’s server with TLS v1.2 protocol for secure communications,
    also in the case of metadata updates when refreshing server data from the BibleGet server

4.1

  • Added check for compatibility of curl and openssl version on each website’s server with TLS v1.2 protocol for secure communications;
    if not compatible fall back to http request when fetching bible verses, otherwise https request to the BibleGet server will be made
  • Added ajax spinner for better user feedback when renewing metadata from the BibleGet server

4.0

  • Another bugfix, the fix that made the spacing better between verse number and verse text was also removing the specific formatting for the NABRE text

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 the favourite versions option from being used when «versions» option not used in shortcode
  • 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 https://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

  • trying to figure out the update process…

1.2

  • trying to figure out the update process…

1.1

  • Corrected a bug that created an error when there is a space in the query

1.0

  • Plugin created