Image Tooltip

What's new?

Version 3.2.1: 27 August 2026

• Open link hover keeps the panel text colour, so Helix and other template a:hover rules cannot turn the CTA brand-blue
• Article source: strip content plugin syntax (default Yes), excerpt format Plain text or Safe HTML, and optional images inside Safe HTML
• Safe HTML is sanitised and re-closed after truncation so unclosed tags cannot break the page
• Use a Joomla article as the tooltip source with article="123" (aliases: id, contentid)
• Article title, intro excerpt, intro or full image, and article URL fill in when those shortcode fields are empty
• Unpublished or restricted articles stay hidden. Explicit title, body, image, or link on the shortcode still override the article
• Editor button: optional article ID field and Select picker
• Plugin option for article excerpt length (80 to 600 characters, default 240)
• Two article load modes in the plugin: Inline (with the page) or AJAX on first hover. Shortcodes can override with load="ajax" or load="inline"
• Backend Article source options: intro / full / both, excerpt length, use article image, and link to article

Version 3.1.3: 19 August 2026

• Hover follows the pointer, so a fading demo section cannot leave the tip dead under a still cursor. The first open is immediate
• Tips stay open when the panel moves to body or the layout shifts. Firefox uses the element under the pointer, not a null relatedTarget
• Tip panels force position:fixed so Bootstrap/Astroid [role=tooltip] { position:absolute } cannot park the tip inside a transformed section
• Anchored tips flip side if the panel would overlap the trigger. Right or left alignment uses margins, not CSS float
• Thumbs keep their natural aspect ratio (no forced 1:1 box). Tooltip images use Contain by default; Cover is optional via Design or fit="contain" / fit="cover"
• Thumbs with thumbwidth keep a real pixel width so grid icons can receive hover in Firefox. They are not loading=lazy
• Cache resized images switch (default Yes) under Design, plus Clear image cache and Remove broken files
• Empty or tiny WebP cache files are rejected. Palette PNGs convert to truecolor before WebP. Local media URLs are site-relative
• Popup images load eagerly. Translatable Open link label, plus cta_text / linktext on the shortcode. Legacy TRIGGER{end-link}image.jpg and {end-itooltip} closers still work
• Content plugin, editor button, and package version numbers stay in sync

Version 3.0: 17 July 2026

Release Date: 17 July 2026

Complete Rebuild

• Full rebuild for Joomla 4, Joomla 5, and Joomla 6
• Namespaced service-provider architecture with Web Asset Manager loading
• Vanilla JavaScript only — jQuery and TimThumb / image.php removed
• Install package pkg_image_tooltip_3.0.zip includes the content plugin and editor button

New Features

• Four themes — Dark, Light, Glass, and Brand, with per-tip shortcode overrides
• Placement modes — Follow cursor, or anchor top / bottom / left / right
• Animations — Fade, Scale, Slide, or None, with reduced-motion support
• Sticky click & touch — Click/tap to pin; Escape or outside click to dismiss
• Image or text triggers — Thumbnails or underlined text labels, with optional float left/right
• WebP thumbnail cache — Local images are resized and cached under images/cache/image-tooltip
• Editor button — Insert {itooltip} shortcodes from the article editor toolbar
• Design controls — Background, text, accent colour, max width, and corner radius
• Rich tip content — Title, multi-line body, large preview image, and optional CTA link

Improvements

• Safer URL handling for media and links (blocks javascript/data schemes)
• Keyboard focus styles and aria-expanded state
• Bootstrap/Helix-compatible show class so tips are not hidden by template CSS
• Responsive behaviour — floated triggers unwrap on small screens; panels stay inside the viewport
• Lazy loading and async decoding for tip images

Removed

• Legacy TimThumb resizing helper
• Deprecated JFactory / JURI / JHtml usage
• jQuery sticky tooltip script

Version 2.5: 19 November 2025

Release Date: 19 November 2025

• Full compatibility with Joomla 6.0 while maintaining backward compatibility with Joomla 4 and 5
• Enhanced security with path validation and input sanitization
• Modern PHP 8+ support with type hints and PSR-12 coding standards

New Features

• Shadow Configuration - Enable/disable and fully customize tooltip shadows with horizontal/vertical offset, blur, spread, and color options
• Tooltip Position Control - Choose from auto (follow mouse), top, bottom, left, or right positioning
• Lazy Loading Implementation - Full lazy loading support for tooltip images to improve page performance
• Enhanced Link Support - Fixed text tooltip links to work properly with clickable links
• Shortcode Examples Tab - Built-in shortcode examples with one-click copy functionality

