Enhance WHMCS integration with mTLS support and product mapping features. Added mTLS configuration options, updated API endpoints for mTLS status and fingerprint registration, and implemented product validation API. Updated database schema and documentation accordingly.

2026-06-30 13:17:12 +02:00
parent 4b20efe4bc
commit 316679a913
34 changed files with 1174 additions and 30 deletions
--- a/integrations/whmcs/lib/ProductMapping.php
+++ b/integrations/whmcs/lib/ProductMapping.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+use WHMCS\Database\Capsule;
+
+final class HexaGameCloudProductMapping
+{
+    public static function resolvePlanSlug(array $params, string $fallback = 'free'): string
+    {
+        $productId = (int) ($params['pid'] ?? 0);
+        if ($productId <= 0) {
+            return $params['configoption1'] ?: $fallback;
+        }
+
+        try {
+            $mapping = Capsule::table('mod_hexagamecloud_product_mappings')
+                ->where('whmcs_product_id', $productId)
+                ->where('is_active', 1)
+                ->first();
+
+            if ($mapping && !empty($mapping->plan_slug)) {
+                return (string) $mapping->plan_slug;
+            }
+        } catch (Throwable) {
+            // Mapping table may not exist before addon activation
+        }
+
+        return $params['configoption1'] ?: $fallback;
+    }
+
+    public static function resolveSoftwareFamily(array $params, string $fallback = 'VANILLA'): string
+    {
+        $productId = (int) ($params['pid'] ?? 0);
+        if ($productId <= 0) {
+            return $params['configoption3'] ?: $fallback;
+        }
+
+        try {
+            $mapping = Capsule::table('mod_hexagamecloud_product_mappings')
+                ->where('whmcs_product_id', $productId)
+                ->where('is_active', 1)
+                ->first();
+
+            if ($mapping && !empty($mapping->default_software)) {
+                return (string) $mapping->default_software;
+            }
+        } catch (Throwable) {
+        }
+
+        return $params['configoption3'] ?: $fallback;
+    }
+
+    public static function resolveMinecraftVersion(array $params, string $fallback = '1.21.1'): string
+    {
+        $productId = (int) ($params['pid'] ?? 0);
+        if ($productId <= 0) {
+            return $params['configoption2'] ?: $fallback;
+        }
+
+        try {
+            $mapping = Capsule::table('mod_hexagamecloud_product_mappings')
+                ->where('whmcs_product_id', $productId)
+                ->where('is_active', 1)
+                ->first();
+
+            if ($mapping && !empty($mapping->default_version)) {
+                return (string) $mapping->default_version;
+            }
+        } catch (Throwable) {
+        }
+
+        return $params['configoption2'] ?: $fallback;
+    }
+}