WHMCS Hook to Automatically Create cPanel Accounts

<?php
/**
 * WHMCS cPanel Account Creation Hook
 * File: includes/hooks/cpanel_auto_provision.php
 * 
 * Automatically creates cPanel accounts when hosting orders are activated
 * Supports multiple servers, packages, and custom configurations
 */

// Prevent direct access
if (!defined("WHMCS")) {
    die("This file cannot be accessed directly");
}

// Configuration - Update these with your server details
define('WHM_HOSTNAME', 'server1.yourhost.com');
define('WHM_USERNAME', 'root');
define('WHM_API_TOKEN', 'your_api_token_here');
define('WHM_PORT', 2087);
define('DEFAULT_NAMESERVERS', 'ns1.yourhost.com,ns2.yourhost.com');

/**
 * Hook: AfterModuleCreate
 * Triggers after a hosting product is successfully created
 */
add_hook('AfterModuleCreate', 1, function($vars) {
    try {
        // Only process cPanel/WHM products
        if ($vars['producttype'] != 'hostingaccount') {
            return;
        }
        
        // Get service details
        $serviceId = $vars['serviceid'];
        $service = getServiceDetails($serviceId);
        
        if (!$service) {
            logActivity("cPanel Hook: Could not retrieve service details for Service #$serviceId");
            return;
        }
        
        // Skip if account already exists
        if (!empty($service['username'])) {
            logActivity("cPanel Hook: Account already exists for Service #$serviceId");
            return;
        }
        
        // Create cPanel account
        $result = createCPanelAccount($service, $vars);
        
        if ($result['success']) {
            // Update service with account details
            updateServiceCredentials($serviceId, $result['credentials']);
            
            // Send welcome email
            sendWelcomeEmail($serviceId, $result['credentials']);
            
            logActivity("cPanel Hook: Successfully created account for Service #$serviceId - Username: " . $result['credentials']['username']);
        } else {
            logActivity("cPanel Hook: Failed to create account for Service #$serviceId - Error: " . $result['error']);
            
            // Optionally suspend service on failure
            // suspendService($serviceId, $result['error']);
        }
        
    } catch (Exception $e) {
        logActivity("cPanel Hook Error: " . $e->getMessage());
    }
});

/**
 * Get service details from WHMCS API
 */
function getServiceDetails($serviceId) {
    try {
        $result = localAPI('GetClientsProducts', [
            'serviceid' => $serviceId
        ]);
        
        if ($result['result'] == 'success' && !empty($result['products']['product'][0])) {
            return $result['products']['product'][0];
        }
    } catch (Exception $e) {
        logActivity("Error getting service details: " . $e->getMessage());
    }
    
    return null;
}

/**
 * Create cPanel account via WHM API
 */
function createCPanelAccount($service, $moduleVars) {
    try {
        // Generate account credentials
        $credentials = generateAccountCredentials($service);
        
        // Get package configuration
        $packageConfig = getPackageConfiguration($service['pid']);
        
        // Prepare WHM API parameters
        $params = [
            'username' => $credentials['username'],
            'password' => $credentials['password'],
            'domain' => $service['domain'],
            'plan' => $packageConfig['cpanel_package'],
            'email' => getClientEmail($service['userid']),
            'quota' => $packageConfig['disk_quota'],
            'hasshell' => 0,
            'cpmod' => 'paper_lantern',
            'maxftp' => $packageConfig['ftp_accounts'] ?: 'unlimited',
            'maxsql' => $packageConfig['mysql_databases'] ?: 'unlimited',
            'maxpop' => $packageConfig['email_accounts'] ?: 'unlimited',
            'maxlst' => $packageConfig['mailing_lists'] ?: 'unlimited',
            'maxsub' => $packageConfig['subdomains'] ?: 'unlimited',
            'maxpark' => $packageConfig['parked_domains'] ?: 'unlimited',
            'maxaddon' => $packageConfig['addon_domains'] ?: 'unlimited',
            'bwlimit' => $packageConfig['bandwidth_limit'] ?: 'unlimited',
            'ip' => 'n', // Use shared IP
            'cgi' => $packageConfig['cgi_access'] ? 1 : 0,
            'frontpage' => 0, // Deprecated
            'hasshell' => 0,
            'contactemail' => getClientEmail($service['userid']),
            'cpmod' => 'paper_lantern',
            'language' => 'en',
            'useregns' => 0,
            'hasuseregns' => 0,
            'reseller' => 0
        ];
        
        // Execute WHM API call
        $response = executeWHMAPI('createacct', $params);
        
        if ($response && isset($response['result']) && $response['result'][0]['status'] == 1) {
            return [
                'success' => true,
                'credentials' => $credentials,
                'response' => $response
            ];
        } else {
            $error = $response['result'][0]['statusmsg'] ?? 'Unknown error occurred';
            return [
                'success' => false,
                'error' => $error,
                'response' => $response
            ];
        }
        
    } catch (Exception $e) {
        return [
            'success' => false,
            'error' => $e->getMessage()
        ];
    }
}

