=== Serend Animations === Contributors: serend Tags: gutenberg, animations, scroll, blocks, effects Requires at least: 6.0 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Add beautiful scroll animations to Gutenberg blocks with a simple dropdown. Lightweight, GDPR-friendly, no third-party dependencies! == Description == Serend Animations makes it incredibly easy to add stunning scroll animations to any Gutenberg block. Simply select a block, choose an animation from the dropdown, and watch your content come to life as visitors scroll through your page. Why choose Serend Animations? - Ultra Lightweight: Pure CSS animations with minimal JavaScript - only 8KB total - GDPR Friendly: No tracking, no cookies, no external connections - 100% privacy compliant - Zero Dependencies: No jQuery, no third-party libraries, no external CDNs - Lightning Fast: GPU-accelerated CSS animations with Intersection Observer - Security First: Clean code, no external requests, WordPress security standards - Accessibility Ready: Respects user motion preferences automatically - White Label Ready: Clean frontend code without plugin branding or bloat = Features = - 8 Beautiful Animation Types: Fade In (from bottom, left, right), Fade In Slow, Zoom In, Rotate In, Bounce In, and Flip In - Staggered Animations: Use the delay slider to create cascading animation effects - One-Click Integration: No code required - just select an animation from the dropdown - Performance Optimized: Uses native Intersection Observer API for smooth performance - Works with All Blocks: Compatible with every Gutenberg block - Clean Code: Pure CSS + vanilla JavaScript - no bloat, no dependencies = How It Works = 1. Open any block in the Gutenberg editor 2. Look for "Serend Animation" in the block inspector panel 3. Choose an animation from the dropdown 4. Optionally set a delay for staggered effects 5. Save and view your animated content on the frontend = Animation Types = - Fade In (from bottom): Elements gracefully fade in from below - Fade In (from left): Elements slide in from the left side - Fade In (from right): Elements slide in from the right side - Fade In Slow: A slower, more elegant fade from below - Zoom In: Elements scale up from smaller size - Rotate In: Elements rotate while fading in - Bounce In: Elements bounce in with elastic effect - Flip In: Elements flip in with 3D rotation effect = Perfect For = - GDPR-Compliant Websites: No tracking, no cookies, no privacy concerns - Performance-Critical Sites: Lightweight and fast-loading - Agency & Developer Projects: White label ready, clean code with no plugin branding - Landing Pages: Engaging animations without the bloat - Portfolio Websites: Showcase your work with beautiful effects - Business Sites: Stand out without compromising on speed or privacy - Blog Posts: Dynamic content reveals that respect user preferences - Client Projects: Safe, reliable animations with zero maintenance overhead = Developer Friendly = - Pure CSS + Vanilla JS: No jQuery or framework dependencies - WordPress Coding Standards: Clean, secure, and maintainable code - Zero External Calls: No CDNs, APIs, or third-party services - White Label Frontend: No plugin branding or comments in generated HTML/CSS - Lightweight Footprint: Only 8KB total - smaller than most images - Extensible Architecture: Easy to customize with your own CSS - Debug Mode: Built-in tools for development and troubleshooting (enable via Settings → Serend Animations) - GDPR Compliant: No data collection, tracking, or external connections - Security Focused: Follows WordPress security best practices == Installation == 1. Upload the plugin files to `/wp-content/plugins/serend-animations/` directory, or install through the WordPress plugins screen 2. Activate the plugin through the 'Plugins' screen in WordPress 3. Start adding animations to your Gutenberg blocks via the block inspector panel == Frequently Asked Questions == = Does this work with all Gutenberg blocks? = Yes! The animation options are added to virtually every Gutenberg block, including core blocks and third-party blocks. = Will this slow down my website? = Absolutely not! The plugin is ultra-lightweight (only 8KB total) with pure CSS animations and minimal JavaScript. It uses the native Intersection Observer API for optimal performance and GPU-accelerated animations for buttery smooth effects. No jQuery, no external libraries, no bloat. = What happens if a visitor has motion sensitivity? = The plugin automatically respects the browser's `prefers-reduced-motion` setting. If a visitor has motion sensitivity enabled, animations will be disabled or significantly reduced. = Can I use multiple animations on the same page? = Absolutely! You can use different animations on different blocks, and even create staggered effects using the delay slider. = Does this work on mobile devices? = Yes, all animations work smoothly on mobile devices and tablets. = Is this white label friendly for agencies? = Absolutely! The plugin generates clean frontend code without any plugin branding, comments, or promotional links. Your clients will only see your professional animations without knowing which plugin was used. = Is this GDPR compliant? = Yes, 100%! The plugin is fully GDPR compliant as it doesn't collect any user data, doesn't use cookies, doesn't make external connections, and doesn't track users in any way. It's pure CSS and JavaScript that runs entirely on your website. = Can I customize the animations? = Absolutely! The plugin provides 8 carefully crafted animations out of the box, but you can easily extend or customize them with your own CSS. The code is clean and well-documented for easy customization. = How do I enable debug mode? = Debug mode can be enabled in your WordPress admin area under Settings → Serend Animations. Once enabled, administrators will see a debug overlay on the frontend showing which animation classes are being used. This is helpful for development and troubleshooting. == Screenshots == 1. Animation selection dropdown in the Gutenberg block inspector (screenshot-1.png) 2. Delay slider for creating staggered animation effects (screenshot-2.png) 3. Example of fade-in animation applied to a paragraph block in Gutenberg editor (screenshot-3.png) == Changelog == = 1.0.1 = * Improved code structure and organization * Separated OOP and functional code into proper files * Moved plugin functions to includes/ directory following WordPress standards * Enhanced JavaScript code formatting and WordPress compliance * Reduced JavaScript linting errors by 85% (from 500+ to 78 errors) * WordPress Coding Standards compliance improvements * Better separation of concerns between classes and functions * Added proper Doc-Comments for all functions and classes * Implemented Yoda Conditions for better code safety = 1.0.0 = * Initial release * 8 animation types: Fade In (bottom, left, right), Fade In Slow, Zoom In, Rotate In, Bounce In, Flip In * Delay slider for staggered animations (0-2000ms) * Intersection Observer for performance * Accessibility support with prefers-reduced-motion * Debug mode with settings panel (Settings → Serend Animations) * Visual debug overlay for administrators * WordPress 6.6 compatibility * Full internationalization support == Upgrade Notice == = 1.0.1 = Code quality improvements and WordPress standards compliance. No new features, but better maintainability and performance. = 1.0.0 = Initial release of Serend Animations. Add beautiful scroll animations to your Gutenberg blocks with ease. == Additional Information == = Minimum Requirements = * WordPress 6.0 or higher * PHP 7.4 or higher * Modern browser with JavaScript enabled = Contributing = This plugin is open source. Contributions are welcome.