Animated Gutenberg Gallery

Beautiful GSAP animations and lightbox for WordPress Gutenberg gallery blocks.

Free and open source — licensed under GPLv2 or later.

Description

Add professional animations and lightbox functionality to your WordPress gallery blocks with GSAP animations.

Features:

• 5 scroll-triggered animation effects: Fade In, Fade Up, Fade Left, Zoom In, Alternate Scroll
• Group or sequence animation styles
• Customizable animation duration
• Hover effects: Zoom, Lift Up, 3D Tilt
• Built-in lightbox with keyboard navigation
• Per-gallery toggles (lightbox / animations) in the block editor
• Smooth scrolling via Lenis
• LiteSpeed Cache lazy-load compatibility
• Live preview in the settings page

Requirements

• WordPress 6.4 or higher
• PHP 7.4 or higher
• Modern browsers supporting CSS3 animations and GSAP

Installation

1. Download the latest .zip from the releases page, or clone this repository into wp-content/plugins/.
2. Upload the plugin via Plugins → Add New → Upload Plugin in WordPress (skip if you cloned).
3. Click Activate Plugin.

Usage

1. Add a Gallery block to a post or page — animations and lightbox are applied automatically.
2. Toggle lightbox and animations per gallery in the block's sidebar settings (Gallery Effects panel).
3. Customize the animation effect, style, duration, and hover effect in AG Gallery in the WordPress admin menu.

Hooks

• agg_premium_default_settings — filter the default plugin settings

Structure

animated-gutenberg-gallery/
├── assets/
│   ├── css/                      # Stylesheets
│   ├── images/                   # Logo and preview images for the settings page
│   └── js/
│       ├── agg-admin.js          # Settings page live preview
│       ├── agg-animations.js     # Shared animation library
│       ├── agg-editor.js         # Gutenberg block controls
│       ├── agg-public.js         # Frontend animations and lightbox
│       └── vendor/               # Bundled GSAP, ScrollTrigger, Lenis
├── includes/
│   ├── admin/                    # Settings page
│   └── core/                     # Core functionality
├── languages/                    # Translations
├── animated-gutenberg-gallery.php
├── uninstall.php                 # Cleanup on uninstall
└── wpml-config.xml               # WPML / Polylang config

Licensing

This plugin is free and open source, licensed under the GPLv2 or later. Use it on as many sites as you like. See the LICENSE file for full terms.

The bundled GSAP and ScrollTrigger libraries are distributed under GSAP's own (free) license — see https://gsap.com/licensing/ for details. Lenis is MIT-licensed.

Support

For support inquiries:

• Email: lukasz@matysiewicz.studio
• Website: https://matysiewicz.studio

Version History

• 1.4.0: Removed Freemius — free and open source (GPLv2 or later), all premium features unlocked. Fixed duplicate frontend script loading, broken error logging, and gallery data attributes being added to every image. Removed dead code (license updater, unused AJAX endpoint and modal, unused security class, lite version handler) and the media-library copy of preview images.
• 1.3.2: Load vendor files locally
• 1.3.1: Added WP best practices
• 1.3.0: Added Contact
• 1.2.9: Small description changes
• 1.2.8: Litespeed Cache compatibility bug fix
• 1.2.7: Added Freemius functionality
• 1.2.6: Load same animations on frontend and backend
• 1.2.5: Alternate Scroll bug fix
• 1.2.4: Added Animation Style
• 1.2.3: Litespeed Cache image lazy load compatibility added
• 1.2.2: Added Lenis Scroll and scroll effect
• 1.2.1: Added branding
• 1.2.0: Lightbox works asynchronously with fade animations
• 1.0.9: Removed effects on single images
• 1.0.8: Added Switcher on/off to Galleries
• 1.0.7: Added lazy load animation
• 1.0.6: Added Compatibility with Polylang and WPML
• 1.0.5: Added CSS fixes
• 1.0.4: Added Live Preview
• 1.0.3: Added Hover Effects
• 1.0.2: Added Animation Effects
• 1.0.1: Added Lightbox Functionality
• 1.0.0: Initial release

Credits

Created by Matysiewicz Studio Copyright (c) 2024 Matysiewicz Studio