WP Manifestindependent plugin directory
manifest / unclassified / tooltipy

Tooltipy

Automatically create tooltip boxes for your technical keywords to explain them for your visitors.

by lebleut · github.com/lebleut/tooltipy

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/lebleut/tooltipy/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/lebleut/tooltipy ↗

=== Tooltipy (tooltips for WP) === Contributors: lebleut Tags: tooltip, keywords, glossary, highlight, definition Requires at least: 6.0 Tested up to: 6.8 Requires PHP: 8.1 Stable tag: 7.0.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

Automatically create tooltip boxes for your technical keywords to explain them to your site visitors.

Description

Tooltipy automatically detects keywords in your posts/pages and displays tooltip popups with their definitions.

Version 7 is a major architectural rewrite (PHP 8.1+ OOP, Tippy.js rendering) with 100% backward compatibility for existing users (same database options, post meta keys, CSS classes, shortcodes, and hooks).

Key Features

  • Auto-detect keywords and display tooltips on hover (Tippy.js)
  • Synonyms support (pipe-separated)
  • Case-sensitive matching option
  • Prefix matching (e.g. "photo" matches "photography")
  • Glossary shortcode: [tooltip_glossary] (aliases: [kttg_glossary], [tooltipy_glossary])
  • Manual shortcode: [tooltip]
  • Keyword families / categories
  • AJAX loading of tooltip content
  • YouTube video tooltips
  • Image alt-text tooltips
  • Sidebar widget showing related keywords
  • Extensible addon system

Architecture (7.x)

  • PHP 8.1 namespaces under Tooltipy\
  • Tippy.js bundled locally (no CDN)
  • Full backward compatibility: same option names, post meta keys, hooks

Installation

  1. Upload the plugin folder to /wp-content/plugins/
  2. Activate through the Plugins menu
  3. Go to Tooltipy > Settings to configure

Frequently Asked Questions

Is 7.x compatible with existing data from 5.x?

Yes. All database options, post meta, CSS classes, and shortcodes are identical.

How do I create a keyword?

Go to Tooltipy > Add New. The title is the keyword; the content is the tooltip body.

How do I add a glossary?

Create a page and add [tooltip_glossary] (or the legacy [kttg_glossary]). Then enable the glossary footer link in Settings and paste that page URL.

What are the requirements?

WordPress 6.0+ and PHP 8.1+.

Changelog

7.0.0

  • Major OOP rewrite: PHP 8.1 namespaces, Tippy.js tooltip rendering
  • Security hardening against Contributor stored XSS (CVE-2025-62917)
  • Glossary footer link only appears when enabled and a page URL is set
  • Backward compatible: all option keys, meta keys, shortcodes, and hooks preserved

5.5.9

  • Security: nonce verification on AJAX calls
  • Improved: excluded posts migration to postmeta

5.2

  • Previous stable procedural release

Upgrade Notice

7.0.0

Major architectural rewrite. Requires PHP 8.1+ and WordPress 6.0+. Existing data and settings are preserved automatically. Includes security fixes for CVE-2025-62917.