Netlen Cloud WHMCS Module

Professional WHMCS integration for comprehensive server management and account management

Overview

The Netlen Cloud WHMCS Module enables you to manage cloud servers through WHMCS using the Netlen Cloud API. The module consists of two main components:

Server Module

Comprehensive module for server creation, management, and customer panel functions.

  • Automatic server setup
  • Power management
  • rDNS management
  • Modern customer interface

Addon Module

Addon module for account management, server list, and more.

  • Balance viewing
  • Server list
  • Package information
  • Ticket management
Note: This module is compatible with Netlen Cloud API v1.0.7.

Features

🖥️ Server Module Features

Server Operations

Server Creation

Automatic server setup with plan, location, and OS selection. Flexible configuration with Configurable Options support.

Suspend/Unsuspend

Easily manage server status. Full control with Suspend and Unsuspend operations.

Server Deletion

Clean up server and related resources (IPs, rDNS records).

Package Upgrade

Upgrade server package and increase resources.

Power Management

Start/Stop/Restart

Modern buttons and confirmation modals for server power control.

Status Tracking

Real-time server status viewing and status badges.

Server Management

Reinstallation

Operating system reinstallation. Modal interface with OS selection from configurable options.

Password Reset

Automatic secure password generation and display in modal.

Extra IP Purchase

Purchase IPv4 and IPv6 extra IP addresses. Easy management with separate buttons.

rDNS Management

Set reverse DNS for IPv4 and IPv6 addresses. View and update existing rDNS.

Customer Panel Features

Resource Usage Cards

Modern cards displaying CPU, RAM, Storage, Upload, Download, and Bandwidth usage information.

Modern UI

Card-based modern interface design. Professional appearance with white background and shadow effects.

Username/Password

Display information retrieved from WHMCS. Secure access with password show/hide feature.

SVG OS Icons

Dynamic SVG icon display based on OS name. Ubuntu, CentOS, Windows, and more.

📦 Addon Module Features

Dashboard

Balance Card

Gradient card displaying current balance. Modern design in blue tones.

Active Server Count

Card displaying active server count. Count based on service status.

Support Tickets

Card displaying open ticket count. For quick access.

Reseller Status

Reseller status and discount information. Tier and discount rate display.

Tabs

Overview

Overview and server list. Displayed on initial load.

Servers

List of all servers. Status, IP, plan, and price information.

Packages

Available packages and prices. Includes reseller discounted prices.

Locations

Location list. Active/inactive status information.

Operating Systems

Operating system list. With version information.

Support Tickets

Ticket list and reply. Message viewing in modal.

Setup

Create Configurable Options. OS and Location options.

Special Features

Lazy Loading

Tab-based data loading for performance. Only clicked tab is loaded.

Version Check

Automatic version checking and update notification. Modern alerts with SweetAlert2.

Existing Options Check

Check for existing configurable options in Setup tab and inform user.

Multi-Language

Turkish and English language support. Automatic selection based on WHMCS admin language preference.

Server Module