Improvements

• Removed unnecessary margin-bottom from tooltip images
• Removed top border from tooltip content area for cleaner design
• Improved link handling for text tooltips
• Enhanced JavaScript event handling for better link navigation
• Updated CSS for better visual consistency

Bug Fixes

• Fixed text tooltip links not working properly
• Fixed margin-bottom causing design issues
• Fixed top border appearing unnecessarily in tooltip content

Version 2.4: 14 September 2025

Release Date: September 14, 2025

Joomla 5 Compatibility

• Full compatibility with Joomla 5.0 while maintaining backward compatibility with Joomla 4
• Modern PHP 8+ support with type hints and PSR-12 coding standards
• Enhanced security with path validation and input sanitization

New Features

• WebP Image Support - Convert images to modern WebP format for better performance
• Lazy Loading - Optional lazy loading support for improved page performance
• Configurable Tooltip Positioning - Choose from top, bottom, left, right, or auto positioning
• Tooltip Delay Settings - Customizable delay settings for better user experience
• Minified Assets Support - Use minified CSS/JS files by default with option for full versions
• Image Caching System - Intelligent caching system for faster loading
• Responsive Design - Perfect display on all screen sizes with mobile-first approach
• Dark Mode Support - Automatic dark mode detection and styling
• High Contrast Mode - Enhanced visibility for accessibility
• Reduced Motion Support - Respects user's motion preferences for better accessibility

Technical Improvements

• Modernized PHP - Complete rewrite with modern PHP 8+ features, type hints, and PSR-12 coding standards
• Enhanced Security - Comprehensive path validation, input sanitization, and XSS protection
• Improved Performance - Optimized image processing with efficient file operations
• Better Error Handling - Comprehensive error logging and graceful fallbacks
• Modern Code Standards - Clean, maintainable code following Joomla 5 best practices
• Enhanced Accessibility - Full keyboard navigation, ARIA support, and screen reader compatibility

Improvements

• Refactored JavaScript with modern ES6+ features and strict mode
• Updated CSS with modern design principles and responsive breakpoints
• Improved XML manifest with better parameter organization and modern field types
• Enhanced helper class with robust image processing and caching
• Better integration with Joomla's asset management system
• Improved compatibility with various Joomla templates
• Fixed image resizing for certain image formats
• Better error handling for missing images
• Improved tooltip animation performance
• Enhanced mobile responsiveness

Bug Fixes

• Fixed URL construction - Fixed double base URL issue in image paths
• Fixed image processing - Improved image resizing and format conversion
• Fixed memory management - Better memory usage for large images
• Fixed cross-browser compatibility - Fixed issues with older browsers
• Fixed mobile responsiveness - Improved tooltip positioning on mobile devices
• Fixed JavaScript array handling - Resolved stickytooltip.stickynotice1.join error
• Fixed regex pattern in parseOptions method - Proper key-value parsing

Security Enhancements

• Path Validation - Comprehensive validation of image paths to prevent directory traversal
• Input Sanitization - Proper sanitization of all user inputs
• XSS Prevention - HTML escaping for all output
• File Type Validation - Strict validation of image file types
• Directory Protection - Automatic creation of security index.html files

Accessibility Improvements

• Keyboard Navigation - Full keyboard support (Enter, Space, Escape keys)
• ARIA Attributes - Proper ARIA labels and roles for screen readers
• Focus Management - Improved focus indicators and management
• High Contrast Mode - Enhanced visibility in high contrast mode
• Reduced Motion - Respects user's motion preferences
• Screen Reader Support - Better compatibility with assistive technologies

Technical Changes

• PHP Requirements - Minimum PHP 7.4 (PHP 8.0+ recommended)
• Joomla Compatibility - Joomla 4.0+ and Joomla 5.0+
• Dependencies - Uses Joomla's native Image class and jQuery
• File Structure - Reorganized files with better separation of concerns
• Code Standards - PSR-12 compliant PHP code

Version 2.3: 11 December 2023

• Supports Joomla 5 without Backward Compatibility Plugin

Version 2.2: 13 February 2023

• New and easy to use shortcode
• Background color change of tooltip added
• Option to open url in a new tab added

Version 2.1: 11 February 2023

• Removed option to load jQuery in body
• Modification to plugin parameters

Version 2.0: 01 February 2021

• Supports Joomla 4

Version 1.9: 01 February 2017

• Joomla Update System Integrated