PrimeBible Verse Preview

Àpèjúwe

Turn every Bible reference on your site into an instant verse preview.

PrimeBible Verse Preview automatically finds references in your content — “John 3:16”, “Romans 8:1-4”, even shorthand like “2 Sam 7:12” — and turns each one into an elegant tooltip that reveals the verse the moment a reader hovers or taps. No copying Scripture into every post, no interrupting your writing, no sending readers off to another site.

It reads like plain writing and just works: type a reference naturally and it becomes interactive on the front end.

Built and maintained by PrimeBible, a 501(c)(3) nonprofit dedicated to making Scripture accessible to everyone, it is fast, privacy-respecting, and free — forever. No accounts, no upsells, no tracking.

Key Features

  • Automatic Detection Ìtumọ̀ Yorùbá: – Finds Bible references like “John 3:16” or “Romans 8:1-4” in your content
  • Manual References Ìtumọ̀ Yorùbá: – Add explicit references with the [primebible] shortcode
  • Multiple Translations Ìtumọ̀ Yorùbá: – Choose from KJV, ESV, ASV, WEB, and more
  • Translation Selector Ìtumọ̀ Yorùbá: – Pick from supported translations instead of typing codes manually
  • API Test Tool Ìtumọ̀ Yorùbá: – Verify the selected translation and endpoint from the settings screen
  • Mobile Optimized Ìtumọ̀ Yorùbá: – Touch-friendly with long-press support for mobile devices
  • Lightning Fast Ìtumọ̀ Yorùbá: – Aggressive caching, lazy loading, and prefetch optimization
  • Fully Customizable Ìtumọ̀ Yorùbá: – Control appearance, behavior, timing, and styling
  • Privacy First Ìtumọ̀ Yorùbá: – No tracking, no external dependencies beyond the Bible API
  • Accessibility Ìtumọ̀ Yorùbá: – Keyboard navigation and screen reader friendly
  • Theme Support Ìtumọ̀ Yorùbá: – Light, dark, or auto-detect system preference
  • Performance Ìtumọ̀ Yorùbá: – Deferred loading, intersection observer, minimal DOM manipulation

How It Works

  1. Install and activate the plugin
  2. Configure your preferred Bible translation and appearance
  3. Write content naturally: “For God so loved the world (John 3:16)”
  4. The reference automatically becomes interactive
  5. Visitors hover or tap to see the verse instantly

Advanced Features

  • Lazy Scanning Ìtumọ̀ Yorùbá: – Only processes content when it enters viewport
  • Smart Caching Ìtumọ̀ Yorùbá: – LRU cache with configurable size and expiry
  • Per-Post Control Ìtumọ̀ Yorùbá: – Disable scanning on specific posts/pages via meta box
  • Exclude Selectors Ìtumọ̀ Yorùbá: – Prevent scanning in code blocks, comments, etc.
  • CSP Aware Ìtumọ̀ Yorùbá: – Injected styles carry a configurable nonce attribute (works with static-nonce CSP setups; per-request rotating nonces are not supported)
  • Chapter Verse Counts Ìtumọ̀ Yorùbá: – Optional JSON config for accurate verse range detection
  • Bundled Verse Counts Ìtumọ̀ Yorùbá: – Accurate cross-chapter expansion works out of the box
  • Prefetch Ìtumọ̀ Yorùbá: – Intelligently preloads nearby references
  • Analytics Ready Ìtumọ̀ Yorùbá: – Optional Google Analytics integration
  • Custom CSS Ìtumọ̀ Yorùbá: – Add your own styles to match your theme

Perfect For

  • Theology and Bible study blogs
  • Church websites and ministries
  • Christian authors and writers
  • Seminary and Bible college sites
  • Devotional and sermon websites
  • Christian education platforms

Technical Highlights

  • No jQuery or external library dependencies
  • Modern vanilla JavaScript (ES2020+)
  • Deferred script loading for zero blocking
  • Intersection Observer API for performance
  • Fetch API with retry logic and timeout
  • Mobile-first responsive design
  • Lightweight Ìtumọ̀ Yorùbá: – a single deferred script, no jQuery, no render blocking

Additional Info

About PrimeBible