Installation

  1. Copy the modules/servers/netlencloud/ folder to your WHMCS modules/servers/ directory
  2. Go to Setup → Products/Services → Servers in WHMCS admin panel
  3. Click Add New Server button
  4. Select Netlen Cloud as Module
  5. Enter your API information:
    • API Key: API key obtained from your Netlen Cloud panel
    • API URL: Your API URL (default: https://api.netlen.com/v1)
  6. Click Test Connection button to test the connection

Product Configuration

  1. Go to Setup → Products/Services → Products/Services menu
  2. Create a new product or edit an existing one
  3. Select Netlen Cloud as Module
  4. In Module Settings section:
    • Select the server you created above as Server
    • You can enter Plan ID, Location ID, OS Version ID values (optional)
  5. Create OS and Location options in Configurable Options section (can be created automatically from Setup tab)

Custom Fields

The module automatically creates a custom field named server_id and saves the server ID to this field when a server is created. This ensures the correct server ID is used in API requests.

Important: After server creation, "root" or "Administrator" is saved to the username field based on OS. A secure password is saved to the password field.

Addon Module

Installation

  1. Copy the modules/addons/netlencloud/ folder to your WHMCS modules/addons/ directory
  2. Go to Setup → Addon Modules in WHMCS admin panel
  3. Find Netlen Cloud module and click Activate button
  4. Click Configure button and enter your API information:
    • API Key: API key obtained from your Netlen Cloud panel
    • API URL: Your API URL (default: https://api.netlen.com/v1)
  5. Click Save Changes button

Usage

After the addon module is activated:

  • Admin Panel: You can access it from Setup → Addon Modules → Netlen Cloud menu
  • Customer Panel: Customers can also access it from the same menu (if permitted)

Setup Tab

You can create Configurable Options in the Setup tab:

  1. Add OS values (format: ID|Name, e.g.: 1|Ubuntu 18.04 LTS)
  2. Add Location values (format: ID|Name, e.g.: 1|Turkey)
  3. You can add a ready OS list with the Add All OS button
  4. Click Create Configurable Options button
Warning: If configurable options already exist, existing values will be deleted and new ones will be added when recreated.

Installation

Requirements

  • WHMCS 8.x
  • PHP 8.1 or higher
  • ionCube Loader 13 or higher
  • cURL support
  • Netlen Cloud API key

Step-by-Step Installation

1. Extract Files

The module zip file is prepared to be extracted directly into WHMCS root directory. Extract the zip file to your WHMCS root directory:

# Navigate to WHMCS root directory
cd /path/to/whmcs/

# Extract the zip file
unzip netlencloud-whmcs-module.zip

Alternative: After uploading the zip file via FTP, you can extract it from your hosting control panel (cPanel, Plesk, etc.).

The zip file already contains the correct folder structure:

  • modules/addons/netlencloud/ - Addon module
  • modules/servers/netlencloud/ - Server module
  • assets/img/servers/ - Required images for OS icons

When you extract the zip file, all files will automatically be placed in the correct locations.

2. Get API Key

  1. Log in to Netlen Cloud panel
  2. Go to Reseller → API menu
  3. Create a new API key
  4. Add at least one IP address (your WHMCS server's IP address)
  5. Copy the API key

3. Activate Module

Activate both modules from WHMCS admin panel and enter your API information.

Success: After installation is complete, use the Test Connection button to test the connection.

Usage

Customer Panel

Customers can perform the following operations on the service detail page:

  • Server Information: View CPU, RAM, Storage, Bandwidth usage information
  • IP Management: View IP addresses and set rDNS
  • Power Management: Start/stop/restart server
  • Reinstallation: Operating system reinstallation (OS selection with modal)
  • Password Reset: Automatic secure password generation and display
  • Extra IP Purchase: Purchase IPv4 and IPv6 extra IP addresses

Admin Panel

In admin panel:

  • Server Status: Real-time server status viewing
  • Custom Buttons: Start, Stop, Restart, Reinstall, Password Reset buttons
  • Service Tab: Detailed server information and management options
  • Configurable Options: Create OS and Location options from Setup tab

Addon Module

With addon module:

  • Dashboard: View balance, active server count, and ticket count
  • Server List: View and manage all servers
  • Package Information: View available packages and prices
  • Locations: View available locations
  • Operating Systems: View available OSes and versions
  • Support Tickets: Ticket list and reply
  • Setup: Create and manage Configurable Options

API Endpoints

The module uses the following API endpoints:

Account and Balance

GET /balance
Balance information
GET /reseller
Reseller status and discount information

Server Management

GET /servers
Server list
GET /servers/{server_id}
Server details
POST /servers
Create server
DELETE /servers/{server_id}
Delete server

Power Management

POST /servers/{server_id}/start
Start server
POST /servers/{server_id}/stop
Stop server
POST /servers/{server_id}/restart
Restart server

Server Operations

POST /servers/{server_id}/reinstall
Reinstallation
POST /servers/{server_id}/password-reset
Password reset
POST /servers/{server_id}/upgrade
Package upgrade

IP Management

POST /servers/{server_id}/ips/purchase
Purchase extra IP
POST /servers/{server_id}/ips/{ip_address}
Set rDNS
GET /servers/{server_id}/ips/{ip_address}/rdns
Get rDNS information
DELETE /servers/{server_id}/ips/{ip_address}
Cancel extra IP

Information Endpoints

GET /packages
Package list
GET /locations
Location list
GET /operating-systems
Operating system list
GET /tickets
Ticket list
GET /tickets/{ticket_number}
Ticket details
POST /tickets/{ticket_number}/reply
Reply to ticket
GET /version-check
Version check

Security and Validation

Password Policy

The module checks for the following password requirements:

  • Minimum 8 characters
  • At least one uppercase letter (A-Z)
  • At least one lowercase letter (a-z)
  • At least one digit (0-9)
  • At least one symbol (!@#$%^&*-)
  • Only allowed characters: letters, digits, and !@#$%^&*- symbols

Automatic Secure Password Generation

If the password entered by the user does not meet the requirements or is empty, the module automatically generates a 9-character secure password. This password meets all requirements and characters are shuffled randomly.

API Key Security

  • API keys are stored securely in WHMCS database
  • API keys are never displayed in the frontend
  • Access is restricted to authorized IPs only with IP whitelist check

Username Based on OS

When a server is created, username is automatically assigned based on operating system:

  • Windows OSes: Administrator
  • Other OSes: root

This information is saved to WHMCS's username field and displayed in the customer panel.

Troubleshooting

Common Issues and Solutions

"API Key cannot be empty" Error

Solution: Make sure the API Key is entered correctly in server module settings. Check that the API Key field is not empty.

"IP address not whitelisted" Error

Solution: Add your WHMCS server's IP address for your API key in Netlen Cloud panel. You can add IP from Reseller → API menu.

"Insufficient balance" Error

Solution: The customer's Netlen Cloud account must have sufficient balance. Balance check is performed before server creation.

"Package not found" Error

Solution: Make sure the Plan ID is correct. Check that the Plan is active.

"Location not found" Error

Solution: Make sure the Location ID is correct. Check that the Location is active.

"OS Version not found" Error

Solution: Make sure the OS Version ID is correct. Check that the OS Version is active.

Configurable Options Creation Error

Solution: Make sure the database structure is correct. Check that WHMCS Database Capsule class is available.

CORS Error

Solution: AJAX requests in addon module are made through the module's own proxy. This resolves CORS issues.

Support

You can contact us for questions and support requests:

Email

support@netlen.com

Website

https://www.netlen.com

API Documentation

API Documentation

API Panel

API Management Panel

Version Information: This documentation is prepared for Netlen Cloud WHMCS Module v1.0.1. The module is compatible with Netlen Cloud API v1.0.7.
Netlen Cloud

Comprehensive WHMCS integration for professional cloud server management

Version 1.0.1 | Netlen Cloud API v1.0.7

© 2012-2026 Netlen. All rights reserved.