=== Magic Elements ===
Contributors: loyalcoder  
Tags: elementor, elementor widgets, elementor templates, page builder, addons  
Requires at least: 5.0  
Tested up to: 7.1
Requires PHP: 7.0  
Stable tag: 1.0.5  
License: GPL v3 or later  
License URI: https://www.gnu.org/licenses/gpl-3.0.html  

Enhance Elementor with advanced widgets, templates, and features for customizable, stunning designs.

== Description ==

**Magic Elements** is a comprehensive extension for Elementor, designed to enhance your page-building capabilities with a wide variety of customizable widgets, pre-designed templates, and advanced features. Whether you're a beginner or an experienced developer, this plugin provides tools to make your website-building process faster and easier.

### Features:
- A collection of unique and powerful Elementor widgets.
- Header, Footer & Mega Menu Builder for full-site layout control.
- Attach Mega Menu templates to WordPress nav menu items.
- Pre-designed templates to kickstart your designs.
- Easy-to-use interface with seamless integration.
- Fully responsive and optimized for performance.

### Elementor Widgets Included

Magic Elements ships with a focused library of **Elementor widgets**, covering content, marketing, navigation, and layout use-cases:

- ✅ **Image** – Flexible image widget with full style controls.
- ✅ **Button** – Modern buttons with icon, hover, and alignment options.
- ✅ **Pricing Table** – Create pricing / plan tables with badges and CTA.
- ✅ **Team** – Showcase team members with image, name, role, and socials.
- ✅ **Text Editor** – Enhanced text/content block with styling controls.
- ✅ **Image Accordion** – Interactive image accordion with hover/click reveal.
- ✅ **Flip Card** – Front/back card with animated flip interaction.
- ✅ **Heading** – Advanced headings with typography and decorative styles.
- ✅ **Post Category Tab** – Filter posts by category in a tabbed layout.
- ✅ **Accordion** – FAQ/accordion content with icons and animations.
- ✅ **Counter** – Animated number counters for stats and milestones.
- ✅ **Category List** – List blog categories with icons and links.
- ✅ **Card** – Content card with image, title, text, and button.
- ✅ **Tab** – Horizontal tabs for organizing content sections.
- ✅ **Post** – Blog posts grid with thumbnail, meta, and excerpt.
- ✅ **Image Compare** – Before/after image comparison slider.
- ✅ **Light Box** – Custom lightbox for images, text, or video content.
- ✅ **Post List** – List style blog layout with meta and read more.
- ✅ **Page List** – List of selected pages with icons and links.
- ✅ **Multiple Button** – Repeater-based multi-button layout (button groups).
- ✅ **Icon Box** – Icon + title + description info boxes.
- ✅ **Info Box** – Content/info box with icon and call-to-action button.
- ✅ **Feature List** – Feature rows with icons, titles, and descriptions.
- ✅ **Review** – Testimonial/review block with rating stars.
- ✅ **Timeline** – Vertical timeline with dates, titles, and content.
- ✅ **Progress Bar** – Animated progress/skill bars with percentage.
- ✅ **Multi Step** – Multi-step wizard/flow with steps, content, and completion popup.
- ✅ **Nav Menu** – Custom header navigation menu with logo, search, and mega-menu ready structure.
- ✅ **Nav Menu V2** – Advanced navigation with logo, AJAX search, cart, off-canvas, sticky header, and Mega Menu support.

Elevate your Elementor experience and create visually stunning websites with ease.


== Source Code ==

The uncompiled JavaScript and CSS source code for this plugin is available in the following repository:

https://github.com/loyalcoder/magic-elements

This repository contains the original source files used to generate the minified assets included in the `/assets/dist/` directory of the plugin.  You can review, study, and modify the source as needed.


== Build Instructions (If applicable) ==

To generate the minified assets from the source code, follow these steps:

1. Clone the repository: `git clone [Your Repository URL]` *(Replace with your actual repository URL)*
2. Navigate to the project directory: `cd [Your Repository Directory]` *(Replace with your actual directory name)*
3. Install dependencies: `npm install`
4. Build the project: `npm run build` (or your specific build command, e.g., `yarn build`, `gulp build`)

The generated files will be placed in the `dist` directory, ready to be used in your WordPress plugin.  *(Adjust this if your build process outputs to a different directory)*


== Installation ==

1. Download the plugin from [WordPress.org](https://wordpress.org/plugins/magic-elements/).
2. Upload the plugin files to the `/wp-content/plugins/magic-elements/` directory, or install the plugin directly through the WordPress plugin screen.
3. Activate the plugin through the 'Plugins' screen in WordPress.
4. Ensure you have Elementor installed and activated for the plugin to work.

== Frequently Asked Questions ==

= Do I need Elementor installed to use this plugin? =  
Yes, Elementor is required for Magic Elements to function properly.

= Does this plugin work with all WordPress themes? =  
Yes, Magic Elements works with any theme that supports Elementor.

= How can I get support if I encounter an issue? =  
You can reach out via our [support page](https://loyalcoder.com/support).

== Changelog ==

= 1.0.5 =
* Added Mega Menu builder type (active/inactive, no display conditions).
* Added Mega Menu template selection on WordPress nav menu items.
* Improved Nav Menu V2 mobile off-canvas icon left/right positioning.
* Improved Mega Menu hover behavior with slide + fade animation.
* Improved header/footer builder condition priority (selective singular, include vs exclude, entire site).
* WordPress coding standards cleanup for layout templates.
* Internal code cleanup and cache handling for builder templates.
* Tested up to WordPress 7.1.

= 1.0.4 =
* Previous stable release on WordPress.org.

= 1.0.3 =
* Added Header & Footer Builder to feature set.
* Security and guideline compliance (sanitization, escaping, direct file access protection).

= 1.0.0 =  
* Initial release with core features.

== Upgrade Notice ==

= 1.0.5 =
Mega Menu builder, Nav Menu V2 improvements, and builder condition fixes. Tested with WordPress 7.1.

= 1.0.3 =
Header & Footer Builder, security and guideline compliance. Tested with WordPress 6.9.

= 1.0.0 =  
Initial release.

== Credits ==

Developed by [LoyalCoder](https://loyalcoder.com). Inspired by the needs of Elementor users worldwide.