PrimeBible is a 501(c)(3) nonprofit organization dedicated to making deep Bible study accessible to everyone. Our platform provides free tools including:
* Hebrew and Greek original language analysis
* StrongÌtumọ̀ Yorùbá: ’s Concordance integration
* Cross-reference explorer
* Biblical timeline
* Scholarly articles on messianic prophecy, textual criticism, and theology
Learn more at primebible.com

Support the Mission

This plugin is free and always will be. If it blesses your ministry, consider:
* Leaving a 5-star review
* Sharing with other Christian content creators
* Donating to support nonprofit Bible study tools at primebible.com/donate

Credits

Developed by the PrimeBible team with love for the global church.
Special thanks to the WordPress community and all beta testers who provided feedback.

Privacy Policy

Data Collection: This plugin does not collect, store, or transmit any personal data about your visitors.

API Requests: When a verse tooltip is displayed, the plugin fetches verse text from primebible.comÌtumọ̀ Yorùbá: ’s API. These requests include:
Ìtumọ̀ Yorùbá: – The Bible reference (e.g., “John 3:16”)
Ìtumọ̀ Yorùbá: – The requested translation (e.g., “KJV”)

No Tracking: PrimeBible does not log IP addresses, track user behavior, or use cookies from these API requests.

Optional Analytics: If you enable the analytics setting, the plugin will fire a Google Analytics event when a tooltip is opened (if GA is already installed on your site). This is disabled by default.

Third-Party Services: The plugin connects to primebible.comÌtumọ̀ Yorùbá: ’s API to fetch verse text. No other third-party services are used.
For more information, see the PrimeBible Privacy Policy.

Copyright and Licensing

PrimeBible Verse Preview is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Bible translations are subject to their respective copyright holders. PrimeBible provides access to public domain translations and those licensed for free distribution.

Developer Notes

Hooks and Filters

Filter: primebible_config
Modify the JavaScript configuration before itÌtumọ̀ Yorùbá: ’s output.

add_filter('primebible_config', function($config) {
    $config['translation'] = 'ESV';
    $config['theme'] = 'dark';
    return $config;
});

Filter: primebible_available_translations
Customize the translation dropdown.

add_filter('primebible_available_translations', function($translations) {
    $translations['YLT'] = 'Young\'s Literal Translation';
    return $translations;
});

Action: primebible_before_enqueue
Runs before scripts are enqueued (if loading conditions are met).

add_action('primebible_before_enqueue', function() {
    // Your code here
});

Programmatic Control

Disable on specific page by template:

add_filter('primebible_should_load', function($should_load) {
    if (is_page_template('template-landing.php')) {
        return false;
    }
    return $should_load;
});

GitHub Repository

Development happens on GitHub: github.com/primebible/wordpress-plugin
Contributions welcome:
Ìtumọ̀ Yorùbá: – Bug reports
Ìtumọ̀ Yorùbá: – Feature requests
Ìtumọ̀ Yorùbá: – Pull requests
Ìtumọ̀ Yorùbá: – Documentation improvements

Support

Documentation: primebible.com/docs/wordpress-plugin
Support Forum: wordpress.org/support/plugin/primebible
Email: support@primebible.com
Average Response Time: 24-48 hours

WeÌtumọ̀ Yorùbá: ’re committed to excellent support. If you have an issue, weÌtumọ̀ Yorùbá: ’ll help you resolve it.

Àwọn àwòrán ìbòjú

Ìgbéwọlẹ̀

Automatic Installation

  1. Log into your WordPress admin panel
  2. Navigate to ‘Plugins Add New’
  3. Search for “PrimeBible Verse Preview”
  4. Click ‘Install Now’ and then ‘Activate’
  5. Go to ‘Settings PrimeBible’ to configure

Manual Installation

  1. Download the plugin zip file
  2. Extract to /wp-content/plugins/primebible/ (the zip extracts to a primebible folder)
  3. Activate through the ‘Plugins’ menu in WordPress
  4. Configure at ‘Settings PrimeBible’

After Installation

  1. Navigate to ‘Settings PrimeBible’
  2. Choose your preferred Bible translation (default: KJV)
  3. Select theme (light/dark/system)
  4. Adjust timing and behavior settings if desired
  5. Save changes and test on a post with Bible references

