Domain Offer

Aus Plambee.de Webhosting Wiki
Zur Navigation springen Zur Suche springen

Dieses Modul ermöglicht ihnen die Automatisierung von Domainangeboten. Nachdem Sie ein Angebot in der Moduloberfläche erstellt haben, passt der Cronjob des Moduls den Preis für die jeweilige Domain zum angegebenen Zeitpunkt an und informiert die Administratoren per E-Mail darüber, dass ein Angebot gestartet wurde. Bei Erreichen des Angebotsendes stellt das Modul den ursprünglichen Preis wieder her und sendet auch hierzu eine Benachrichtigung an die Administratoren. Zusätzlich kann das Angebot in der Preisliste der domainchecker.php Seite optisch hervorgehoben werden.

Systemvorraussetzung

Zur Nutzung des Domain Offer Moduls müssen folgende Voraussetzungen erfüllt sein:

  • Lauffähige WHMCS Installation mit Version 7.2 - 7.6
  • Admin Zugang zu WHMCS
  • FTP Zugang
  • installierter Ioncube Loader (mindestens Version 10.2)
  • PHP 5.6 - 7.2
  • Möglichkeit einen eigenen Cronjob einzurichten

Installation

  • Loggen Sie sich bitte im Kundenbereich von Plambee.de Webhosting ein und laden Sich dort die aktuelle Version des Domain Offer Moduls herunter.
  • Entpacken Sie die .zip Datei auf Ihrem Rechner und laden Sie den Ordner „domain_offers“ via FTP in das WHMCS Verzeichnis /modules/addons/
  • Wenn Sie die optische Hervorhebung in der Preisliste der domainchecker.php wünschen, kopieren Sie bitte noch die Datei „domain_offers_pricelist.php“ in das Verzeichnis /includes/hooks/ und die passenden tpl Dateien in Ihr Templateverzeichnis. Sollten Sie ein Custom-Template verwenden, müssen Sie dieses selbst anpassen, die mitgelieferten tpl Dateien können als Vorlage verwendet werden. (Nur WHMCS 6)
  • Loggen Sie sich nun in Ihren WHMCS Adminbereich ein und gehen dort auf „System/Addon Module“
  • In der Addonauflistung suchen Sie nun bitte nach dem Modul „Domain Offers“ und klicken dort bitte auf „Aktivieren“ und danach auf „Configure“
  • In dem Feld „Module license“ tragen Sie bitte ihren Lizenzcode ein, diesen finden Sie im Plambee.de Kundenbereich in den Produktdetails.
  • In dem Feld „WHMCS Admin User Name“ geben Sie bitte den Usernamen eines WHMCS Admins ein welcher Zugriff auf die interne API hat. Dies wird z.B. für den Mailversand benötigt.
  • Wählen Sie zum Schluss bitte noch aus welche Admingruppen auf das Modul zugreifen können.
  • Richten Sie nun bitte auf Ihrem Server einen Cronjob auf /modules/addons/domain_offers/cron.php ein welcher 1x täglich ausgeführt werden soll damit die Preise entsprechend geändert werden.

Nach Durchführung dieser Punkte ist das Modul vollständig installiert und kann verwendet werden.

Updatehinweise

Nachfolgend finden Sie zu Updatehinweise zu den jeweiligenden Versionen

Update auf Version 1.1.0

Seit Version 1.1.0 arbeitet das Modul mit einer eigenen Cronjob Datei wodurch der Zeitpunkt der Preisänderung nun nicht mehr vom Zeitpunkt des Dailycronjob von WHMCS abhängig ist. Löschen Sie deswegen bitte die hook.php aus dem Modulverzeichnis (da das Modul sonst weiterhin auch den WHMCS Cronjob nutzt) und legen Sie auf die Datei /addons/modules/domains_offers/cron.php einen täglichen Cronjob an welcher zu Ihrer Wunschzeit laufen soll.

Version 1.1.0 unterstützt nun auch Kundengruppenspezifische Domainpreise. Sollten Sie bereits mit Kundengruppen arbeiten und das Modul nutzen, überprüfen Sie bitte ihre Domainpreise da diese unter Umständen nicht korrekt gesetzt/zurückgesetzt wurden. Bei aktiven/wartenden Angeboten gehen Sie nach dem Update bitte in die Datenbanktabelle mod_domain_pricing und geben in der Zeile tsetupfee bitte die ID der jeweiligen Kundengruppe ein. Die ID finden Sie z.B. in der Domainpreisliste der jeweiligen Domain in der URL bei selectedcugroupid. Wenn dort z.B. „selectedcugroupid=2“ steht tragen Sie in der Tabelle 2.00 ein. Leider gibt es für das Modul keine Möglichkeit dies beim Update automatisch zu hinterlegen.

Update auf Version 1.3.0

Mit Version 1.3.0 unterstützt das Modul wieder die Hervorhebung von Angeboten im Domainchecker von WHMCS 7.2. Hierfür muss die domainregister.tpl des Orderforms angepasst werden. Wie genau entnehmen Sie bitte dem Punkt "Templateanpassung", oder Sie verwenden die dem Modul beigelegte Templatedatei.

Update auf Version 1.6.0

  • Entfernen Sie bei einem Update auf Version 1.6.0 bitte die Datei includes/hooks/domain_offers_pricelist.php
  • Gehen Sie nach dem Update bitte auf die WHMCS Addonauflistung /admin/configaddonmods.php und klicken beim Domain Offer Modul auf Speichern damit die neue Hookdatei von WHMCS erkannt wird.

