Dual Component System

Component (com_xbuilder)
- Visual React-based popup builder with drag-and-drop interface
- 250+ professionally designed templates organized by category
- Comprehensive guided tour for new users
- Real-time preview on multiple device sizes
- Advanced image management with folder support
- Joomla article and module integration
- JSON-based configuration for unlimited flexibility

Module (modxbuilderpopup)
- Easy popup selection via dropdown
- Display popups in any module position
- Flexible menu assignment (all pages, selected pages, or exceptions)
- Respects Joomla access levels and publishing dates
- Multiple instances supported for different popups
- Perfect integration with component

Key Features

Visual Builder Interface
- Modern React-based drag-and-drop editor
- Intuitive WYSIWYG interface - see changes in real-time
- Comprehensive guided tour for first-time users
- Responsive preview (mobile, tablet, desktop)
- Keyboard shortcuts for power users
- Undo/redo functionality
- Element layers panel for easy management
- Properties panel for detailed customization

250+ Professional Templates
- Extensive template library with 250+ pre-built designs
- Organized by category: Newsletter, Promotions, Announcements, Product Launches, Events, CTAs, Social Media, Exit Intent, Countdown Timers, and more
- One-click template selection
- Fully customizable after selection
- Option to start from blank for complete creative control
- Search and filter functionality

Advanced Image Management
- Direct image upload from builder interface
- Browse and navigate Joomla images folder structure
- Create and organize folders
- Delete images and folders
- Support for JPG, PNG, GIF, WebP, SVG, BMP formats
- Integrated media browser with preview

Flexible Popup Configuration
- Trigger Settings: On page load, delayed, on click, exit intent, scroll-based
- Animation Controls: Entrance and exit animations with customizable timing
- Styling Options: Colors, fonts, spacing, borders, shadows, backgrounds
- Size & Position: Control popup dimensions and screen placement
- Overlay Settings: Background overlay color and opacity
- Responsive Design: Automatic adaptation to all screen sizes

Publishing & Scheduling
- Publish Up/Down Dates: Schedule popups to appear and disappear automatically
- Access Levels: Control visibility using Joomla access levels (Public, Registered, Special, Custom)
- Language Filtering: Multilingual support with language-specific popups
- Status Management: Published, Unpublished, Archived, Trashed states
- Perfect for time-sensitive campaigns and seasonal promotions

Data Management
- JSON-based configuration for unlimited customization
- SEO-friendly rendered HTML for search engine indexing
- Easy export/import of popup configurations
- Version control friendly format
- Secure database storage with proper validation

Security & Performance
- Comprehensive input validation and sanitization
- XSS prevention and CSRF protection
- Path traversal protection for secure file access
- Optimized asset loading with deferred scripts
- Efficient database queries
- Browser caching for static assets
- Graceful error handling

Quick Start

Installation:
1. Install pkg_xbuilder.zip via Joomla Extension Manager
2. Both component and module are automatically installed
3. Navigate to Components > XBuilder > Popups

Creating Your First Popup:
1. Click "New" button in popups list
2. Choose from 250+ templates or start blank
3. Complete the guided tour (highly recommended)
4. Build your popup using drag-and-drop interface
5. Save your popup with a title

Displaying Popup on Site:
1. Go to Content > Site Modules
2. Click "New" and select "XBuilder Popup"
3. Choose your popup from the dropdown
4. Assign to any module position (debug position recommended for testing)
5. Set menu assignment (all pages or selected pages)
6. Publish the module

Perfect For

• Marketing Campaigns - Promotions, special offers, discount codes, sales announcements
• Newsletter Signups - Email subscription popups with various designs
• Product Launches - New product announcements and showcases
• Event Notifications - Event invitations, reminders, and countdown timers
• Content Highlights - Featured articles, related content, important notices
• Call-to-Action - Various CTA designs for conversions and engagement
• Exit Intent - Popups triggered when users are about to leave
• Social Media - Social sharing prompts and follow requests
• Time-Sensitive Offers - Limited-time promotions with automatic scheduling
• Multilingual Sites - Language-specific popups for international audiences

Configuration Options

