yalst-Einbindung in den OXID eshop 3

Als Partner der OXID eSales AG haben wir Ihnen auf dieser Seite alle Informationen zusammengestellt, um yalst optimal in Ihren OXID-Shop zu integrieren. Dabei haben wir großen Wert darauf gelegt, daß nur wenige Shop-Dateien (Templates) geändert werden müssen. Für weitere Fragen steht Ihnen unser Produkt-Support selbstverständlich gerne zur Verfügung. Mit dem wachsenden Funktionsumfang beider Software-Pakete (OXID eshop und yalst) wird diese Seite regelmäßig aktualisiert. Bitte schauen Sie also öfter mal vorbei! Die hier zusammengestellten Einbindungen bewirken (zusätzlich zu den ohnehin schon standardmäßig vorhandenen Funktionalitäten) im Einzelnen: Besucher-Monitoring mit Anzeige der Artikelzahl und des Warenwertes im Warenkorb direkt in der Operator-Konsole Anzeige des Kundennamens direkt im Besucher-Monitor (dazu muß sich der Kunde wenigstens einmal angemeldet haben) Anzeige des Warenkorb-Inhalts mit Hilfe der yalst-Funktion "Tracking-Daten" Erfassung der Verkäufe und Umsätze (Conversion-Tracking) Zur optimalen Einbindung schlagen wir die Ergänzung einer PHP-Datei und drei Template-Dateien (pro verwendeter Sprache) vor. Die entsprechenden Änderungen finden Sie in den Textboxen der folgenden Abschnitten. Für den Großteil der hier beschriebenen Einbindungen benötigen Sie die Professional-Edition von yalst, für die Warenkorb-Statistiken die Business-Edition. Diese Anleitung wurde auf Basis einer Oxid-Standardinstallation erstellt.

letzte Aktualisierung dieser Anleitung: 18.01.2009

ubase.php

Diese Datei finden Sie im Hauptverzeichnis Ihrer OXID-Installation. Die Ergänzung ist ganz unten, kurz vor dem Dateiende.

function init()
  {
  if( !$this->blCommonAdded)
    {  // as the objects are cached by dispatcher we have to watch out, that we don't add
       // these components twice
    $this->aComponentNames = array_merge( $this->aComponentNames, $this->aUserComponents);
    }
  parent::init();

  }

Hier werden Domain, Verzeichnis und Site Ihrer yalst-Installation einmal definiert. Diese Eckdaten stehen dann in allen Templates zur Verfügung. Das hat den Vorteil, daß bei Verwendung eines anderen yalst-Servers (z.B. bei einem Wechsel von der Miet- zur Kauflösung) die Informationen hier nur einmal zentral geändert werden müssen. Außerdem können Sie auf diese Weise die u.g. Template-Ergänzungen ohne Änderungen übernehmen.

In Zeile 1 ($this->aViewData['yalst_domain']...) wird die Domain Ihres yalst-Servers eingetragen. Bei Mietlösungen ist dies "rd.livesupportserver.de", bei Kauflösungen hängt der Wert davon ab, wo Sie yalst installiert haben. In Zeile 2 wird - bis auf ganz wenige Ausnahmen - immer "yalst" eingetragen. Zeile 3 definiert die Site-Nummer Ihres yalst-Pakets. Bei Mietlösungen erfahren Sie diese Nummer aus unserem Kundenbereich, bei Kauflösungen lautet sie - bei einer Lizenz - immer "1-1" (bei mehreren Lizenzen ergibt sie sich aus dem yalst-Kundenbereich der jeweiligen Installation).

inc_footer.tpl

Diese Datei finden Sie im Verzeichnis out/oxbaseshop/html/0/templates Ihrer Oxid-Installation. Auch hier werden kurz vorm Dateiende einige Zeilen ergänzt:

    </div>
    [{if $fixedwidth}]
      </div>
    [{/if}]

  </body>
</html>

Die Ergänzungen hier sind fürs Besucher- und Warenkorb-Monitoring. Bitte beachten Sie die zwei alternativen Code-Blöcke zum Warenkorb-Monitoring je nach yalst-Version und Edition. Für den Warenkorbwert werden die Nettopreise ausgelesen. Falls Sie lieber Bruttopreise erfassen möchten, müssen Sie im Code "fproductsnetprice" durch "fproductsprice" ersetzen (kommt 2x vor). Bei einem mehrsprachigen Shop müßten auch die Template-Dateien für die weiteren Sprachen - für Englisch z.B. /oxbaseshop/html/1/templates/inc_footer.tpl - entsprechend erweitert werden.

inc_leftitem.tpl (oder inc_rightitem.tpl)

Auch diese Datei finden Sie im Verzeichnis out/oxbaseshop/html/0/templates Ihrer Oxid-Installation. Unsere Ergänzung muß diesmal ziemlich in der Mitte der Datei vorgenommen werden:

[{ if $bl_perfLoadCurrency && $bl_perfShowLeftBasket}]
  <div class="boxleft">Währung</div>
  <div class="boxleft-content">
  [{include file="inc_cmp_cur.tpl" }]
  </div>
[{/if }]
<div class="boxleft">Informationen</div>
<div class="boxleft-content">
  [{include file="inc_infobox.tpl"}]
</div>

<:!-- ox_mod05 inc_leftitem -->
<!-- ox_mod06 inc_leftitem -->

Diese Ergänzung sorgt für einen Chat-Button am linken Rand unterhalb von "Information". Bitte wählen Sie nach Möglichkeit einen Button mit einer Breite von 180 Pixeln. Für evtl. englischsprachige Seiten können direkt die englischen yalst-Fenster verlinkt werden (dazu muß zusätzlich im yalst-Kundenbereich die Option unter "Einstellungen" aktiviert werden). Hierzu wird der Einbindungscode (dann in out/oxbaseshop/html/1/templates/inc_leftitem.tpl) um einen Parameter ergänzt:

Wenn Sie Ihren Chat-Button am rechten Rand plazieren möchten, ist die Template-Datei inc_rightitem.tpl entsprechend anzupassen (gleiches Verzeichnis).

thankyou.tpl (oder laststep.tpl)

Dieses Template muß unmittelbar vor der letzten Zeile ergänzt werden:

[{ insert name="oxid_tracker" title=$template_title }]

[{include file="inc_footer.tpl"}]

Damit kann yalst Ihre Shop-Verkäufe erfassen (Conversion-Tracking). Für den Bestellwert wird der Nettopreis ausgelesen. Falls Sie lieber den Bruttopreis erfassen möchten, müssen Sie im Code "dproductsnetprice" durch "dproductsprice" ersetzen. Gleichzeitig wird das Warenkorb-Monitoring erfolgreich abgeschlossen. Wenn Sie die 5-Schritt-Bestellung verwenden, müssen Sie statt der thankyou.tpl die Datei laststep.tpl ergänzen.

Hinweis für https-Seiten

Wenn es in Ihrem Shop Seiten gibt, die über SSL-Verschlüsselung abgerufen werden (https-Seiten), sollten Sie yalst mit SSL-Unterstützung verwenden, damit es keine Sicherheitswarnungen in den Webbrowsern der Besucher gibt. Diese ist ab der Basic-Edition verfügbar, bei der Kauflösung kann die SSL-Unterstützung bei der Installation (oder auch nachträglich, s. Installationsanleitung) konfiguriert werden (Domain, die per https erreichbar ist, oder SSL-Proxy erforderlich). Zur Einbindung können Sie in obenstehenden HTML-Codes alle "http://" durch "https://" ersetzen (bei Verwendung eines sogenannten SSL-Proxys muß die entsprechende Proxy-URL angegeben werden).