內容簡介
EstudoBiblico Bíblia Digital 外掛讓網站管理員能夠在 WordPress 中發佈本地儲存的聖經內容，透過專屬的資料庫表格、友好的網址、短碼、小工具及搜尋區塊，提供使用者便捷的聖經閱讀體驗。
【主要功能】
• 前端聖經閱讀器，依書籍、章節及經文顯示
• 支援多種搜尋方式，包括關鍵字及精確短語
• 友好的網址結構，適用於書籍、章節及經文
• SEO 元資料及本地清單端點支援
• Gutenberg 搜尋區塊及隨機經文小工具
• 多版本聖經支援，每個網站可使用多種翻譯
外掛標籤
開發者團隊
② 後台搜尋「EstudoBiblico Bíblia Digital」→ 直接安裝（推薦）
原文外掛簡介
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.
Live demo: the plugin runs the Bible section of estudobiblico.org, in English and Spanish as well, with the reader, the search and the version switcher working on real content.
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.
