This plugin finds Scripture references in your WordPress content, stores open Bible texts in your own database, and shows the matching verses in fast hover and keyboard-focus cards. Start by installing one or more open Bible translations below, choose the translation that should open first, then decide where the scanner should look on your public pages and optional admin screens.
Install any combination of local Bible texts. Installed translations are automatically available in frontend tooltip tabs; the default translation only controls which one opens first.
No local Bible texts are installed yet.
| Translation | Canonical books | Status |
|---|---|---|
| Complete' : esc_html('Missing: ' . implode(', ', $row['missing'])); ?> |
This checks whether each installed text has at least one row for every canonical Bible book after source-code interpretation.
This plugin is designed for Bible texts that are public domain, openly licensed, or otherwise legally permitted for local storage and display. It does not provide import tools for restricted commercial translations unless a future integration explicitly supports proper licensing.
The built-in importer currently supports selected open/public-domain eBible VPL packages, including WEB, KJV, ASV, YLT, BSB, and OEB-US.
' + esc(err.message || 'Verse not available locally.') + '
'; place(target); revealPop(); } } async function lookup(ref, translation){ const code = translation || 'WEB'; const key = code + ':' + ref.toLowerCase(); if (cache.has(key)) return cache.get(key); const separator = String(BibleReferenceTooltips.rest).includes('?') ? '&' : '?'; const url = BibleReferenceTooltips.rest + separator + 'ref=' + encodeURIComponent(ref) + '&translation=' + encodeURIComponent(code); const data = await fetch(url, {headers:{'X-WP-Nonce': BibleReferenceTooltips.nonce || ''}}).then(r => r.json()); cache.set(key, data); return data; } function render(data){ if (!pop) return; const translations = Array.isArray(data.translations) && data.translations.length ? data.translations : (Array.isArray(BibleReferenceTooltips.translations) ? BibleReferenceTooltips.translations : []); const tabs = translations.map(row => { const code = String(row.code || '').toUpperCase(); if (!code) return ''; const active = code === String(data.translation || '').toUpperCase() ? ' active' : ''; const title = row.name ? ' title="' + esc(row.name) + '"' : ''; return ''; }).join(''); const label = BibleReferenceTooltips.showTranslation && data.translation_label ? ' (' + esc(data.translation_label) + ')' : ''; const title = data.reference || activeRef || ''; const errorReason = data.reason ? '' + esc(String(data.reason).replace(/_/g, ' ')) + '' : ''; const verses = data.ok === false ? '' + esc(data.message || 'Verse text is not available locally for this reference.') + '
' + errorReason : (Array.isArray(data.verses) && data.verses.length ? data.verses.map(row => { return '' + esc(row.verse) + '.' + esc(row.text) + '
'; }).join('') : '' + esc(data.text || '') + '
'); pop.innerHTML = '' + esc(err.message || 'Verse text is not available locally for this reference.') + '
'; } }); document.body.appendChild(pop); } function revealPop(){ if (!pop) return; pop.classList.remove('ready'); window.requestAnimationFrame(() => { if (pop) pop.classList.add('ready'); }); } function place(target){ if (!pop) return; const pad = 14; const rect = target.getBoundingClientRect(); let x = Math.min(rect.left, window.innerWidth - pop.offsetWidth - pad); let y = rect.bottom + 10; if (y + pop.offsetHeight > window.innerHeight - pad) y = Math.max(pad, rect.top - pop.offsetHeight - 10); pop.style.left = Math.max(pad, x) + 'px'; pop.style.top = Math.max(pad, y) + 'px'; } function scheduleClear(){ hideTimer = window.setTimeout(clear, 140); } function clear(){ window.clearTimeout(loadingTimer); requestToken++; if (pop) { pop.remove(); pop = null; } activeRef = ''; activeTrigger = null; } function resolvedTheme(){ if (BibleReferenceTooltips.theme === 'light') return 'light'; if (BibleReferenceTooltips.theme === 'dark') return 'dark'; const doc = document.documentElement; const body = document.body; const darkClass = doc.classList.contains('dark') || body.classList.contains('dark') || body.classList.contains('dark-mode') || doc.dataset.theme === 'dark' || body.dataset.theme === 'dark'; if (darkClass) return 'dark'; return 'light'; } function esc(s){ return String(s || '').replace(/[&<>"']/g, c => ({'&':'&','<':'<','>':'>','"':'"',"'":'''}[c])); } if (BibleReferenceTooltips.showTooltips) { document.addEventListener('mouseover', show); document.addEventListener('focusin', show); document.addEventListener('mouseout', e => { const ref = e.target.closest('.brt-ref'); if (ref && (!e.relatedTarget || (!ref.contains(e.relatedTarget) && (!pop || !pop.contains(e.relatedTarget))))) scheduleClear(); }); document.addEventListener('focusout', e => { if (e.target.closest('.brt-ref')) scheduleClear(); }); } function initScan(){ const selectors = (BibleReferenceTooltips.scope || 'body').split(',').map(s => s.trim()).filter(Boolean); if (BibleReferenceTooltips.scanComments) selectors.push('.brt-comment-scope'); const roots = selectors.flatMap(s => Array.from(document.querySelectorAll(s))); Array.from(new Set(roots.length ? roots : [document.body])).forEach(root => { scan(root); }); } if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', initScan, {once:true}); else initScan(); })(); JS; } } register_activation_hook(__FILE__, ['Bible_Reference_Tooltips', 'activate']); register_deactivation_hook(__FILE__, ['Bible_Reference_Tooltips', 'deactivate']); new Bible_Reference_Tooltips(); }