PUQ Mautic Skip to main content

Installation and Update

Service Label Designer 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-Service-Label-Designer/php81/PUQ_WHMCS-Service-Label-Designer-latest.zip

PHP 8.2+:

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Service-Label-Designer/php82/PUQ_WHMCS-Service-Label-Designer-latest.zip

All versions are available at: https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Service-Label-Designer/

After downloading, extract the archive:

unzip PUQ_WHMCS-Service-Label-Designer-latest.zip

Installation

Step 1: Upload Files

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

/your-whmcs/modules/addons/puq_service_label_designer/

Directory structure after upload:

modules/addons/puq_service_label_designer/
    puq_service_label_designer.php
    hooks.php
    whmcs.json
    version
    logo.png
    lib/
        puqServiceLabelDesigner.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 Service Label Designer in the list
  4. Click Activate

On activation, the module creates two database tables: puq_service_label_designer_config and puq_service_label_designer_overwrite.

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-16T01:32:13+01:00).

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

Step 4: Access the Module

Go to Addons > PUQ Service Label Designer to access the dashboard.

Update

Step 1: Backup

Before updating, we recommend backing up:

  • Your WHMCS database
  • Module files in modules/addons/puq_service_label_designer/

Step 2: Upload New Files

Extract the new version and overwrite all files in:

/your-whmcs/modules/addons/puq_service_label_designer/

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 settings and templates are preserved.

Step 4: Verify

  1. Go to Addons > PUQ Service Label Designer
  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 Service Label Designer
  3. Confirm the deactivation

Warning: Deactivation drops the module's database tables (puq_service_label_designer_config and puq_service_label_designer_overwrite). All your templates and settings will be lost. Export your settings before deactivating if you want to preserve them.

License

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

How License Verification Works

  • The module periodically checks license validity at https://license.puqcloud.com/
  • Verification results are cached in the database for 5 days
  • If the license server is temporarily unreachable, the module uses the last cached result

Without an Active License

  • Dashboard (Home page) remains fully accessible
  • All other pages (Config, Designer) display a license required page
  • All AJAX controllers (except Dashboard) return a 403 error

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 Service Label Designer > 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

No Comments
Back to top