PUQ Mautic

Menu Manager WHMCS Addon

WHMCS addon module for customizing the client area Primary Navbar with a drag-and-drop menu editor, multi-language labels, display rules, mega menus, Font Awesome icons, 10 customizable navbar styles with live preview, and ready-to-use menu presets.

Description

Menu Manager addon WHMCS

Order now | Download | FAQ

PUQ Menu Manager — WHMCS Addon

PUQ Menu Manager is a standalone WHMCS addon module for customizing the client area Primary Navbar. It provides a full-featured drag-and-drop menu editor with multi-language support, display rules, mega menus, customizable navbar styles with live preview, and ready-to-use menu presets.

Key Features

Use Cases

System Requirements

Requirement Minimum
WHMCS 8.x, 9.x
PHP 8.1, 8.2+
ionCube Loader v13 or newer (v14, v15)

Changelog

Menu Manager addon WHMCS

Order now | Download | FAQ

v1.0 — 2026-02-24

First release.

New Features

Installation and Update

Menu Manager addon WHMCS

Order now | Download | FAQ

System Requirements

Requirement Minimum
PHP 8.1, 8.2 or newer
WHMCS 8.x, 9.x or newer
ionCube Loader v13 or newer (v14, v15)

Note: The module uses ionCube encoding. Make sure ionCube Loader is installed and active on your server.

Download

The module can be ordered and downloaded from PUQ Cloud:

PHP 8.1:

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Menu-Manager/php81/PUQ_WHMCS-Menu-Manager-latest.zip

PHP 8.2+:

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Menu-Manager/php82/PUQ_WHMCS-Menu-Manager-latest.zip

All versions are available at: https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Menu-Manager/

After downloading, extract the archive:

unzip PUQ_WHMCS-Menu-Manager-latest.zip

Installation

Step 1: Upload Files

Extract the module archive and upload the puq_menu_manager directory to the WHMCS addons directory:

/your-whmcs/modules/addons/puq_menu_manager/

Directory structure after upload:

modules/addons/puq_menu_manager/
    puq_menu_manager.php
    hooks.php
    whmcs.json
    version
    logo.png
    lib/
        puqMenuManager.php
        NavbarStyleManager.php
        MenuPresetManager.php
    lang/
        english.php
    templates/
        ...

Step 2: Activate the Module

  1. Log in to the WHMCS admin panel
  2. Go to Setup > Addon Modules
  3. Find PUQ Menu Manager in the list
  4. Click Activate

On activation, the module creates two database tables: puq_menu_manager and puq_menu_manager_settings.

Step 3: Configure the License Key

  1. After activation, click Configure next to the module
  2. Enter your license key in the License key field
  3. Select admin role groups that should have access to the module
  4. Click Save Changes

After saving, a verification status will appear below the license key field (e.g., success: 2027-02-23T23:25:35+01:00).

Module configuration with license key and access control Module configuration page — enter your license key and select admin role groups

Step 4: Access the Module

Go to Addons > PUQ Menu Manager to access the dashboard.

Update

Step 1: Backup

Before updating, we recommend backing up:

Step 2: Upload New Files

Extract the new version and overwrite all files in:

/your-whmcs/modules/addons/puq_menu_manager/

Step 3: Re-activate (if needed)

If the update adds new database columns, deactivate and re-activate the module:

  1. Go to Setup > Addon Modules
  2. Click Deactivate, then Activate again

This is safe — the module only creates tables/columns if they don't already exist. Your menu configuration and settings are preserved.

Step 4: Verify

  1. Go to Addons > PUQ Menu Manager
  2. Check the version number in the top-right corner of the navigation bar (e.g., v1.0)

Deactivation

  1. Go to Setup > Addon Modules
  2. Click Deactivate next to PUQ Menu Manager
  3. Confirm the deactivation

Warning: Deactivation drops the module's database tables (puq_menu_manager, puq_menu_manager_settings). All your menu configuration, navbar style settings, and customizations will be lost.

License

The module requires an active license for full functionality. The license is verified through the PUQ Cloud license server.

How License Verification Works

Without an Active License

After Activating a License

  1. The warning banner disappears
  2. All pages and features become accessible
  3. Enter your license key in Setup > Addon Modules > PUQ Menu Manager > Configure

Purchase a License

https://puqcloud.com/store/whmcs-addon-modules

For license-related questions, please contact us via the ticket system:

https://puqcloud.com/submitticket.php

Dashboard

Menu Manager addon WHMCS

Order now | Download | FAQ

Overview

The Dashboard is the main page of the PUQ Menu Manager module. It provides a quick overview of your current menu configuration and shortcuts to key features.

Dashboard page with metrics and quick actions Dashboard — overview of menu item count, active navbar style, and module version

Metrics

The dashboard displays three key metrics:

