PrimeBible Verse Preview - WordPress Plugin

Beautiful, mobile-friendly Bible verse tooltips for WordPress. Auto-detects references and shows instant previews.

Download from WordPress.org | Documentation | Report Bug | Request Feature

---

🎬 See It In Action

Hover over any Bible reference to see instant verse previews

✨ Features

• 🔍 Auto-detection of Bible references (e.g., "John 3:16", "Romans 8:1-4")
• 📱 Mobile-optimized with touch support and long-press
• ⚡ Lightning fast - aggressive caching, lazy loading, prefetch
• 🎨 Fully customizable - themes, styles, timing, behavior
• 🔒 Privacy-focused - no tracking or data collection
• 🌍 Multiple translations - KJV, ESV, ASV, WEB, and more
• ♿ Accessible - keyboard navigation and screen reader friendly
• 🚀 Performance - <50kb, deferred loading, minimal DOM impact

📸 Screenshots

Verse Tooltip

Hover or tap any Bible reference to see an instant verse preview

Admin Settings

Full control over translations, themes, and behavior

🚀 Quick Start

From WordPress.org (Recommended)

1. Go to Plugins → Add New in WordPress admin
2. Search "PrimeBible Verse Preview"
3. Click Install → Activate
4. Configure at Settings → PrimeBible

Manual Installation

1. Download the latest release
2. Upload to /wp-content/plugins/primebible-verse-preview/
3. Activate through WordPress admin
4. Configure settings

From Source (Developers)

cd /path/to/wordpress/wp-content/plugins
git clone https://github.com/primebible/wordpress-plugin.git primebible-verse-preview

💡 Usage

Write content naturally with Bible references:

Jesus said, "I am the way, the truth, and the life" (John 14:6).
For more context, read Romans 8:1-4 and Ephesians 2:8-9.

The references automatically become interactive tooltips. No manual markup required!

⚙️ Configuration

Access settings at Settings → PrimeBible in WordPress admin.

Key Options

• Bible Translation: Choose from 10+ translations
• Theme: Light, dark, or system preference
• Tooltip Appearance: Width, position, animations
• Performance: Caching, lazy loading, prefetch
• Per-Post Control: Disable on specific posts/pages

See full documentation for all options.

🛠️ Development

Requirements

• PHP 7.4+
• WordPress 5.8+
• Modern browser with ES2020+ support

File Structure

wordpress-plugin/
├── .github/
│   └── FUNDING.yml              # GitHub Sponsors configuration
├── assets/
│   ├── assets/
│   │   ├── primebible-embed.js     # Source JavaScript
│   │   └── primebible-embed.min.js # Minified production JS
│   ├── css/
│   │   └── admin.css               # Admin panel styles
│   ├── package.json                # Build configuration (terser)
│   └── .gitkeep                    # Folder placeholder
├── .gitattributes              # GitHub Linguist configuration
├── CHANGELOG.md                # Version history
├── CONTRIBUTING.md             # Contribution guidelines
├── LICENSE                     # GPL-2.0+ license
├── README.md                   # This file
├── primebible-verse-preview.php # Main plugin file (861 lines)
└── uninstall.php               # Cleanup on uninstall

Local Development

# Clone the repo
git clone https://github.com/primebible/wordpress-plugin.git

# Create symlink in your WordPress install
ln -s /path/to/repo /path/to/wordpress/wp-content/plugins/primebible-verse-preview

# Activate in WordPress admin

Testing

Test on:

• ✅ Latest WordPress version
• ✅ PHP 7.4, 8.0, 8.1, 8.2
• ✅ Common page builders (Gutenberg, Elementor, Divi)
• ✅ Multiple themes
• ✅ Mobile devices

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md first.

Ways to Contribute

• 🐛 Report bugs via Issues
• 💡 Suggest features
• 🔧 Submit pull requests
• 🌍 Translate into other languages
• 📖 Improve documentation

📋 Changelog

[2.5.1] - 2025-11-15

Added

• Chapter verse counts awareness for accurate range detection
• maxMatchesPerNode and maxNodeTextLength performance limits
• Debug mode for troubleshooting

Improved

• Mobile touch interaction reliability
• Cache efficiency with LRU algorithm

Fixed

• Edge case with overlapping verse ranges
• Tooltip positioning on narrow viewports

See CHANGELOG.md for full version history.

📄 License

GPL-2.0-or-later. See LICENSE for details.

Free for personal and commercial use. Modify and redistribute as you like.

🙏 About PrimeBible

PrimeBible is a 501(c)(3) nonprofit dedicated to making deep Bible study accessible to everyone.

Our Free Tools

• 📖 Original language analysis (Hebrew/Greek)
• 📚 Strong's Concordance integration
• 🔗 Cross-reference explorer
• 📅 Biblical timeline
• ✍️ Scholarly articles on prophecy and theology

Mission: Provide free, high-quality Bible study resources to the global church.

Visit PrimeBible.com • Donate

💬 Support

• Documentation: primebible.com/docs/wordpress-plugin
• WordPress.org Forum: Support Forum
• GitHub Issues: Report Bug
• Email: support@primebible.com
• Response Time: 24-48 hours

We're committed to excellent support. If you have an issue, we'll help you resolve it.

⭐ Support the Project

If this plugin blesses your ministry:

• ⭐ Star this repository
• 📝 Leave a 5-star review on WordPress.org
• 📢 Share with other Christian content creators
• 💝 Donate to support nonprofit Bible tools

---

Made with ❤️ for the global church

PrimeBible • A 501(c)(3) Nonprofit Organization