# Admin Panel Unique WHMCS Addon # Description ### Admin Panel Unique addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/) | [FAQ](https://community.puqcloud.com/) ## 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 - **Dashboard Overview** — current customization status, dark mode state, active preset detection, preset library count, and module information - **Configuration Workspace** — card-based UI for all appearance settings in one place - **Enable/Disable Customization** — global switch to apply or disable all admin panel style overrides - **Dark Mode Option** — optional dark interface surfaces while preserving selected accent colors - **20 Built-in Theme Presets** — one-click preset application (Standard, Blue, Purple, Green, Turquoise, Sunset, Rose, Nord, Midnight, Graphite, Amber, Cherry, Ocean, Sky, Forest, Emerald, Indigo, Lavender, Copper, Cyber) - **10 Manual Color Controls** — fine-tune navigation bar, search field, icons, primary buttons, button border, switches, table headers, page selector, page selector border, and footer bar - **Live Preview** — instant visual preview of pending changes before saving - **Safe Configuration Save Flow** — CSRF token validation, HEX color validation, and PRG redirect after save - **Admin Hooks Integration** — automatic CSS injection via `AdminAreaHeadOutput` when customization is enabled - **License Protection** — online/offline license verification with graceful behavior (Dashboard stays available, Configuration is locked without valid license) - **License Alerts** — warning banner in module pages and admin homepage hook notification when license is invalid - **Multilingual Interface** — automatic admin language detection with 30 language files included - **Persistent Storage** — settings are stored in `mod_puq_admin_panel_unique_config` and preserved on module deactivation - - - - - - ## System Requirements
RequirementMinimum
**WHMCS**8.x, 9.x
**PHP**8.1, 8.2+
**ionCube Loader**v13 or newer (v14, v15)
- - - - - - ## Links - **Product page:** [https://puqcloud.com/](https://puqcloud.com/) - **Documentation:** [https://doc.puq.info/books/admin-panel-unique-whmcs-addon](https://doc.puq.info/books/admin-panel-unique-whmcs-addon) - **Support:** [https://puqcloud.com/submitticket.php?step=2&deptid=1](https://puqcloud.com/submitticket.php?step=2&deptid=1) - **Community:** [https://community.puqcloud.com/](https://community.puqcloud.com/)# Changelog ### Admin Panel Unique addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/) | [FAQ](https://community.puqcloud.com/) ## v1.0 — 2026-03-10 First release. ### New Features - Dashboard page with current configuration overview (module info, customization status, dark mode status, active preset, current colors) - Configuration page with modern card-based UI for all appearance settings - Global enable/disable switch for all admin panel customization styles - Dark mode toggle for admin interface surfaces - 20 built-in theme presets with one-click apply - 10 individual color controls for key admin UI elements - Real-time live preview of pending changes before save - CSRF protection on configuration save requests - HEX color format validation before writing settings - Safe PRG save flow (redirect after POST to prevent duplicate submissions) - Automatic CSS injection into WHMCS admin area via `AdminAreaHeadOutput` hook - License verification system with online/offline validation logic - Configuration page locked when license is invalid; Dashboard remains accessible - License warning banner inside module pages - Additional license alert on WHMCS admin homepage via `AdminHomepage` hook - Multilingual support with automatic admin language detection and fallback to English - Persistent settings storage in `mod_puq_admin_panel_unique_config`# Installation and Update ### Admin Panel Unique addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/) | [FAQ](https://community.puqcloud.com/) ## System Requirements
RequirementMinimum
**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: - **Order / Download:** [https://puqcloud.com/store/whmcs-addon-modules](https://puqcloud.com/store/whmcs-addon-modules) - **Documentation:** [https://doc.puq.info/books/puq-admin-panel-unique](https://doc.puq.info/books/puq-admin-panel-unique) - **FAQ / Community:** [https://community.puqcloud.com/](https://community.puqcloud.com/) - **Direct download links:** PHP 8.1: ```bash wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/php81/puq_admin_panel_unique-latest.zip ``` PHP 8.2+: ```bash 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/](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/) After downloading, extract the archive: ```bash 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: ```text /your-whmcs/modules/addons/puq_admin_panel_unique/ ``` Directory structure after upload: ```text 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): - `mod_puq_admin_panel_unique_config` — module configuration storage - `puq_license` — license verification cache table ### 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](https://doc.puq.info/uploads/images/gallery/2026-03/embedded-image-vxnrvpva.png)*01-addon-config-license.png* ### Step 4: Open the Module Go to **Addons** > **PUQ Admin Panel Unique**. You will see: - **Dashboard** page (module overview, active preset and current colors) - **Configuration** page (enable/disable, dark mode, presets, manual colors, live preview) - - - - - - ## Update ### Step 1: Backup Before updating, back up: - Your WHMCS database - Module files in `modules/addons/puq_admin_panel_unique/` - Module tables: `mod_puq_admin_panel_unique_config`, `puq_license` ### Step 2: Upload New Files Extract the new version and overwrite all files in: ```text /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 - License key is stored in addon module settings. - Online verification is performed against `https://license.puqcloud.com/api/v1/licenses_verification`. - Verification result is cached in `puq_license`. - Cache validity window is 5 days (module setting `days = 5`). - If cached verification is valid for the current period, the module can continue working without an immediate online request. ### Without an Active License - **Dashboard** remains accessible. - **Configuration** page is locked and shows a license-required screen. - A license warning appears in module pages and on WHMCS admin homepage. ### 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](https://puqcloud.com/store/whmcs-addon-modules)** For license-related questions: **[https://puqcloud.com/submitticket.php?step=2&deptid=1](https://puqcloud.com/submitticket.php?step=2&deptid=1)**# Dashboard ### Admin Panel Unique addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/) | [FAQ](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-03/embedded-image-on2cyy2d.png)*02-dashboard.png* - - - - - - ## Current Configuration The status card shows the current module state:
MetricDescription
**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: - Navigation bar - Search field - Icons - Primary buttons - Button border - Switches - Table headers - Page selector - Page selector border - Footer bar 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: - Module name and current version - Quick links to documentation and website - A short capability summary (enable/disable customization, dark mode, presets, manual color controls, live preview) 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 Overview ### Admin Panel Unique addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Admin-Panel-Unique/) | [FAQ](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-03/embedded-image-2yc1skm2.png) *03-configuration.png* --- ## Configuration Flow Recommended workflow: 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 - **Yes**: module CSS is injected into WHMCS admin area and all selected colors are applied. - **No**: custom styles are disabled and WHMCS default styling remains active. When disabled, preset and color controls become inactive in the configuration form. ### Dark Theme - Toggles dark surfaces for admin interface blocks while keeping your accent colors. - Works together with your selected preset or manual colors. - State is shown as ON/OFF in the toggle button and reflected in live preview immediately. --- ## Theme Presets The module includes 20 built-in presets. Clicking a preset instantly fills all color fields in the form: - Navigation bar - Search field - Icons - Primary buttons - Button border - Switches - Table headers - Page selector - Page selector border - Footer bar 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](https://doc.puq.info/uploads/images/gallery/2026-03/embedded-image-ig0lmbib.png) *04-live-preview.png* How it works: - Any change in a color picker updates preview styles instantly. - Preset click updates preview instantly. - Dark mode toggle updates preview instantly. - If customization is set to **No**, preview resets to default (non-customized) appearance. - Checkbox/radio, table, pagination, navigation, search, and button elements are rendered in preview with current settings. 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. - If the license is invalid, Configuration is locked with a License Required screen. - Dashboard remains accessible in read-only mode.