=== Elementor Scroll Header Switcher ===
Contributors: corsolutions
Tags: elementor, header, sticky header, scroll header, header switching
Requires at least: 5.9
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Switch between two completely different Elementor headers when scrolling. The first plugin with true dual-header replacement.

== Description ==

**Elementor Scroll Header Switcher** is the first WordPress plugin that allows you to display **two completely different Elementor headers** based on scroll position - not just style changes, but entirely different header structures, layouts, and content.

= The Problem It Solves =

Current solutions only modify styling (transparency, colours) or shrink existing headers. With our plugin, you can:

* Display a **transparent header with large logo** at the top of the page
* Switch to a **solid header with compact navigation** when scrolling
* Show **different menu items** in each header
* Use **completely different layouts** for initial vs scrolled headers
* **Mobile-first approach** - works perfectly on all devices

= Key Features =

**Dual Header System:**
* Select two different Elementor header templates (A & B)
* Header A shows at the top of the page
* Header B shows after scrolling
* Complete structure replacement, not just styling

**Smart Scroll Triggers:**
* Pixel-based triggers (e.g., "activate after 200px scroll")
* Percentage-based triggers (e.g., "activate after 20% scroll")
* Configurable trigger points

**Smooth Animations:**
* Slide Down - Header slides in smoothly
* Fade In - Header fades in elegantly
* Instant - No animation, immediate switch

**Responsive Control:**
* Enable/disable on desktop
* Enable/disable on tablet
* Enable/disable on mobile
* Device-specific configurations

**Performance Optimised:**
* Lightweight (<50KB total)
* Vanilla JavaScript (no jQuery)
* GPU-accelerated animations
* Minimal impact on page speed

= Why Choose This Plugin? =

✅ **FIRST plugin** with true dual-header replacement (complete structure change)
✅ **Mobile-first approach** - solves the #1 user complaint with other solutions
✅ **No header overlap or flash issues** - professional, polished transitions
✅ **Cross-browser compatible** - works in Chrome, Safari, Firefox, Edge
✅ **Accessibility built-in** - WCAG 2.1 AA compliant
✅ **GPL-compliant** - free to use, modify, and distribute

= Use Cases =

* **Hero sections:** Transparent header over hero image, solid header when scrolling
* **E-commerce sites:** Different CTAs in scrolled header (cart, search, account)
* **Landing pages:** Minimal initial header, full navigation when scrolling
* **Portfolios:** Creative initial header, compact professional header when browsing
* **Blogs:** Large branding header at top, focused reading header when scrolling

= Requirements =

* WordPress 5.9 or higher
* PHP 7.4 or higher
* Elementor (Free or Pro)

= Documentation & Support =

* [Documentation](https://corsolutions.co.uk/docs/elementor-scroll-header-switcher)
* [Support Forum](https://wordpress.org/support/plugin/elementor-scroll-header-switcher/)
* [Contact CorSolutions](https://corsolutions.co.uk/support)

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/elementor-scroll-header-switcher`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Create two Elementor header templates (or use existing ones)
4. Go to Header Switcher → Settings
5. Select your Header A (initial) and Header B (scrolled)
6. Configure scroll trigger and animation
7. Save settings and test on your site!

== Frequently Asked Questions ==

= Does this work with Elementor Free? =

Yes! The plugin works with both Elementor Free and Elementor Pro.

= Can I use the same header twice? =

Yes, but it's not recommended. The plugin is designed for using two different headers to create dynamic scroll behaviour.

= Will this work on mobile devices? =

Absolutely! We built this plugin with a mobile-first approach. The #1 complaint about other solutions is broken mobile functionality - ours works perfectly on all devices.

= Does this conflict with Elementor's Motion Effects? =

No. Our plugin is designed to work alongside Elementor's built-in features without conflicts.

= Can I disable the plugin on specific pages? =

The free version applies globally. Per-page customisation will be available in the Pro version.

= Will this slow down my site? =

No. The plugin is highly optimised with a total size of less than 50KB and has minimal impact on page speed (<100ms).

= What if I don't see my headers in the dropdown? =

Make sure your Elementor templates are set as "Header" type in the template settings. The plugin automatically detects Elementor headers.

= Can I switch based on specific elements instead of scroll distance? =

The free version uses pixel or percentage-based triggers. Element-based triggers (e.g., "activate when hero section exits viewport") will be available in the Pro version.

= Is there a preview feature? =

Currently, you'll need to save and test on your live site. A live preview feature is planned for a future update.

= What animation types are available? =

The free version includes three animations: Slide Down, Fade In, and Instant (no animation). More animations will be added in future updates.

== Screenshots ==

1. Settings page - Configure your dual headers
2. Header A selection - Choose your initial header
3. Scroll trigger settings - Control when Header B appears
4. Animation settings - Choose transition style
5. Responsive controls - Enable/disable per device

== Changelog ==

= 1.0.0 (11th March, 2026) =
* Initial release
* Dual header system - Select two different Elementor headers
* Basic scroll triggers - Pixel and percentage-based
* Three animation types - Slide, Fade, Instant
* Responsive control - Device-specific enable/disable
* Simple settings panel - Easy configuration
* Mobile-first approach - Works perfectly on all devices
* Performance optimised - Lightweight and fast
* Cross-browser compatible - Chrome, Safari, Firefox, Edge
* GPL v2 licensed - Free and open source

== Upgrade Notice ==

= 1.0.0 =
Initial release of Elementor Scroll Header Switcher. The first plugin with true dual-header replacement for Elementor.

== Credits ==

**Created by:** CorSolutions Team
**Website:** https://corsolutions.co.uk
**Support:** https://corsolutions.co.uk/support

Special thanks to the Elementor community for feedback and inspiration.

== Privacy & GDPR ==

This plugin does not:
* Collect any user data
* Use cookies
* Connect to external services
* Track analytics
* Store personal information

The plugin operates entirely on your WordPress installation and respects user privacy.
