Mit diesem Modul können sich Ihre Kunden den Vertrag für die Auftragsdatenverarbeitung über ihren Kundenbereich generieren und Ihnen diesen anschließend in ausgedruckter Form unterschrieben zukommen lassen. Das Modul bietet nur die Basis Ihren Kunden den Vertrag erstellen zu lassen, es beinhaltet keinen vorgefertigten und einsatzbereiten AV Vertrag.

Systemvoraussetzungen

Zur Nutzung des AV Contract Moduls müssen folgende Voraussetzungen erfüllt sein:

• Lauffähige WHMCS 8.3 – 8.6 Installation
• Admin Zugang zu WHMCS
• installierter Ioncube Loader (mindestens Version 12)
• PHP 7.2 – 7.4 & 8.1

Installation

1. 1. Laden Sie die Moduldateien bitte auf Ihren Webspace hoch und aktivieren Sie dann das Modul in Adminbereich von WHMCS
   2. Den benötigten Lizenzcode finden Sie in Ihrem Kundenaccount bei Plambee.de Webhosting
   3. Sofern Sie möchten, dass das Modul E-Mail Benachrichtigungen versendet, aktivieren Sie bitte die entsprechenden Checkboxen. Die E-Mail Vorlage für den Kunden kann im E-Mail Templatebereich von WHMCS bearbeitet werden, die Vorlage heißt: AV Contract Confirmation

   4. Wählen Sie bitte aus, auf welche Bootstrap Version Ihr Kundenbereichstemplate basiert, damit das Modul die entsprechende Datei für den Kundenbereich des Moduls verwendet.

   5. Gehen Sie dann bite in das Modul und hinterlegen dort Ihren AV Vertrag

   6. Passen Sie die mitgelieferten Templatedateien pdf_footer_rename.tpl und pdf_header_rename.tpl für die PDF-Erstellung an und entfernen das „_rename“ aus dem Dateinamen. Sie können in den Dateien mit HTML arbeiten, der verwendete PDF Generator dompdf unterstützt auch teilweise CSS.

   7. Der Kundenbereich zu diesem Modul, dort wo sich der Kunde den Vertrag erzeugen kann, ist unter https://ihr-whmcs.de/index.php?m=av_contract zu finden

   8. Wenn Sie für die Kundennummer nicht die WHMCS eigene Nummer verwenden, sondern eine eigene Nummer als Custom-Kundenfeld verwenden, gehen Sie bitte in die Addonauflistung (dort wo Sie den Lizenzkey eingeben) und wählen dort das Customfield für die Kundennummer aus

Verfügbare Variablen

Vertragstext

Für den Vertragstext stehen Ihnen folgende Variablen zur Verfügung:
$kid = Kundennummer
$frstname = Vorname des Kunden
$lastname = Nachname des Kunden
$clientcompany = Firma des Kunden
$address = Adresse des Kunden
$postcode = Postleitzahl des Kunden
$city = Stadt des Kunden
$country = Land des Kunden
$current_date = Aktelles Datum
$owncompany = Ihr Firmenname
$contract_created_from_ip = Vertrag erstellt von IP
$contract_created_at = Vertrag erstellt am
$data_category = Art der Daten
$afected_data = Betrofene

E-Mail Template

Für das E-Mail Template „AV Contract Confrmaton“, welches bei der Eingangsbestätgung des unterschriebenen Vertrages an den Kunden gesendet wird, steht Ihnen zu den WHMCS eigenen Variablen noch folgende Variable zur Verfügung:

$create_date = Erstellungsdatum des Vertrages (Datum, wann der Kunde den Vertrag über den Kundenbereich generiert hat)
$contract_created_from_ip = Von welcher IP aus der Vertrag generiert wurde

Eigene Variablen

Ab Version 1.2.0 können Sie für die Art der Daten und für die Betroffenen eigene Variablen hinterlegen um diese Datenfelder nach eigenen Wunsch zu erweitern. Gehen Sie hierfür bitte wie folgt vor:

Öffnen Sie die clientarea.tpl Datei des Modules

• Suchen Sie den Form-Block
  <form role="form" method="post" action="" id="form2">
• Wenn Sie z.B. Die Art der Daten erweitern möchten, hängen Sie nach dem Block:
  <div><input id="kind-3" class="checkbox-custom" name="kind-3" type="checkbox"><label for="kind-3" class="checkbox-customlabel">{$av_contract_details.contract_data}</label></div>

einen weiteren Block in diesem Format an:
<div><input id="kind-4" class="checkbox-custom" name="kind[]" value="kind-4" type="checkbox"> <label for="kind-4" class="checkbox-custom-label">{$av_contract_lang.custom_kind_4}</label></div>

