In der Plugin Konfiguration ist ein nicht belegtes Freitextfeld für die Bestellung zu definieren. (s_order_basket / s_order) Nach der Installation steht nun unter Marketing ein neues Backend Modul zur Verfügung: "Bonus-System" Bilder:

Da auch bei der Bestellbestätigungsmail die Bonuspunkte angezeigt werden sollten, ist das sOrder-Emailtemplate anzupassen. Öffnen Sie dazu unter Einstellungen die eMail-Vorlagen und editieren Sie das Template "sOrder". Im Plaintex finden Sie folgende Zeilen:

 
{$details.price|padding:8} EUR 
{$details.amount|padding:8} EUR		
 

Ersetzen Sie diese durch:

 
{if $details.isBonusArticle}
   {$details.points_per_unit|padding:8} Punkte
   {$details.required_points|padding:8} Punkte
{elseif $details.isBonusVoucher} 
   {$details.required_points|padding:8} Punkte
   $details.price|padding:8} EUR 
{else}
   {$details.price|padding:8} EUR 
   {$details.amount|padding:8} EUR	
{/if}
 

Im HTML-Text Feld finden Sie folgende Zeilen:

 
   <td>{$details.price|padding:8}{$sCurrency}</td>
   <td>{$details.amount|padding:8} {$sCurrency}</td>
 

Ersetzen Sie diese durch:

 
{if $details.isBonusArticle}
   <td>{$details.points_per_unit|padding:8} Punkte</td>
   <td>{$details.required_points|padding:8} Punkte</td>
{elseif $details.isBonusVoucher} 
   <td>{$details.required_points|padding:8} Punkte</td>
   <td>{$details.price|padding:8}{$sCurrency}</td>
{else}
   <td>{$details.price|padding:8}{$sCurrency}</td>
   <td>{$details.amount|padding:8} {$sCurrency}</td>
{/if}
 

Im folgenden Bereich wird das Backend-Modul des Bonus-Systems erklärt:

Beim Start des Programms öffnet sich die Startseite des Bonus-Systems, in dem die Funktionen des Plugins noch einmal aufgelistet werden.

Auf der linken Seite befindet sich eine Auswahl der verfügbaren Funktionen:

- Bestellungen mit Bonuspunkten
- Benutzer Punktestand
- Bonusartikel konfigurieren
- Einstellungen

Mit diesen vier Bereichen sind die Funktionen des Bonus Systems komplett abgedeckt.

Beim Aufruf jeder dieser Bereiche wird für jeden Subshop ein Reiter mit der entsprechenden Komponente generiert um die Einstellungen und Bonus-Informationen von jedem Shop einstellen zu können.

In dieser Funktion kann der Benutzer alle Bestellungen mitteilen, die seit der Aktivierung des Bonus Systems getätigt wurden. Das trifft auch auf die Menge der Bonuspunkte zu, die der Kunde für diese Bestellung erhält.

Über einen Button in der Toolbar „Freigeben“ kann der Benutzer die Bonuspunkte der Bestellung manuell auf das Konto des Kunden transferieren. Mithilfe der Suche in der Toolbar können bestimmte Bestellungen schnell und einfach gefunden werden.

In dieser Funktion kann der Benutzer die verschiedenen Punktestände der Shop Kunden auslesen und diese manuell bearbeiten. Diese Funktion spielt eine große Rolle, da das Bonus System keine Bonuspunkte automatisiert zurückbucht, wenn z.B. eine Bestellung storniert wird. Sobald die Anpassung der Punkte abgeschlossen ist, kann der Mitarbeiter über den „Speichern“ Button die Änderungen in die Datenbank übernehmen.

Die Shopware Bonusartikel sind keine realen Artikel. Der Benutzer kann in dieser Funktion für vorhandene Artikel definieren, dass diese ebenfalls für Bonuspunkte gekauft werden können.

