=== Cascading Mega Menu for Elementor ===
Contributors: terencebentem
Tags: mega menu, elementor, navigation, dropdown, menu builder
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 3.02
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Unlimited-level cascading mega menu with full Elementor widget support.

== Description ==

Cascading Mega Menu for Elementor adds a powerful, fully customizable mega menu widget to Elementor.
You can visually build multi‑column, multi‑level navigation where hovering an item reveals its children in the next column.

**Key features:**

- Unlimited nesting depth – build simple two-level menus or complex cascading structures.
- Pure Elementor workflow – configure menu items, parents, and links directly in the widget panel.
- Smart column layout – each depth level automatically appears as a new column.
- Submenu indicators – configurable icons for items that have children.
- Modern styling controls – typography, colors, padding, column width, separators, and more.
- Responsive – columns stack vertically on mobile for better usability.

The widget is designed to feel native to Elementor and requires no custom code from the end user.

== Installation ==

1. Upload the plugin ZIP to your WordPress site:
   - Go to **Plugins → Add New → Upload Plugin**.
   - Select the ZIP file containing this plugin.
   - Click **Install Now**, then **Activate**.

2. Open any page with the Elementor editor.

3. In the Elementor panel, search for **“Cascading Mega Menu”**.

4. Drag the widget into your layout and configure:
   - Add items in the **Menu Items** section.
   - For top-level items, leave **Parent Item Title** empty.
   - For nested items, set **Parent Item Title** to the exact title of the parent you want to nest under.

5. Use the **Item Styling**, **Panel Styling**, and **Column Headings** sections to fine‑tune the appearance.

== Frequently Asked Questions ==

= Does this plugin require Elementor? =

Yes. Cascading Mega Menu for Elementor is an Elementor widget and requires the Elementor plugin to be installed and active.

= Will this work with any theme? =

The widget is built using standard WordPress and Elementor practices and should work with any properly coded theme.
Styling may vary slightly between themes, but you can adjust typography, colors, and spacing from the widget controls.

= How do I create nested (child) menu items? =

Each menu item has a **Parent Item Title** field:

- Leave it empty to create a **top-level** item.
- To create a **child** item, type the exact title of the parent item into **Parent Item Title**.
- You can repeat this process to create as many levels as you need.

= Does the menu support external links and nofollow? =

Yes. Each item uses Elementor’s **URL** control, which supports external links (`target="_blank"`) and `nofollow`.

== Screenshots ==

1. Cascading multi‑column mega menu in the front end.
2. Elementor editor view showing the Cascading Mega Menu widget and its controls.

== Changelog ==

= 3.02 =
* Initial public release for the WordPress.org plugin directory.

== Upgrade Notice ==

= 3.02 =
Initial public release. Install this version to start using the Cascading Mega Menu widget in Elementor.