Component Settings
- Popup title and alias
- JSON configuration (visual builder handles this)
- Publishing status and dates
- Access level control
- Language assignment
- Metadata (keywords, description)

Builder Interface
- Drag-and-drop element placement
- Real-time preview
- Element properties panel
- Layers management
- Responsive preview modes
- Image upload and management
- Article and module selection
- Styling and animation controls

Module Settings
- Popup selection (dropdown of published popups)
- Module position assignment
- Menu assignment (all pages, selected, or exceptions)
- Access level
- Language filtering
- Module ordering
- Publishing status

Popup Behavior
- Trigger type (on load, delayed, click, exit intent, scroll)
- Delay timing (milliseconds)
- Animation settings (entrance/exit)
- Size and position
- Overlay opacity
- Responsive breakpoints

Technical Features

Modern Architecture
- Full Joomla 4, 5 & 6 compatibility
- React-based builder interface for modern UX
- Uses WebAssetManager for optimal asset loading
- PHP 8.0+ with strict type declarations
- Proper namespace implementation (JoomlaComponentXbuilder)
- Clean, standards-compliant code following Joomla best practices

Performance Optimized
- Asynchronous popup loading (doesn't block page rendering)
- Assets loaded only when needed
- Optimized JavaScript for fast execution
- Efficient database queries with proper indexing
- Browser caching for static assets
- Minimal impact on page load times

Security Enhanced
- Multiple layers of input validation
- XSS prevention with proper escaping
- CSRF token verification
- Path traversal protection
- Secure file upload validation
- Safe image handling
- Joomla security best practices

Responsive Design
- Mobile-optimized with touch-friendly controls
- Automatic responsive breakpoints
- Preview modes for mobile, tablet, desktop
- Works perfectly on all devices and screen sizes
- Optimized performance for mobile networks

Accessibility
- ARIA support for screen readers
- Keyboard navigation support
- Semantic HTML structure
- Focus management
- WCAG compliant design

Cross-Browser Support
- Chrome, Firefox, Safari, Edge, Opera (latest versions)
- Mobile browsers (iOS Safari, Chrome Mobile)
- Cross-platform compatibility
- Modern browser features with graceful fallbacks

SEO Optimization
- Rendered HTML for search engine indexing
- Hidden SEO content (display:none) for crawlers
- Proper semantic markup
- Meta data support
- Search engine friendly structure

Support

• Support Portal: https://support.joomlax.com
• Email Support: [email protected]
• Website: https://www.joomlax.com
• Guided Tour: Interactive tutorial built into the builder interface

Why Choose XBuilder Popup?

No Coding Required - Visual drag-and-drop interface makes popup creation accessible to everyone, no technical knowledge needed

250+ Templates - Extensive template library saves time and provides professional designs for every use case

Guided Tour - Comprehensive interactive tutorial ensures you can use all features effectively from day one

Flexible Display - Module-based system allows popups on any page, with flexible menu assignment and multiple instances

Professional Features - Advanced triggers, animations, scheduling, access control, and responsive design for professional results

Modern Technology - React-based builder, modern PHP 8.0+, built for Joomla 4, 5 & 6 with future-proof architecture

Performance Optimized - Asynchronous loading, efficient code, minimal impact on page speed, optimized for all devices

Security First - Multiple security layers, input validation, XSS prevention, CSRF protection, follows Joomla security guidelines

SEO Friendly - Rendered HTML for search engines, proper semantic markup, hidden SEO content, search engine optimized

Well Documented - Comprehensive documentation with clear examples, FAQs, troubleshooting guides, and step-by-step tutorials

Beautiful Design - Professional templates, smooth animations, customizable styling, polished user experience

Easy to Use - Intuitive interface, guided tour, real-time preview, drag-and-drop simplicity, perfect for content editors

Flexible & Powerful - JSON configuration allows unlimited customization, while visual builder makes it easy to use

Time-Saving - Templates, guided tour, and intuitive interface help you create professional popups quickly

Create stunning, engaging popups that enhance user experience, drive conversions, and showcase your content beautifully while maintaining optimal performance, security, and compatibility across all devices and Joomla versions. Perfect for marketers, content creators, and website owners who want professional popups without the complexity.