WHMCS-Addon¶

Wir stellen Ihnen ein WHMCS-Addon zur Verfügung, mit dem Sie unsere Dienste direkt über WHMCS weiterverkaufen können.

Installation¶

Sie können das Addon kostenlos bei unserem Support anfordern. Wir senden Ihnen das Addon anschließend als ZIP-Datei zu.

Entpacken Sie das Archiv und laden Sie den Ordner realtoxmedia_ccp_reseller in das Verzeichnis /modules/servers Ihrer WHMCS-Installation hoch.

Konfiguration¶

1. Öffnen Sie in WHMCS den Bereich System Settings > Servers.
   
2. Klicken Sie auf Add New Server.
   
3. Wählen Sie als Servertyp RealtoxMedia CCP Reseller aus.
4. Konfigurieren Sie die Serverfelder wie folgt:
   • Hostname: api.ccp.realtoxmedia.de
   • Secure: aktiviert
   • Username: UUID des CCP-Brandings
   • Password: CCP-API-Schlüssel
5. Speichern Sie den Server.
6. Klicken Sie auf Test Connection.
7. Erstellen Sie eine Servergruppe und weisen Sie den Server dieser Gruppe zu.

Der Verbindungstest prüft den API-Schlüssel, validiert die konfigurierte Branding-ID und lädt die verfügbaren CCP-Brandings, Produkte und Checkout-Optionen in WHMCS.

Falls Sie mehrere CCP-Brandings verwenden, erstellen Sie für jedes Branding einen eigenen WHMCS-Server. Verwenden Sie WHMCS-Servergruppen, um die Produkte dem jeweils richtigen Branding zuzuweisen.

Produktkonfiguration¶

Erstellen oder bearbeiten Sie unter System Settings > Products/Services ein Produkt.

1. Öffnen Sie den Tab Module Settings des Produkts.
2. Setzen Sie Module Name auf RealtoxMedia CCP Reseller.
3. Wählen Sie die korrekte WHMCS-Servergruppe aus.
4. Konfigurieren Sie die Moduleinstellungen:
   • Management mode: CCP Impersonation – weitere Optionen folgen.
   • Product type: Wählen Sie den passenden Produkttyp aus.
   • CCP Product: Wählen Sie das zu bestellende CCP-Produkt aus.
5. Speichern Sie das Produkt einmal, nachdem Sie das CCP-Produkt ausgewählt haben.
6. Füllen Sie die anschließend angezeigten Checkout-Optionsfelder für dieses Produkt aus.
7. Speichern Sie das Produkt erneut.

Checkout-Optionen¶

Nachdem ein CCP-Produkt ausgewählt und gespeichert wurde, zeigt das Modul die zugehörigen CCP-Checkout-Optionen als feste Felder in den Moduleinstellungen des WHMCS-Produkts an.

Verwenden Sie diese festen Felder für Werte, die bei Bestellungen dieses WHMCS-Produkts immer übermittelt werden sollen.

Sollen Kunden bestimmte Checkout-Werte während des Bestellvorgangs auswählen oder überschreiben können, erstellen Sie für das Produkt entsprechende konfigurierbare WHMCS-Optionen. Benennen Sie jede konfigurierbare Option exakt nach dem Namen des Schlüssels, der neben dem jeweiligen Feld in den Moduleinstellungen angezeigt wird.

Auch benutzerdefinierte WHMCS-Felder werden automatisch erkannt, wenn deren Namen mit einem Schlüssel oder einer Bezeichnung einer CCP-Checkout-Option übereinstimmen. Bei der Zuordnung werden Groß- und Kleinschreibung, Leerzeichen, Bindestriche, Unterstriche und Satzzeichen ignoriert.

Für Hostnamen wird automatisch das standardmäßige WHMCS-Domainfeld des Dienstes verwendet, sofern keine passende konfigurierbare Option und kein entsprechendes benutzerdefiniertes Feld einen Wert bereitstellen.

Kundenverwaltung¶

Kunden verwalten ihre Dienste über die Schaltfläche Login to Management im WHMCS-Kundenbereich. Die Schaltfläche öffnet das zugehörige CCP und meldet den Kunden über eine Impersonation-Sitzung in seinem Kundenkonto an.

Derzeit arbeiten wir daran, grundlegende Verwaltungsfunktionen optional direkt in die Produktseite des WHMCS-Kundenbereichs zu integrieren. Dadurch soll künftig nicht für jede Aktion eine Impersonation beziehungsweise eine separate Anmeldung im CCP erforderlich sein.