Manual References

Use the shortcode when you want exact control over the clickable text:

[primebible ref="John 3:16"]

You can also override the translation for a single reference:

[primebible ref="Romans 8:1" translation="ESV"]this promise[/primebible]

FAQ

Is this plugin really free?

Yes, 100% free with no hidden costs, premium tiers, or upsells. PrimeBible is a 501(c)(3) nonprofit organization making Bible study tools accessible to everyone.

What Bible translations are available?

The settings screen includes KJV, ESV, NIV, ASV, WEB, NET, NASB, NKJV, NLT, and CSB. Developers can customize this list with the primebible_available_translations filter.

Does it work on mobile devices?

Absolutely. The plugin is mobile-first with touch-optimized interactions including long-press to view verses. Tooltips automatically adjust size and position for small screens.

Will it slow down my website?

No. The plugin uses:
Ìtumọ̀ Yorùbá: – Deferred script loading (non-blocking)
Ìtumọ̀ Yorùbá: – Lazy scanning with Intersection Observer
Ìtumọ̀ Yorùbá: – Aggressive caching with LRU eviction
Ìtumọ̀ Yorùbá: – Minimal DOM manipulation
Ìtumọ̀ Yorùbá: – No external library dependencies
Total impact: <50kb and processes only visible content.

Can I customize the appearance?

Yes. You can:
Ìtumọ̀ Yorùbá: – Choose light, dark, or system theme
Ìtumọ̀ Yorùbá: – Adjust tooltip width for desktop and mobile
Ìtumọ̀ Yorùbá: – Add custom CSS in the settings panel
Ìtumọ̀ Yorùbá: – Control whether to show reference header and footer branding
Ìtumọ̀ Yorùbá: – Enable/disable animations

How do I disable scanning on a specific post?

Edit the post and look for the ‘PrimeBible Verse Preview’ meta box in the sidebar (usually on the right). Check “Disable PrimeBible scanning on this content” and save.

Can I exclude certain elements from scanning?

Yes. By default, these elements are excluded: script, style, noscript, iframe, textarea, code, pre, .pbv-no-scan
You can customize this list in ‘Settings PrimeBible Exclude selectors’.
You can also add the class pbv-no-scan to any HTML element to prevent scanning inside it.

Does it collect user data or track visitors?

No. The plugin is privacy-focused and doesnÌtumọ̀ Yorùbá: ’t collect, store, or transmit any user data except Bible verse API requests to primebible.com (which are not logged or tracked).
Optional: You can enable Google Analytics event tracking in settings if you use GA on your site.

What happens if the API is down?

The plugin includes:
Ìtumọ̀ Yorùbá: – Configurable timeout (default: 8 seconds)
Ìtumọ̀ Yorùbá: – Automatic retry logic (default: 2 retries)
Ìtumọ̀ Yorùbá: – Graceful fallback (tooltip shows “Unable to load verse”)
Ìtumọ̀ Yorùbá: – Error handling that doesnÌtumọ̀ Yorùbá: ’t break your page

Can I use this with page builders?

Yes. Works with:
Ìtumọ̀ Yorùbá: – Gutenberg (WordPress block editor)
Ìtumọ̀ Yorùbá: – Classic Editor
Ìtumọ̀ Yorùbá: – Elementor
Ìtumọ̀ Yorùbá: – Beaver Builder
Ìtumọ̀ Yorùbá: – Divi Builder
Ìtumọ̀ Yorùbá: – WPBakery
Ìtumọ̀ Yorùbá: – And most other page builders

Does it support custom post types?

Yes. In ‘Settings PrimeBible Post types’, you can select which post types should have the meta box and be scanned when using “singular only” mode.

What if I need help?

  1. Check this FAQ
  2. Visit the Support Forum
  3. Read documentation at primebible.com/docs
  4. Contact support at support@primebible.com

Can I contribute or request features?

Absolutely! The plugin is GPL-licensed. You can:
Ìtumọ̀ Yorùbá: – Submit bug reports and feature requests on the support forum
Ìtumọ̀ Yorùbá: – Contribute code via GitHub (link in plugin header)
Ìtumọ̀ Yorùbá: – Suggest improvements
Ìtumọ̀ Yorùbá: – Translate into other languages