Um die Auswahl der Bonusartikel im Backend zu optimieren, wurde eine neue Funktion integriert. Sobald ein Artikel hinzugefügt werden soll oder die Definition geändert wird, erscheint ein Auswahlfenster, in dem alle möglichen Artikel des aktuellen Shop-Reiters angezeigt werden. Hier kann der Mitarbeiter per Klick einen Artikel auswählen und als Bonusartikel hinterlegen.

In diesem Bereich kann der Benutzer die verschiedenen Einstellungen zum Bonus-System treffen. Die Einstellungen unterteilen sich in drei Bereiche: - Allgemein - Bonuspunkte Verrechnung - Template

Im Bereich Allgemein stehen dem Benutzer folgende Optionen zur Verfügung:



- Wartungsmodus aktivieren Wenn der Wartungsmodus aktiviert ist, können Kunden nicht den aktuellen Punktestand abfragen, Bonusartikel kaufen, einen Gutschein aus den Bonuspunkten generieren oder für eine Bestellung Bonuspunkte sammeln. Das gesamte Modul ist für alle Kunden inaktiv. Anders als im Shopwareseitigen Wartungsmodus,bleibt der Shop dabei aber erreichbar.

- Bonusartikel aktivieren: Wenn dieser Punkt aktiv ist, werden die eingerichteten Bonusartikel im Frontend zur Auswahl angezeigt.

- Umrechnungsfaktor Bonuspunkte: Dieser Faktor gibt an, ab wieviel Euro der Kunde einen Bonuspunkt gut geschrieben bekommt. Bei der Berechnung der Bonuspunkte wird immer das kaufmännische Runden angewendet. Bei der Berechnung der Bonuspunkte werden die Versandkosten nicht mit einbezogen. Mindermegenzuschläge hingegen schon.

- Freischaltung der Bonuspunkte: Hier kann definiert werden, wann einem Kunden die Bonuspunkte freigeschaltet werden. Weitere Informationen finden Sie in den Hilfetexten der Elemente.

- Tage bis zur Freischaltung: Ist im vorherigen Punkt „Nach X Tagen nach Bestellung“ ausgewählt worden, so kann hier der Intervall der Freischaltung gesetzt werden. Die Freischaltung wird dann per Cronjob durchgeführt. Vorraussetzung für diese Funktion ist ein funktionstüchtiger Standard Cronjob, der mindestens einmal pro Tag ausgeführt wird.

Die Cronjob-Funktion ermöglicht ein automatisiertes Abarbeiten verschiedenster Funktionen. Der für das Bonus-System zuständige Cronjob wird in die Liste der Standard-Cronjobs der Shopware hinterlegt. Wenn Sie die Cronjobs bereits nutzen, wird auch der Cronjob für das Bonus-System verwendet, es ist kein weiterer Eingriff erforderlich.

Wenn Sie Cronjobs bisher noch nicht nutzen sind verschiedene Einstellungen in der Shopware und am Hostingserver zu treffen. Sie finden in folgendem Artikel mehr zum Thema: Shopware Cronjobs.

Im Bereich "Bonuspunkte Verrechnung" stehen dem Benutzer folgende Optionen zur Verfügung:

- Verrechnung aktivieren: Sobald dieser Punkt aktiviert ist, kann der Shop Kunde seine Bonuspunkte im Warenkorb in Euro eintauschen. Hierfür generiert Shopware automatisch einen neuen Gutschein und fügt diesen dem Warenkorb hinzu.

- Umrechnungsfaktor: Wie im Bereich Allgemein wird hier der Faktor für die Umrechnung der Bonuspunkte definiert. Anders als im Bereich Allgemein wird hier jedoch angegeben, wie viele Punkte einem Euro entsprechen.

- Art der Verrechnungsbeschränkung: Die Umwandlung von Bonuspunkten in Euro kann hier beschränkt werden. Es besteht die Möglichkeit, einen fixen Eurobetrag einzutragen oder die Beschränkung relativ zum Bestellwert zu bestimmen.

