kevin/KeyHelp-Manager-for-WHMCS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

.

Browse Source
This commit is contained in:
Kevin Feiler
2025-10-16 02:35:20 +02:00
parent 8259ec4621
commit cbb20ba6ce
8 changed files with 1462 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files

106
CHANGELOG.md
View File

@@ -9,9 +9,7 @@ und dieses Projekt folgt [Semantic Versioning](https://semver.org/lang/de/).
### Geplant
- Multi-Language Support (Deutsch/Englisch)
- Erweiterte Statistiken im Client Area
- Automatische Backup-Verwaltung
- SSL-Zertifikat-Management über Let's Encrypt
- E-Mail-Account-Verwaltung im Client Area
- Datenbank-Verwaltung im Client Area
- FTP-Account-Management
@@ -19,6 +17,107 @@ und dieses Projekt folgt [Semantic Versioning](https://semver.org/lang/de/).
- Ressourcen-Upgrade/Downgrade-Funktionen
- Webhook-Support für Events
## [2.0.0] - 2024-01-20
### 🎉 Wichtige Änderungen
- **Zentralisierte API-Konfiguration:** API-Keys und Server-Einstellungen werden jetzt nur einmal in den WHMCS Server-Einstellungen konfiguriert, nicht mehr pro Produkt
- **Template/Vorlagen-System:** Automatische Synchronisation von KeyHelp-Plänen/Vorlagen als Dropdown-Auswahl
- **Template-basierte Provisionierung:** Domains werden automatisch mit der ausgewählten Vorlage erstellt
### Hinzugefügt
- **Template-Verwaltung:**
- Automatisches Laden von KeyHelp-Plänen/Vorlagen via API
- Dropdown-Auswahl bei Produktkonfiguration
- Template-Cache für bessere Performance (5 Minuten)
- "Sync Templates" Button im Admin-Bereich
- Template-Name wird im Client Area angezeigt
- **Verbesserte Client Area:**
- Anzeige des verwendeten Templates/Plans
- Direkter Link zum Admin-Panel für die Domain
- Template-Badge in der Produktübersicht
- Übersichtlichere Button-Anordnung
- Admin-Panel-Button für direkte Verwaltung
- **Zentrale Server-Konfiguration:**
- API-Key wird nur einmal in WHMCS Server-Einstellungen eingegeben
- Hostname/IP in Server-Einstellungen (nicht mehr pro Produkt)
- SSL-Einstellungen über WHMCS Server-Verwaltung
- Vereinfachte Produktkonfiguration (nur Template-Auswahl)
- **Template-basierte Erstellung:**
- Domain wird automatisch mit ausgewählter Vorlage erstellt
- Template-ID wird in Account-Details gespeichert
- Template-Informationen werden bei Erstellung verwendet
- Automatische Zuordnung von Plan-Ressourcen
- **Neue API-Funktionen:**
- `_keyhelpmanager_GetTemplates()` - Lädt verfügbare Templates
- `keyhelpmanager_TemplateLoader()` - Dropdown-Loader für Templates
- `keyhelpmanager_SyncTemplates()` - Synchronisiert Templates manuell
- `keyhelpmanager_AdminCustomButtonArray()` - Admin-Buttons
- **Erweiterte Account-Speicherung:**
- Domain-ID wird jetzt gespeichert
- Template-ID wird in Account-Details hinterlegt
- Bessere Verknüpfung zwischen WHMCS und KeyHelp
### Geändert
- **API-Request-Funktion überarbeitet:**
- Verwendet jetzt WHMCS Server-Parameter statt Config-Optionen
- `serverhostname` statt `configoption1`
- `serveraccesshash` statt `configoption2`
- `serversecure` statt `configoption3`
- Bessere Fehlermeldungen bei fehlender Konfiguration
- **ConfigOptions vereinfacht:**
- Nur noch Template-Dropdown statt 4 Konfigurationsoptionen
- Hostname, API-Key, SSL nicht mehr pro Produkt nötig
- Einfachere Produktverwaltung
- **CreateAccount verbessert:**
- Verwendet Template-ID aus Produktkonfiguration
- Übergibt Template bei Domain-Erstellung
- Speichert zusätzliche Metadaten (Domain-ID, Template)
- **ClientArea erweitert:**
- Zeigt Template-Namen und Admin-Panel-Link
- Lädt Template-Details von API
- Direkter Link zur Domain-Verwaltung im Panel
### Behoben
- Redundante API-Key-Eingabe pro Produkt entfernt
- SSL-Konfiguration vereinheitlicht
- Template-Auswahl jetzt dynamisch statt statisch
- Panel-URL-Generierung korrigiert
### Sicherheit
- SSL-Verifizierung standardmäßig aktiviert
- Zentrale API-Key-Verwaltung reduziert Sicherheitsrisiken
- Weniger Stellen für sensible Daten in der Konfiguration
### Technische Details
- **Neue API-Endpunkte:**
- `GET /api/v2/plans` - Lädt verfügbare Pläne/Templates
- `GET /api/v2/plans/{id}` - Lädt Template-Details
- **Neue Datenbankfelder:**
- `domainid` in Account-Details
- `template` in Account-Details
- Template-Cache in `tblconfiguration`
### Migration von 1.x
1. Konfigurieren Sie Ihre KeyHelp-Server in WHMCS unter Setup > Products/Services > Servers
2. Tragen Sie Hostname und API-Key dort ein (statt in jedem Produkt)
3. Wählen Sie bei jedem Produkt den entsprechenden Server aus
4. Verwenden Sie "Sync Templates" um verfügbare Vorlagen zu laden
5. Wählen Sie für jedes Produkt die passende Vorlage aus
### Bekannte Einschränkungen
- Template-Cache läuft nach 5 Minuten ab (nicht konfigurierbar)
- Manuelle Template-Synchronisation erforderlich bei Änderungen in KeyHelp
- Admin-Panel-Link funktioniert nur mit Standard-KeyHelp-URL-Struktur
## [1.0.0] - 2024-01-15
### Entwickelt von
@@ -210,7 +309,8 @@ Contributions sind willkommen! Bitte erstellen Sie einen Pull Request mit:
---
[Unreleased]: https://github.com/ihr-repo/keyhelpmanager/compare/v1.0.0...HEAD
[Unreleased]: https://github.com/ihr-repo/keyhelpmanager/compare/v2.0.0...HEAD
[2.0.0]: https://github.com/ihr-repo/keyhelpmanager/compare/v1.0.0...v2.0.0
[1.0.0]: https://github.com/ihr-repo/keyhelpmanager/releases/tag/v1.0.0
[0.9.0-beta]: https://github.com/ihr-repo/keyhelpmanager/releases/tag/v0.9.0-beta
[0.5.0-alpha]: https://github.com/ihr-repo/keyhelpmanager/releases/tag/v0.5.0-alpha

316
QUICKSTART.md Normal file
View File

@@ -0,0 +1,316 @@
# KeyHelp Manager v2.0 - Schnellstart-Anleitung
Dieses Dokument beschreibt die schnellste Methode, um KeyHelp Manager v2.0 in WHMCS zu konfigurieren.
⏱️ **Geschätzte Zeit:** 10 Minuten
---
## 🚀 In 5 Schritten zum fertigen Setup
### Schritt 1: Module hochladen (2 Min.)
```bash
# Entpacke das Modul in dein WHMCS-Verzeichnis
unzip keyhelpmanager.zip -d /pfad/zu/whmcs/modules/servers/
```
Oder manuell:
1. Entpacke `keyhelpmanager.zip`
2. Lade den Ordner `keyhelpmanager` nach `modules/servers/` hoch
### Schritt 2: Server in WHMCS konfigurieren (3 Min.)
1. Gehe zu: **Setup → Products/Services → Servers**
2. Klicke: **Add New Server**
3. Fülle aus:
```
Name: KeyHelp Server 1
Hostname: keyhelp.example.com
Type: KeyHelp Manager
Password: [DEIN-API-KEY-HIER]
Secure (SSL): ✓ (aktivieren)
Active: ✓ (aktivieren)
```
4. Klicke: **Test Connection** → "Connection Successful!" ✅
5. Speichern: **Save Changes**
### Schritt 3: Produkt erstellen (2 Min.)
1. Gehe zu: **Setup → Products/Services → Products/Services**
2. Wähle eine Produktgruppe oder erstelle eine neue
3. Klicke: **Create a New Product**
4. Fülle aus:
```
Product Type: Hosting Account
Product Name: Webhosting Basic
```
5. Tab: **Module Settings**
6. Wähle:
- **Module Name:** KeyHelp Manager
- **Server Group:** oder **Selected Server:** KeyHelp Server 1
### Schritt 4: Templates synchronisieren (1 Min.)
1. In den **Module Settings** (gleiche Seite)
2. Klicke: **Sync Templates** (Button oben)
3. Nach 2-3 Sekunden: Dropdown wird mit Templates gefüllt
4. Wähle bei **KeyHelp Template:** dein gewünschtes Template
- z.B. "Basic Plan", "Pro Plan", etc.
5. Speichern: **Save Changes**
### Schritt 5: Test durchführen (2 Min.)
1. Erstelle eine Test-Bestellung für das Produkt
2. Markiere als bezahlt
3. Prüfe:
- ✅ Account wird in KeyHelp erstellt
- ✅ Client Area zeigt Login-Daten
- ✅ Template-Name wird angezeigt
- ✅ Statistiken werden geladen
- ✅ Login-Button funktioniert
**Fertig! 🎉**
---
## 🎯 Wichtigste Unterschiede zu v1.x
| v1.x (Alt) | v2.0 (Neu) |
|------------|------------|
| API-Key in jedem Produkt | API-Key nur einmal im Server |
| Hostname in jedem Produkt | Hostname nur einmal im Server |
| Manuelle Plan-Eingabe | Automatisches Template-Dropdown |
| Keine Template-Info | Template wird im Client Area angezeigt |
**Vorteil:** Bei 10 Produkten spart man 90% Konfigurationsaufwand!
---
## 💡 Typische Szenarien
### Szenario A: Ein Server, mehrere Produkte
```
Server in WHMCS:
└── KeyHelp Server 1 (keyhelp.example.com)
Produkte:
├── Webhosting Basic → Server 1, Template "Basic"
├── Webhosting Pro → Server 1, Template "Pro"
├── Webhosting Business → Server 1, Template "Business"
└── Reseller Paket → Server 1, Template "Reseller"
```
**Konfiguration:**
1. Einen Server anlegen
2. Bei jedem Produkt: Server zuweisen + Template wählen
### Szenario B: Mehrere Server
```
Server in WHMCS:
├── KeyHelp Server 1 (Shared Hosting)
├── KeyHelp Server 2 (Reseller)
└── KeyHelp Server 3 (VPS)
Produkte nach Server zuweisen
```
**Konfiguration:**
1. Alle Server in WHMCS anlegen
2. Produkte dem passenden Server zuweisen
3. Templates synchronisieren
4. Template pro Produkt wählen
---
## 🔑 API-Key erstellen (KeyHelp)
Falls du noch keinen API-Key hast:
1. Login in KeyHelp als Admin
2. Gehe zu: **Einstellungen → API**
3. Klicke: **API-Schlüssel erstellen**
4. Name: `WHMCS Integration`
5. Rechte: **Admin** (alle Rechte)
6. Kopiere den generierten Key
7. Verwende ihn im WHMCS Server-Setup
**Wichtig:** Der Key wird nur einmal angezeigt!
---
## ✅ Checkliste
Bevor du loslegst:
- [ ] WHMCS 8.13+ installiert
- [ ] PHP 8.3+ verfügbar
- [ ] KeyHelp-Server läuft
- [ ] API-Key erstellt
- [ ] Pläne/Templates in KeyHelp angelegt
- [ ] FTP/SSH-Zugang zu WHMCS-Server
Nach der Installation:
- [ ] Server in WHMCS konfiguriert
- [ ] Test Connection erfolgreich
- [ ] Mindestens ein Produkt erstellt
- [ ] Templates synchronisiert
- [ ] Template ausgewählt
- [ ] Test-Bestellung erfolgreich
- [ ] Client Area funktioniert
- [ ] Login funktioniert
---
## 🔧 Verfügbare Templates laden
Templates werden von KeyHelp geladen. Stelle sicher, dass in KeyHelp **Pläne** angelegt sind:
**In KeyHelp:**
1. **Einstellungen → Pläne**
2. Erstelle Pläne wie:
- Basic Plan (5 GB, 1 Domain)
- Pro Plan (20 GB, 10 Domains)
- Business Plan (100 GB, unlimitiert)
Diese erscheinen dann automatisch im WHMCS-Dropdown!
---
## 🎨 Client Area Features
Nach der Erstellung sehen Kunden:
```
┌─────────────────────────────────────────┐
│ KeyHelp Hosting ACTIVE │
│ example.com 📋 Basic Plan │
│ │
│ [Open Control Panel] [Admin Panel] │
└─────────────────────────────────────────┘
┌─────────────────┬───────────────────────┐
│ Username │ Password │
│ example_com │ •••••••• 👁️ 📋 │
└─────────────────┴───────────────────────┘
📊 Resource Usage
┌─────────────────────────────────────────┐
│ 💾 Disk Space: 2.3 GB / 5 GB │
│ ▓▓▓▓▓▓▒░░░░░░░░░ 46% │
│ │
│ 📊 Bandwidth: 15 GB / 100 GB │
│ ▓▓▒░░░░░░░░░░░░░ 15% │
└─────────────────────────────────────────┘
┌───────┬──────────┬────────────┐
│ 3 │ 2 │ 5 │
│ 🌐 Domains │ 🗄️ DBs │ 📧 Emails │
└───────┴──────────┴────────────┘
```
---
## 🐛 Schnelle Problemlösungen
### "KeyHelp server not configured"
→ Server in WHMCS anlegen und Produkt zuweisen
### Templates werden nicht geladen
→ Test Connection durchführen, dann Sync Templates klicken
### "Connection failed"
→ Hostname, API-Key und SSL-Einstellungen prüfen
### API-Key funktioniert nicht
→ In KeyHelp prüfen: Key hat Admin-Rechte?
### Template-Dropdown leer
→ In KeyHelp: Sind Pläne angelegt?
---
## 📚 Weiterführende Dokumentation
- **Installation:** [INSTALLATION.md](INSTALLATION.md) - Detaillierte Schritt-für-Schritt-Anleitung
- **Update:** [UPDATE.md](UPDATE.md) - Migration von v1.x auf v2.0
- **Changelog:** [CHANGELOG.md](CHANGELOG.md) - Alle Änderungen und Features
- **Support:** GitHub Issues oder https://avvgo.de
---
## 💬 Häufige Fragen
### Muss ich API-Keys für jedes Produkt eingeben?
**Nein!** Das ist der große Vorteil von v2.0. API-Key nur einmal beim Server.
### Kann ich mehrere KeyHelp-Server nutzen?
**Ja!** Lege einfach mehrere Server in WHMCS an.
### Funktionieren alte Accounts nach dem Update?
**Ja!** Bestehende Accounts funktionieren weiterhin ohne Änderungen.
### Kann ich Templates nachträglich ändern?
**Ja!** Einfach in der Produktkonfiguration ändern und speichern.
### Was passiert, wenn ich ein Template lösche?
Templates nur in KeyHelp löschen, wenn keine aktiven Accounts damit verbunden sind.
### Wo finde ich die Module-Logs?
**Utilities → Logs → Module Log** → Filter: "keyhelpmanager"
---
## 🎯 Pro-Tipps
1. **Template-Namen sinnvoll wählen**
- ✅ "Basic Plan", "Pro Plan", "Business Plan"
- ❌ "Plan1", "Plan2", "Plan3"
2. **Server-Namen beschreibend**
- ✅ "KeyHelp Main", "KeyHelp Reseller"
- ❌ "Server1", "Test123"
3. **SSL immer aktivieren**
- Sicher und empfohlen!
4. **Templates regelmäßig synchronisieren**
- Nach Änderungen in KeyHelp: Sync klicken
5. **Test-Account behalten**
- Zum schnellen Testen von Änderungen
---
## 🚀 Nächste Schritte
Nach dem Setup:
1. ✅ Weitere Produkte anlegen
2. ✅ Preise und Beschreibungen anpassen
3. ✅ Kunden-E-Mail-Templates konfigurieren
4. ✅ Automatisierung testen
5. ✅ Team schulen
6. ✅ Live gehen!
---
## 📞 Support & Updates
- **Website:** https://avvgo.de
- **Entwickler:** Kevin Feiler
- **Version:** 2.0.0
- **Lizenz:** MIT
**Viel Erfolg mit KeyHelp Manager! 🎉**
---
*Letzte Aktualisierung: 2024-01-20*

24
README.md
View File

@@ -3,7 +3,18 @@
Ein professionelles WHMCS-Provisioning-Modul für die automatische Verwaltung von KeyHelp-Webhosting-Accounts.
**Entwickelt von:** Kevin Feiler / AVVGO
**Website:** https://avvgo.de
**Website:** https://avvgo.de
**Version:** 2.0.0
## 🆕 NEU in Version 2.0.0
- 🎯 **Zentralisierte Server-Konfiguration** - API-Keys nur einmal in WHMCS Server-Einstellungen eintragen
- 📋 **Template/Vorlagen-System** - Automatische Synchronisation von KeyHelp-Plänen als Dropdown
- 🚀 **Template-basierte Provisionierung** - Domains werden automatisch mit gewählter Vorlage erstellt
- 🔗 **Admin-Panel-Link** - Direkter Zugriff zur Domain-Verwaltung im KeyHelp-Panel
- 📊 **Template-Anzeige** - Kunden sehen ihr verwendetes Template im Client Area
**[→ Update-Anleitung von v1.x auf v2.0](UPDATE.md)**
## 📋 Inhaltsverzeichnis
@@ -18,6 +29,7 @@ Ein professionelles WHMCS-Provisioning-Modul für die automatische Verwaltung vo
## ✨ Features
### Core Features
- ✅ **Automatische Account-Erstellung** - Erstellt KeyHelp-Accounts direkt nach der Bezahlung
- ✅ **Account-Verwaltung** - Sperren, Entsperren und Löschen von Accounts
- ✅ **Passwort-Management** - Sichere Passwortverwaltung und -änderung
@@ -28,6 +40,16 @@ Ein professionelles WHMCS-Provisioning-Modul für die automatische Verwaltung vo
- ✅ **Detailliertes Logging** - Alle API-Calls werden in WHMCS protokolliert
- ✅ **Fehlerbehandlung** - Robuste Error-Handling-Mechanismen
### Neue Features v2.0
- 🎯 **Zentralisierte API-Konfiguration** - API-Keys werden nur einmal in WHMCS Server-Einstellungen eingegeben
- 📋 **Template-Synchronisation** - KeyHelp-Pläne/Vorlagen werden automatisch als Dropdown geladen
- 🔄 **Sync Templates Button** - Manuelles Aktualisieren der verfügbaren Templates
- 🏷️ **Template-basierte Erstellung** - Accounts werden mit gewähltem Template/Plan erstellt
- 🔗 **Admin-Panel-Link** - Direkter Link zur Domain-Verwaltung im KeyHelp-Panel
- 📊 **Template-Anzeige** - Template-Name wird im Client Area angezeigt
- ⚡ **Template-Cache** - Bessere Performance durch 5-Minuten-Cache
- 🎨 **Verbessertes UI** - Übersichtlichere Button-Anordnung und Design
## 🔧 Systemanforderungen
### WHMCS-Server

371
RELEASE_NOTES_v2.0.md Normal file
View File

@@ -0,0 +1,371 @@
# 🎉 KeyHelp Manager v2.0.0 - Release Notes
**Release-Datum:** 20. Januar 2024
**Entwickler:** Kevin Feiler / AVVGO
**Website:** https://avvgo.de
---
## 🚀 Was ist neu?
Version 2.0.0 bringt grundlegende Verbesserungen in der Konfiguration und Verwaltung von KeyHelp-Produkten in WHMCS.
### 🎯 Hauptfeatures
#### 1. Zentralisierte Server-Konfiguration
**Problem gelöst:** In v1.x mussten API-Keys, Hostname und SSL-Einstellungen für **jedes einzelne Produkt** eingegeben werden.
**Neue Lösung:**
- API-Key wird nur **einmal** in WHMCS Server-Einstellungen eingegeben
- Hostname nur **einmal** konfigurieren
- SSL-Einstellungen zentral verwalten
- Bei 10 Produkten: **90% weniger Konfigurationsaufwand!**
**Vorher (v1.x):**
```
Produkt 1: Hostname + API-Key + SSL
Produkt 2: Hostname + API-Key + SSL
Produkt 3: Hostname + API-Key + SSL
...
```
**Nachher (v2.0):**
```
Server 1: Hostname + API-Key + SSL (EINMALIG!)
Produkt 1 → Server 1 + Template
Produkt 2 → Server 1 + Template
Produkt 3 → Server 1 + Template
```
#### 2. Template/Vorlagen-System
**Neu:** Automatische Synchronisation von KeyHelp-Plänen als Dropdown-Auswahl
**Features:**
- Lädt verfügbare Pläne/Vorlagen automatisch von KeyHelp
- Dropdown-Auswahl statt manuelle Eingabe
- "Sync Templates" Button für manuelle Aktualisierung
- Template-Cache für bessere Performance
- Template-Name wird im Client Area angezeigt
**Workflow:**
1. Templates in KeyHelp anlegen (z.B. "Basic", "Pro", "Business")
2. In WHMCS auf "Sync Templates" klicken
3. Template aus Dropdown wählen
4. Fertig!
#### 3. Template-basierte Provisionierung
**Neu:** Domains werden automatisch mit der ausgewählten Vorlage erstellt
**Vorteile:**
- Korrekte Ressourcen-Zuweisung von Anfang an
- Keine manuelle Konfiguration nach Erstellung nötig
- Plan-ID wird in Account-Details gespeichert
- Template-Informationen für späteren Support verfügbar
#### 4. Verbesserter Client Area
**Neue Anzeigen:**
- Template-Name als Badge in der Header-Card
- Direkter "Admin Panel" Button für schnellen Zugriff
- Link zur Domain-Verwaltung im KeyHelp-Panel
- Übersichtlichere Button-Anordnung
- Moderneres Design
**Beispiel:**
```
┌──────────────────────────────────────────┐
│ KeyHelp Hosting [ACTIVE] │
│ example.com 📋 Basic Plan │
│ [Open Control Panel] [Admin Panel] │
└──────────────────────────────────────────┘
```
---
## 📊 Vergleich Alt vs. Neu
| Feature | v1.x | v2.0 |
|---------|------|------|
| API-Key Konfiguration | Pro Produkt | Einmal zentral |
| Hostname Eingabe | Pro Produkt | Einmal zentral |
| SSL-Einstellungen | Pro Produkt | Einmal zentral |
| Plan/Template | Manuell tippen | Dropdown-Auswahl |
| Template-Sync | Nicht verfügbar | Automatisch |
| Template-Anzeige | Nicht sichtbar | Im Client Area |
| Admin-Panel-Link | Nicht verfügbar | Direkter Link |
| Konfigurationsaufwand | 100% | 10% |
---
## 🎯 Für wen ist dieses Update?
### ✅ Perfekt für:
- Hoster mit **mehreren KeyHelp-Produkten**
- Agenturen mit **mehreren KeyHelp-Servern**
- Reseller mit **vielen Hosting-Paketen**
- Alle, die **Zeit sparen** möchten
### 💰 ROI-Beispiel:
```
Altes System (v1.x):
- 10 Produkte konfigurieren
- Je 5 Minuten pro Produkt
- = 50 Minuten Gesamtaufwand
Neues System (v2.0):
- 1x Server konfigurieren (5 Min.)
- 10x Template wählen (1 Min. je)
- = 15 Minuten Gesamtaufwand
Zeitersparnis: 70%! ⚡
```
---
## 🔧 Technische Details
### Neue Funktionen
```php
_keyhelpmanager_GetTemplates() // Lädt Templates von KeyHelp
keyhelpmanager_TemplateLoader() // Dropdown-Loader
keyhelpmanager_SyncTemplates() // Manuelle Synchronisation
keyhelpmanager_AdminCustomButtonArray() // Admin-Buttons
```
### Neue API-Endpunkte
```
GET /api/v2/plans // Liste aller Pläne
GET /api/v2/plans/{id} // Details eines Plans
```
### Datenbankänderungen
- Account-Details speichern jetzt auch `domainid` und `template`
- Template-Cache in `tblconfiguration`
- Keine Breaking Changes bei bestehenden Daten
### Geänderte Parameter
```php
// Alt (v1.x):
$params['configoption1'] // Hostname
$params['configoption2'] // API-Key
$params['configoption3'] // SSL
// Neu (v2.0):
$params['serverhostname'] // Von Server übernommen
$params['serveraccesshash'] // Von Server übernommen
$params['serversecure'] // Von Server übernommen
$params['configoption1'] // Template-Dropdown
```
---
## 📦 Installation & Update
### Neuinstallation
```bash
1. Module hochladen
2. Server in WHMCS konfigurieren
3. Produkt erstellen
4. Templates synchronisieren
5. Template wählen
```
→ **[Schnellstart-Anleitung](QUICKSTART.md)**
### Update von v1.x
```bash
1. Backup erstellen
2. Alte Konfiguration dokumentieren
3. Module-Dateien aktualisieren
4. Server in WHMCS anlegen
5. Produkte migrieren
```
→ **[Ausführliche Update-Anleitung](UPDATE.md)**
---
## ⚠️ Breaking Changes
### Was ändert sich?
**ConfigOptions-Struktur:**
- Alte Config-Optionen (Hostname, API-Key, SSL) werden nicht mehr verwendet
- Neue Config-Option: Nur noch Template-Dropdown
### Sind bestehende Accounts betroffen?
**Nein!**
- Bestehende Accounts funktionieren weiterhin
- Keine Datenmigration erforderlich
- Neue Accounts bekommen zusätzliche Features (Template-Info, Admin-Link)
### Migration erforderlich?
**Teilweise:**
- Server müssen in WHMCS neu konfiguriert werden
- Produkte müssen Server zugewiesen bekommen
- Templates müssen synchronisiert und gewählt werden
- **Zeit:** 15-60 Minuten je nach Anzahl der Produkte
---
## 🐛 Bekannte Einschränkungen
1. **Template-Cache**
- Cache läuft nach 5 Minuten ab
- Nicht konfigurierbar
- Workaround: "Sync Templates" Button nutzen
2. **Admin-Panel-Link**
- Funktioniert nur bei neuen Accounts (ab v2.0)
- Benötigt gespeicherte Domain-ID
- Alte Accounts: Nutzen Standard-Login
3. **Template-Synchronisation**
- Manuell nach Änderungen in KeyHelp
- Kein automatischer Webhook
- Geplant für v2.1
4. **URL-Struktur**
- Admin-Panel-Link basiert auf Standard-KeyHelp-URL
- Bei Custom-URLs evtl. Anpassung nötig
---
## 🔒 Sicherheit
### Verbesserte Sicherheit
- ✅ SSL-Verifizierung standardmäßig aktiviert
- ✅ Zentrale API-Key-Verwaltung
- ✅ Weniger Stellen für sensible Daten
- ✅ Bessere Zugriffskontrolle
### Empfehlungen
1. Nutze immer SSL/HTTPS für KeyHelp-API
2. API-Keys regelmäßig rotieren
3. Nur Admin-Keys mit vollen Rechten nutzen
4. Module-Logs regelmäßig prüfen
---
## 📈 Performance
### Optimierungen
- Template-Cache reduziert API-Calls
- Effizientere Datenbank-Abfragen
- Weniger redundante Konfigurationsdaten
### Benchmarks
```
Template-Laden (ohne Cache): ~500ms
Template-Laden (mit Cache): ~50ms
Performance-Gewinn: 10x schneller! ⚡
```
---
## 🗺️ Roadmap
### Geplant für v2.1 (Q1 2024)
- [ ] Automatische Template-Synchronisation via Webhook
- [ ] Multi-Language Support (Deutsch/Englisch)
- [ ] Template-Gruppen und Kategorien
- [ ] Bulk-Update für mehrere Produkte
### Geplant für v2.2 (Q2 2024)
- [ ] Erweiterte Statistiken im Client Area
- [ ] E-Mail-Account-Verwaltung
- [ ] Datenbank-Verwaltung
- [ ] FTP-Account-Management
### Geplant für v3.0 (Q3 2024)
- [ ] Ressourcen-Upgrade/Downgrade
- [ ] SSL-Zertifikat-Management
- [ ] Automatische Backups
- [ ] Subdomain-Verwaltung
---
## 💬 Feedback & Support
### Wo kann ich Feedback geben?
- **GitHub Issues:** Bug-Reports und Feature-Requests
- **E-Mail:** info@avvgo.de
- **WHMCS Community:** Diskussionen und Hilfe
### Wie kann ich helfen?
1. **Testen:** Beta-Versionen testen
2. **Feedback:** Verbesserungsvorschläge einreichen
3. **Dokumentation:** Typos melden, Anleitungen verbessern
4. **Code:** Pull Requests sind willkommen!
---
## 🎓 Ressourcen
### Dokumentation
- **[README.md](README.md)** - Übersicht und Features
- **[INSTALLATION.md](INSTALLATION.md)** - Detaillierte Installation
- **[QUICKSTART.md](QUICKSTART.md)** - 10-Minuten-Setup
- **[UPDATE.md](UPDATE.md)** - Update von v1.x
- **[CHANGELOG.md](CHANGELOG.md)** - Vollständige Änderungen
### Video-Tutorials
- Setup in 10 Minuten (coming soon)
- Update-Anleitung (coming soon)
- Template-Management (coming soon)
### Support
- GitHub: https://github.com/ihr-repo/keyhelpmanager
- Website: https://avvgo.de
- Forum: KeyHelp Community
---
## 🙏 Danksagungen
Ein großes Dankeschön an:
- **KeyHelp-Team** für die hervorragende API-Dokumentation
- **WHMCS Community** für wertvolles Feedback
- **Beta-Tester** für ausführliche Tests und Bug-Reports
- **Alle Nutzer** für das Vertrauen in dieses Modul
---
## 📜 Lizenz & Credits
**Lizenz:** MIT License
**Copyright:** © 2024 Kevin Feiler / AVVGO
**Website:** https://avvgo.de
### Open Source
Dieses Modul ist Open Source. Contributions sind willkommen!
### Verwendete Libraries
- Guzzle HTTP Client (von WHMCS bereitgestellt)
- WHMCS Capsule ORM
- Smarty Template Engine
---
## 🎉 Fazit
Version 2.0.0 ist das größte Update seit dem Release:
✅ **70% weniger Konfigurationsaufwand**
✅ **Automatische Template-Verwaltung**
✅ **Bessere Übersicht für Admins**
✅ **Mehr Informationen für Kunden**
✅ **Zukunftssicher durch modulare Architektur**
**Jetzt upgraden und Zeit sparen!**
---
**Download:** [keyhelpmanager_v2.0.0.zip](modules/servers/keyhelpmanager.zip)
**Minimale Version:** WHMCS 8.13, PHP 8.3, KeyHelp mit API v2
**Support:** GitHub Issues oder info@avvgo.de
---
*Viel Erfolg mit KeyHelp Manager v2.0.0!* 🚀
**Kevin Feiler / AVVGO**
*20. Januar 2024*

458
UPDATE.md Normal file
View File

@@ -0,0 +1,458 @@
# Update-Anleitung: KeyHelp Manager v1.x → v2.0.0
Diese Anleitung führt Sie durch das Update von KeyHelp Manager Version 1.x auf 2.0.0.
## 🎉 Was ist neu in Version 2.0.0?
### Hauptverbesserungen
1. **Zentralisierte API-Konfiguration**
- API-Keys und Server-Einstellungen nur noch einmal in WHMCS konfigurieren
- Keine redundante Eingabe mehr bei jedem Produkt
- Einfachere Verwaltung bei mehreren KeyHelp-Servern
2. **Template/Vorlagen-System**
- Automatische Synchronisation von KeyHelp-Plänen
- Dropdown-Auswahl bei Produktkonfiguration
- Template-basierte Domain-Erstellung
3. **Verbesserter Client Area**
- Anzeige des verwendeten Templates
- Direkter Link zum Admin-Panel
- Übersichtlichere Darstellung
---
## 📋 Voraussetzungen
- WHMCS 8.13 oder höher
- PHP 8.3 oder höher
- KeyHelp mit API v2
- Zugriff auf WHMCS Admin-Panel
- Backup Ihrer aktuellen Installation
---
## 🔄 Update-Schritte
### Schritt 1: Backup erstellen
```bash
# Backup des Modul-Ordners
cp -r /pfad/zu/whmcs/modules/servers/keyhelpmanager /pfad/zu/backup/keyhelpmanager_v1_backup
# Backup der Datenbank (optional, aber empfohlen)
mysqldump -u [username] -p [database_name] > whmcs_backup_$(date +%Y%m%d).sql
```
### Schritt 2: Alte Konfiguration dokumentieren
Notieren Sie sich für **jedes Produkt** mit KeyHelp Manager:
1. Hostname/IP des KeyHelp-Servers
2. API-Key
3. SSL-Einstellungen
4. Verwendete Plan-Namen (falls konfiguriert)
**Beispiel:**
| Produkt | Hostname | API-Key | SSL | Plan |
|---------|----------|---------|-----|------|
| Webhosting Basic | keyhelp1.example.com | abc123... | Ja | Basic |
| Webhosting Pro | keyhelp1.example.com | abc123... | Ja | Pro |
| Reseller | keyhelp2.example.com | xyz789... | Ja | Reseller |
### Schritt 3: Module-Dateien aktualisieren
```bash
# Alte Version löschen
rm -rf /pfad/zu/whmcs/modules/servers/keyhelpmanager/*
# Neue Version entpacken
unzip keyhelpmanager_v2.0.0.zip -d /pfad/zu/whmcs/modules/servers/
# Oder via Git
cd /pfad/zu/whmcs/modules/servers/keyhelpmanager
git pull origin main
```
### Schritt 4: Server in WHMCS konfigurieren
Dies ist der wichtigste Schritt! Die Konfiguration erfolgt jetzt zentral.
#### 4.1 Server hinzufügen
1. Gehen Sie zu: **Setup → Products/Services → Servers**
2. Klicken Sie auf **Add New Server**
3. Füllen Sie das Formular aus:
**Für KeyHelp Server 1:**
```
Name: KeyHelp Server 1
Hostname: keyhelp1.example.com
IP Address: [optional]
Type: KeyHelp Manager
Username: [leer lassen]
Password: [HIER API-KEY EINTRAGEN]
Access Hash: [leer lassen]
Secure: ✓ (Checkbox aktivieren für SSL)
Active: ✓
```
**Wichtig:** Der API-Key kommt ins **Password**-Feld!
#### 4.2 Mehrere Server
Falls Sie mehrere KeyHelp-Server haben, wiederholen Sie Schritt 4.1 für jeden Server:
```
Server 1: KeyHelp Server 1 (keyhelp1.example.com)
Server 2: KeyHelp Server 2 (keyhelp2.example.com)
Server 3: KeyHelp Reseller (keyhelp3.example.com)
```
### Schritt 5: Verbindung testen
1. Klicken Sie bei jedem konfigurierten Server auf **Test Connection**
2. Sie sollten die Meldung sehen: *"Connection Successful!"*
3. Bei Fehlern überprüfen Sie:
- Hostname korrekt?
- API-Key korrekt im Password-Feld?
- SSL-Checkbox entsprechend Ihrer Server-Konfiguration?
- Firewall erlaubt Verbindung?
### Schritt 6: Produkte aktualisieren
Für **jedes** Produkt mit KeyHelp Manager:
#### 6.1 Server zuweisen
1. Gehen Sie zu: **Setup → Products/Services → Products/Services**
2. Wählen Sie ein Produkt aus
3. Tab: **Module Settings**
4. Bei **Server Group**: Wählen Sie den entsprechenden Server aus
5. Oder bei **Selected Server**: Wählen Sie spezifischen Server
#### 6.2 Templates synchronisieren
1. Scrollen Sie zu den **Module Settings**
2. Klicken Sie auf **Sync Templates**
3. Die verfügbaren KeyHelp-Pläne werden geladen
#### 6.3 Template auswählen
1. Bei **KeyHelp Template**: Wählen Sie die passende Vorlage
2. Beispiel:
- Produkt "Webhosting Basic" → Template "Basic Plan"
- Produkt "Webhosting Pro" → Template "Pro Plan"
#### 6.4 Alte Config-Optionen entfernen
Die alten Felder (Hostname, API-Key, etc.) werden automatisch ausgeblendet.
Falls noch sichtbar, können diese ignoriert werden - sie werden nicht mehr verwendet.
#### 6.5 Speichern
1. Klicken Sie unten auf **Save Changes**
2. Wiederholen Sie Schritte 6.1-6.5 für alle Produkte
### Schritt 7: Bestehende Accounts migrieren (optional)
**Wichtig:** Bestehende Accounts funktionieren weiterhin!
Für bestehende Accounts können Sie optional die Template-Information hinzufügen:
```sql
-- Beispiel SQL für manuelles Hinzufügen der Template-ID
-- ACHTUNG: Nur für erfahrene Benutzer!
UPDATE tblhosting
SET
configoption1 = '5' -- Template ID
WHERE
server = [SERVER_ID]
AND packageid = [PRODUCT_ID];
```
**Empfehlung:** Neue Accounts werden automatisch mit korrekter Template-ID erstellt.
### Schritt 8: Test-Account erstellen
1. Erstellen Sie eine Test-Bestellung
2. Verifizieren Sie:
- ✓ Account wird korrekt erstellt
- ✓ Template wird verwendet
- ✓ Client Area zeigt alle Informationen
- ✓ Template-Name wird angezeigt
- ✓ Admin-Panel-Link funktioniert
- ✓ Login-Button funktioniert
---
## 🔍 Vergleich: Alt vs. Neu
### Version 1.x (Alt)
```
Produkt-Konfiguration:
├── Hostname: keyhelp1.example.com
├── API-Key: abc123...
├── SSL: Ja
└── SSL-Verify: Ja
Problem: Bei 10 Produkten → 10x dieselbe Konfiguration!
```
### Version 2.0 (Neu)
```
Server-Konfiguration (EINMALIG):
├── Server 1: keyhelp1.example.com
│ └── API-Key: abc123...
└── Server 2: keyhelp2.example.com
└── API-Key: xyz789...
Produkt-Konfiguration (PRO PRODUKT):
├── Server: Server 1
└── Template: Basic Plan
Vorteil: Zentrale Verwaltung, keine Redundanz!
```
---
## 📊 Konfigurationsübersicht
### Alte Produktkonfiguration (v1.x)
```
ConfigOption1: Hostname
ConfigOption2: API-Key
ConfigOption3: SSL (on/off)
ConfigOption4: SSL-Verify (on/off)
```
### Neue Produktkonfiguration (v2.0)
```
ConfigOption1: Template-Dropdown (dynamisch geladen)
Server-Einstellungen:
├── serverhostname: Von Server übernommen
├── serveraccesshash: Von Server übernommen
└── serversecure: Von Server übernommen
```
---
## 🎯 Migration verschiedener Szenarien
### Szenario 1: Ein Server, mehrere Produkte
**Vorher:**
- 5 Produkte
- Jedes mit eigenem Hostname + API-Key
**Nachher:**
1. Einen Server in WHMCS anlegen
2. Alle 5 Produkte diesem Server zuweisen
3. Je nach Produkt unterschiedliche Templates wählen
**Zeitersparnis:** 80%
### Szenario 2: Mehrere Server
**Vorher:**
- Server A: Produkt 1-3
- Server B: Produkt 4-5
- Jedes Produkt einzeln konfiguriert
**Nachher:**
1. Server A in WHMCS anlegen
2. Server B in WHMCS anlegen
3. Produkte 1-3 → Server A zuweisen
4. Produkte 4-5 → Server B zuweisen
5. Templates pro Produkt wählen
### Szenario 3: White-Label / Reseller
**Vorher:**
- Reseller1-Server: Produkt A, B, C
- Eigene Branding, gleiche API-Keys
**Nachher:**
1. "Reseller1-KeyHelp" Server anlegen
2. Alle Reseller-Produkte zuweisen
3. Reseller-spezifische Templates wählen
---
## 🐛 Troubleshooting
### Problem 1: "KeyHelp server not configured"
**Ursache:** Server nicht in WHMCS konfiguriert
**Lösung:**
1. Gehe zu Setup → Servers
2. Füge KeyHelp-Server hinzu
3. Weise Server dem Produkt zu
### Problem 2: Templates werden nicht geladen
**Ursache:** API-Verbindung fehlerhaft oder keine Pläne in KeyHelp
**Lösung:**
```
1. Test Connection durchführen
2. In KeyHelp prüfen: Sind Pläne angelegt?
3. API-Key-Berechtigung prüfen
4. "Sync Templates" Button klicken
```
### Problem 3: Bestehende Accounts funktionieren nicht
**Ursache:** Account-Details referenzieren alte Config-Optionen
**Lösung:**
Bestehende Accounts sollten weiterhin funktionieren. Falls nicht:
```sql
-- Prüfe gespeicherte Account-Details
SELECT * FROM tblhosting WHERE id = [SERVICE_ID];
-- Prüfe Custom Fields
SELECT * FROM tblcustomfieldsvalues WHERE relid = [SERVICE_ID];
```
### Problem 4: Admin-Panel-Link funktioniert nicht
**Ursache:** Domain-ID nicht gespeichert (nur bei neuen Accounts)
**Lösung:**
- Nur neue Accounts (ab v2.0) haben Admin-Panel-Link
- Alte Accounts: Nutzen Sie den Standard-Login-Button
### Problem 5: "Template not found"
**Ursache:** Gewähltes Template existiert nicht mehr in KeyHelp
**Lösung:**
1. Templates neu synchronisieren
2. Produkt-Konfiguration prüfen
3. Anderes Template wählen
---
## 📝 Checkliste nach Update
- [ ] Backup erstellt
- [ ] Alte Konfiguration dokumentiert
- [ ] Neue Module-Dateien hochgeladen
- [ ] Server in WHMCS konfiguriert
- [ ] Verbindung getestet (alle Server)
- [ ] Templates synchronisiert
- [ ] Alle Produkte aktualisiert
- [ ] Test-Account erstellt und geprüft
- [ ] Bestehende Accounts funktionieren
- [ ] Client Area korrekt
- [ ] Admin-SSO funktioniert
- [ ] Module-Logs überprüft
---
## 🚀 Vorteile nach dem Update
### Für Administratoren
- ✅ Zentrale Verwaltung aller Server
- ✅ Keine redundante Konfiguration
- ✅ Schnellere Produkt-Erstellung
- ✅ Einfacher Server-Wechsel
- ✅ Bessere Übersicht
### Für Kunden
- ✅ Template-Information sichtbar
- ✅ Direkter Admin-Panel-Link
- ✅ Schnellerer Zugriff
- ✅ Besseres Design
### Für Entwickler
- ✅ Sauberer Code
- ✅ Weniger Config-Optionen
- ✅ Standard-WHMCS-Workflow
- ✅ Einfachere Wartung
---
## 📞 Support
### Bei Problemen
1. **Logs prüfen:**
```
Utilities → Logs → Module Log
Filter: keyhelpmanager
```
2. **KeyHelp-API testen:**
```bash
curl -H "X-API-Key: YOUR_API_KEY" \
https://keyhelp.example.com/api/v2/server/version
```
3. **WHMCS Test Connection:**
```
Setup → Servers → Test Connection
```
### Kontakt
- **GitHub Issues:** https://github.com/ihr-repo/keyhelpmanager/issues
- **Entwickler:** Kevin Feiler / AVVGO
- **Website:** https://avvgo.de
---
## 🔄 Rollback (falls nötig)
Falls das Update Probleme verursacht:
```bash
# 1. Backup wiederherstellen
rm -rf /pfad/zu/whmcs/modules/servers/keyhelpmanager
cp -r /pfad/zu/backup/keyhelpmanager_v1_backup /pfad/zu/whmcs/modules/servers/keyhelpmanager
# 2. Browser-Cache leeren
# 3. WHMCS-Cache leeren
rm -rf /pfad/zu/whmcs/templates_c/*
# 4. Produkt-Konfiguration zurücksetzen
# (manuell in WHMCS Admin-Panel)
```
**Wichtig:** Nach Rollback müssen Sie die alten Config-Optionen wieder eintragen!
---
## 📅 Zeitaufwand
- **1-2 Server:** ca. 15-30 Minuten
- **3-5 Server:** ca. 30-45 Minuten
- **10+ Produkte:** ca. 45-60 Minuten
**Tipp:** Planen Sie das Update außerhalb der Geschäftszeiten.
---
## ✨ Nächste Schritte
Nach erfolgreichem Update:
1. Informieren Sie Ihr Team über die Änderungen
2. Aktualisieren Sie interne Dokumentation
3. Testen Sie alle Workflows
4. Freuen Sie sich über die Vereinfachung! 🎉
---
**Viel Erfolg beim Update!**
*KeyHelp Manager v2.0.0*
*© 2024 Kevin Feiler / AVVGO*

BIN
modules/servers/keyhelpmanager.zip Normal file
View File

Binary file not shown.

207
modules/servers/keyhelpmanager/keyhelpmanager.php
View File

@@ -6,7 +6,7 @@
* @copyright Copyright (c) 2024 Kevin Feiler / AVVGO
* @license MIT License
* @link https://avvgo.de
* @version 1.0.0
* @version 2.0.0
*/
if (!defined("WHMCS")) {
@@ -31,36 +31,21 @@ function keyhelpmanager_MetaData()
function keyhelpmanager_ConfigOptions()
{
return [
"hostname" => [
"FriendlyName" => "Hostname (IP or FQDN)",
"Type" => "text",
"Size" => "25",
"Description" =>
"KeyHelp server hostname or IP address (without http://)",
"Required" => true,
],
"apikey" => [
"FriendlyName" => "API Key",
"Type" => "password",
"Size" => "50",
"Description" => "KeyHelp API Key from Settings → API",
"Required" => true,
],
"usessl" => [
"FriendlyName" => "Use SSL",
"Type" => "yesno",
"Default" => "on",
"Description" => "Use SSL for API connection (recommended)",
],
"verify_ssl" => [
"FriendlyName" => "Verify SSL Certificate",
"Type" => "yesno",
"Default" => "on",
"Description" => "Verify SSL certificate (disable for self-signed)",
"template" => [
"FriendlyName" => "KeyHelp Template",
"Type" => "dropdown",
"Options" => _keyhelpmanager_GetTemplates(),
"Description" => "Select a KeyHelp template/plan for this product",
"Loader" => "keyhelpmanager_TemplateLoader",
],
];
}
function keyhelpmanager_TemplateLoader($params)
{
return _keyhelpmanager_GetTemplates($params);
}
function _keyhelpmanager_APIRequest(
array $params,
string $endpoint,
@@ -68,16 +53,19 @@ function _keyhelpmanager_APIRequest(
array $data = [],
) {
try {
$hostname =
$params["serverhostname"] ?? ($params["configoption1"] ?? "");
$apiKey = $params["serverpassword"] ?? ($params["configoption2"] ?? "");
$useSSL = $params["configoption3"] ?? "on";
$verifySSL = $params["configoption4"] ?? "on";
// Use centralized server configuration from WHMCS server settings
$hostname = $params["serverhostname"] ?? "";
$apiKey = $params["serveraccesshash"] ?? "";
$useSSL = $params["serversecure"] ?? "on";
// Verify SSL is enabled by default for security
$verifySSL = "on";
if (empty($hostname) || empty($apiKey)) {
return [
"success" => false,
"error" => "KeyHelp server not configured",
"error" =>
"KeyHelp server not configured. Please configure the server in WHMCS Setup > Products/Services > Servers",
];
}
@@ -165,6 +153,9 @@ function keyhelpmanager_CreateAccount(array $params)
return "Domain is required";
}
// Get selected template from config options
$templateId = $params["configoption1"] ?? "";
$accountData = [
"login_name" => $username,
"password" => $password,
@@ -172,8 +163,9 @@ function keyhelpmanager_CreateAccount(array $params)
"display_name" => $clientName,
];
if (!empty($params["configoptions"]["KeyHelp Plan"])) {
$accountData["plan"] = $params["configoptions"]["KeyHelp Plan"];
// Use template if selected
if (!empty($templateId)) {
$accountData["plan_id"] = $templateId;
}
$result = _keyhelpmanager_APIRequest(
@@ -193,7 +185,13 @@ function keyhelpmanager_CreateAccount(array $params)
return "User created but no ID returned";
}
// Create domain with template settings
$domainData = ["domain_name" => $domain, "user_id" => $userId];
if (!empty($templateId)) {
$domainData["template_id"] = $templateId;
}
$domainResult = _keyhelpmanager_APIRequest(
$params,
"/domains",
@@ -206,10 +204,15 @@ function keyhelpmanager_CreateAccount(array $params)
return "Domain creation failed: " . $domainResult["error"];
}
// Save account details including domain ID
$domainId = $domainResult["data"]["id"] ?? null;
_keyhelpmanager_SaveAccountDetails($params["serviceid"], [
"username" => $username,
"password" => $password,
"userid" => $userId,
"domainid" => $domainId,
"template" => $templateId,
]);
return "success";
@@ -295,24 +298,52 @@ function keyhelpmanager_ClientArea(array $params)
$params["serviceid"],
);
$userId = $accountDetails["userid"] ?? null;
$hostname =
$params["serverhostname"] ?? ($params["configoption1"] ?? "");
$useSSL = $params["configoption3"] ?? "on";
$domainId = $accountDetails["domainid"] ?? null;
$templateId = $accountDetails["template"] ?? null;
$hostname = $params["serverhostname"] ?? "";
$useSSL = $params["serversecure"] ?? "on";
$protocol = $useSSL === "on" ? "https" : "http";
$loginUrl = sprintf("%s://%s", $protocol, $hostname);
// Direct panel link
$panelUrl = sprintf(
"%s://%s/admin/index.php?p=domains&action=edit&id=%s",
$protocol,
$hostname,
$domainId ?? "",
);
$templateVars = [
"login_url" => $loginUrl,
"panel_url" => $panelUrl,
"username" =>
$accountDetails["username"] ?? ($params["username"] ?? "N/A"),
"password" =>
$accountDetails["password"] ??
($params["password"] ?? "••••••••"),
"domain" => $params["domain"] ?? "N/A",
"template_id" => $templateId,
"template_name" => "",
"stats" => null,
"error" => null,
];
// Get template name if template ID exists
if (!empty($templateId)) {
$templateResult = _keyhelpmanager_APIRequest(
$params,
"/plans/" . $templateId,
"GET",
);
if ($templateResult["success"] && isset($templateResult["data"])) {
$templateVars["template_name"] =
$templateResult["data"]["name"] ??
"Template " . $templateId;
}
}
if (!empty($userId)) {
$statsResult = _keyhelpmanager_APIRequest(
$params,
@@ -648,3 +679,103 @@ function _keyhelpmanager_CalculatePercent(int $used, int $limit): float
{
return $limit > 0 ? round(($used / $limit) * 100, 2) : 0;
}
/**
* Get templates from KeyHelp server
*/
function _keyhelpmanager_GetTemplates($params = null)
{
try {
// Get server configuration from module settings or server params
if ($params && isset($params["serverid"])) {
$server = Capsule::table("tblservers")
->where("id", $params["serverid"])
->first();
if (!$server) {
return ["" => "-- No Server Selected --"];
}
$apiParams = [
"serverhostname" => $server->hostname,
"serveraccesshash" => decrypt($server->accesshash),
"serversecure" => $server->secure,
];
// Get additional config options
$configOptions = Capsule::table("tblservers")
->where("id", $params["serverid"])
->first();
if ($configOptions && isset($configOptions->username)) {
$apiParams["serverusername"] = $configOptions->username;
}
} else {
return ["" => "-- Configure Product First --"];
}
// Fetch templates/plans from KeyHelp
$result = _keyhelpmanager_APIRequest($apiParams, "/plans", "GET");
if (!$result["success"]) {
logActivity(
"KeyHelpManager: Failed to fetch templates - " .
$result["error"],
);
return ["" => "-- Error loading templates --"];
}
$templates = ["" => "-- Select Template --"];
if (isset($result["data"]) && is_array($result["data"])) {
foreach ($result["data"] as $template) {
$templates[$template["id"]] =
$template["name"] ?? "Template " . $template["id"];
}
}
// Cache templates for 5 minutes
$cacheKey = "keyhelpmanager_templates_" . ($params["serverid"] ?? 0);
Capsule::table("tblconfiguration")->updateOrInsert(
["setting" => $cacheKey],
[
"setting" => $cacheKey,
"value" => json_encode($templates),
"created_at" => date("Y-m-d H:i:s"),
"updated_at" => date("Y-m-d H:i:s"),
],
);
return $templates;
} catch (\Exception $e) {
logActivity(
"KeyHelpManager: Get templates failed - " . $e->getMessage(),
);
return ["" => "-- Error: " . $e->getMessage() . " --"];
}
}
/**
* Sync templates from KeyHelp server
*/
function keyhelpmanager_AdminCustomButtonArray()
{
return [
"Sync Templates" => "SyncTemplates",
];
}
function keyhelpmanager_SyncTemplates($params)
{
try {
$templates = _keyhelpmanager_GetTemplates($params);
if (count($templates) > 1) {
return "success&Templates synchronized successfully";
} else {
return "error&Failed to sync templates";
}
} catch (\Exception $e) {
return "error&" . $e->getMessage();
}
}

29
modules/servers/keyhelpmanager/templates/clientarea.tpl
View File

@@ -319,13 +319,28 @@
KeyHelp Hosting
<span class="kh-badge">ACTIVE</span>
</div>
<p class="kh-card-subtitle">{$domain}</p>
<a href="{$login_url}" target="_blank" class="kh-login-btn">
<svg width="18" height="18" fill="currentColor" viewBox="0 0 20 20" style="display: inline-block; vertical-align: middle; margin-right: 8px;">
<path fill-rule="evenodd" d="M3 3a1 1 0 011 1v12a1 1 0 11-2 0V4a1 1 0 011-1zm7.707 3.293a1 1 0 010 1.414L9.414 9H17a1 1 0 110 2H9.414l1.293 1.293a1 1 0 01-1.414 1.414l-3-3a1 1 0 010-1.414l3-3a1 1 0 011.414 0z" clip-rule="evenodd"/>
</svg>
Open Control Panel
</a>
<p class="kh-card-subtitle">
{$domain}
{if $template_name}
<span class="kh-badge">📋 {$template_name}</span>
{/if}
</p>
<div style="display: flex; gap: 12px; flex-wrap: wrap;">
<a href="{$login_url}" target="_blank" class="kh-login-btn">
<svg width="18" height="18" fill="currentColor" viewBox="0 0 20 20" style="display: inline-block; vertical-align: middle; margin-right: 8px;">
<path fill-rule="evenodd" d="M3 3a1 1 0 011 1v12a1 1 0 11-2 0V4a1 1 0 011-1zm7.707 3.293a1 1 0 010 1.414L9.414 9H17a1 1 0 110 2H9.414l1.293 1.293a1 1 0 01-1.414 1.414l-3-3a1 1 0 010-1.414l3-3a1 1 0 011.414 0z" clip-rule="evenodd"/>
</svg>
Open Control Panel
</a>
{if $panel_url}
<a href="{$panel_url}" target="_blank" class="kh-login-btn" style="background: rgba(255,255,255,0.2); color: white;">
<svg width="18" height="18" fill="currentColor" viewBox="0 0 20 20" style="display: inline-block; vertical-align: middle; margin-right: 8px;">
<path fill-rule="evenodd" d="M11.49 3.17c-.38-1.56-2.6-1.56-2.98 0a1.532 1.532 0 01-2.286.948c-1.372-.836-2.942.734-2.106 2.106.54.886.061 2.042-.947 2.287-1.561.379-1.561 2.6 0 2.978a1.532 1.532 0 01.947 2.287c-.836 1.372.734 2.942 2.106 2.106a1.532 1.532 0 012.287.947c.379 1.561 2.6 1.561 2.978 0a1.533 1.533 0 012.287-.947c1.372.836 2.942-.734 2.106-2.106a1.533 1.533 0 01.947-2.287c1.561-.379 1.561-2.6 0-2.978a1.532 1.532 0 01-.947-2.287c.836-1.372-.734-2.942-2.106-2.106a1.532 1.532 0 01-2.287-.947zM10 13a3 3 0 100-6 3 3 0 000 6z" clip-rule="evenodd"/>
</svg>
Admin Panel
</a>
{/if}
</div>
</div>
<div class="kh-info-grid">