Àwọn àgbéyẹ̀wò

Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.

Àwọn Olùkópa & Olùgbéejáde

“PrimeBible Verse Preview” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.

Àwọn Olùkópa

Túmọ̀ “PrimeBible Verse Preview” sí èdè rẹ.

Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.

Àkọsílẹ̀ àwọn àyípadà

Full history: see CHANGELOG.md on GitHub (github.com/primebible/wordpress-plugin).

2.5.3 Ìtumọ̀ Yorùbá: – 2026-07-11

  • Fixed: Reference detection no longer matches everyday words — prose like “there is 5”, “I am 24”, or “so 3 people” was being wrapped as a verse link (and “is 5” fetched 1 Samuel 5). Ambiguous short aliases still work in the shortcode but never trigger auto-detection
  • Fixed: Times (“3pm”), ordinals (“3rd”), years, and percentages next to book-like words no longer create false verse links
  • Fixed: The “Load in Admin Dashboard” setting now actually loads the script in wp-admin
  • Fixed: The documented primebible_should_load filter is now implemented
  • Security: Inline config JSON hardened so stored settings values cannot break out of the script tag
  • Added: 14 detection regression tests in PrimeBible.runTests()

2.5.2 Ìtumọ̀ Yorùbá: – 2026-06-11

  • Fixed: Short book abbreviations are normalized before API requests
  • Fixed: Ac, Rm, Ga, Lu, and compact numbered forms such as 2Sa now resolve to their full book names internally
  • Fixed: Delayed hover previews are canceled when the pointer leaves a reference
  • Fixed: Invalid exclude selectors no longer stop content scanning
  • Added: Translation dropdown and API test tool in settings
  • Added: [primebible ref="John 3:16"] shortcode for manual references
  • Added: Bundled chapter verse counts for accurate cross-chapter expansion
  • Updated: mobileOptimized now controls mobile tooltip layout instead of being a dead setting
  • Updated: Release metadata now matches plugin version 2.5.2

2.5.1 Ìtumọ̀ Yorùbá: – 2025-11-15

  • Added: Chapter verse counts awareness for accurate range detection
  • Added: maxMatchesPerNode and maxNodeTextLength performance limits
  • Added: Debug mode for troubleshooting
  • Improved: Mobile touch interaction reliability
  • Improved: Cache efficiency with LRU algorithm
  • Fixed: Edge case with overlapping verse ranges
  • Fixed: Tooltip positioning on narrow viewports

2.5.0 Ìtumọ̀ Yorùbá: – 2025-11-01

  • Added: Multi-translation support (KJV, ESV, ASV, WEB) with admin selector
  • Added: Aggressive caching with configurable TTL, lazy tooltips, prefetch
  • Changed: Redesigned admin settings page and tooltip design
  • Fixed: WordPress 6.4 compatibility, PHP 8.2 deprecations, theme CSS conflicts

2.0.0 Ìtumọ̀ Yorùbá: – 2025-10-01

  • Major: Complete rewrite for performance and reliability
  • Added: Lazy scanning with Intersection Observer
  • Added: Smart prefetch for nearby references
  • Added: Configurable caching with expiry
  • Added: Per-post disable meta box
  • Added: Custom CSS support
  • Added: CSP nonce compatibility
  • Added: Load scope (everywhere vs singular only)
  • Added: Post type selection
  • Added: Exclude selectors configuration
  • Improved: Mobile interactions with long-press
  • Improved: Tooltip positioning algorithm
  • Improved: Error handling and retry logic
  • Changed: Migrated from inline styles to dynamic style injection
  • Changed: Settings UI overhaul for better UX
  • Performance: 40% faster initial scan
  • Performance: 60% reduction in memory usage

1.5.0 Ìtumọ̀ Yorùbá: – 2025-08-15

  • Added: Multiple translation support
  • Added: Theme selection (light/dark/system)
  • Added: Animation controls
  • Improved: Tooltip positioning on mobile
  • Fixed: Conflict with certain themes

1.0.0 Ìtumọ̀ Yorùbá: – 2025-06-01

  • Initial release
  • Auto-detection of Bible references
  • KJV translation support
  • Basic tooltip functionality
  • Admin settings panel