BibleBridge
| 开发者 | biblebridge |
|---|---|
| 更新时间 | 2026年5月13日 13:29 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
BibleBridge is a complete Bible for your WordPress site — 12 translations, 95 topics with curated anchor verses, a scripture reference parser, cross-references, a topic explorer, reading plans, search, verse highlighting, verse notes, and optional cloud sync across devices.
Features:
- 12 Bible translations: KJV, BSB, ASV, WEB, YLT (English), Reina-Valera (Spanish), Louis Segond (French), Luther 1912 (German), Almeida RA (Portuguese), CUV (Chinese), KRV (Korean), Ang Dating Biblia (Tagalog)
- Scripture reference parser that recognizes natural references such as "Jn 3:16", "1 Cor 13:4-7", book-name abbreviations, and verse ranges
- Cross-references panel — tap any verse to open a list of related references with a back button and browsing history
- Topic explorer — 95 topics organized by the scripture they share, with 3,325 anchor verses across doctrine and pastoral care
- 5 reading plans: Bible in a Year, New Testament in 90 Days, New Testament in a Year, Gospel of John, Psalms & Proverbs
- Scripture search with book filtering and instant suggestions
- Verse sharing — copy text or generate image cards
- Verse highlighting with persistent colors
- Verse notes
- Cloud sync across devices via a short code (no account required)
- Dark mode
- Mobile layout with bottom navigation
- Install and activate the plugin
- Go to Settings → BibleBridge
- Set your reader name (e.g. "Grace Church Bible")
- Your Bible is live at yoursite.com/bible
- 250 API requests per day
- All 12 translations
- All features (search, topics, plans, cross-refs, sync)
- No ads, no tracking, no account wall
- BibleBridge API (holybible.dev/api) — serves all Bible content including scripture text, search, cross-references, topics, and reading plan data. On plugin activation, the plugin sends your site URL and site name to automatically provision a free API key. During normal use, visitor search queries and page navigation result in API calls that include the API key and requested scripture references. No visitor personal data is collected or transmitted.
- BibleBridge Sync (holybible.dev/reader/sync.php) — provides optional cross-device sync for visitor highlights, notes, and reading progress. Sync is initiated by visitors using an anonymous code (no email or account required). No personally identifiable information is collected.
安装:
- In your WordPress admin, go to Plugins → Add New
- Search for "BibleBridge" and click Install Now
- Activate the plugin
- Go to Settings → BibleBridge to set your reader name
- Add a "Bible" link to your site navigation pointing to
/bible/read
biblebridge folder to /wp-content/plugins/ and activate through the Plugins menu.屏幕截图:
常见问题:
Does this work out of the box?
Yes. The plugin works immediately with no setup required. A free API key is automatically provisioned for your site on activation. For usage alerts and higher limits, claim your key at holybible.dev/signup.
Who is this for?
Anyone who wants Scripture on their website — churches, ministries, bloggers, devotional sites, schools, or content creators.
What translations are included?
KJV, BSB, ASV, WEB, YLT (English), Reina-Valera (Spanish), Louis Segond (French), Luther 1912 (German), Almeida RA (Portuguese), CUV (Chinese), KRV (Korean), Ang Dating Biblia (Tagalog).
Does it slow down my site?
No. All styles and scripts are bundled with the plugin. Bible data is fetched on demand from the API. No heavy assets or database tables are added to your site.
Can visitors sync across devices?
Yes. Cloud sync uses a simple code (like "GRACE-4821") — no email or password needed. Highlights, reading progress, and plan completion sync automatically.
Can I customize the URL?
Yes. By default the reader lives at /bible but you can change this in Settings → BibleBridge.
Does it work with my theme?
The reader uses its own full-page template and includes safeguards to prevent most styling conflicts. In most cases it works without issue across themes. Some themes or plugins apply aggressive global styles — such as button or link hover effects — that can occasionally show up in the reader. If you notice anything unexpected, try temporarily switching themes to confirm the source, or contact support with a screenshot and we'll help resolve it.
What happens if I hit the daily limit?
Readers will see a friendly message that the reader is busy. No errors, no broken pages. Limits reset at midnight UTC. To raise limits, claim your site from the plugin's settings page, then choose a plan at holybible.dev/pricing.
更新日志:
1.0.20
- Added:
[biblebridge_verse]shortcode — embed any verse or passage as a styled card anywhere on your site. Examples:[biblebridge_verse ref="John 3:16"],[biblebridge_verse ref="Romans 8:1-4" version="bsb"]. Shortcode supports KJV and BSB; omittingversiondefaults to KJV. - Parallel view now compares KJV and BSB side by side
- Parallel mode is preserved when searching or navigating by reference
- Version selector now highlights the active translation with your site's theme color
- Fix: Cross-reference links now use English book slugs and correct verse URL format
- Fix: Theme styles no longer inject borders on the search bar
- Added: Berean Standard Bible (BSB) — modern public domain English translation
- Added: Omitted verse placeholders — verses absent from a translation's textual tradition now display "Not in [version]" rather than a silent gap in verse numbering
- Fix: "Continue reading" no longer resets to a stale chapter when cloud sync is active — sync pull no longer overwrites the current chapter on read page load
- Fix: API passthrough now forwards Cache-Control and ETag headers to the browser, enabling proper caching of cross-reference and context responses
- Fix: Scripture Atlas and other new routes could return 404 after plugin updates. Rewrite rules now flush automatically on update and when Scripture Atlas is toggled in Settings.
- Added: Scripture Atlas — an interactive map of biblical topics connected through shared verses. Enable in Settings.
- Added: Third-party library disclosure (vis-network, MIT License)
- Fix: Reader page showing "This Bible is popular right now" could remain visible after the daily quota resets, due to WordPress caching plugins storing the page. The reader now correctly reloads after quota resets.
- Fix: Extended theme compatibility hardening to text colors — search inputs, navigation links, sidebar controls, and header elements now resist aggressive theme color injection
- Fix: Improved compatibility with aggressive WordPress themes — panels, modals, navigation controls, and interactive buttons now correctly maintain dark-theme styling across a wide range of themes
- Fix: Button and interactive element hover states now resist aggressive theme CSS injection
- Fix: "Continue reading" link now updates correctly when the Bible reader URL is changed
- Fix: Uninstall cleanup now removes all plugin data (page ID, synced site name, usage records)
- Fix: PHP 8 warning when reading plans directory is missing
- Fix: Resume banner URL stored as book/chapter rather than full URL, preventing stale links after URL changes
- Fix: Home page "Continue reading" link built with DOM methods (security hardening)
- Fix: Changing the Bible page URL now works correctly (no more broken links)
- Fix: Settings page loads faster (usage data is cached)
- Fix: Empty page URL no longer breaks the reader
- Fix: Sidebar book names no longer inherit uppercase or spacing from some WordPress themes
- Fix: Verse of the day no longer shows stray quote marks on some themes
- New: Added billing management for paid subscribers in Settings → BibleBridge
- Fix: sidebar book selection now navigates to the correct path (was routing to /read/ instead of /bible/read/ because the click handler wasn't using BIBLEBRIDGE_CONFIG.baseUrl)
- Fix: reading progress bar now spans the full viewport width on mobile instead of starting at the sidebar offset
- New: 9 color themes — choose accent and navigation colors in Settings
- Admin UI: unify the "upgrade" messaging across all four admin surfaces — settings page help text, 80% quota warning banner, daily-limit-reached banner, and usage-table status cell. Each now uses a single "Claim your account" link that routes through the signup/claim flow with the site's API key, so users who haven't claimed their account yet reach the right starting point. Previously these linked directly to pricing and bypassed the claim step.
- Readme: remove external GitHub URL that pointed to the standalone codebase, not this plugin.
- Readme: clarify that raising the daily limit requires claiming the site first.
- Migrate the public sync endpoint from the custom
/bible/syncrewrite route to the WordPress REST API under/wp-json/biblebridge/v1/sync. Both GET (code retrieval) and POST (sync push) now useregister_rest_route()with WordPress-managed request parsing; the plugin no longer reads raw request input for sync handling. - Replace custom body-length / JSON-decode hardening with a recursive shape-preserving sanitizer that walks nested highlight/note structures, sanitizing string keys and values while preserving booleans, integers, floats, and array shape.
- Scripture passthrough (
/bible/api/{endpoint}) is unchanged — still served via the existing public page rewrite route with endpoint + parameter whitelists.
- Ship
assets/js/reader.jsas human-readable unminified source directly in the plugin zip (no minified build, no build step — what you download is what runs) - Migrate the reader's scripture passthrough off
admin-ajax.phpentirely. Cross-references, context, search, passage, topics, and cloud sync are now served by dedicated public page routes —/bible/api/{endpoint}and/bible/sync— alongside the existing/bible/read,/bible/topics, and/bible/plansroutes. No morewp_ajax_nopriv_*handlers in the plugin. - Harden
/bible/syncPOST body handling: reject empty / oversized (>64KB) / non-JSON input before forwarding upstream, and re-encode the parsed body viawp_json_encode()so only canonical JSON derived from a decoded array is sent on - Escape inline SVG output in the reading plans page via
wp_kses()with an explicit SVG-safe whitelist - Prefix all remaining generic globals and JS-localized identifiers:
$PASSAGE_NICKNAMES→$BIBLEBRIDGE_PASSAGE_NICKNAMES,$BOOK_ALIASES→$BIBLEBRIDGE_BOOK_ALIASES,$GLOBALS['bb_prefetched_topic']→$GLOBALS['biblebridge_prefetched_topic'],bbWpRoute→BIBLEBRIDGE_WP_ROUTE, script handlebb-reader→biblebridge-reader - Simplify the Source Code readme section: every file in the zip is human-readable, no build step, no external lookup required
- Fix cross-reference panel failing on installs not hosted on holybible.dev (relative-URL bug in reader.js now uses the WordPress admin-ajax proxy)
- Fix cloud sync failing on installs not hosted on holybible.dev (same bug class as cross-references — sync now routes through a dedicated admin-ajax proxy handler)
- Fix plan detail and plan day pages missing styles (inline CSS was stripped during the 1.0.4 WP.org blocker fix but never migrated into reader.css)
- Refine cross-reference panel typography across the reader page and topic pages for a consistent Study Bible look (serif headline, uppercase reference labels, generous spacing, left accent border)
- Rename plugin from "BibleBridge — Free Bible Reader" to "BibleBridge" and rewrite description for the WordPress.org directory
- Topic pages reimagined for sermon prep: each topic now opens with anchor verse previews and a cross-reference walker for following verses across Scripture
- New "Copy all verses" button on every topic page (plain-text export with source attribution)
- Topics browse page now organized into intentional shelves: "Start with doctrine" (taught in teaching order) and "For pastoral care & life" (alphabetical)
- Stripped editorial prose from topic pages — anchor scriptures and shared-verse adjacency now do the work of guiding study, with no doctrinal commentary
- New shared-verse adjacency on every topic page ("Topics that share scripture") for finding related passages without doctrinal labels
- Improved meta descriptions and social-share images for topic pages
- Added Bookmark verse to the mobile action sheet (previously desktop-only)
- Normalized verse action labels between mobile and desktop (Copy verse, Share verse, Share as image, Bookmark verse, Highlight verse, Add note)
- Refactored verse actions to render from a single registry to prevent future drift
- Added beacon-based read metering (accurate quota tracking per chapter read)
- Passage API calls no longer count against quota for WordPress installs
- Sends X-BB-Client header to identify first-party reader requests
- Bundled CSS, JS, and fonts locally (no external CDN)
- Fixed cross-references for non-English translations
- Fixed topic flow rendering for ungrouped chains
- Fixed reference resolution using correct API key
- Added 80% quota warning in admin
- Updated free tier to 250 requests/day
- Added external services disclosure and privacy links
- Initial release
- 10 Bible translations
- Full-text search with book filtering
- Cross-references with topic explanations
- Topic explorer with flow visualization
- 5 reading plans
- Verse sharing (text and image)
- Verse highlighting and notes
- Cloud sync
- Dark/light mode
- Mobile-optimized