- Wert der Beschränkung: Hier wird der Euro Betrag für die Einschränkung hinterlegt.

Im Bereich Template stehen dem Benutzer folgende Optionen zur Verfügung:

- Text für das Bonusartikel Listing: Dieser Text wird im Listing der Bonusartikel angezeigt.

- Banner anzeigen: Da das Upload-Field nicht das Anzeigen bestehender Daten bzw. Bilder unterstützt, kann das Banner über diesen Punkt deaktiviert werden. Beim hochladen einer Grafikdatei wird diese im Hintergrund an den Server übertragen.

- Akkordeon anzeigen: Wenn dieser Punkt aktiviert ist, wird das Bonusartikel Akkordeon auf der Startseite und den Kategorie-Listings angezeigt. Optisch entspricht das dem des Hersteller Accordeons auf der Rechten Seite der Startseite Ihres Shops.

- Bonusartikel Slider anzeigen: Wenn dieser Punkt aktiviert ist, wird der Bonusartikel Slider im Warenkorb und auf der Startseite angezeigt.

- Banner für das Bonusartikel Listing: Das Extjs 4 Upload-Field unterstützt keine Darstellung bestehenden Grafiken. Sie können die Funktion also ausschlisslich zum erstmaligem Hochladen oder späterem überschreiben bestehender Grafiken verwenden.

Sobald das Bonus System von Shopware aktiviert ist, finden Sie im Frontend einige neue Elemente.

- Sollten die Bonusartikel aktiviert und definiert sein, befindet sich nun auf Ihrer Startseite ein Akkordeon mit den ersten fünf Bonusartikeln. Diese werden über das Feld „Position“ sortiert. Am Ende des Akkordeons befindet sich ein Link „Alle anzeigen“ über den der Benutzer zum Listing der Bonusartikel gelangen kann.

- Zusätzlich zum Akkordeon wird ein Artikel Slider mit allen Bonusartikeln angezeigt. Dieser kann, wie auch das Akkordeon über das Backend Module optional deaktiviert werden.

- Sobald der Benutzer eingeloggt ist, werden unter „Mein Konto“ die Bonuspunkte des Benutzers dargestellt.

- Bei einem Klick auf „Sie besitzen X Bonuspunkte“ erscheinen zwei Links, die zu den Bonusartikeln und zum Punktekonto des Benutzers führen.

- Wenn der Benutzer einen Artikel in den Warenkorb gelegt hat, werden die Bonuspunkte, die der Benutzer für den aktuellen Warenkorb bekommen würde, ebenfalls im Kopfbereich der Seite angezeigt:

- Für die Bonusartikel wurde ein neues Listing hinzugefügt, hier werden alle Bonusartikel, die im Backend definiert wurden, angezeigt. Wenn der Benutzer eingeloggt ist, werden die Punkte für den Artikel grün angezeigt sofern er bereits genügend Punkte gesammelt hat. Sollte der Benutzer noch nicht ausreichend Punkte für den Artikel besitzen, werden die restlichen benötigten Punkte in der darunter liegenden Zeile rot angezeigt.

- Damit der Benutzer auf der Detailseite eines Artikel sehen kann, wie viele Punkte er für den Artikel gut geschrieben bekommen würde, befindet sich unterhalb des "Kaufen"-Buttons ein neues Element zur Anzeige der gut zuschreibenden Punkte.

- Für die Unterscheidung, ob der Artikel für Bonuspunkte oder für Euro gekauft werden soll, wurden zwei Auswahlboxen oberhalb des "Kaufen"-Buttons hinzugefügt. Die hier angezeigten Preise/Punkte beziehen sich auf den Stückpreis.

- Wie im Header, werden auch im Warenkorb die für die Bestellung gut zu schreibenden Punkte über der Tabelle mit den Bestellpositionen angezeigt.

- Artikel die für Bonuspunkte gekauft wurden, werden hier mit einer besonderen Kennzeichnung angezeigt:

