=== Giuliomax Menu Builder ===
Contributors: giuliomax
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.

== 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.