/**
 * Generate secure account credentials
 */
function generateAccountCredentials($service) {
    // Generate username from domain (first 8 chars + random)
    $domain_part = preg_replace('/[^a-z0-9]/', '', strtolower($service['domain']));
    $username = substr($domain_part, 0, 6) . rand(10, 99);
    
    // Ensure username is unique and meets cPanel requirements
    $username = ensureValidUsername($username);
    
    // Generate strong password
    $password = generateStrongPassword();
    
    return [
        'username' => $username,
        'password' => $password,
        'domain' => $service['domain']
    ];
}

/**
 * Ensure username meets cPanel requirements and is unique
 */
function ensureValidUsername($username) {
    // cPanel username requirements
    $username = strtolower($username);
    $username = preg_replace('/[^a-z0-9]/', '', $username);
    
    // Length must be between 1-16 characters
    if (strlen($username) > 16) {
        $username = substr($username, 0, 16);
    }
    
    if (strlen($username) < 1) {
        $username = 'user' . rand(1000, 9999);
    }
    
    // Check if username already exists
    $attempt = 0;
    $original_username = $username;
    
    while (checkUsernameExists($username) && $attempt < 10) {
        $attempt++;
        $username = substr($original_username, 0, 14) . str_pad($attempt, 2, '0', STR_PAD_LEFT);
    }
    
    return $username;
}

/**
 * Check if username already exists on server
 */
function checkUsernameExists($username) {
    try {
        $response = executeWHMAPI('accountsummary', ['user' => $username]);
        return isset($response['data']['acct']) && !empty($response['data']['acct']);
    } catch (Exception $e) {
        return false; // Assume doesn't exist on error
    }
}

/**
 * Generate cryptographically secure password
 */
function generateStrongPassword($length = 16) {
    $characters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*';
    $password = '';
    
    for ($i = 0; $i < $length; $i++) {
        $password .= $characters[random_int(0, strlen($characters) - 1)];
    }
    
    return $password;
}

/**
 * Get package configuration for cPanel account
 */
function getPackageConfiguration($productId) {
    try {
        $result = localAPI('GetProducts', ['pid' => $productId]);
        
        if ($result['result'] == 'success' && !empty($result['products']['product'][0])) {
            $product = $result['products']['product'][0];
            
            // Map WHMCS product to cPanel package
            $config = [
                'cpanel_package' => $product['configoption1'] ?: 'default',
                'disk_quota' => $product['configoption2'] ?: 'unlimited',
                'bandwidth_limit' => $product['configoption3'] ?: 'unlimited',
                'email_accounts' => $product['configoption4'] ?: 'unlimited',
                'mysql_databases' => $product['configoption5'] ?: 'unlimited',
                'ftp_accounts' => $product['configoption6'] ?: 'unlimited',
                'subdomains' => $product['configoption7'] ?: 'unlimited',
                'parked_domains' => $product['configoption8'] ?: 'unlimited',
                'addon_domains' => $product['configoption9'] ?: 'unlimited',
                'mailing_lists' => $product['configoption10'] ?: 'unlimited',
                'cgi_access' => $product['configoption11'] == 'Yes',
            ];
            
            return $config;
        }
    } catch (Exception $e) {
        logActivity("Error getting package configuration: " . $e->getMessage());
    }
    
    // Return default configuration
    return [
        'cpanel_package' => 'default',
        'disk_quota' => 'unlimited',
        'bandwidth_limit' => 'unlimited',
        'email_accounts' => 'unlimited',
        'mysql_databases' => 'unlimited',
        'ftp_accounts' => 'unlimited',
        'subdomains' => 'unlimited',
        'parked_domains' => 'unlimited',
        'addon_domains' => 'unlimited',
        'mailing_lists' => 'unlimited',
        'cgi_access' => true
    ];
}

