=== Block Animations, Scroll & Motion Effects by ExtenderX  ===
Version: 1.7.1
Author: WPXERO
Author URI: https://wpxero.com/plugins/extenderx
Donate link: https://wpxero.com/plugins/extenderx/pricing
Contributors: wpxero
Tags: animation, gutenberg, dark mode, maintenance mode, header footer
Requires at least: 6.2
Tested up to: 7.0
Stable tag: 1.7.1
Requires PHP: 7.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Animate any Gutenberg block — entrance scroll effects, floating motion, 3D tilt, visibility, tooltips & wrapper links. No extra blocks needed.

== Description ==

**ExtenderX adds Gutenberg block animations and scroll effects to every block in the Block Editor** — core WordPress blocks and third-party block libraries alike. No replacement blocks. No shortcodes. Open the block sidebar, pick an animation preset, and publish.

Animate blocks on scroll with **entrance animations**, add continuous **floating motion**, apply **3D tilt on hover**, control **device visibility**, add **tooltips**, and wrap blocks with **wrapper links** — all from a single **ExtenderX** panel inside Gutenberg.

### Why Use ExtenderX for Block Animations?

Most animation plugins only work with their own blocks. ExtenderX extends **the blocks you already use** — including Kadence Blocks, Spectra, Stackable, Essential Blocks, Ultimate Blocks, Ghostkit, Greenshift, Otter Blocks, and more.

- **6 animation & interaction types** in one block sidebar panel
- **Scroll-triggered entrance animations** with duration, delay, and easing controls
- **No coding required** — configure everything visually in the editor
- **Conditional asset loading** — animation scripts load only when a block uses them
- **Works with any theme** — no page builder lock-in

