EstudoBiblico Bíblia Digital lets site administrators publish locally stored Bible content in WordPress using plugin-owned database tables, friendly URLs, shortcodes, widgets, and a search block.

This public package does not include copyrighted Bible texts, SQL dumps, or proprietary translations. The site administrator imports licensed Bible data with a ZIP file that contains books.csv and verses.csv.

Main features:

Frontend Bible reader by book, chapter, and verse.
Search by word, phrase, exact phrase, any word, or all words.
Friendly URLs for books, chapters, verses, and version-aware paths.
Backward compatibility with older query-string URLs.
SEO metadata, canonical URL support, and local manifest endpoint.
Gutenberg search block.
Search widget and random verse widget.
Shortcodes for the reader, search, random verses, specific verses, and chapters.
Multisite-compatible structure.
Multiple Bible versions/translations per site.
Optional upload of .pot, .po, and .mo files for plugin interface translation.
Admin tabs for overview, import, versions, frontend translation, shortcodes, SEO and URLs, and diagnostics.
No required calls to external APIs.

Bible Data License

This plugin does not distribute Bible text. The site administrator is responsible for confirming that every imported translation is public domain, properly licensed, or used with permission from the rights holder.

Import Format

Bible text is imported from a ZIP file containing two CSV files: books.csv and verses.csv. Ready-made templates can be downloaded from Settings > Bíblia Digital > Import.

books.csv

The first line is the header. Then one book per line, all 66 books, numbered 1 (Genesis) to 66 (Revelation) in the traditional Protestant order.

livro_seq,livro,livro_desc
1,Gn,Genesis
2,Ex,Exodus
...
66,Rev,Revelation

livro_seq: book number, 1 to 66.
livro: short abbreviation.
livro_desc: book name. It is shown on the site and also becomes the book URL (Colossians /colossians/). Review the spelling before importing: changing it later changes the URL.

The import stops with a message listing the missing book numbers if any of the 66 is absent. Deuterocanonical books are not supported.

verses.csv

The first line is the header. Then one verse per line.

testamento,livroseq,livro,capitulo,versiculo,palavra
OT,1,Gen,1,1,"Text of Genesis 1:1."
NT,43,John,3,16,"Text with commas, and ""doubled"" quotes."

testamento: OT/NT, AT/NT or empty. It is inferred from the book number.
livroseq, capitulo, versiculo: book, chapter and verse numbers.
livro: abbreviation (optional content, required column).
palavra: plain verse text, up to 5,000 characters. HTML is removed.

Put the verse text in double quotes. Quotes inside the text are written doubled (""). Line breaks inside a quoted text are accepted.

Saving and packaging

Encoding: UTF-8. In Excel, use “CSV UTF-8 (Comma delimited)”. In LibreOffice, choose the Unicode (UTF-8) character set, comma separator and double quote as text delimiter. Files in another encoding are rejected with the line number.
Separator: comma is recommended. Semicolon is also accepted; the separator is detected once, from the header line.
ZIP: the two CSV files may be at the root of the ZIP or inside a single folder. System files added by macOS and Windows (__MACOSX/, .DS_Store, Thumbs.db) are ignored.
Limits: ZIP up to 50 MB and up to 25 MB extracted. The PHP zip extension is required.
Language: use a code such as pt-BR, en-US or es-ES.

Importing again and deleting versions

Each import creates a new Bible version and makes it active. To replace a translation, import the new file and then delete the old version in Settings > Bíblia Digital > Versions.

Deleting a version removes its record, books and verses, and cannot be undone. The active Bible cannot be deleted directly: activate another version first. URLs of a deleted version redirect (301) to the same book, chapter and verse in the active Bible.

Shortcodes

All shortcodes are also documented inside the plugin admin area under Settings > Biblia Digital > Shortcodes.

Main Bible Reader

Shortcode:

[biblia-digital]

Compatibility aliases:

[biblia-wp-estudobiblico]
[bibliawp-estudobiblico]

Description: displays the full Bible reader, including landing area, books, chapters, verses, search, breadcrumbs, and navigation.

Examples:

[biblia-digital]
[biblia-digital version="1"]
[biblia-digital per_page="30" title="Bible Reader" version="1"]

