=== MenuVerse – Mobile Menu & Bottom Navigation Bar ===
Contributors: wpxero
Tags: mobile menu, bottom navigation, bottom menu, mobile navigation, hamburger menu
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.6.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a mobile menu and an app-style bottom navigation bar to WordPress. Sticky bottom menu with icons, live preview, WooCommerce and block themes.

== Description ==

**MenuVerse adds a mobile menu and an app-style bottom navigation bar to any WordPress site.** Put your most important pages one thumb-tap away on phones, with a sticky bottom menu like the tab bar in every mobile app, an off-canvas hamburger menu, or both together. Set it up with a live phone preview, without code, using the menus you already have.

Most mobile visitors never open a hamburger menu. A bottom navigation bar keeps Shop, Cart, Search, Book and Call on screen the whole time they scroll, which is where people tap.

= What you can build with MenuVerse =

* **A bottom navigation bar** (also called a tab bar, mobile footer menu or sticky bottom menu) with icons and labels, fixed to the bottom of the screen on phones and tablets.
* **A mobile menu**: a responsive hamburger menu that slides in from the side, with accordion submenus.
* **Both together**, from one dashboard, each placed automatically, with a block, with a shortcode or in a theme template.

= Who it is for =

* **WooCommerce stores**: a cart button, product search and account one tap away.
* **Restaurants, salons, clinics and services**: Book, Call and Directions always in reach.
* **Blogs and news sites**: categories, search and saved posts on a phone.
* **Membership, course and community sites**: dashboard, messages and profile, the way an app feels.

= Bottom navigation bar features (free) =

* Up to four buttons, plus a **More** drawer for everything else.
* Buttons that open a page, a link, or a **search box** for the whole site, **WooCommerce** products or Easy Digital Downloads.
* **229 built-in icons**, drawn for MenuVerse and delivered as inline SVG: no icon font and nothing loaded from a CDN.
* Wording above or below each icon, your own badge text (such as "New" or "Sale"), and room for the iPhone home bar.
* Three ways to mark the current page: colour, pill or underline.
* A **dock** shape, where the current button rises out of a slim base.
* Hide the bar while visitors scroll down and bring it back when they scroll up.
* **43 ready-made looks**, 13 of them free, from clean white to dark, glass and gradient. Every look keeps its icons at a contrast of at least 3:1 against the bar, the level accessibility guidelines ask of icons.
* Buttons respond the moment they are touched, on the iPhone as well.

= Mobile menu features (free) =

* A responsive off-canvas hamburger menu that slides in from the left or the right.
* An animated menu button and an optional top bar with your logo or site title.
* Accordion submenus that open on the section the visitor is already in.
* An optional coloured edge where the panel meets the page.
* Keyboard friendly: focus stays inside the open menu and returns to the button when it closes.
* Your breakpoint, so the mobile menu takes over exactly where your theme's desktop menu stops working.

= Works with your theme and your menus =

* **No rebuilding.** MenuVerse shows the menus you already manage under Appearance → Menus, and the Navigation menus block themes use. Keep editing them where you always have.
* **Block themes and classic themes.** Block themes such as Twenty Twenty-Five hide Appearance → Menus; MenuVerse brings it back only when your theme leaves it out.
* **Page builders.** Use the block, or the `[menuverse_bottom_menu]` and `[menuverse_mobile_menu]` shortcodes in Elementor, Divi, Beaver Builder or any builder that accepts shortcodes.
* **Per-item extras** such as an icon, a badge, or hide on mobile, edited right in the WordPress menu editor.

= Fast, accessible and private =

* **Under 8 KB per module**, JavaScript and CSS together, compressed. The bottom bar adds 7.4 KB.
* **Loads only where it shows.** Pages without a MenuVerse menu load no MenuVerse files at all.
* **No jQuery, no icon font, no external requests.**
* **Accessible**: screen reader labels, the current page announced, full keyboard support, and every animation stills for visitors who ask their device to reduce motion.
* **Right-to-left ready**: the layout mirrors itself on Arabic, Hebrew and other RTL sites, automatically.