Templateanpassung

Basierend auf dem standard_cart Template von WHMCS 7.2 sind folgende Änderungen zu machen damit die Preise in der Preisliste im Domainsucher hervorgehoben werden. In der domainregister.tpl ersetzen Sie folgende Zeile

{if current($price.register) >= 0}
{current($price.register)}<br>
<small>{key($price.register)} {if key($price.register) > 1}{lang key="orderForm.years"}{else}{lang key="orderForm.year"}{/if}</small>
{else}
<small>N/A</small>
{/if}

durch

{if current($price.register) >= 0}
{if $offers.{$tld}.domainregister}
<span style="text-decoration:line-through;">{$offers.{$tld}.domainregister}</span><br />
<span style="color:red;">PROMO</span> {current($price.register)}
{else}
{current($price.register)}<br>
{/if}
<small>{key($price.register)} {if key($price.register) > 1}{lang key="orderForm.years"}{else}{lang key="orderForm.year"}{/if}</small>
{else}
<small>N/A</small>
{/if} 

ersetzen Sie folgenden Teil

{if current($price.transfer) > 0}
{current($price.transfer)}<br>
<small>{key($price.transfer)} {if key($price.register) > 1}{lang key="orderForm.years"}{else}{lang key="orderForm.year"}{/if}</small>
{else}
<small>N/A</small>
{/if}

mit

{if current($price.transfer) > 0}
{if $offers.{$tld}.domaintransfer}
<span style="text-decoration:line-through;">{$offers.{$tld}.domaintransfer}</span><br />
<span style="color:red;">PROMO</span> {current($price.transfer)}
{else}
{current($price.transfer)}<br>
{/if}
<small>{key($price.transfer)} {if key($price.register) > 1}{lang key="orderForm.years"}{else}{lang key="orderForm.year"}{/if}</small>
{else}
<small>N/A</small>
{/if}

und ersetzen Sie:

{if current($price.renew) > 0}
{current($price.renew)}<br>
<small>{key($price.renew)} {if key($price.register) > 1}{lang key="orderForm.years"}{else}{lang key="orderForm.year"}{/if}</small>
{else}
<small>N/A</small>
{/if}

durch

{if current($price.renew) > 0}
{if $offers.{$tld}.domainrenew}
<span style="text-decoration:line-through;">{$offers.{$tld}.domainrenew}</span><br />
<span style="color:red;">PROMO</span> {current($price.renew)}
{else}
{current($price.renew)}<br>
{/if}
<small>{key($price.renew)} {if key($price.register) > 1}{lang key="orderForm.years"}{else}{lang key="orderForm.year"}{/if}</small>
{else}
<small>N/A</small>
{/if}

Verwendung

Nach der erfolgreichen Installation kann das Modul bereits verwendet werden. Gehen Sie hierzu bitte in das Modul (Addons/Domain Offer).

  • Um ein Angebot anzulegen klicken Sie bitte auf den Button „Neues Angebot erstellen“.
  • In der dann erscheinenden Maske wählen Sie bitte zuerst die betreffende Domain aus dem Drop-Down Menü aus.
  • Nach der Domainauswahl können Sie nun auswählen für welchen Vorgang (Registrierung/Transfer/Verlängerung) das Angebot gelten soll. Mit der gedrückter Strg-Taste können mehrere Vorgänge per Klick ausgewählt werden.
  • Wenn Sie die gewünschten Vorgänge ausgewählt haben klicken Sie mit der Maus bitte einmal auf eine freie Stelle innerhalb des Moduls damit die erforderliche Maske erstellt wird.
  • Nun erhalten Sie eine zusätzliche Zeilen, oben sehen Sie den aktuellen Preis in allen Währungen die Sie in WHMCS konfiguriert haben und unten bei Angebotspreis können Sie den Angebotspreis für die jeweiligen Vorgänge und Währungen festlegen.
  • In den letzten beiden Zeilen können Sie durch Klicken auf das Kalendersymbol die jeweiligen Start und Endtage auswählen.

Hinweis: Das Modul agiert an den Tagen die hier ausgewählt werden. Wenn Sie beim Enddatum z.B. den 15.10. angeben dann wird das Angebot mit dem Cronjob am 15.10. beendet.

  • Wenn Sie das Angebot fertig erstellt haben, klicken Sie bitte auf Speichern.

Nach dem Speichern gelangen Sie wieder auf die Übersichtsseite. Wartende Angebote können jederzeit durch klicken auf das Bearbeiten Icon verändert werden. Sollten Sie bei einem aktiven Angebot den Angebotspreis nachträglich verändern wollen, können Sie dies in der normalen WHMCS Domainpreisliste machen.

FAQ

Frage: Wieso werden die Domainpreise nicht geändert?
Antwort: Bitte kontrollieren Sie das Sie einen Cronjob für die cron.php Datei aus dem Modulverzeichnis angelegt haben.

Frage: Wieso erhalte ich keine E-Mail Benachrichtigung?
Antwort: Bitte kontrollieren Sie ob Sie in den Moduleinstellungen einen gültigen Admin Usernamen, welcher auch API Zugriff hat, eingetragen haben.

Frage: Kann ich das Wort „Promo“ im Domainchecker ändern?
Antwort: Ja, hierfür müssen Sie nur die domainregister.tpl Datei anpassen.