A WHMCS module for seamless integration with KeyHelp control panel. This module allows you to automate hosting account provisioning, management, and billing for KeyHelp-based services directly from WHMCS.

Features

Account Management

• Create Accounts: Automatically create hosting accounts in KeyHelp when a product is ordered in WHMCS.
• Suspend/Unsuspend Accounts: Suspend or unsuspend accounts directly from WHMCS.
• Terminate Accounts: Remove accounts from KeyMHelp when terminated in WHMCS.
• Change Password: Update client passwords in KeyHelp from WHMCS.
• Change Package: Upgrade/downgrade hosting plans in KeyHelp.

Single Sign-On (SSO)

• Client SSO: Allow clients to log in to their KeyHelp panel directly from the WHMCS client area.
• Admin SSO: Admins can log in to the KeyHelp admin panel from WHMCS.

Automation & Sync

• Daily Sync: Automatically sync usage statistics (disk, bandwidth, domains, etc.) from KeyHelp to WHMCS.
• Usage Updates: Update resource usage in WHMCS based on real-time KeyHelp data.
• Client Data Sync: Sync client contact details between WHMCS and KeyHelp.

Client Area Features

• Resource Overview: Display disk usage, bandwidth, domains, email accounts, databases, and FTP users.
• Domain Management: View domains (including SSL status and domain status) in the client area.
• Email Management: List email accounts, usage, and aliases.
• Database Management: View database names, usernames, and sizes.
• FTP Management: List FTP users and their home directories.

Admin Features

• List Accounts: View all KeyHelp accounts in the WHMCS admin area.
• Custom Buttons: Add custom buttons for quick actions (e.g., "Sync Account").
• Admin Services Tab: Display KeyHelp account status, creation date, and resource usage.

Hooks

• Client Edit Hook: Sync client details in KeyHelp when edited in WHMCS.
• After Module Create Hook: Sync resource usage after account creation.
• Welcome Email Hook: Send welcome emails with login credentials.
• Password Change Hook: Log password changes.
• Termination Hook: Log account terminations.

Customization

• Username Generation: Customize how usernames are generated.
• Hosting Plan Loader: Dynamically load hosting plans from KeyHelp.
• Override Functions: Extend or override default behavior with custom functions.

Requirements

• WHMCS: 8.0 or later
• KeyHelp: API v2 access
• PHP: 7.4 or later
• cURL: Enabled

Installation

1. Upload Files: Upload the module files to /modules/servers/keyhelp/ in your WHMCS installation.
2. Configure Server:
   • Go to Setup > Products/Services > Servers in WHMCS.
   • Add a new server with type KeyHelp.
   • Enter your KeyHelp server details (hostname, API key, port, etc.).
3. Configure Products:
   • Create a product in WHMCS and assign it to the KeyHelp server.
   • Set the module name to keyhelp.
   • Configure the product options (hosting plan, language, etc.).
4. Enable Hooks: Ensure all hooks are enabled in WHMCS.

Configuration

Module Settings

• Hosting Plan: Select the KeyHelp hosting plan.
• Default Language: Set the default language for the KeyHelp panel.
• Create System Domain: Automatically create a system domain.
• Send Login Credentials: Email login credentials to the client.

Custom Functions

• Override username generation, client data, or domain data by uncommenting and modifying the provided functions in the module.