= A dashboard you can see =

* A **live phone preview** beside every setting, so each change shows as you make it.
* A short guided setup the first time you open it.
* **Import and export** your settings to move them to another site.
* A **Maintenance** panel: a System Status report for support requests, a button that clears cached menus, and a settings repair.
* Delete-on-uninstall is optional and off by default, so your setup is never lost by accident.

= MenuVerse Pro: more taps on what earns you money =

The free plugin is complete on its own. [MenuVerse Pro](https://wpxero.com/plugins/menuverse/pricing?utm_source=wordpress.org&utm_medium=readme&utm_campaign=menuverse) is an add-on for sites that want the bar to work harder.

**Turn taps into calls, chats and sales**

* **WhatsApp and phone call buttons** that open a chat or dial straight away.
* **A standout button**: one button, such as Book, Order or Shop, drawn bigger and rising out of the bar, with an optional wiggle that draws the eye.
* **Live cart and wishlist counts** for WooCommerce and YITH Wishlist, updated without reloading the page and safe with full-page caching.
* **Popup Maker buttons**, a **slide-up panel** of your own content or a contact form, and a button that opens **one of your menus**.
* **A fifth button onwards**, or a bar that scrolls sideways.

**Show the right menu to the right visitor**

* **Page rules**: show a menu everywhere, only on chosen pages, or everywhere except some.
* **Audience rules**: show it to signed-in visitors, signed-out visitors or chosen user roles, for the whole bar or one button at a time.
* **Scheduling**: a date range, chosen weekdays and a daily time window, for opening hours or a weekend sale.

**Make it unmistakably yours**

* **30 more ready-made looks**: frosted glass, gradients, a smooth notch that slides under the current page, glowing dots and lifted buttons.
* **Glass, gradient and picture backgrounds**, shadows, a **dark mode** palette and per-button colours.
* **Your own images as icons**, with a different image for the current page.
* **A livelier feel**: buttons that press in deeply or pop, and a light vibration on tap on Android.

**A fuller mobile menu**

* **Full-screen and push panels**, and new ways for the menu to open, including one that grows out of the menu button.
* **Search, social links, free text and big action buttons** inside the menu.
* A sticky top bar that hides on scroll, swipe to close, and hiding your theme's own mobile menu.

**No lock-in.** Pro installs beside the free plugin, so nothing is rebuilt. If your licence ever lapses, every setting stays saved and the bar simply falls back to the free options.

[See MenuVerse Pro features and pricing →](https://wpxero.com/plugins/menuverse/pricing?utm_source=wordpress.org&utm_medium=readme&utm_campaign=menuverse)

= Coming soon =

A **mega menu** is in development and shows as Coming soon in the dashboard. It is not usable yet.

= For developers =

Hooks, settings schemas, the render pipeline and the REST routes under `menuverse/v1` are documented in `docs/extension-points.md`. Development happens on [GitHub](https://github.com/wpxero/menuverse).

== Installation ==

1. In your WordPress admin, go to **Plugins → Add New**, search for **MenuVerse**, then click **Install Now** and **Activate**.
2. Open **MenuVerse** in the admin sidebar. A short guided setup walks you through your first menu.
3. Turn on the **Bottom Menu** module, pick a look, choose what each button does, and save.
4. Choose where it appears: automatically on every page, with the MenuVerse block, with a shortcode, or with a template tag.

To install by hand, upload the `menuverse` folder to `/wp-content/plugins/` and activate it on the **Plugins** screen.

== Frequently Asked Questions ==

= What is a bottom navigation bar? =

A bottom navigation bar is a row of three to five icon buttons fixed to the bottom of a phone screen, like the tab bar in most phone apps. It keeps a site's most important pages one thumb-tap away while visitors scroll. MenuVerse adds one to WordPress without code.

= How do I add a bottom navigation bar to WordPress? =

Install MenuVerse, open **MenuVerse** in the admin sidebar and turn on the **Bottom Menu** module. Pick a ready-made look, choose what each button opens (a page, a link or a search box) and save. Turn on "Show it on every page automatically", or place the MenuVerse block or the `[menuverse_bottom_menu]` shortcode where you want it. No theme files are edited.

= How do I add a mobile menu to WordPress? =

Turn on the **Mobile Menu** module, choose one of your existing menus, and set the breakpoint where your theme's desktop menu should hand over. Then turn on automatic placement or add the MenuVerse Mobile Menu block or the `[menuverse_mobile_menu]` shortcode. The mobile menu is marked Beta: it works and your settings are kept, though some options may still change.

= Hamburger menu or bottom navigation: which is better on mobile? =

For most sites, both. A bottom navigation bar keeps the four or five most-used pages visible at all times, and a hamburger menu holds everything else. MenuVerse does both, from the menus you already have.

= How do I make my WordPress menu mobile friendly? =

Add a bottom navigation bar for the pages people use most and a responsive hamburger menu for the rest. With MenuVerse both take a few minutes, use the menus you already built, and show only below the screen width you choose.

= Can I add a WooCommerce cart button to the mobile bottom bar? =

Yes. Any button can link to the cart or open a product search, free. A live cart count badge on the button is part of MenuVerse Pro. It reads each visitor's own cart, so it stays correct under full-page caching.

= Does MenuVerse work with Elementor, Divi and other page builders? =

Yes. MenuVerse renders outside your page content, so it works with any builder. To place it inside a layout, use the shortcode widget or module with `[menuverse_bottom_menu]` or `[menuverse_mobile_menu]`.

= Does it work with block themes and the Site Editor? =

Yes. MenuVerse reads block Navigation menus, adds blocks you can place in any template, and restores Appearance → Menus on block themes so per-item icons and badges can be edited.

= Do I have to rebuild my menus? =

No. MenuVerse displays the menus you already have. It never copies or replaces them, so you keep editing them in WordPress.

= Will it slow my site down? =

No meaningful amount. Each module is under 8 KB compressed, loads only on pages where it shows, and uses no jQuery, no icon font and no outside requests.

= Can I show the bottom bar only on some pages, or only to logged-in users? =

A bar you place yourself with a block, shortcode or template tag shows exactly where you put it, free. Rules for automatic placement (chosen pages, signed-in or signed-out visitors, user roles, dates and times) are part of MenuVerse Pro.

= Can I hide my theme's mobile menu? =

Yes, with MenuVerse Pro: enter the theme menu's CSS selector and it is hidden below your breakpoint, so only MenuVerse's menu shows.

= Is MenuVerse accessible and RTL-ready? =

Yes. It uses proper labels, announces the current page, supports the keyboard throughout, and respects reduced motion. The layout mirrors itself automatically on right-to-left sites.

= Is MenuVerse free? =

Yes. The free plugin includes the mobile menu, the bottom navigation bar with up to four buttons, 13 looks, 229 icons, the live preview and every way of placing a menu. MenuVerse Pro adds more buttons and button types, visibility rules, 30 more looks and extra finishes.

= What happens to my settings if Pro is deactivated? =

Nothing is deleted. Paid options fall back to the free defaults on your site, and everything you set up stays saved until a licence is active again.

= Can I move my settings to another site? =

Yes. Under **MenuVerse → Tools**, export your settings as a file and import it on the other site. Menus and media are not included.

= Does uninstalling remove my settings? =

Only if you ask it to. Turn on "Delete data on uninstall" under Tools before deleting the plugin. It is off by default.

= Where do I get help? =

Ask in the [support forum](https://wordpress.org/support/plugin/menuverse/), or open the **Support** screen inside the MenuVerse dashboard. Include the System Status report from **Tools → Maintenance** and we can help faster.

== Screenshots ==

1. The MenuVerse dashboard: the mobile menu, bottom navigation bar and other modules as cards, each with its status and settings.
2. The mobile menu: an off-canvas hamburger menu with an accordion submenu open, on a phone.
3. The bottom navigation bar on a phone, an app-style sticky bottom menu with the More drawer open.
4. Ready-made looks for the bottom navigation bar, with the live phone preview showing the selected one.
5. Customization: step-by-step settings for colour, labels and corner shape beside the live preview.
6. A mobile menu and a bottom navigation bar working together on the frontend of a site.

== Changelog ==

= 0.6.0 =
* Renamed to "MenuVerse – Mobile Menu & Bottom Navigation Bar".
* 43 ready-made looks for the bottom bar, up from 38: Bloom, Fern, Magenta, Breeze and Neon.
* Twelve looks read more clearly: Aqua, Aurora, Blaze, Coral, Graphite, Hairline, Lagoon, Orchid, Sea glass, Sunset, Tide and Wording only. Every look now keeps its icons at 3:1 or better against the bar, where some were as low as 1.9:1 over a light page. A bar already using one keeps its colours until you choose the look again.
* The cut out marker is now a smooth curve: the bar dips under the current page and rises back with rounded edges. The original round cut is still there, under "Shape of the cut out".
* A standout button: one button drawn bigger, rising out of the bar, in five sizes, with an optional wiggle (Pro).
* A button can open one of your menus in a slide-up sheet, with nested items that fold open (Pro).
* Choose how a button moves when tapped, for the whole bar or one button. Pressing in stays free; a deeper press and a pop are Pro.
* Buttons show they have been pressed the moment a finger lands, including on the iPhone.
* A tiny vibration on each tap, on Android phones that allow it (Pro).
* The dot in the small cut out can take the bar's own colour (Pro).
* Mobile menu: big buttons under the links (Pro), an edge where the panel meets the page in one colour (free) or a blend of two (Pro), and new ways to open: drift, grow, swing like a door, slide up, drop like a blind, or grow out of the menu button (Pro).
* 52 more icons, 229 in all, drawn in the same style: food and drink, travel, health, home, business, weather and more.
* New Maintenance panel under Tools: System Status, clear the menu cache, and repair stored settings.
* A one-time request for a review on the MenuVerse dashboard, two weeks after install and only once a menu is live. Dismiss it for good with one click.
* Developers: `notch_shape`, `tap_animation`, `fullscreen_animation` and the `menu` link type; REST routes `GET /status`, `DELETE /cache` and `POST /repair`; action `menuverse_cache_cleared`.

= 0.5.1 =
* Renamed to "MenuVerse – Mobile Menu & Bottom Navigation Builder".
* Fixed: search, panel and popup buttons in the More drawer picked up the theme's button styling.
* Fixed: a mobile menu with its top bar on showed two close buttons.

= 0.5.0 =
* Twenty seven ready-made looks for the bottom bar, rebuilt to differ in shape as well as colour, including nine frosted glass looks and new Statement looks.
* A quieter dashboard that no longer shows other plugins' admin notices.
* Fixed the lifted current-page button on scrolling bars and on blended or picture backgrounds, a flash when closing the search box, and current-page markers in the live preview.

= 0.4.0 =
* Dashboard redesign, and Support as a screen inside the dashboard.

= 0.3.0 =
* Block themes get Appearance → Menus back, where per-item icons and badges are edited.

= 0.2.0 =
* Bottom bar: slide-up panels, image icons, per-button visibility and a sideways-scrolling mode.

= 0.1.0 =
* First public release: Mobile Menu and Bottom Menu modules, live preview dashboard, and settings import and export.

The full history is in [CHANGELOG.md on GitHub](https://github.com/wpxero/menuverse/blob/main/CHANGELOG.md).

== Upgrade Notice ==

= 0.6.0 =
Five new looks, clearer colours on twelve more, a standout button, menus that open from the bar, 52 new icons and a Maintenance panel. Bars using the cut out marker switch to the new smooth curve; choose "Round cut" to keep the old shape. No menus or saved settings are removed.

= 0.5.1 =
A new name and two visual fixes. No settings, menus or saved data are touched.