Metric Description
Total Menu Items The total number of menu items currently configured in the Primary Navbar (including all nesting levels)
Navbar Style The currently active navbar style applied to the client area (e.g., Glass Morphism, Dark Elegant, etc.)
Module Version The installed version of the PUQ Menu Manager module

Quick Actions

Below the metrics, the dashboard provides quick action buttons:

Button Description
Edit Primary Navbar Opens the drag-and-drop menu editor
Navbar Styles Opens the navbar styles management page
Settings Opens the module settings page

Navigation

The module navigation bar at the top provides access to all pages:

Primary Navbar

Menu Manager addon WHMCS

Order now | Download | FAQ

Overview

The Primary Navbar page is the main menu editor. It provides a visual drag-and-drop interface for building and managing the WHMCS client area navigation bar.

Primary Navbar editor with menu structure and item editor Primary Navbar editor — drag-and-drop menu structure on the left, item editor on the right

Action Buttons

At the top of the page, three action buttons are available:

Button Description
Save Changes Saves the current menu structure to the database and applies it to the client area
Load Preset Opens a dropdown with 5 ready-to-use menu presets
Set Default Resets the menu to the original WHMCS default Primary Navbar

Load Preset dropdown menu Load Preset dropdown — choose from Standard, Business Pro, Hosting Provider, Full Mega, or Minimal Clean

Menu Structure

The left panel shows the current menu tree. Items can be:

Menu structure with expanded nested items Menu Structure — example with Products, Resources, Support, Promotions, and My Account items with nested children

Item Editor

The right panel contains the form for adding and editing menu items.

Item Editor form with all fields Item Editor — configure menu name, link, target, display rule, divider, and mega menu settings

Fields

Field Description
Menu Name The display text for the menu item. Must be unique. Includes an icon picker button for selecting a Font Awesome 5 icon.
Menu Link The URL for the menu item. Use relative paths for internal pages (e.g., cart.php) or full URLs with https:// for external links.
Open in new tab? Whether the link opens in a new browser tab (_blank) or the same tab (_self).
Display Rule Controls when the menu item is visible: Always (all visitors), Existing Client (logged-in clients only), or Guest Client (guests only).
Nav divider Adds a horizontal dividing line before this item in dropdown menus.
Mega menu Enables mega menu mode — displays a wide dropdown panel with custom HTML content instead of a standard dropdown.
Mega menu text The HTML content for the mega menu panel. Supports any valid HTML including columns, images, links, and styled content.

Buttons

Button Description
Update Updates the currently selected menu item with the form values (enabled only when an item is selected for editing)
Add Adds a new menu item using the current form values

Multi-Language Labels

Click the Show all languages button below the Menu Name field to expand the translations panel. You can enter a translated menu name for each of the 27 supported languages.

Multi-language labels panel with 27 language fields Multi-language labels — enter translated menu names for Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Polish, Portuguese-BR, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, and Ukrainian

When a client visits the client area with a specific language selected, the matching translated label is displayed instead of the default Menu Name.

Mega Menu Templates

Below the Mega menu text field, 5 quick templates are available:

Template Description
Columns with Icons Multi-column layout with Font Awesome icons and grouped links
Feature Cards Card-based layout for highlighting features or services
Services Grid Grid layout for displaying service categories
Contact & Info Contact information panel with phone, email, and quick action buttons
Promo Banner Promotional banner with call-to-action

Click any template button to insert its HTML into the Mega menu text field. You can then customize the content as needed.

Menu Presets

The Load Preset dropdown provides 5 ready-to-use menu configurations:

Preset Description
Standard Default WHMCS menu structure with Products, Resources, Support, Promotions, and My Account
Business Pro Professional business-oriented menu with enhanced navigation
Hosting Provider Optimized for web hosting companies with hosting-specific menu items
Full Mega Menu with mega menu panels enabled for rich dropdown content
Minimal Clean Simplified, minimalist menu with essential items only

Note: Loading a preset replaces the current menu structure. A confirmation dialog is shown before applying. After loading a preset, the page reloads to reflect the changes.

Navbar Styles

Menu Manager addon WHMCS

Order now | Download | FAQ

Overview

The Navbar Styles page displays all available navbar styles as cards. Each style card shows the style name, icon, description, and an Edit button for customization.

Navbar Styles list with all 10 styles Navbar Styles — all 10 available styles with descriptions and Edit buttons

Available Styles