/**
 * Get client email address
 */
function getClientEmail($clientId) {
    try {
        $result = localAPI('GetClientsDetails', ['clientid' => $clientId]);
        
        if ($result['result'] == 'success') {
            return $result['email'];
        }
    } catch (Exception $e) {
        logActivity("Error getting client email: " . $e->getMessage());
    }
    
    return 'noreply@' . $_SERVER['SERVER_NAME'];
}

/**
 * Execute WHM API call
 */
function executeWHMAPI($function, $params = []) {
    $url = "https://" . WHM_HOSTNAME . ":" . WHM_PORT . "/json-api/" . $function;
    
    // Build query string
    $query = http_build_query($params);
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url . '?' . $query);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // For self-signed certificates
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($ch, CURLOPT_TIMEOUT, 60);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30);
    
    // Authentication headers
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: whm ' . WHM_USERNAME . ':' . WHM_API_TOKEN,
        'Content-Type: application/x-www-form-urlencoded'
    ]);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);
    
    if ($error) {
        throw new Exception("cURL Error: " . $error);
    }
    
    if ($httpCode !== 200) {
        throw new Exception("HTTP Error: " . $httpCode);
    }
    
    $decoded = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new Exception("JSON Decode Error: " . json_last_error_msg());
    }
    
    return $decoded;
}

/**
 * Update service with account credentials
 */
