ITMedia Popup

Overview

ITMedia Popup allows you to display beautiful, customizable popup modals on your Joomla website. Perfect for announcements, promotions, newsletter signups, cookie notices, and more.

Features

Content Types

• Custom Text/HTML - Use the built-in WYSIWYG editor
• Joomla Article - Display any published article
• Joomla Module - Embed any frontend module
• Image - Show an image with optional link

Trigger Options

• Immediate - Show on page load
• Time Delay - Show after X seconds
• Scroll Percentage - Show after scrolling X% of page
• Exit Intent - Show when mouse leaves the viewport
• Click - Show when clicking specific elements

Frequency Control

• Every page load
• Only once (ever)
• Once per session
• Once per day
• Once per week
• Once per month

Targeting

• Pages: All pages, homepage only, selected menu items, or exclude specific pages
• Users: All visitors, guests only, registered users, or specific user groups
• Devices: All devices, desktop only, or mobile only
• Date Range: Schedule popups with start and end dates

Appearance

• 5 sizes: Small, Medium, Large, Extra Large, Fullscreen
• 3 positions: Center, Top, Bottom
• 4 animations: Fade, Slide Down, Slide Up, Zoom
• Customizable backdrop color and opacity
• Custom CSS class and inline styles
• Dark mode support

Advanced Features

• Auto-close with visual progress bar
• Bootstrap 5 integration (auto-loads if needed)
• Native fallback when Bootstrap unavailable
• Keyboard navigation (ESC to close)
• ARIA accessibility support
• Debug mode for troubleshooting

Requirements

• Joomla 4.x, 5.x, or 6.x
• PHP 8.1 or higher

Installation

1. Download the latest release from https://www.itemedia.sk
2. In Joomla admin, go to System → Install → Extensions
3. Upload the plg_system_itemediapopup_vX.X.X.zip file
4. After installation, go to System → Manage → Plugins
5. Find "ITMedia Popup" and enable it
6. Click on the plugin name to configure settings

Usage Examples

Newsletter Signup Popup

1. Create a module with your newsletter form
2. Set Content Type to "Joomla Module"
3. Select your newsletter module
4. Set Trigger to "Exit Intent"
5. Set Frequency to "Once per week"

Cookie Notice

1. Set Content Type to "Custom Text"
2. Add your cookie notice HTML
3. Set Trigger to "Immediate"
4. Set Frequency to "Only once"
5. Set Position to "Bottom"

Promotional Banner

1. Set Content Type to "Image"
2. Upload your promotional image
3. Add link URL to your offer page
4. Set Start/End Date for the campaign
5. Set Frequency to "Once per day"

Click-triggered Popup

1. Configure your popup content
2. Set Trigger to "On element click"
3. Set Click Selector to .my-popup-button
4. Add class my-popup-button to any element on your site

Languages

• English (en-GB)
• Slovak (sk-SK)

Updates

The plugin supports Joomla's built-in update system. You'll receive notifications when new versions are available.

To manually check for updates:
1. Go to System → Update → Extensions
2. Click "Check for Updates"

Troubleshooting

Popup not showing?

1. Make sure the plugin is enabled
2. Check the "Enable Popup" setting is set to "Yes"
3. Verify your targeting settings (pages, users, devices)
4. Check date range if configured
5. Clear browser localStorage to reset frequency tracking
6. Enable Debug Mode and check browser console

Popup appears behind other elements?

Increase the Z-Index value in Advanced Settings.

Bootstrap conflicts?

Set "Bootstrap Loading" to "No" if your template already includes Bootstrap 5.

License

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.

Author

Ing. Roman Hricišin, ITMedia

• Website: https://www.itemedia.sk
• Email: itemedia@itemedia.sk