yalst-Einbindung in den osCommerce-Shop

Für Ihren osCommerce-Shop haben wir auf dieser Seite alle Informationen zusammengestellt, um yalst optimal zu integrieren. Dabei haben wir großen Wert darauf gelegt, daß nur wenige Shop-Dateien geändert werden müssen. Für weitere Fragen steht Ihnen unser Produkt-Support selbstverständlich gerne zur Verfügung. Mit dem wachsenden Funktionsumfang von 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 angemeldet haben) Anzeige des Warenkorb-Inhalts mit Hilfe der yalst-Funktion "Tracking-Daten" Erfassung der Verkäufe und Umsätze (Conversion-Tracking) 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 osCommerce-Standardinstallation erstellt.

letzte Aktualisierung dieser Anleitung: 18.01.2009

configure.php

Diese Datei finden Sie in ..catalog/includes. Die Ergänzung ist ganz unten, kurz vor dem Dateiende.

  ?>

Hier werden Domain, Verzeichnis und Site Ihrer yalst-Installation einmal definiert. Diese Eckdaten stehen dann in allen Dateien 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).

yalst.php

Diese Datei muss in dem Verzeichnis ..catalog/includes/functions Ihrer osCommerce-Installation erstellt werden.

Die Funktionen in dieser Datei werden an verschiedenen Stellen in anderen Dateien benutzt.

application_top.php

Diese Datei finden Sie im Verzeichnis ..catalog/includes Ihrer osCommerce-Installation. Sie ist an dieser Stelle wie folgt zu ergänzen:

// define general functions used application-wide
require(DIR_WS_FUNCTIONS . 'general.php');
require(DIR_WS_FUNCTIONS . 'html_output.php');

shopping_cart.php

Diese Datei finden Sie im Verzeichnis ..catalog/includes/boxes Ihrer osCommerce-Installation. Hier werden am Anfang und kurz vorm Dateiende einige Zeilen ergänzt:

*/
?>
<!-- shopping_cart //-->

<tr>
<td>
<?php
  $info_box_contents = array();
  $info_box_contents[] = array('text' => BOX_HEADING_SHOPPING_CART);
  new infoBox($info_box_contents);
?>
</td>
</tr>

<!-- shopping_cart_eof //-->

Die Ergänzungen hier sind fürs Warenkorb-Monitoring und Tacking. Für den Warenkorbwert werden die Bruttopreise ausgelesen.

yalst.php

Diese Datei muß in dem Verzeichnis ..catalog/includes/boxes Ihrer osCommerce-Installation erstellt werden, wenn Sie in Ihrem Shop einen Chat-Button im der linken oder rechten Menüleiste als Box haben möchten.

german.php

Alle Haupt-Sprachdateien müssen um die Konstante "BOX_HEADING_YALST" ergänzt werden. Wir zeigen das hier am Beispiel der deutschen Sprachdatei "german.php".

Diese Datei finden Sie im Verzeichnis ..catalog/includes/languages Ihrer osCommerce-Installation. Hier wird die Boxüberschrift der yalst-Einbindung ergänzt:

column_right.php

Die Einbindung der yalst-Box in einer Seitenspalte zeigen wir hier am Beispiel der rechten Leiste "column_right.php".

Diese Datei finden Sie im Verzeichnis ..catalog/includes Ihrer osCommerce-Installation. Hier wird an einer Stelle Ihrer Wahl die Box eingestellt:

require(DIR_WS_BOXES . 'shopping_cart.php');

footer.php

Die abschliessende Einbindung zur Übermittlung der Daten an yalst erfolgt in dieser Datei. Sie ist im Verzeichnis ..catalog/includes Ihrer osCommerce-Installation zu finden. Hier werden ganz am Dateiende einige Zeilen ergänzt:

</table>

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