Style Description
Default WHMCS Standard WHMCS navbar appearance with no modifications. No customization available.
Modern Shadow Clean design with subtle shadows, smooth hover transitions and refined typography
Dark Elegant Dark background navbar with light text, elegant hover effects and premium feel
Gradient Wave Vibrant gradient backgrounds on hover, colorful and eye-catching transitions
Minimal Underline Ultra-clean design with animated underline effects on hover, no borders
Rounded Pill Rounded pill-shaped items with soft shadows and friendly, approachable design
Glass Morphism Frosted glass effect with blur, transparency and modern glassmorphism aesthetic
Neon Glow Vibrant neon glow effects on hover with dark background and luminous accents
Flat Material Google Material Design inspired with elevation shadows and ripple-like effects
Classic Bordered Traditional bordered design with clean lines, separators and classic aesthetics

Editing a Style

Click the Edit button on any style card to open the style editor page.

Note: The Default WHMCS style has no customization options — it uses the standard WHMCS navbar without any CSS modifications.

Style Editor

The style editor provides a live preview and property controls for customizing the selected style.

Style editor with live preview and property controls Style Editor — Glass Morphism style with live preview showing dropdown menu and customizable properties

Live Preview

The top section shows a live preview of the navbar with the current style settings applied. The preview includes sample menu items (Home, Services, Domains, Support) with a dropdown example, so you can see how the style looks in real-time as you adjust the properties.

Style Properties

Each style has its own set of customizable properties. Common properties include:

Property Description
Background Color The background color of navbar items
Background Opacity Opacity of the background color
Border Color Color of the item borders
Border Opacity Opacity of the borders
Text Color Color of the menu item text
Shadow Color Color of box shadows
Hover Background Opacity Opacity of the background on hover
Blur Amount Blur intensity for glass effects
Dropdown Blur Blur intensity for dropdown menus
Transition Duration Animation speed for hover effects (in seconds)

Properties vary between styles. For example, Glass Morphism includes blur controls, while Gradient Wave includes gradient angle and colors.

Action Buttons

Button Description
Save Changes Saves the current style properties to the database
Reset to Defaults Restores the default values for all properties of this style

Client Area Examples

Below are examples of how different navbar styles appear in the WHMCS client area.

Glass Morphism

Glass Morphism style — mega menu Glass Morphism — frosted glass effect with mega menu showing Get Help and Quick Actions

Glass Morphism style — dropdown menu Glass Morphism — dropdown menu with transparent blur effect

Modern Shadow

Modern Shadow style — mega menu Modern Shadow — clean design with subtle shadows and mega menu

Modern Shadow style — dropdown menu Modern Shadow — dropdown menu with smooth hover transitions

Dark Elegant

Dark Elegant style — mega menu Dark Elegant — dark background navbar with mega menu

Dark Elegant style — dropdown menu Dark Elegant — dark navbar with dropdown menu and light text

Gradient Wave

Gradient Wave style — mega menu Gradient Wave — vibrant gradient backgrounds with mega menu

Gradient Wave style — dropdown menu Gradient Wave — colorful gradient effects with dropdown menu

Minimal Underline

Minimal Underline style — mega menu Minimal Underline — ultra-clean design with mega menu

Minimal Underline style — dropdown menu Minimal Underline — animated underline effect with dropdown menu

Neon Glow

Neon Glow style — mega menu Neon Glow — dark background with luminous mega menu columns

Neon Glow style — dropdown menu Neon Glow — neon accent colors with dropdown menu

Classic Bordered

Classic Bordered style — mega menu Classic Bordered — traditional bordered design with mega menu

Classic Bordered style — dropdown menu Classic Bordered — classic borders and separators with dropdown menu

Settings

Menu Manager addon WHMCS

Order now | Download | FAQ

Overview

The Settings page allows you to select the active navbar style for the WHMCS client area.

Settings page with navbar style selector Settings — select the active navbar style from 10 available options

Navbar Style

The main section of the Settings page displays all available navbar styles as selectable cards. Each card shows:

Click on a style card to select it. The currently active style is highlighted with a border.

Available Styles

Style Description
Default WHMCS Standard WHMCS navbar appearance with no modifications
Modern Shadow Clean design with subtle shadows, smooth hover transitions and refined typography
Dark Elegant Dark background navbar with light text, elegant hover effects and premium feel
Gradient Wave Vibrant gradient backgrounds on hover, colorful and eye-catching transitions
Minimal Underline Ultra-clean design with animated underline effects on hover, no borders
Rounded Pill Rounded pill-shaped items with soft shadows and friendly, approachable design
Glass Morphism Frosted glass effect with blur, transparency and modern glassmorphism aesthetic
Neon Glow Vibrant neon glow effects on hover with dark background and luminous accents
Flat Material Google Material Design inspired with elevation shadows and ripple-like effects
Classic Bordered Traditional bordered design with clean lines, separators and classic aesthetics

Saving

After selecting a style, click the Save Settings button at the bottom of the page. The selected style is immediately applied to the WHMCS client area.

Customize Styles

Click the Customize Styles link below the style cards to navigate to the Navbar Styles page, where you can edit colors, shadows, and other properties for each style.