• Öffnen Sie die Sprachdateien des Moduls und erweitern diese um einen Sprachstring namens $_ADDONLANG[‚custom_kind_4‘] = „NEUE DATENART“;
• Wiederholen Sie dies für jeden Eintrag, den Sie hinzufügen möchten (wobei Sie kind-4 mit jedem neuen Datensatz um 1 erhöhen)
• Um das Datenfeld der Betroffenen zu erweitern, gehen Sie bitte genauso vor, ersetzen nur das „kind“

durch „betroffen“

E-Mail Template

Für das E-Mail Template „AV Contract Confirmation“, welches bei der Eingangsbestätigung des unterschriebenen Vertrages an den Kunden gesendet wird, steht Ihnen zu den WHMCS eigenen Variablen noch folgende Variable zur Verfügung:

$create_date = Erstellungsdatum des Vertrages (Datum, wann der Kunde den Vertrag über den Kundenbereich generiert hat)
$contract_created_from_ip = Von welcher IP aus der Vertrag generiert wurde

Update-Hinweise

Update auf Version 1.2.0

Nachdem Sie die neuen Dateien auf Ihren Webspace hochgeladen haben, gehen Sie bitte im WHMCS Adminbereich auf die Addonauflistung /admin/configaddonmods.php, klicken dort beim AV Contract Modul auf “Configure” und dann auf Save. Dies ist nötig, um eine Datenbankänderung durchzuführen.

Wenn Ihre WHMCS Version älter als Version 7.6 ist, benennen Sie bitte die clientarea_under_76.tpl in clientarea.tpl um.

Update auf Version 1.5.2

Wenn Sie eigene Variablen verwenden, öffnen Sie bitte die Templatedatei des Moduls und ersetzen dort
{$av_contract_lang.custom_kind-4}
durch {$av_contract_lang.custom_kind_4} und entsprechend in den Langdateien
$_ADDONLANG['custom_kind-4']
durch
$_ADDONLANG['custom_kind_4']
dies ist erforderlich, da neuere smarty Versionen den Bindestrich nicht mehr erlauben.

Update auf Version 1.7.0

Mit Version 1.7.0 ist es möglich, ein Custom-Kundenfeld für die Kundennummer zu verwenden. Sollten Sie diese Funktion nutzen möchten, gehen Sie bitte in die Addonauflistung (dort wo Sie den Lizenzkey eingeben) und wählen dort das Customfield für die Kundennummer aus.

Update auf Version 1.8.0

n dieser Version wurde eine Option eingefügt, dass der Kunde eine Notification im Kundenbereich erhält, wenn Sie den Vertragstext aktualisiert haben. Um diese Option zu aktivieren, gehen Sie bitte in die Addonauflistung (dort wo Sie den Lizenzkey eingeben) und aktivieren diese dort.

Es gab eine kleine Änderung an der Templatedatei für den Kundenbereich, wenn Sie eine eigene clientarea.tpl Datei verwenden, gleichen Sie die Änderung bitte manuell ab. Nutzen Sie unsere originale Templatedatei, bennen Sie bitte die clientarea_rename.tpl aus dem Archiv nach clientarea.tpl um

Update auf Version 2.1.0

Diese Version benötigt ein Update der WHMCS Datenbanktabelle, damit WHMCS dieses einspielen kann gehen Sie bitte in die Addonauflistung (dort wo Sie den Lizenzkey eingeben) klicken beim AV Contract Modul auf „Configure“ und dann auf Speichern. Damit wird die nötige Änderung automatisch eingespielt. Diese Version kommt mit 2 TPL Dateien für den Kundenbereich, wenn Sie ein Bootstrap 4 basierendes Template verwenden (z.B. twenty-one) dann benennen Sie die clientarea_rename_bs4.tpl bitte nach clientarea.tpl um.

Update auf Version 2.5.0

Die Templatedateien für den Kundenbereich heißen nun clientarea.tpl und clientarea_bs4.tpl, eine Umbenennung der Dateien ist nun nicht mehr nötig. Wenn Sie Ihre Templatedatei angepasst haben, achten Sie bitte darauf, Ihre eigenen Anpassungen beim Upload nicht durch die Templatedatei aus dem Modularchiv zu überschreiben.
Nach dem Upload aller Moduldateien gehen Sie bitte in WHMCS auf die Seite der Addonauflistung, klicken beim AV Contract Modul auf Configure und wählen die Bootstrap Version, aus die von Ihrem Kundenbereichstemplate verwendet wird.