PUQ Mautic

Admin Panel Unique WHMCS Addon

WHMCS addon module for admin panel theme customization with dashboard overview, global enable/disable controls, optional dark mode, 20 built-in presets, 10 manual color groups, and real-time live preview before saving. Includes license-protected configuration, safe validation flow, and multilingual admin interface support.

Description

Admin Panel Unique addon WHMCS

Order now | Download | FAQ

PUQ Admin Panel Unique — WHMCS Addon

PUQ Admin Panel Unique is an addon module for WHMCS that lets administrators fully customize the visual style of the WHMCS admin area.
It includes a modern dashboard, one-click theme presets, manual color controls, dark mode surfaces, and live preview before saving.

Key Features

System Requirements

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

 

Changelog

Admin Panel Unique addon WHMCS

Order now | Download | FAQ

v1.0 — 2026-03-10

First release.

New Features

Installation and Update

Admin Panel Unique addon WHMCS

Order now | Download | FAQ

System Requirements

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

Download

The module can be ordered and downloaded from PUQ Cloud:

PHP 8.1:

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/php81/puq_admin_panel_unique-latest.zip

PHP 8.2+:

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/php82/puq_admin_panel_unique-latest.zip

All versions are available at: https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/

After downloading, extract the archive:

unzip puq_admin_panel_unique-latest.zip

Installation

Step 1: Upload Files

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

/your-whmcs/modules/addons/puq_admin_panel_unique/

Directory structure after upload:

modules/addons/puq_admin_panel_unique/
    puq_admin_panel_unique.php
    hooks.php
    whmcs.json
    version
    logo.png
    lib/
        AdminPanelUniqueCore.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 Admin Panel Unique in the list.
  4. Click Activate.

During activation, the module creates (if missing):

Step 3: Configure Access and License Key

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

The license verification status appears under the license key field in module settings.

Module configuration with license key and access control 01-addon-config-license.png

Step 4: Open the Module

Go to Addons > PUQ Admin Panel Unique.

You will see:

Update

Step 1: Backup

Before updating, back up:

Step 2: Upload New Files

Extract the new version and overwrite all files in:

/your-whmcs/modules/addons/puq_admin_panel_unique/

Step 3: Verify

  1. Log in to WHMCS admin panel.
  2. Open Addons > PUQ Admin Panel Unique.
  3. Check the module version in the top-right of the module navigation bar (for example: v1.0).
  4. Open Configuration and confirm your saved settings are still present.

Re-activation is not required after update. Overwriting files is enough.

Deactivation

  1. Go to Setup > Addon Modules.
  2. Click Deactivate next to PUQ Admin Panel Unique.
  3. Confirm deactivation.

Deactivation does not remove module configuration data. The table mod_puq_admin_panel_unique_config is preserved for future re-activation.

License

The module requires an active license for full functionality.

How License Verification Works

Without an Active License

After Activating a License

  1. Open Setup > Addon Modules > PUQ Admin Panel Unique > Configure.
  2. Enter the license key and save.
  3. Re-open the module page; the warning disappears and full functionality is available.

Purchase a License

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

For license-related questions:

https://puqcloud.com/submitticket.php?step=2&deptid=1

Dashboard

Admin Panel Unique addon WHMCS

Order now | Download | FAQ

The Dashboard is the home page of the module, available at: Addons > PUQ Admin Panel Unique > Dashboard

It provides a quick overview of the current admin panel theme state: module version, customization status, dark mode state, active preset, current colors in use, and available preset library.

Dashboard — module overview, current theme state, and preset library 02-dashboard.png

Current Configuration

The status card shows the current module state:

Metric Description
Customization Status Shows whether global styling overrides are enabled or disabled
Dark Theme Shows whether dark mode surfaces are enabled
Active Preset Displays the currently matched preset name, or Custom Theme if colors were manually adjusted
Preset Library Total number of built-in presets available in the module

Current Colors In Use

The dashboard displays all active color groups with swatches and HEX values:

This block helps quickly audit the exact color palette currently applied in WHMCS admin.

Available Presets

The preset library section lists all built-in themes and highlights the currently active one with an In Use marker.

The dashboard is read-only: to apply another preset or change colors, open the Configuration page.

Module Information & Capabilities

The final section contains:

This gives admins a compact operational summary without opening additional pages.

Configuration

Configuration guide for Admin Panel Unique: general settings, theme presets, manual color controls, live preview behavior, and save flow.

Configuration

Configuration Overview

Admin Panel Unique addon WHMCS

Order now | Download | FAQ

The Configuration page is available at: Addons > PUQ Admin Panel Unique > Configuration

This page is the main workspace for setting up the admin panel theme: enable/disable customization, dark mode, preset selection, manual color tuning, and save.

Configuration page — general settings, presets, live preview, and color controls 03-configuration.png

Configuration Flow

  1. Enable customization.
  2. Choose a preset as a base theme.
  3. Fine-tune individual colors if needed.
  4. Check the result in Live Preview.
  5. Save configuration.

Changes are not applied to WHMCS globally until you click Save Configuration.

General Settings

Enable customization

When disabled, preset and color controls become inactive in the configuration form.

Dark Theme

Theme Presets

The module includes 20 built-in presets.
Clicking a preset instantly fills all color fields in the form:

After selecting a preset, you can still manually adjust any color before saving.

Manual Color Controls

The Choose the colors section provides direct per-element color editing via native color pickers.

Color Field Affects
Navigation bar Left navigation background
Search field Top search input and button background
Icons Icons in navigation dropdown menus
Primary buttons .btn-primary elements
Button border Borders for primary buttons
Switches Bootstrap switch handles
Table headers Datatable and themed table headers
Page selector Active pagination and selector backgrounds
Page selector border Borders for active pagination/selectors
Footer bar Admin footer bar background

Live Preview

Live Preview shows how the admin UI will look with the current form values before saving.

Live Preview — real-time rendering of current configuration values 04-live-preview.png

How it works:

This allows safe visual tuning without affecting the production admin interface until save.

Save, Validation, and Security

When you click Save Configuration, the module:

  1. Validates CSRF token.
  2. Normalizes boolean fields (enabled, dark_mode) to yes/no.
  3. Validates color fields as HEX values.
  4. Saves values to mod_puq_admin_panel_unique_config.
  5. Redirects back to Configuration page (PRG flow) and shows success/error message.

License Note

Configuration page requires a valid license.