Codevera AI Tooltip Explainer for Jargon and Confusing Terms

توسط codevera

Every day, visitors hit a word or concept they don’t understand and leave your site to search for it. They get distracted. They don’t come back.

Codevera AI Content Explainer keeps them on the page.

Highlight any text. Press explain. GPT-4.1 returns a clear, intelligent answer right there in a tooltip. No new tab. No Google. No lost reader.

How it works:

Visitor highlights text they don’t understand
An explain button appears next to the selection
GPT-4.1 generates a clear explanation instantly
The tooltip follows them around the page so they can keep reading

Free:

OpenAI (GPT-4.1) — pre-configured and ready to go, no model selection needed
Smart caching cuts API costs by up to 70%. Repeated questions cost nothing after the first request
Rate limiting with separate buckets for logged-in and anonymous users
Tooltip with full viewport boundary detection. It never clips off-screen
Interface in 7 languages (English US/UK, Spanish, German, French, Hindi, Chinese)
See which terms your visitors ask about most
Target specific page areas with CSS selectors. Include or exclude anything
API keys encrypted and never exposed to the browser
WCAG AA compliant with keyboard navigation and screen reader support
GDPR compliant. Only the selected text leaves the server. Nothing is stored

Need more? Pro plugin available separately

A separate pro version at https://wpaiexplainer.com/pro adds Claude and Gemini providers, bulk post scanning across your archive, full tooltip styling and an editable explanations dashboard. Pro is a separate download, not unlocked from this free plugin.

Works well for:

Technical documentation where jargon stops readers mid-article
Medical or legal sites where specialist terms cost reader trust
Online courses where confusion becomes drop-offs and cancellations
News sites covering politics, finance, science, or law
Any site where reader comprehension directly affects engagement

Built for production:

Adds under 100ms to page load
Hardened against XSS, CSRF and abuse out of the box
Tested against WordPress core 5.0 and up

External Services & Privacy

This plugin sends user-selected text to OpenAI to generate the explanation. No other external services are contacted by the plugin. No telemetry, no analytics, no licence checks.

OpenAI (api.openai.com)

Privacy Policy: https://openai.com/privacy/
Terms of Service: https://openai.com/terms/
What is sent: only the text the visitor selected
Model: GPT-4.1

API keys are encrypted with WordPress salts and never exposed to the browser. Nothing is stored after the request completes.

By using this plugin you agree to comply with OpenAI’s terms. You should let your visitors know that selected text is processed by an external AI service.

If you install the separately distributed pro plugin from https://wpaiexplainer.com/pro, additional providers (Anthropic Claude and Google Gemini) become available. Those services are documented inside the pro plugin and are not called by this free plugin.

Support

Email info@codevera.ai for support, bug reports, or feature requests. Include your WordPress version, PHP version, theme name, active provider, and a description of the issue with steps to reproduce.

Documentation is in the Help tab inside the plugin settings.

We reply within 24-48 hours on business days.

Technical Requirements

Minimum:
* WordPress 5.0
* PHP 7.4
* OpenAI API key
* JavaScript enabled in the browser

Recommended:
* WordPress 6.0 or higher
* PHP 8.0 or higher
* HTTPS enabled

Privacy & Security

The plugin does not collect or store personal data. The only external request is the selected text sent to your chosen AI provider.

API keys are encrypted with WordPress salts, stored in the database, and never sent to the browser. Only administrators can view or change them.

No cookies. No analytics. No telemetry. AJAX requests use nonces and capability checks.

Credits

OpenAI, Anthropic, and Google for their APIs
WordPress community for development standards and tools
Beta testers for feedback during development

Developers

The plugin dispatches three custom events on document:

codeveraAIExpPopupOnOpen — tooltip opened
codeveraAIExpPopupOnClose — tooltip closed
codeveraAIExpExplanationLoaded — explanation rendered

javascript document.addEventListener('codeveraAIExpExplanationLoaded', function(event) { console.log('Explanation loaded:', event.detail); });

For hook and filter documentation, email info@codevera.ai.

Links

Website: https://wpaiexplainer.com
Support: info@codevera.ai

From WordPress Admin:

Go to Plugins Add New
Search for “Codevera AI Content Explainer”
Click Install Now and then Activate
Go to Settings Codevera AI Content Explainer
Enter your OpenAI API key
Test your API connection
Customise settings as needed
Save and test on your site

Manual Installation:

Download the plugin zip file
Upload to /wp-content/plugins/ directory
Extract the files
Activate through the Plugins menu in WordPress
Configure settings as described above

Getting Your API Key:

OpenAI (free tier):
1. Visit https://platform.openai.com/
2. Create an account or sign in
3. Navigate to API Keys section
4. Click Create new secret key
5. Copy the key and paste into plugin settings

After activation:

Enable the plugin site-wide
Select your language preference
Enter and test your OpenAI API key
Set minimum and maximum text selection lengths
Configure rate limiting to manage API costs
Customise the prompt template if desired
Customise tooltip appearance

سوالات متداول

What AI providers does the free version support?

The free version uses OpenAI (GPT-4.1). Claude and Gemini support is in the separate pro plugin available at https://wpaiexplainer.com/pro.

Is there a paid version with more features?

Yes, a separate Codevera AI Content Explainer Pro plugin is distributed from https://wpaiexplainer.com/pro. It adds Claude and Gemini providers, bulk post scanning, AI blog post generation, an explanations dashboard, and full visual customisation of the tooltip. The pro plugin is a separate download and is not bundled into this free plugin.

Do I need an API key?

Yes, an OpenAI API key. Get one free at https://platform.openai.com/. Pro users can use a Claude or Gemini key instead via the separate pro plugin.

How much does it cost?

The plugin is free. You pay OpenAI directly for API usage, around $0.002-0.005 per explanation using GPT-4.1. Smart caching means repeated questions cost nothing after the first request.

Will this slow down my website?

No. It adds under 100ms to page load. Scripts only load on pages where the plugin is active, and API calls happen in the background after a visitor requests an explanation.

Does it work with my theme?

Yes. The CSS uses specific selectors to avoid conflicts with existing styles. It works with any theme.

Is it accessible?

Yes. WCAG AA compliant. Visitors can open, read, and close the tooltip using only the keyboard. Screen readers can access the explanation text.

Can I customise the appearance?

You can change the background colour, text colour, button style, position, and add custom footer text to the tooltip.

What about privacy and GDPR?

Only the selected text is sent to OpenAI. No personal data. No page content beyond the selection. Users trigger requests manually. No cookies are set.

Can I limit usage to prevent high API costs?

Yes. Rate limiting lets you set separate caps for logged-in and anonymous visitors, per minute, per hour, and per day. Caching reduces calls significantly for repeated selections.

Does it work on mobile devices?

Yes. The tooltip works on touch screens, with tap-friendly buttons and a layout that adapts to smaller screens.

What if the API is down?

The tooltip shows a clear error message. Everything else on your page keeps working normally.

Can I use this on a multisite installation?

Yes. Each site in the network can have its own API key and settings.

Can I translate this plugin?

The plugin ships with translations for 7 languages and works with WPML and Polylang for additional locales.

Can I use custom prompts?

Yes. Write a custom prompt template and use {{selectedtext}} to insert the visitor’s selection dynamically.

How do I troubleshoot issues?

Enable debug mode in the Advanced Settings tab. It writes to a plugin-specific log file rather than the main WordPress debug log. For JavaScript errors, check the browser console.