kevin/KeyHelp-Manager-for-WHMCS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
KeyHelp-Manager-for-WHMCS/RELEASE_NOTES_v2.0.md
Kevin Feiler cbb20ba6ce .
2025-10-16 02:35:20 +02:00

9.6 KiB
Raw Permalink Blame History

🎉 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

_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

// 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

1. Module hochladen
2. Server in WHMCS konfigurieren
3. Produkt erstellen
4. Templates synchronisieren
5. Template wählen

→ Schnellstart-Anleitung

Update von v1.x

1. Backup erstellen
2. Alte Konfiguration dokumentieren
3. Module-Dateien aktualisieren
4. Server in WHMCS anlegen
5. Produkte migrieren

→ Ausführliche Update-Anleitung

⚠️ 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

Video-Tutorials

  • Setup in 10 Minuten (coming soon)
  • Update-Anleitung (coming soon)
  • Template-Management (coming soon)

Support

🙏 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

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

Reference in New Issue View Git Blame Copy Permalink