Glitter Bomb

Description

Glitter Bomb brings wildly extra, interactive particle effects to your WordPress site with two delightful experience modes that work beautifully on desktop, tablet, and mobile devices with full touch and gesture support.

✨ Sprinkle Trail Mode
Create zany particle trails that follow your cursor on desktop or touch path on mobile devices. Perfectly optimized for touch screens with smooth gesture tracking and responsive sizing. Perfect for adding a touch of magic to hero sections, landing pages, or special announcements.

💫 Particle Field Mode
Transform your entire page into a magical canvas filled with hundreds of shimmering glitter particles. Particles gently drift, attract to your cursor or touch, and explode into sparkles on click or tap – creating an enchanting, physics-based experience that works flawlessly across all devices.

🎯 Why Choose Glitter Bomb?

• Fully Responsive & Mobile-Optimized: Works beautifully on all screen sizes from mobile phones to desktop monitors with adaptive particle sizing and touch-optimized controls
• Touch & Gesture Support: Complete touch event optimization with smooth gesture tracking, tap explosions, and mobile-specific performance enhancements
• Two Distinct Modes: Choose between cursor-following sprinkle trails or immersive full-screen particle fields
• Fully Accessible: WCAG 2.2 AA compliant with keyboard navigation, screen reader support, and reduced motion respect
• Performance Optimized: Advanced optimizations including object pooling, canvas scaling, particle culling, and mobile-specific performance features ensure smooth framerates even on mobile devices
• Highly Customizable: Extensive controls for colors, sizes, animation speed, particle behavior, with separate desktop and mobile settings
• Beautiful Color Palettes: Choose from Rainbow, Metallic, Neutral Spectrum, Warm Sunset, Cool Ocean, or custom colors – all with smooth cycling animations
• Zero Configuration: Works beautifully out of the box with smart defaults, or customize every detail to match your brand

📱 Mobile & Touch Features:

• Touch-Optimized Interface: All controls meet minimum 44x44px touch target requirements
• Gesture Tracking: Smooth particle trails follow your finger movements with precision
• Tap Explosions: Dramatic sparkle bursts respond to touch taps (Particle Field mode)
• Separate Mobile Sizing: Configure different particle sizes for mobile vs desktop for optimal visual balance
• Mobile Disable Option: Optionally disable effects on mobile devices for maximum performance flexibility
• Canvas Resolution Optimization: Automatically reduces canvas resolution on high-DPI mobile screens for better performance without visual quality loss
• Touch Event Throttling: Smart touch event handling prevents overwhelming mobile processors
• Responsive Viewport: Automatically adapts to mobile browser UI changes (address bar appearance/disappearance)

🎨 Key Features:

• Interactive Effects: Smooth, animated particles that respond to cursor and touch movements
• Color Cycling: Beautiful color palette animations that smoothly transition between hues
• Physics-Based Movement: Natural particle behavior with attraction, drift, and spreading forces
• Click/Tap Explosions: Dramatic sparkle bursts on click or tap (Particle Field mode)
• Customizable Controls: Adjust opacity, size, speed, particle count, and behavior
• Position Control: Place toggle button in any screen corner
• Enable by Default: Choose whether effects are active on page load
• User Preferences: Remembers user’s enable/disable choice across sessions
• Gradient Buttons: Beautiful gradient controls that automatically match your color palette
• Compact or Scattered: Choose particle display behavior (Sprinkle Trail mode)
• Mobile Optimization: Separate sizing controls and optional disable for mobile devices

♿ Accessibility Features:

• Keyboard activation with Enter and Space keys
• Screen reader announcements via ARIA live regions
• Semantic HTML structure
• Visible focus indicators
• Respects prefers-reduced-motion settings
• Minimum 44x44px touch targets for mobile
• WCAG 2.2 AA color contrast compliance

⚡ Performance Features:

• Object pooling for efficient memory usage
• RequestAnimationFrame optimization
• Particle culling for off-screen particles
• Canvas resolution scaling on mobile devices
• Touch event optimization
• Tab visibility detection to pause animations
• Smart particle limits to maintain smooth framerates
• Mobile-specific performance enhancements

💻 Developer Friendly:

• Clean-ish, well-documented code
• WordPress coding standards compliant
• No external dependencies
• Lightweight bundle size
• Proper cleanup and resource management
• Safari privacy-friendly (non-fingerprinting)

Performance & Browser Support

The block uses modern JavaScript features and is optimized for performance with:
* Object pooling for efficient memory management
* Passive event listeners for smooth scrolling
* RequestAnimationFrame for optimized animations
* Particle culling to prevent off-screen rendering
* Canvas resolution scaling on mobile devices (reduces to 1.5x pixel ratio on high-DPI screens)
* Touch event throttling for mobile performance
* Tab visibility detection to pause animations
* Particle count limits to maintain framerates
* Proper cleanup to prevent memory leaks
* Safari privacy-friendly implementation (non-fingerprinting)

Supported browsers: Chrome, Firefox, Safari, Edge (latest versions)
Mobile browsers: iOS Safari, Chrome Mobile, Samsung Internet, Firefox Mobile

Tested on:
* WordPress 6.1, 6.2, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8
* PHP 7.4, 8.0, 8.1, 8.2, 8.3
* Desktop: Windows, macOS, Linux
* Mobile: iOS (iPhone/iPad), Android phones and tablets
* Various screen sizes: 320px to 4K displays
* Touch devices: phones, tablets, touch-enabled laptops

Privacy & Data

Glitter Bomb respects your privacy:
* No external requests: All code runs locally in the browser
* No tracking: No analytics or user tracking
* No cookies: Uses sessionStorage for user preferences (not persistent)
* No personal data: Does not collect or transmit any user information
* GDPR compliant: No personal data processing
* Safari privacy-friendly: Non-fingerprinting canvas implementation

Support

For support, please use the WordPress.org support forum for this plugin.

Contributing

I welcome contributions! If you’d like to contribute code, report bugs, or suggest features, please visit the GitHub repository: https://github.com/klatespencer