function updateServiceCredentials($serviceId, $credentials) {
    try {
        localAPI('UpdateClientProduct', [
            'serviceid' => $serviceId,
            'username' => $credentials['username'],
            'password' => $credentials['password'],
            'domain' => $credentials['domain']
        ]);
        
        // Also update the hosting table
        $pdo = \WHMCS\Database\Capsule::connection()->getPdo();
        $stmt = $pdo->prepare("
            UPDATE tblhosting 
            SET username = ?, password = ?, domain = ?
            WHERE id = ?
        ");
        
        $stmt->execute([
            $credentials['username'],
            encrypt($credentials['password']),
            $credentials['domain'],
            $serviceId
        ]);
        
    } catch (Exception $e) {
        logActivity("Error updating service credentials: " . $e->getMessage());
    }
}

/**
 * Send welcome email with account details
 */
function sendWelcomeEmail($serviceId, $credentials) {
    try {
        // Get service and client details
        $service = getServiceDetails($serviceId);
        $client = localAPI('GetClientsDetails', ['clientid' => $service['userid']]);
        
        if ($client['result'] != 'success') {
            return;
        }
        
        // Prepare email content
        $subject = "Your hosting account is ready!";
        $message = "
        <h2>Welcome to your new hosting account!</h2>
        
        <p>Dear {$client['firstname']},</p>
        
        <p>Your hosting account has been successfully created and is ready to use.</p>
        
        <h3>Account Details:</h3>
        <ul>
            <li><strong>Domain:</strong> {$credentials['domain']}</li>
            <li><strong>Username:</strong> {$credentials['username']}</li>
            <li><strong>Password:</strong> {$credentials['password']}</li>
        </ul>
        
        <h3>Control Panel Access:</h3>
        <ul>
            <li><strong>cPanel URL:</strong> https://{$credentials['domain']}:2083</li>
            <li><strong>Alternative URL:</strong> https://" . WHM_HOSTNAME . ":2083</li>
        </ul>
        
        <h3>FTP Details:</h3>
        <ul>
            <li><strong>FTP Server:</strong> {$credentials['domain']}</li>
            <li><strong>Username:</strong> {$credentials['username']}</li>
            <li><strong>Password:</strong> {$credentials['password']}</li>
            <li><strong>Port:</strong> 21 (or 22 for SFTP)</li>
        </ul>
        
        <h3>Name Servers:</h3>
        <ul>
            <li><strong>Primary:</strong> ns1.yourhost.com</li>
            <li><strong>Secondary:</strong> ns2.yourhost.com</li>
        </ul>
        
        <p>If you need any assistance, please don't hesitate to contact our support team.</p>
        
        <p>Best regards,<br>Your Hosting Team</p>
        ";
        
        // Send email using WHMCS email system
        sendMessage('Hosting Account Created', $message, $service['userid']);
        
    } catch (Exception $e) {
        logActivity("Error sending welcome email: " . $e->getMessage());
    }
}

?>

<?php
/**
 * Enhanced error handling and retry mechanisms
 */

/**
 * Create cPanel account with retry logic
 */
function createCPanelAccountWithRetry($service, $moduleVars, $maxRetries = 3) {
    $attempt = 0;
    $lastError = '';
    
    while ($attempt < $maxRetries) {
        $attempt++;
        
        try {
            $result = createCPanelAccount($service, $moduleVars);
            
            if ($result['success']) {
                return $result;
            }
            
            $lastError = $result['error'];
            
            // Check if error is retryable
            if (!isRetryableError($lastError)) {
                break;
            }
            
            // Wait before retry (exponential backoff)
            sleep(pow(2, $attempt));
            
            logActivity("cPanel Hook: Retry attempt $attempt for Service #{$service['id']} - Error: $lastError");
            
        } catch (Exception $e) {
            $lastError = $e->getMessage();
            logActivity("cPanel Hook: Exception on attempt $attempt for Service #{$service['id']}: $lastError");
            
            if ($attempt < $maxRetries) {
                sleep(pow(2, $attempt));
            }
        }
    }
    
    // All attempts failed
    return [
        'success' => false,
        'error' => $lastError,
        'attempts' => $attempt
    ];
}

/**
 * Check if error is retryable
 */
function isRetryableError($error) {
    $retryableErrors = [
        'connection timeout',
        'connection refused',
        'temporary failure',
        'server overloaded',
        'quota exceeded temporarily',
        'dns lookup failed',
        'network unreachable'
    ];
    
    $errorLower = strtolower($error);
    
    foreach ($retryableErrors as $retryableError) {
        if (strpos($errorLower, $retryableError) !== false) {
            return true;
        }
    }
    
    return false;
}

/**
 * Validate account creation prerequisites
 */
function validateAccountCreation($service) {
    $errors = [];
    
    // Check domain validity
    if (empty($service['domain']) || !filter_var($service['domain'], FILTER_VALIDATE_DOMAIN)) {
        $errors[] = "Invalid domain name: " . $service['domain'];
    }
    
    // Check if domain already exists on server
    if (checkDomainExists($service['domain'])) {
        $errors[] = "Domain already exists on server: " . $service['domain'];
    }
    
    // Check server connectivity
    if (!testWHMConnection()) {
        $errors[] = "Cannot connect to WHM server";
    }
    
    // Check available disk space on server
    $diskUsage = getServerDiskUsage();
    if ($diskUsage && $diskUsage > 90) {
        $errors[] = "Server disk usage too high: {$diskUsage}%";
    }
    
    return $errors;
}

/**
 * Check if domain already exists on server
 */
function checkDomainExists($domain) {
    try {
        $response = executeWHMAPI('domainuserdata', ['domain' => $domain]);
        return isset($response['data']['userdata']) && !empty($response['data']['userdata']);
    } catch (Exception $e) {
        return false; // Assume doesn't exist on error
    }
}

/**
 * Test WHM server connection
 */
function testWHMConnection() {
    try {
        $response = executeWHMAPI('version');
        return isset($response['version']);
    } catch (Exception $e) {
        return false;
    }
}

/**
 * Get server disk usage percentage
 */
function getServerDiskUsage() {
    try {
        $response = executeWHMAPI('systemloadavg');
        if (isset($response['data']['one'])) {
            // Parse disk usage from system info
            $diskInfo = executeWHMAPI('getdiskusage');
            if (isset($diskInfo['data'][0]['percent'])) {
                return (int) $diskInfo['data'][0]['percent'];
            }
        }
    } catch (Exception $e) {
        logActivity("Error getting server disk usage: " . $e->getMessage());
    }
    
    return null;
}

/**
 * Enhanced hook with comprehensive error handling
 */
add_hook('AfterModuleCreate', 1, function($vars) {
    try {
        // Only process cPanel/WHM products
        if ($vars['producttype'] != 'hostingaccount') {
            return;
        }
        
        $serviceId = $vars['serviceid'];
        $service = getServiceDetails($serviceId);
        
        if (!$service) {
            logActivity("cPanel Hook: Could not retrieve service details for Service #$serviceId");
            return;
        }
        
        // Skip if account already exists
        if (!empty($service['username'])) {
            logActivity("cPanel Hook: Account already exists for Service #$serviceId");
            return;
        }
        
        // Validate prerequisites
        $validationErrors = validateAccountCreation($service);
        if (!empty($validationErrors)) {
            $errorMsg = implode('; ', $validationErrors);
            logActivity("cPanel Hook: Validation failed for Service #$serviceId - " . $errorMsg);
            
            // Suspend service due to validation failure
            suspendService($serviceId, $errorMsg);
            return;
        }
        
        // Create account with retry logic
        $result = createCPanelAccountWithRetry($service, $vars);
        
        if ($result['success']) {
            // Update service credentials
            updateServiceCredentials($serviceId, $result['credentials']);
            
            // Send welcome email
            sendWelcomeEmail($serviceId, $result['credentials']);
            
            // Log success
            logActivity("cPanel Hook: Successfully created account for Service #$serviceId - Username: " . $result['credentials']['username']);
            
            // Send success notification to admin
            sendAdminNotification($serviceId, $result['credentials'], 'success');
            
        } else {
            // Log failure
            $errorMsg = $result['error'] . " (Attempts: " . ($result['attempts'] ?? 1) . ")";
            logActivity("cPanel Hook: Failed to create account for Service #$serviceId - Error: " . $errorMsg);
            
            // Suspend service on failure
            suspendService($serviceId, $result['error']);
            
            // Send failure notification to admin
            sendAdminNotification($serviceId, null, 'failed', $result['error']);
        }
        
    } catch (Exception $e) {
        logActivity("cPanel Hook Critical Error: " . $e->getMessage());
        
        // Send critical error notification
        $subject = "CRITICAL: cPanel Hook Error";
        $message = "A critical error occurred in the cPanel auto-provisioning hook:\n\n";
        $message .= "Service ID: " . ($serviceId ?? 'Unknown') . "\n";
        $message .= "Error: " . $e->getMessage() . "\n";
        $message .= "Trace: " . $e->getTraceAsString() . "\n\n";
        $message .= "Please investigate immediately.";
        
        sendAdminEmail($subject, $message);
    }
});

/**
 * Suspend service with reason
 */
function suspendService($serviceId, $reason) {
    try {
        localAPI('ModuleSuspend', ['serviceid' => $serviceId]);
        
        // Add admin note
        localAPI('UpdateClientProduct', [
            'serviceid' => $serviceId,
            'notes' => "Auto-suspended due to provisioning failure: " . $reason
        ]);
        
        logActivity("Service #$serviceId suspended due to: " . $reason);
        
    } catch (Exception $e) {
        logActivity("Error suspending service #$serviceId: " . $e->getMessage());
    }
}

/**
 * Send admin notifications
 */
function sendAdminNotification($serviceId, $credentials, $status, $error = null) {
    try {
        $subject = "cPanel Account " . ucfirst($status) . " - Service #$serviceId";
        
        if ($status === 'success') {
            $message = "cPanel account successfully created:\n\n";
            $message .= "Service ID: $serviceId\n";
            $message .= "Username: " . $credentials['username'] . "\n";
            $message .= "Domain: " . $credentials['domain'] . "\n";
            $message .= "Time: " . date('Y-m-d H:i:s') . "\n";
        } else {
            $message = "cPanel account creation failed:\n\n";
            $message .= "Service ID: $serviceId\n";
            $message .= "Error: $error\n";
            $message .= "Time: " . date('Y-m-d H:i:s') . "\n";
            $message .= "\nPlease investigate and create account manually if needed.";
        }
        
        sendAdminEmail($subject, $message);
        
    } catch (Exception $e) {
        logActivity("Error sending admin notification: " . $e->getMessage());
    }
}

/**
 * Send email to admin
 */
function sendAdminEmail($subject, $message) {
    $adminEmail = \WHMCS\Config\Setting::getValue('Email');
    if ($adminEmail) {
        mail($adminEmail, $subject, $message);
    }
}
?>

# WHMCS Product Configuration Options
# Configure these in Setup → Products/Services → Edit Product → Custom Fields

Option 1: cPanel Package Name (default)
Option 2: Disk Quota in MB (unlimited)
Option 3: Bandwidth Limit in MB (unlimited)  
Option 4: Email Accounts (unlimited)
Option 5: MySQL Databases (unlimited)
Option 6: FTP Accounts (unlimited)
Option 7: Subdomains (unlimited)
Option 8: Parked Domains (unlimited)
Option 9: Addon Domains (unlimited)
Option 10: Mailing Lists (unlimited)
Option 11: CGI Access (Yes/No)

# Example configuration for a basic hosting package:
cPanel Package: basic_hosting
Disk Quota: 5000 (5GB)
Bandwidth: 50000 (50GB)
Email Accounts: 25
MySQL Databases: 5
FTP Accounts: 5
Subdomains: 10
Parked Domains: 2
Addon Domains: 1
Mailing Lists: 2
CGI Access: Yes

<?php
/**
 * Testing and debugging utilities
 */

/**
 * Test hook functionality
 * File: test_cpanel_hook.php (place in WHMCS root)
 */

require_once 'init.php';
require_once 'includes/hooks/cpanel_auto_provision.php';

// Test configuration
echo "=== cPanel Hook Test Suite ===\n\n";

// Test 1: WHM Connection
echo "1. Testing WHM Connection...\n";
if (testWHMConnection()) {
    echo " WHM connection successful\n";
} else {
    echo "✗ WHM connection failed\n";
    exit(1);
}

// Test 2: Username generation
echo "\n2. Testing username generation...\n";
$testService = ['domain' => 'example.com'];
$credentials = generateAccountCredentials($testService);
echo "Generated username: " . $credentials['username'] . "\n";
echo "Generated password: " . $credentials['password'] . "\n";

// Test 3: Username uniqueness
echo "\n3. Testing username uniqueness...\n";
$exists = checkUsernameExists($credentials['username']);
echo "Username exists on server: " . ($exists ? 'Yes' : 'No') . "\n";

// Test 4: Domain validation
echo "\n4. Testing domain validation...\n";
$testDomains = ['example.com', 'invalid-domain', 'test.example.com'];
foreach ($testDomains as $domain) {
    $isValid = filter_var($domain, FILTER_VALIDATE_DOMAIN);
    echo "Domain '$domain': " . ($isValid ? 'Valid' : 'Invalid') . "\n";
}

// Test 5: Package configuration
echo "\n5. Testing package configuration...\n";
$config = getPackageConfiguration(1); // Test with product ID 1
print_r($config);

// Test 6: Server resources
echo "\n6. Testing server resources...\n";
$diskUsage = getServerDiskUsage();
if ($diskUsage !== null) {
    echo "Server disk usage: {$diskUsage}%\n";
} else {
    echo "Could not retrieve disk usage\n";
}

echo "\n=== Test completed ===\n";

/**
 * Debug mode for hook
 */
function debugLog($message, $data = null) {
    if (defined('CPANEL_HOOK_DEBUG') && CPANEL_HOOK_DEBUG) {
        $logEntry = date('Y-m-d H:i:s') . " - DEBUG: " . $message;
        if ($data) {
            $logEntry .= "\nData: " . print_r($data, true);
        }
        file_put_contents('/tmp/cpanel_hook_debug.log', $logEntry . "\n", FILE_APPEND);
    }
}

/**
 * Enhanced logging with debug info
 */
function enhancedLogActivity($message, $data = null) {
    logActivity($message);
    debugLog($message, $data);
}

// Usage in hook:
// define('CPANEL_HOOK_DEBUG', true); // Enable debug mode
// enhancedLogActivity("Creating account", $credentials);
?>