=== Giuliomax Menu Builder ===
Contributors: giuliomax
Donate link: https://paypal.me/giuliosw
Tags: menu, navigation, hamburger menu, responsive menu, shortcode
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A powerful and easy-to-use menu plugin. Build any menu via the [menux] shortcode with icons, roles, submenus, mobile modes and multilingual support.

== Description ==

**Giuliomax Menu Builder** lets you create fully customized navigation menus and embed them anywhere using the `[menux]` shortcode. Build your menu visually from the WordPress admin, style it with colors and typography, and it works perfectly on desktop, tablet and mobile.

= ✨ Main Features =

* **Visual menu builder** — drag-and-drop interface to add pages, custom links, icons, badges, notification dots and submenus up to 3 levels
* **20 Pre-built Templates** — Choose from over 20 ready-to-use themes and use them with a single click
* **Page + custom link support** — use existing WP pages or external URLs, with target controls and role visibility
* **Advanced item targeting** — show/hide items by user role, login state, device, current page, schedule, time range or UTM source
* **Menu location assignment** — tag items for Primary, Footer, Sidebar or Mobile and render with `[menux location="..."]`
* **Responsive mobile menu** — automatic fit-based breakpoint or manual pixel threshold
* **4 mobile opening modes** — Dropdown, Fullscreen overlay, Drawer left, Drawer right
* **Hamburger style controls** — classic, modern or minimal icon appearance, alignment and colors
* **Sticky header** — fixed menu on scroll with background, shadow, alignment, shrink and auto-hide behavior
* **Scroll progress bar** — page reading indicator that works on sticky or normal menus
* **Dark mode support** — Light, Dark or Auto (follows OS preference)
* **Typography & layout** — Google Fonts, fallback font, size, weight, spacing and text transform
* **Link animations** — hover effects like Lift, Scale, Pulse, Bounce, Shake, Glow and Underline
* **Entrance animations** — Fade, Slide, Zoom, Flip with duration, delay and stagger controls
* **Import / Export** — save and restore menu configurations as JSON
* **Multilingual ready** — WPML, Polylang and TranslatePress support with language-specific item labels
* **Live preview** — desktop/tablet/mobile preview while building the menu

= 🎨 Style Options =

* Colors: background, links, hover, active state, submenus, last item
* Typography: Google Fonts, font family, size, weight, letter spacing, text transform
* Layout: gap, padding, item alignment, push-last-right
* Mobile: breakpoint, overlay color and opacity, blur, drawer width, open animation

= 🔌 Usage =

1. Go to **Giuliomax Menu Builder** in the WordPress admin sidebar
2. Build your menu items
3. Configure colors and style
4. Place `[menux]` in any page, post, widget or template

= 🚀 Pro Version =

The **Pro** version adds:

* 📊 **Click statistics** — track which items users click, by device, role and date
* 🖼️ **Logo** — add and position a logo image inside the menu
* 🔍 **Search bar** — instant full-text search modal with keyboard navigation
* ♿ **Accessibility panel** — WCAG 2.1 tools (focus outline, skip link, reduced motion, high contrast, ARIA labels)
* 🌈 **Gradients** — CSS gradient backgrounds for container, hover and active states
* 🎨 **Custom CSS** — write your own CSS rules directly from the admin panel
* 📄 **Multiple menus** — create and manage independent menu configurations for different pages or locations

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin from **Plugins → Installed Plugins**
3. Go to **MenuX** in the admin menu
4. Build your menu and copy the shortcode `[menux]`
5. Paste `[menux]` wherever you want the menu to appear

= Requirements =

* WordPress 5.8 or higher
* PHP 7.4 or higher

== Frequently Asked Questions ==

= How do I display the menu? =

Use the shortcode `[menux]` in any page, post, widget or block. The same menu is shown everywhere; for multiple menus in the same site, use the Import/Export feature to manage separate configurations.

= Can I have different menus for different pages? =

Not in the free version. Use role-based visibility or per-item device/page conditionals to adapt the menu per context. Full multiple-menu support is available in the Pro version.

= Does it work with page builders? =

Yes. You can insert `[menux]` as a shortcode block in Gutenberg, Elementor, Divi, WPBakery and most other builders.

= Does it work with caching plugins? =

Yes. The menu HTML is generated server-side and compatible with WP Rocket, LiteSpeed Cache, W3 Total Cache and similar plugins.

= How do I add Font Awesome icons? =

In the menu builder, each item has an icon field. Type the FA class name, e.g. `fa-solid fa-house`. The Font Awesome 6 library is loaded automatically.

= Is it compatible with WPML / Polylang / TranslatePress? =

Yes. This plugin automatically detects installed multilingual plugins and lets you set a label per language for each menu item.

= Where is the mobile breakpoint? =

Go to **MenuX → Style → Layout → Sticky & Advanced** and set your preferred pixel breakpoint. Default is 768px.

= Can I use custom CSS? =

Custom CSS editing is available in the Pro version. In the free version you can rely on WordPress theme CSS or child-theme stylesheets to target the `.menux-container` wrapper and its child elements.


== External Services ==

This plugin may connect to the following external service:

**Google Fonts** (optional)

If a Google Font name is entered in the Style panel (Typography tab), the plugin loads that font's stylesheet from Google's servers at `https://fonts.googleapis.com`. This request is made only when a Google Font is explicitly configured by the site administrator. The font name and the visitor's IP address are sent to Google as part of the standard HTTP request.

* Terms of service: https://developers.google.com/terms
* Privacy policy: https://policies.google.com/privacy

Font Awesome icons are bundled locally within the plugin and do **not** load from any external server.

== Screenshots ==

1. Page configuration settings.
2. Typography and visual effects settings.
3. Dedicated settings for mobile mode.
4. Layout customization options.
5. Live preview of the mobile layout.
6. Live preview of the desktop layout.


== Changelog ==

= 2.1.2 =
* Removed Custom CSS textarea from the Style panel to comply with WordPress.org plugin guidelines
* Removed ipapi.co external call (click-tracking country detection is a Pro-only feature)
* Updated External Services documentation in readme with Terms of Service and Privacy Policy links

= 2.1.1 =
* Initial release of Giuliomax Menu Builder
* Includes all core features: builder, 4 mobile modes, sticky, scroll progress bar, entrance animations, import/export, multilingual

== Upgrade Notice ==

= 2.1.2 =
Compliance update: removes the Custom CSS textarea and an undisclosed external service call. No data loss; previously saved custom CSS will no longer be applied.

= 2.1.1 =
First public release. No upgrade needed.