- Für die Verrechnung der Bonuspunkte in Euro wurde das jQuery UI eingebunden. Hierfür wird die Slider Komponente verwendet. Der Benutzer kann ganz einfach den Slider Regler von einer Seite zur anderen ziehen und so den Wert für die Verrechnung bestimmen:

- Wie bei den Bonusartikeln wird auch der Bonuspunkte Gutschein als Bestellposition aufgelistet und mit einer besonderen Kennzeichnung angezeigt:

- Unterhalb der Warenkorb Summe wurde ein neues Element hinzugefügt, welches zur Anzeige der ausgegebenen und gut zu schreibenden Punkte zuständig ist:

- Des Weiteren befindet sich unterhalb des „Zur Kasse gehen" Buttons ein weiterer Bonusartikel Slider, wie er auch auf der Startseite angezeigt wird. Hier kann der Kunde nochmals sehen, was er für die Bonuspunkte kaufen könnte.

- Sollten Sie Ihr Emailtemplate wie bei der Plugin Installation beschrieben angepasst haben, werden auch hier die Summen der Bonuspunkte angezeigt:

- Im „Mein Konto“-Bereich des Benutzers wurde ein weiterer Punkt hinzugefügt, „Mein Punktekonto“. Hier werden alle Bestellungen angezeigt, bei denen der Benutzer Punkte gesammelt oder ausgegeben hat.

- In dem Grid „Meine Bestellungen“ werden ebenfalls die Punkte für die Positionen dargestellt.

Bevor die Komponenten individuell ins Template eingebunden werden, sollte vorher eine Prüfung stattfinden, ob das Bonus System und die Bonusartikel aktiviert sind:

 
{if $sBonusSystem.settings.bonus_articles_active && $sBonusSystem.settings.display_article_slider==1}
    -- Gewünschte Komponente (siehe unten)
{/if}
 

Akkordeon:

 
{include file='frontend/plugins/swag_bonus_system/accordion/accordion.tpl'}
 

Artikel Slider mit Bonusartikeln:

 
{include file="frontend/plugins/swag_bonus_system/recommendation/slider.tpl"}
 

Die Gutscheine welche aus Bonuspunkten generiert wurden, werden auch im Backend Modul angezeigt. Mit Shopware 4 wird es eine Filtermöglichkeit geben diese Gutscheine auszublenden. Sollten Sie solange nicht warten können, bieten wir hier eine Möglichkeit zum Ausschließen dieser Gutscheine:

Öffnen Sie die Datei "engine/backend/modules/vouchers/ajax/getVouchers.php"

Folgende Zeilen sind hier zu editieren:

Zeile 40 von:

 
$sql_where = "WHERE id=".intval($_POST["feedID"]);
 

zu

 
$sql_where = "WHERE id=".intval($_POST["feedID"]) . " AND modus != 2 ";
 

und Zeile 52 bis 66 von:

 
   if ($_POST["search"]) {
      if (strlen($_POST["search"])>1){
         $search = "%".mysql_real_escape_string(utf8_decode($_POST["search"]))."%";
      }else {
         $search = mysql_real_escape_string(utf8_decode($_POST["search"]))."%";
      }
      $searchSQL = "
         WHERE
            description LIKE '$search'
         OR
            vouchercode LIKE '$search'
         OR
            value LIKE '$search'
         ";
   }
 

zu:

 
   if ($_POST["search"]) {
      if (strlen($_POST["search"])>1){
         $search = "%".mysql_real_escape_string(utf8_decode($_POST["search"]))."%";
      }else {
         $search = mysql_real_escape_string(utf8_decode($_POST["search"]))."%";
      }
      $searchSQL = "
         WHERE
            modus != 2
         AND (
            description LIKE '$search'
         OR
            vouchercode LIKE '$search'
         OR
            value LIKE '$search'
         )
      ";
   } else {
      $searchSQL = " WHERE modus != 2 ";
   }