{"id":262538,"date":"2025-12-01T00:12:27","date_gmt":"2025-12-01T00:12:27","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/primebible-verse-preview\/"},"modified":"2025-12-01T00:12:04","modified_gmt":"2025-12-01T00:12:04","slug":"primebible","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/primebible\/","author":23405273,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.5.1","stable_tag":"trunk","tested":"6.8.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"PrimeBible Verse Preview","header_author":"PrimeBible","header_description":"Auto-detects Bible references in your content and shows a beautiful, mobile-friendly tooltip preview powered by PrimeBible. Includes admin settings, caching controls, per-post disable, and counts-aware expansion.","assets_banners_color":"","last_updated":"2025-12-01 00:12:04","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/primebible.com\/donate","header_plugin_uri":"https:\/\/github.com\/primebible\/wordpress-plugin","header_author_uri":"https:\/\/primebible.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":155,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"2.5.1":"<p>Recommended update: Performance improvements, counts-aware detection, and mobile enhancements. Fully backward compatible.<\/p>","2.0.0":"<p>Major update with significant performance improvements, lazy scanning, and enhanced customization. Recommended for all users. Settings will be preserved but please review new options.<\/p>","1.5.0":"<p>Adds multiple translations and theme support. Your existing settings will be preserved.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Verse Tooltip - Beautiful hover preview showing John 3:16 with reference header and verse text","2":"Admin Settings Page - Full control over translations, themes, performance, and behavior","3":"Mobile View - Touch-optimized tooltip perfectly sized for phones and tablets","4":"Per-Post Control - Meta box to disable scanning on specific posts","5":"Dark Theme - System-aware dark mode for night reading","6":"Advanced Settings - Performance tuning, caching, timing controls"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[12198,12201,12285,788,10510],"plugin_category":[],"plugin_contributors":[251429],"plugin_business_model":[],"class_list":["post-262538","plugin","type-plugin","status-publish","hentry","plugin_tags-bible","plugin_tags-christianity","plugin_tags-scripture","plugin_tags-tooltip","plugin_tags-verse","plugin_contributors-primebible","plugin_committers-primebible"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/primebible.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>PrimeBible Verse Preview transforms Bible references in your content into interactive tooltips that display verse text instantly. Perfect for theology blogs, church websites, and Christian content creators.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li>Automatic Detection - Finds Bible references like \"John 3:16\" or \"Romans 8:1-4\" in your content<\/li>\n<li>Multiple Translations - Choose from KJV, ESV, ASV, WEB, and more<\/li>\n<li>Mobile Optimized - Touch-friendly with long-press support for mobile devices<\/li>\n<li>Lightning Fast - Aggressive caching, lazy loading, and prefetch optimization<\/li>\n<li>Fully Customizable - Control appearance, behavior, timing, and styling<\/li>\n<li>Privacy First - No tracking, no external dependencies beyond the Bible API<\/li>\n<li>Accessibility - Keyboard navigation and screen reader friendly<\/li>\n<li>Theme Support - Light, dark, or auto-detect system preference<\/li>\n<li>Performance - Deferred loading, intersection observer, minimal DOM manipulation<\/li>\n<\/ul>\n\n<h4>How It Works<\/h4>\n\n<ol>\n<li>Install and activate the plugin<\/li>\n<li>Configure your preferred Bible translation and appearance<\/li>\n<li>Write content naturally: \"For God so loved the world (John 3:16)\"<\/li>\n<li>The reference automatically becomes interactive<\/li>\n<li>Visitors hover or tap to see the verse instantly<\/li>\n<\/ol>\n\n<h4>Advanced Features<\/h4>\n\n<ul>\n<li>Lazy Scanning - Only processes content when it enters viewport<\/li>\n<li>Smart Caching - LRU cache with configurable size and expiry<\/li>\n<li>Per-Post Control - Disable scanning on specific posts\/pages via meta box<\/li>\n<li>Exclude Selectors - Prevent scanning in code blocks, comments, etc.<\/li>\n<li>CSP Compatible - Support for Content Security Policy nonce<\/li>\n<li>Chapter Verse Counts - Optional JSON config for accurate verse range detection<\/li>\n<li>Prefetch - Intelligently preloads nearby references<\/li>\n<li>Analytics Ready - Optional Google Analytics integration<\/li>\n<li>Custom CSS - Add your own styles to match your theme<\/li>\n<\/ul>\n\n<h4>Perfect For<\/h4>\n\n<ul>\n<li>Theology and Bible study blogs<\/li>\n<li>Church websites and ministries<\/li>\n<li>Christian authors and writers<\/li>\n<li>Seminary and Bible college sites<\/li>\n<li>Devotional and sermon websites<\/li>\n<li>Christian education platforms<\/li>\n<\/ul>\n\n<h4>Technical Highlights<\/h4>\n\n<ul>\n<li>No jQuery or external library dependencies<\/li>\n<li>Modern vanilla JavaScript (ES2020+)<\/li>\n<li>Deferred script loading for zero blocking<\/li>\n<li>Intersection Observer API for performance<\/li>\n<li>Fetch API with retry logic and timeout<\/li>\n<li>Mobile-first responsive design<\/li>\n<li>Sub-50kb footprint including all assets<\/li>\n<\/ul>\n\n<h3>Additional Info<\/h3>\n\n<h4>About PrimeBible<\/h4>\n\n<p>PrimeBible is a 501(c)(3) nonprofit organization dedicated to making deep Bible study accessible to everyone. Our platform provides free tools including:\n* Hebrew and Greek original language analysis\n* Strong's Concordance integration\n* Cross-reference explorer\n* Biblical timeline\n* Scholarly articles on messianic prophecy, textual criticism, and theology\nLearn more at <a href=\"https:\/\/primebible.com\">primebible.com<\/a><\/p>\n\n<h4>Support the Mission<\/h4>\n\n<p>This plugin is free and always will be. If it blesses your ministry, consider:\n* Leaving a 5-star review\n* Sharing with other Christian content creators\n* Donating to support nonprofit Bible study tools at primebible.com\/donate<\/p>\n\n<h4>Credits<\/h4>\n\n<p>Developed by the PrimeBible team with love for the global church.\nSpecial thanks to the WordPress community and all beta testers who provided feedback.<\/p>\n\n<h3>Privacy Policy<\/h3>\n\n<p>Data Collection: This plugin does not collect, store, or transmit any personal data about your visitors.<\/p>\n\n<p>API Requests: When a verse tooltip is displayed, the plugin fetches verse text from primebible.com's API. These requests include:\n-   The Bible reference (e.g., \"John 3:16\")\n-   The requested translation (e.g., \"KJV\")<\/p>\n\n<p>No Tracking: PrimeBible does not log IP addresses, track user behavior, or use cookies from these API requests.<\/p>\n\n<p>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.<\/p>\n\n<p>Third-Party Services: The plugin connects to primebible.com's API to fetch verse text. No other third-party services are used.\nFor more information, see the <a href=\"https:\/\/primebible.com\/privacy\">PrimeBible Privacy Policy<\/a>.<\/p>\n\n<h3>Copyright and Licensing<\/h3>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Bible translations are subject to their respective copyright holders. PrimeBible provides access to public domain translations and those licensed for free distribution.<\/p>\n\n<h3>Developer Notes<\/h3>\n\n<h4>Hooks and Filters<\/h4>\n\n<p>Filter: <code>primebible_config<\/code>\nModify the JavaScript configuration before it's output.<\/p>\n\n<p>add_filter('primebible_config', function($config) {\n     $config['translation'] = 'ESV';\n     $config['theme'] = 'dark';\n     return $config;\n });<\/p>\n\n<p>Action: <code>primebible_before_enqueue<\/code>\nRuns before scripts are enqueued (if loading conditions are met).<\/p>\n\n<p>add_action('primebible_before_enqueue', function() {\n     \/\/ Your code here\n });<\/p>\n\n<h4>Programmatic Control<\/h4>\n\n<p>Disable on specific page by template:<\/p>\n\n<p>add_filter('primebible_should_load', function($should_load) {\n     if (is_page_template('template-landing.php')) {\n         return false;\n     }\n     return $should_load;\n });<\/p>\n\n<h4>GitHub Repository<\/h4>\n\n<p>Development happens on GitHub: <a href=\"https:\/\/github.com\/primebible\/wordpress-plugin\">github.com\/primebible\/wordpress-plugin<\/a>\nContributions welcome:\n-   Bug reports\n-   Feature requests\n-   Pull requests\n-   Documentation improvements<\/p>\n\n<h3>Support<\/h3>\n\n<p>Documentation: <a href=\"https:\/\/primebible.com\/docs\/wordpress-plugin\">primebible.com\/docs\/wordpress-plugin<\/a>\nSupport Forum: <a href=\"https:\/\/wordpress.org\/support\/plugin\/primebible-verse-preview\">wordpress.org\/support\/plugin\/primebible-verse-preview<\/a>\nEmail: support@primebible.com\nAverage Response Time: 24-48 hours<\/p>\n\n<p>We're committed to excellent support. If you have an issue, we'll help you resolve it.<\/p>\n\n<!--section=installation-->\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Log into your WordPress admin panel<\/li>\n<li>Navigate to 'Plugins \u2192 Add New'<\/li>\n<li>Search for \"PrimeBible Verse Preview\"<\/li>\n<li>Click 'Install Now' and then 'Activate'<\/li>\n<li>Go to 'Settings \u2192 PrimeBible' to configure<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin zip file<\/li>\n<li>Extract to <code>\/wp-content\/plugins\/primebible-verse-preview\/<\/code><\/li>\n<li>Activate through the 'Plugins' menu in WordPress<\/li>\n<li>Configure at 'Settings \u2192 PrimeBible'<\/li>\n<\/ol>\n\n<h4>After Installation<\/h4>\n\n<ol>\n<li>Navigate to 'Settings \u2192 PrimeBible'<\/li>\n<li>Choose your preferred Bible translation (default: KJV)<\/li>\n<li>Select theme (light\/dark\/system)<\/li>\n<li>Adjust timing and behavior settings if desired<\/li>\n<li>Save changes and test on a post with Bible references<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='is%20this%20plugin%20really%20free%3F'><h3>Is this plugin really free?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id='what%20bible%20translations%20are%20available%3F'><h3>What Bible translations are available?<\/h3><\/dt>\n<dd><p>Currently supports: KJV (King James Version), ESV (English Standard Version), ASV (American Standard Version), WEB (World English Bible), and more. Visit primebible.com for the full list.<\/p><\/dd>\n<dt id='does%20it%20work%20on%20mobile%20devices%3F'><h3>Does it work on mobile devices?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id='will%20it%20slow%20down%20my%20website%3F'><h3>Will it slow down my website?<\/h3><\/dt>\n<dd><p>No. The plugin uses:\n-   Deferred script loading (non-blocking)\n-   Lazy scanning with Intersection Observer\n-   Aggressive caching with LRU eviction\n-   Minimal DOM manipulation\n-   No external library dependencies\nTotal impact: &lt;50kb and processes only visible content.<\/p><\/dd>\n<dt id='can%20i%20customize%20the%20appearance%3F'><h3>Can I customize the appearance?<\/h3><\/dt>\n<dd><p>Yes. You can:\n-   Choose light, dark, or system theme\n-   Adjust tooltip width for desktop and mobile\n-   Add custom CSS in the settings panel\n-   Control whether to show reference header and footer branding\n-   Enable\/disable animations<\/p><\/dd>\n<dt id='how%20do%20i%20disable%20scanning%20on%20a%20specific%20post%3F'><h3>How do I disable scanning on a specific post?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id='can%20i%20exclude%20certain%20elements%20from%20scanning%3F'><h3>Can I exclude certain elements from scanning?<\/h3><\/dt>\n<dd><p>Yes. By default, these elements are excluded: <code>script<\/code>, <code>style<\/code>, <code>noscript<\/code>, <code>iframe<\/code>, <code>textarea<\/code>, <code>code<\/code>, <code>pre<\/code>, <code>.pbv-no-scan<\/code>\nYou can customize this list in 'Settings \u2192 PrimeBible \u2192 Exclude selectors'.\nYou can also add the class <code>pbv-no-scan<\/code> to any HTML element to prevent scanning inside it.<\/p><\/dd>\n<dt id='does%20it%20collect%20user%20data%20or%20track%20visitors%3F'><h3>Does it collect user data or track visitors?<\/h3><\/dt>\n<dd><p>No. The plugin is privacy-focused and doesn't collect, store, or transmit any user data except Bible verse API requests to primebible.com (which are not logged or tracked).\nOptional: You can enable Google Analytics event tracking in settings if you use GA on your site.<\/p><\/dd>\n<dt id='what%20happens%20if%20the%20api%20is%20down%3F'><h3>What happens if the API is down?<\/h3><\/dt>\n<dd><p>The plugin includes:\n-   Configurable timeout (default: 8 seconds)\n-   Automatic retry logic (default: 2 retries)\n-   Graceful fallback (tooltip shows \"Unable to load verse\")\n-   Error handling that doesn't break your page<\/p><\/dd>\n<dt id='can%20i%20use%20this%20with%20page%20builders%3F'><h3>Can I use this with page builders?<\/h3><\/dt>\n<dd><p>Yes. Works with:\n-   Gutenberg (WordPress block editor)\n-   Classic Editor\n-   Elementor\n-   Beaver Builder\n-   Divi Builder\n-   WPBakery\n-   And most other page builders<\/p><\/dd>\n<dt id='does%20it%20support%20custom%20post%20types%3F'><h3>Does it support custom post types?<\/h3><\/dt>\n<dd><p>Yes. In 'Settings \u2192 PrimeBible \u2192 Post types', you can select which post types should have the meta box and be scanned when using \"singular only\" mode.<\/p><\/dd>\n<dt id='what%20if%20i%20need%20help%3F'><h3>What if I need help?<\/h3><\/dt>\n<dd><ol>\n<li>Check this FAQ<\/li>\n<li>Visit the <a href=\"https:\/\/wordpress.org\/support\/plugin\/primebible-verse-preview\/\">Support Forum<\/a><\/li>\n<li>Read documentation at primebible.com\/docs<\/li>\n<li>Contact support at support@primebible.com<\/li>\n<\/ol><\/dd>\n<dt id='can%20i%20contribute%20or%20request%20features%3F'><h3>Can I contribute or request features?<\/h3><\/dt>\n<dd><p>Absolutely! The plugin is GPL-licensed. You can:\n-   Submit bug reports and feature requests on the support forum\n-   Contribute code via GitHub (link in plugin header)\n-   Suggest improvements\n-   Translate into other languages<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.5.1 - 2025-11-15<\/h4>\n\n<ul>\n<li>Added: Chapter verse counts awareness for accurate range detection<\/li>\n<li>Added: <code>maxMatchesPerNode<\/code> and <code>maxNodeTextLength<\/code> performance limits<\/li>\n<li>Added: Debug mode for troubleshooting<\/li>\n<li>Improved: Mobile touch interaction reliability<\/li>\n<li>Improved: Cache efficiency with LRU algorithm<\/li>\n<li>Fixed: Edge case with overlapping verse ranges<\/li>\n<li>Fixed: Tooltip positioning on narrow viewports<\/li>\n<\/ul>\n\n<h4>2.0.0 - 2025-10-01<\/h4>\n\n<ul>\n<li>Major: Complete rewrite for performance and reliability<\/li>\n<li>Added: Lazy scanning with Intersection Observer<\/li>\n<li>Added: Smart prefetch for nearby references<\/li>\n<li>Added: Configurable caching with expiry<\/li>\n<li>Added: Per-post disable meta box<\/li>\n<li>Added: Custom CSS support<\/li>\n<li>Added: CSP nonce compatibility<\/li>\n<li>Added: Load scope (everywhere vs singular only)<\/li>\n<li>Added: Post type selection<\/li>\n<li>Added: Exclude selectors configuration<\/li>\n<li>Improved: Mobile interactions with long-press<\/li>\n<li>Improved: Tooltip positioning algorithm<\/li>\n<li>Improved: Error handling and retry logic<\/li>\n<li>Changed: Migrated from inline styles to dynamic style injection<\/li>\n<li>Changed: Settings UI overhaul for better UX<\/li>\n<li>Performance: 40% faster initial scan<\/li>\n<li>Performance: 60% reduction in memory usage<\/li>\n<\/ul>\n\n<h4>1.5.0 - 2025-08-15<\/h4>\n\n<ul>\n<li>Added: Multiple translation support<\/li>\n<li>Added: Theme selection (light\/dark\/system)<\/li>\n<li>Added: Animation controls<\/li>\n<li>Improved: Tooltip positioning on mobile<\/li>\n<li>Fixed: Conflict with certain themes<\/li>\n<\/ul>\n\n<h4>1.0.0 - 2025-06-01<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Auto-detection of Bible references<\/li>\n<li>KJV translation support<\/li>\n<li>Basic tooltip functionality<\/li>\n<li>Admin settings panel<\/li>\n<\/ul>","raw_excerpt":"Automatically detects Bible references and displays beautiful verse previews on hover or tap. Mobile-optimized, fast, and fully customizable.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/262538","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=262538"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/primebible"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=262538"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=262538"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=262538"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=262538"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=262538"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=262538"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}