Attributes:

per_page: number of items per page when pagination is used. Default: 30.
title: optional title displayed by the shortcode when applicable.
version: Bible version ID. Example: version="1".

Simple Bible Search

Shortcode:

[biblia-busca]

Alias:

[estudo_biblico_busca]

Description: displays only the Bible search form.

Examples:

[biblia-busca]
[biblia-busca title="Search the Bible" placeholder="Type a word or phrase" button="Search"]

Attributes:

title: search form title.
placeholder: placeholder text for the search field.
button: submit button text.
version: Bible version ID, when applicable.

Full Search Page

Shortcode:

[biblia-busca-pagina]

Alias:

[biblia-digital-busca]

Description: displays the search form, results, and pagination. This shortcode is recommended for a public search page.

Examples:

[biblia-busca-pagina]
[biblia-busca-pagina title="Search the Bible" per_page="30" show_book="1"]

Attributes:

title: search page or block title.
per_page: number of results per page. Suggested default: 30.
show_book: show the book selector. Accepts 1 or 0.
version: Bible version ID, when applicable.

Random Verse

Shortcode:

[biblia-versiculo-aleatorio]

Description: displays a random Bible verse.

Examples:

[biblia-versiculo-aleatorio]
[biblia-versiculo-aleatorio book="19"]
[biblia-versiculo-aleatorio title="Verse of the Moment" book="19" show_button="1" button_text="Read chapter"]

Attributes:

title: block title.
book: book ID or book identifier. Example: book="19" for Psalms.
version: Bible version ID.
show_reference: show the Bible reference. Accepts 1 or 0.
link_reference: link the reference to the reader. Accepts 1 or 0.
show_button: show a chapter button. Accepts 1 or 0.
button_text: button label.

Specific or Random Verse

Shortcode:

[biblia-versiculo]

Description: displays one specific verse or a random verse.

Examples:

[biblia-versiculo livro="john" capitulo="3" versiculo="16"]
[biblia-versiculo book="43" chapter="3" verse="16"]
[biblia-versiculo livro="random" capitulo="random" versiculo="random"]
[biblia-versiculo livro="psalms" capitulo="23" versiculo="random"]

Attributes:

title: optional title.
livro: book name, abbreviation, or ID.
book: English alias for livro.
capitulo: chapter number or random.
chapter: English alias for capitulo.
versiculo: verse number or random.
verse: English alias for versiculo.
version: Bible version ID.
show_reference: show the reference. Accepts 1 or 0.
link_reference: link the reference to the reader. Accepts 1 or 0.
show_button: show a button. Accepts 1 or 0.
button_text: button label.

Accepted random values:

random
aleatorio
aleatório
rand
*

Specific or Random Chapter

Shortcode:

[biblia-capitulo]

Description: displays a specific chapter or a random chapter.

Examples:

[biblia-capitulo random="1" limite="15"]
[biblia-capitulo livro="john" capitulo="3"]
[biblia-capitulo livro="43" capitulo="3"]

Attributes:

title: optional title.
livro: book name, abbreviation, or ID.
book: English alias for livro.
capitulo: chapter number.
chapter: English alias for capitulo.
random: enable random chapter mode. Accepts 1 or 0.
limite: limit the number of displayed verses.
limit: English alias for limite.
version: Bible version ID.
show_title: show the chapter title. Accepts 1 or 0.
show_button: show a button to open the full chapter. Accepts 1 or 0.
button_text: button label.

Friendly URLs

Biblia Digital supports friendly URLs and keeps compatibility with older query-string URLs.

Version-aware URL example:

/biblia-digital/versao/acf-pt-br/john/3/16/

Legacy URL example:

/biblia-digital/john/3/16/?bdwp_bible_id=1

After changing the Bible URL base in the plugin settings, go to Settings > Permalinks and click Save Changes once.

Privacy

Biblia Digital does not collect personal data, track visitors, or require calls to external APIs. Imported Bible content is stored locally in the WordPress database.

License

This plugin is licensed under GPLv2 or later. Imported Bible data must be public domain, properly licensed, or used with permission from the rights holder.