yalst-Einbindung in den OXID eshop 4

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, der Sprachdateien 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: 04.01.2010

config.inc.php

Diese Datei finden Sie im Hauptverzeichnis Ihrer OXID-Installation. Die Ergänzung ist ganz am Ende der Datei einzufügen.

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 (define('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).

Sprachdateien

Bitte passen Sie - im Falle eines deutsch-/englischsprachigen Shops - die Sprachdateien out/basic/de/cust_lang.php und out/basic/en/cust_lang.php wie folgt an (bei anderen Sprachkombinationen analog):

Ergänzt werden muß nur die Zeile, die mit 'YLANG' beginnt.

_footer.tpl

Diese Datei finden Sie im Verzeichnis out/basic/tpl/ Ihrer Oxid-Installation. Hier werden kurz vorm Dateiende einige Zeilen ergänzt:

  </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 entsprechend erweitert werden.

_left.tpl (oder _right.tpl)

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

[{if $oView->showLeftBasket()}]
    [{oxid_include_dynamic file="dyn/mini_basket.tpl" type="basket" testid="LeftBasket"}]
[{/if}]

[{include file="inc/infobox.tpl"}]

[{if $oxcmp_news && count($oxcmp_news) > 0}]
    [{include file="inc/cmp_news.tpl"}]
[{/if}]

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.

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

thankyou.tpl

Dieses Template (ebenfalls in out/basic/tpl zu finden) muß unmittelbar vor der letzten Zeile ergänzt werden:

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

[{include file="_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.

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).