**Ready for advanced motion? [Upgrade to Pro](https://wpxero.com/plugins/extenderx/pricing)** for parallax, custom CSS/JS per block, seasonal effects, and marketing tools.

---

### How Block Animations Work

1. **Activate ExtenderX** and enable **Gutenberg Block Extensions** from the dashboard.
2. **Edit any page or post** in the Block Editor.
3. **Select a block** and open the right sidebar.
4. **Open the ExtenderX panel** and choose entrance, floating, tilt, visibility, tooltip, or wrapper link settings.

Your animations appear on the frontend immediately after publishing.

---

### Gutenberg Block Animations (Free)

**✅ Entrance Animations (Scroll Effects)**
Make blocks **animate on scroll** with fade in, slide up, zoom in, flip, bounce, and more. Customize duration, delay, and easing. Animations trigger when blocks enter the viewport — perfect for landing pages, portfolios, and storytelling layouts.

**✅ Floating Animations**
Add subtle, continuous **floating motion** to any block. Ideal for hero sections, testimonials, and promotional banners.
**Note:** Floating animations do not run simultaneously with Entrance or Tilt on the same block.

**✅ 3D Tilt Effect**
Blocks respond to cursor movement with GPU-accelerated **3D tilt** powered by VanillaTilt.js. Great for cards, images, pricing tables, and portfolio items.

**✅ Responsive Visibility Control**
Show or hide any block on **desktop**, **tablet**, or **mobile** independently using clean CSS — no duplicate content required.

**✅ Tooltips**
Add hover **tooltips to any Gutenberg block** powered by Tippy.js for accessible, smooth rendering.

**✅ Wrapper Links**
Turn **any Gutenberg block into a clickable link** — wrap images, groups, columns, and cards with a custom URL.

---

### Block Library Compatibility

ExtenderX extends the Gutenberg editor itself, not individual block plugins. Tested with:

- Kadence Blocks
- Spectra (UAG)
- Stackable
- Essential Blocks
- Ultimate Blocks
- Ghostkit
- Gutenverse
- GutenKit
- Otter Blocks
- Greenshift
- CoBlocks
- GenerateBlocks
- All core WordPress blocks

---

### Bonus Site Tools (Also Included Free)

ExtenderX is more than block animations — it bundles a full suite of optional site-wide tools you can toggle from one dashboard, replacing several single-purpose plugins:

**Dark Mode & Light Mode Toggle** — visitor-facing dark mode powered by DarkReader, plus a light-mode toggle. Works with any theme, no configuration.

**Maintenance Mode & Coming Soon Page** — put your site behind a maintenance screen or launch a coming-soon page with a click, while you keep working in the dashboard.

**Insert Headers & Footers + Custom Code Snippets** — add HTML, CSS, and JavaScript to your site's header (`<head>`), body, or footer without editing theme files. Manage reusable code snippets from one dashboard — perfect for Google Analytics, Google Tag Manager, Meta Pixel, AdSense, and site verification tags.

**Content Protection** — disable right click, copy/paste, inspect element, and image drag to protect your content.

**UI Enhancements** — back to top button, sticky header, sticky footer, scroll progress bar, smart scroll (auto-hide header), and scrollspy navigation.

**Announcement Bar & Floating CTA** — show a dismissible announcement / notification bar, a floating call-to-action button, and a CTA pulse animation to boost conversions.

**Seasonal Effects** — add a falling snow effect (Winter Snow), Autumn Leaves, or Falling Hearts overlay for holidays and special campaigns.

**Appearance Polish** — fade-in on page load and smooth CSS transitions site-wide.

Enable only what you need. Every feature loads conditionally — disabled tools add zero CSS or JavaScript to your pages.

---

### Insert Headers and Footers + Code Snippets (Free)

ExtenderX includes a built-in **headers and footers** manager and **custom code snippet** library — no separate plugin required.

**✅ Insert Header & Footer Code**
Add scripts and meta tags to the `<head>`, after the opening `<body>`, or before the closing `</body>` — ideal for **Google Analytics**, **Google Tag Manager**, **Meta Pixel**, **site verification**, and other third-party code.

**✅ HTML, CSS & JavaScript Snippets**
Create, organize, and toggle reusable **code snippets** from a clean dashboard table. Enable or disable each snippet instantly — your code stays saved even when switched off.

**✅ Safe & Conditional Output**
Snippets only run where you allow them. **Custom PHP snippets, conditional display logic, and scheduling** are available in **ExtenderX Pro**.

---

### ExtenderX Pro

**Pro unlocks advanced motion and site tools:** parallax effects, custom CSS/JS per block, advanced scroll effects, PHP code snippets with conditional display logic and scheduling, scrollbar styler, custom cursor effects, smooth scrolling (Lenis), 16+ seasonal & particle effects (Christmas lights, fireworks, fireflies, confetti, weather, and more), marketing tools (sticky WhatsApp button, global countdown banner), compliance modes (cookie consent, GDPR notice, age verification, exit intent), and advanced appearance modes (high contrast, reading mode, night shift, glassmorphism, preloader, skeleton loader).

[View Pro pricing →](https://wpxero.com/plugins/extenderx/pricing)

== Installation ==

1. **Download & Install:** Upload the `extenderx` folder to your `/wp-content/plugins/` directory, or search for **ExtenderX** in the WordPress Plugin Repository and click **Install Now**.

2. **Activate the Plugin:** Navigate to **Plugins > Installed Plugins** and click **Activate** next to ExtenderX.

3. **Enable Block Animations:** After activation, open the **ExtenderX Dashboard** and ensure **Gutenberg Blocks** is enabled.

4. **Animate Your First Block:** Edit any page, select a block, open the **ExtenderX** panel in the block sidebar, and choose an **Entrance Animation** preset.

5. **Publish** — your block animation is live.

== Frequently Asked Questions ==

= How do I add scroll animations to Gutenberg blocks? =
Open any page or post in the Gutenberg editor, select any block, and look for the **ExtenderX** panel in the right sidebar. Click **Entrance Animation**, choose a preset (fade in, slide up, zoom, flip, etc.), set duration and delay, and publish. Blocks animate when they scroll into view.

= What is the difference between entrance, floating, and tilt animations? =
**Entrance animations** trigger once when a block scrolls into the viewport. **Floating animations** add continuous subtle motion. **3D tilt** responds to cursor movement. Only one motion type runs per block at a time — pick the effect that fits your design.

= Does ExtenderX work with Kadence Blocks, Spectra, and Stackable? =
Yes. ExtenderX extends the Gutenberg editor itself, so **Kadence Blocks**, **Spectra**, **Stackable**, **Essential Blocks**, **Ultimate Blocks**, **Ghostkit**, **Greenshift**, **Otter Blocks**, and other third-party block libraries automatically receive ExtenderX animation controls in the block sidebar.

= Is ExtenderX compatible with all Gutenberg blocks? =
Yes. Every core WordPress block and supported third-party block gets the ExtenderX panel with entrance, floating, tilt, visibility, tooltip, and wrapper link controls.

= What is the 3D Tilt Effect and how do I use it? =
Select any block in the editor, open the ExtenderX panel, and enable **Tilt Effect**. Adjust intensity and perspective. Blocks tilt in 3D as visitors move their cursor — powered by VanillaTilt.js.

= How do I show or hide blocks on mobile, tablet, or desktop? =
Select a block, open the ExtenderX panel, and use **Visibility Control** to toggle desktop, tablet, and mobile visibility independently.

= Will ExtenderX slow down my website? =
No. ExtenderX uses **conditional asset loading** — animation JavaScript and CSS load only when a block on the current page actually uses an ExtenderX effect. Unused features add zero overhead.

= Do I need coding knowledge to use ExtenderX block animations? =
Not at all. Select a block, open the ExtenderX panel, pick a preset, and publish. No CSS or JavaScript required.

= Does ExtenderX work with third-party block libraries? =
Absolutely. ExtenderX hooks into the block editor globally, so any registered Gutenberg block — core or third-party — receives animation controls automatically.

= How do I enable dark mode on my WordPress website? =
Navigate to **ExtenderX > Site Enhancements > Appearance** and toggle **Dark Mode**. Visitors get a floating toggle to switch themes. Dark mode uses the DarkReader engine and works with any theme.

= How does content protection work in ExtenderX? =
Enable **Disable Right Click**, **Disable Copy Paste**, **Disable Inspect Element**, and/or **Disable Image Drag** from **Site Enhancements > Utility & Protection**. Each layer can be toggled independently.

= Can I disable right click on my WordPress site? =
Yes. Go to **ExtenderX > Site Enhancements > Utility & Protection** and enable **Disable Right Click**.

= How do I insert header and footer code in WordPress? =
Go to **ExtenderX > Custom Code**, create a new snippet, paste your code, and choose where it loads — the **header** (`<head>`), **body open** (after `<body>`), or **footer** (before `</body>`). It's perfect for Google Analytics, Google Tag Manager, Meta Pixel, and site verification tags — no theme file editing required.

= Can I add custom CSS, HTML, or JavaScript snippets? =
Yes. The **Custom Code** screen lets you create and manage reusable HTML, CSS, and JavaScript snippets, each with its own on/off toggle. Disabled snippets stay saved but stop running. **PHP snippets, conditional display logic, and scheduling** are available in **ExtenderX Pro**.

= How do I add a back to top button to my WordPress site? =
Enable **Back to Top** from **Site Enhancements > UI Enhancements**.

= How do I add a scroll progress bar? =
Enable **Scroll Progress Bar** from **Site Enhancements > UI Enhancements**.

= How does the Sticky Header feature work? =
Enable **Sticky Header** from **Site Enhancements > UI Enhancements**. Your navigation stays fixed at the top of the viewport as visitors scroll. Sticky Header is included in the **free version**.

= How do I add a falling snow effect to WordPress? =
Go to **ExtenderX > Site Enhancements > Seasonal Effects** and enable **Winter Snow** for an animated falling-snow overlay. **Autumn Leaves** and **Falling Hearts** are also free. Additional seasonal and particle effects (Christmas lights, fireworks, fireflies, confetti, and more) are available in **ExtenderX Pro**.

= How do I put my WordPress site in maintenance mode? =
Enable **Maintenance Mode** from **ExtenderX > Site Enhancements > Site Modes** to show visitors a maintenance screen while you work. Both **Maintenance Mode** and a **Coming Soon** launch page are included free.

= How do I create a coming soon page? =
Enable **Coming Soon Mode** under **Site Enhancements > Site Modes**. ExtenderX displays a full-page coming-soon screen to visitors while administrators keep full access to the site. It's free, with no separate plugin required.

= How do I add an announcement bar or notification bar? =
Enable **Announcement Bar** from **Site Enhancements > Marketing**. You can set the message, colors, position, and make it dismissible. A **Floating CTA Button** and **CTA Pulse Animation** are also included free.

= Can I add Google Analytics or Tag Manager without editing theme files? =
Yes. Open **ExtenderX > Custom Code**, create a snippet, paste your tracking code, and choose where it loads — the `<head>`, after the opening `<body>`, or before the closing `</body>`. It works for Google Analytics, Google Tag Manager, Meta Pixel, AdSense, and site verification tags — no theme editing.

= What is the difference between free and Pro? =
The **free version** includes all 6 Gutenberg block extensions (entrance, floating, tilt, visibility, tooltip, wrapper link); the Insert Headers & Footers + HTML/CSS/JS code snippet manager; dark mode and light mode toggle; all 4 content protection features; back to top, sticky header, sticky footer, scroll progress bar, smart scroll and scrollspy; maintenance mode and coming soon page; announcement bar, floating CTA button and CTA pulse; and three seasonal effects (Winter Snow, Autumn Leaves, Falling Hearts). **ExtenderX Pro** unlocks parallax effects, custom CSS/JS per block, advanced scroll effects, PHP code snippets with conditional logic and scheduling, scrollbar styler, custom cursor effects, smooth scrolling (Lenis), 16+ seasonal & particle effects, marketing tools (sticky WhatsApp button, countdown banner), compliance modes (cookie consent, GDPR, age verification, exit intent), and advanced appearance modes (high contrast, reading mode, night shift, glassmorphism, preloader, skeleton loader).

= How do I upgrade to ExtenderX Pro? =
Click **Upgrade to Pro** in the ExtenderX dashboard or visit [wpxero.com/plugins/extenderx/pricing](https://wpxero.com/plugins/extenderx/pricing).

= Does ExtenderX support RTL languages? =
Yes. ExtenderX includes full RTL stylesheet support for Arabic, Hebrew, Persian, Urdu, and other RTL languages.

= Can I add a WhatsApp chat button to my site? =
Yes, with **ExtenderX Pro**. Enable **Sticky WhatsApp Button** from the Marketing section.

= Does ExtenderX include cookie consent and GDPR compliance tools? =
Yes, with **ExtenderX Pro** — Cookie Consent and GDPR Notice features are included.

== Screenshots ==

1. **ExtenderX Block Sidebar** – Configure Gutenberg block animations directly from the block settings panel.
2. **Entrance Animations** – Scroll-triggered entrance effects with customizable presets, duration, and easing.
3. **3D Tilt Effect** – Interactive 3D tilt that responds to cursor movement on cards and images.
4. **Floating Animations** – Continuous floating motion effects for hero sections and highlights.
5. **Responsive Visibility** – Show or hide blocks on desktop, tablet, or mobile independently.
6. **Block Library Compatibility** – Works with Kadence, Spectra, Stackable, and all core Gutenberg blocks.
7. **ExtenderX Dashboard** – Enable Gutenberg extensions and site tools from one panel.
8. **Performance** – Conditional asset loading keeps pages fast when animations are not in use.
9. **Dark Mode** – Optional site-wide dark mode with visitor toggle (bonus feature).
10. **Content Protection** – Optional disable right click, copy, inspect, and image drag tools.

== Changelog ==

= 1.7.1 – June 21, 2026 =
* Improved: Expanded and clarified the plugin listing so the free site tools — dark mode, maintenance mode, coming soon page, announcement bar, insert headers & footers, and seasonal snow effects — are easier to discover.
* Added: New FAQ entries covering falling snow effects, maintenance mode, coming soon pages, announcement bars, and adding Google Analytics / Tag Manager without editing theme files.
* Fixed: Corrected the documented free vs Pro feature split — Smart Scroll and three seasonal effects (Winter Snow, Autumn Leaves, Falling Hearts) are free; Smooth Scrolling (Lenis) is Pro.

= 1.7.0 – June 20, 2026 =
* New: Insert Headers & Footers + Custom Code Snippets — add HTML, CSS & JavaScript to your site's header, body, or footer and manage reusable code snippets from one dashboard. Perfect for Google Analytics, Google Tag Manager, Meta Pixel, and site verification — no theme file editing.
* New: Site Modes section in Site Enhancements — maintenance mode, coming soon page, age verification, cookie consent, GDPR notice, and exit intent, all toggleable from the dashboard.
* New: Redesigned admin dashboard with a cleaner, faster card-based layout for browsing block animations and site enhancement features at a glance.
* Improved: Removed decorative emoji icons across the dashboard for a more professional, accessible interface.
* Improved: Settings now save in a single batched request when you toggle several options quickly, with a cleaner, non-duplicating "saved" notice.
* Improved: Consistent notification styling across every dashboard screen, including Custom Code snippets.
* Improved: The "Upgrade to Pro" button now reflects your license — Pro users see a "Pro active" badge instead.
* Improved: Admin dashboard accessibility — ARIA labels on feature toggles and a current-page indicator in the sidebar navigation.
* Improved: Cleaner Gutenberg Editor and Site Enhancements screens with friendlier wording for disabled states.
* Performance: Removed unused code from the settings dashboard for a lighter, faster admin interface.

= 1.6.6 – June 06, 2026 =
* Improved: Animation-first WordPress.org listing, readme, and plugin metadata for Gutenberg block animation discoverability.
* Added: Quick Start animation checklist and editor deep-link in the admin dashboard.
* Added: Review prompt and one-time block editor onboarding notice for new users.
* Added: Documentation hub with block-library compatibility guides.
* Improved: Aligned free vs Pro feature messaging across readme and licensing.
* Removed: Scroll Effects "Coming Soon" placeholder — use Entrance Animations for scroll-triggered block motion.

= 1.6.5 – May 11, 2026 =
* Improved: Floating animations block wrapper and editor panel for a clearer setup flow.
* Improved: Toggle control visuals and reset button styling in block extension panels.
* Improved: Tooltip behavior and shared extension helpers.

= 1.6.4 – April 11, 2026 =
* Improved: Compatibility with latest WordPress and PHP versions.
* Fixed: Issues with some features not working properly.

= 1.6.3 – April 08, 2026 =
* Improved: Optimized memory management for enhanced plugin performance and reduced server resource consumption.
* Improved: Redesigned settings page interface for a more intuitive and streamlined user experience.

= 1.6.2 – February 24, 2026 =
* Fixed: Resolved Sticky Header and Sticky Footer modules not functioning correctly on certain themes.
* Fixed: Corrected gradient color rendering issues in Scrollbar Styler and Scroll Progress Bar modules.
* Fixed: Addressed Hide Admin Bar on Frontend option not applying properly for logged-in users.

= 1.6.1 – February 22, 2026 =
* Tweaked: Dark Mode for admin dashboard.
* Tweaked: Shortcodes for the dark mode.
* Improved: unlock color settings for the dark mode.
* Improved: top center and bottom center positions added for the back to top button.
* Improved: Color settings added for the sticky header and footer.
* Fixed: Scrollbar styler issues are resolved.

= 1.6.0 – February 17, 2026 =
* Added: Back to Top button module for enhanced site navigation and user convenience.
* Added: Sticky Header module to keep headers visible while scrolling for better accessibility.
* Added: Sticky Footer module for persistent footer visibility across all pages.
* Added: Smooth Scroll module for seamless page navigation and improved browsing experience.
* Added: Scrollspy module for automatic navigation highlighting based on scroll position.
* Added: Scroll Progress Bar module to display reading progress indicator for visitors.

= 1.5.2 – February 09, 2026 =
* Fixed: Resolved compatibility issues with WordPress 6.9 for improved stability.
* Improved: Improved overall performance and system reliability.
* Improved: Dark mode support for the website, providing a comfortable viewing experience in low-light environments.

= 1.5.1 – January 23, 2026 =
* Added: Freemius SDK integration for better plugin management and updates.

= 1.5.0 – January 23, 2026 =
* Added: Dark Mode support for the website, providing a comfortable viewing experience in low-light environments.
* Added: Disable Right Click functionality to protect your website content from unauthorized copying.
* Added: Disable Copy Paste feature to prevent text content theft and improve content security.
* Added: Disable Inspect Element option to deter users from accessing browser developer tools on your site.
* Added: Disable Image Drag protection to prevent images from being easily downloaded via drag-and-drop.
* Added: Hide Admin Bar on Frontend option for a cleaner visitor experience without the WordPress admin bar.
* Improved: Introduced a comprehensive Dashboard for centralized plugin settings and feature management.

= 1.4.5 – December 12, 2025 =
* Improved: WordPress 6.9 compatibility.

= 1.4.4 – November 11, 2025 =
* Improved: Enhanced overall performance and system reliability.

= 1.4.3 – September 19, 2025 =
* Fixed: Resolved compatibility issues with WordPress 6.8.2 for improved stability.
* Improved: Enhanced overall performance and system reliability.
* Fixed: Corrected preview rendering issues for floating animations in the block editor.
* Fixed: Resolved preview display problems for tilt animations in the block editor.

= 1.4.2 – August 17, 2025 =
* Added: New animation presets for entrance effects.
* Improved: Further optimized loading times for animation scripts.
* Fixed: Compatibility issues with the latest WordPress 6.8.2.
* Fixed: Edge case where animations wouldn't trigger on certain themes.

= 1.4.1 – July 10, 2025 =
* Improved: Enhanced tooltip styling and positioning for better user experience.
* Improved: Optimized plugin assets for faster loading and improved performance.
* Fixed: Resolved minor compatibility issues with WordPress 6.8.1.
* Fixed: Addressed a bug where tooltips would not display correctly on some third-party blocks.

= 1.4.0 – May 20, 2025 =
* Added: Tooltips feature added.

= 1.3.6 – May 01, 2025 =
* Fixed: Compatibility issues with WordPress 6.8.1 have been resolved.

= 1.3.5 – March 04, 2025 =
* Added: Unlock all pro features, happy designing:)

= 1.3.4 – February 17, 2025 =
* Improved: General performance enhancements and code optimizations for a smoother user experience.

= 1.3.3 – December 21, 2024 =
* Fixed: Resolved minor bugs and stability issues.

= 1.3.2 – December 21, 2024 =
* Improved: System optimizations to enhance overall functionality.

= 1.3.1 – November 29, 2024 =
* Fixed: Ensured full compatibility with WordPress 6.7.1, addressing any related issues.

= 1.3.0 – November 01, 2024 =
* Added: Wrapper Link feature introduced, allowing users to wrap entire blocks with custom links for better interaction.
* Fixed: Compatibility issues with WordPress 6.7 have been resolved.

= 1.2.0 – October 18, 2024 =
* Added: Floating Animations feature introduced, providing new motion effects to enhance visual appeal.
* Fixed: Resolved compatibility conflicts with Essential Blocks, Ultimate Blocks, and Kadence Blocks.

= 1.1.3 – October 10, 2024 =
* Fixed: Compatibility fixes for Ghostkit and Otter Blocks to ensure seamless integration.
* Fixed: Various minor bug fixes for improved stability.

= 1.1.2 – October 08, 2024 =
* Fixed: Addressed compatibility issues with Spectra and GutenKit block plugins.

= 1.1.1 – October 04, 2024 =
* Added: Easing Control added to Entrance Animations for smoother motion effects.
* Added: Value Reset functionality implemented for Tilt Animation, allowing users to revert changes easily.
* Improved: Enhanced Controls UI for a more intuitive user experience.

= 1.1.0 – October 03, 2024 =
* Added: Entrance Animations introduced, enabling blocks to animate on page load for better engagement.

= 1.0.0 – October 02, 2024 =
* Initial Release: First official release of the plugin with core functionalities.

== Upgrade Notice ==

= 1.7.1 =
Listing and documentation update — easier discovery of the free site tools (dark mode, maintenance mode, announcement bar, snow effects, headers & footers) and a corrected free vs Pro feature breakdown. Recommended for all users.

= 1.7.0 =
Major free update: Insert Headers & Footers with HTML/CSS/JS code snippets, new Site Modes (maintenance, coming soon, GDPR & more), and a redesigned, faster admin dashboard. Recommended for all users.

= 1.6.6 =
Animation-first listing update, onboarding checklist, and documentation hub. Recommended for all sites targeting Gutenberg block animations.

= 1.6.5 =
Floating animations and block extension UI improvements; recommended update for all sites.

== License & Disclaimer ==

This plugin is licensed under GPL v2 or later. No warranties are provided. You are free to modify and distribute it under the same license.
