yalst Live-Support-Tool - Live-Support, Webcontrolling und E-Marketing - Support - Einbindung Shop-Systeme

Dokumentation

Einbindungsbsp.

Einbindung Shop-Systeme

Videos

Updateanltg.

Dokumente: Handbuch | Installation

Startseite > Support > yalst-Einbindung in Shop-Systeme >
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.

osCommerce Logo

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.

  // yalst Definitionen
  define('YALST_DOMAIN','rd.livesupportserver.de');
  define('YALST_DIR','yalst');
  define('YALST_SITE','27000-1');

?>

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.

<?php

  // übergibt den Namen eines angemeldeten Besuchers an die folgenden Funktionen
  function yalst_customer_name() {
    global $customer_id;
    if (tep_session_is_registered('customer_id')) {
      $customer_query = tep_db_query("select customers_firstname, customers_lastname from " . TABLE_CUSTOMERS . " where customers_id = '" . (int)$customer_id . "'");
      $customer = tep_db_fetch_array($customer_query);
      $yalst_full_name = $customer['customers_firstname'] . ' ' . $customer['customers_lastname'];
     } else {
       $yalst_full_name = '';
     }
     return $yalst_full_name;
  }

  // gibt Namen und Kundennummer für das yalst-Tracking und die Operator-Konsole aus
  function tep_customer_yalst() {
    global $customer_id;
    if (tep_not_null(yalst_customer_name())) {
      $customer_yalst_string ='<script language="JavaScript">'."\n";
      $customer_yalst_string .='<!--'."\n";
      $customer_yalst_string .='ytrack = new Array();'."\n";
      $customer_yalst_string .='ytrack["Name"]="'. yalst_customer_name() .'";'."\n";
      $customer_yalst_string .='ytrack["Kundennummer"]="'.tep_output_string_protected($customer_id).'";'."\n";
      $customer_yalst_string .='// -->'."\n";
      $customer_yalst_string .='</script>'."\n";
      $customer_yalst_string .='<script language="JavaScript">'."\n";
      $customer_yalst_string .='<!--'."\n";
      $customer_yalst_string .='var y_comment="'. yalst_customer_name() .' ('.tep_output_string_protected($customer_id).')";'."\n";
      $customer_yalst_string .='var y_remark = "'. yalst_customer_name() .' ('.tep_output_string_protected($customer_id).')";'."\n";
      $customer_yalst_string .='// -->'."\n";
      $customer_yalst_string .='</script>'."\n";
    } else {
      $customer_yalst_string = '';
    }
    return $customer_yalst_string;
  }

  // gibt den Namen eines angemeldeten Besuchers statt der IP im yalst-Besuchermonitor aus
  function tep_customer_yalst_show() {
    if (tep_not_null(yalst_customer_name())) {
      $customer_yalst_show ='&mstr='.str_replace(' ', '%20', yalst_customer_name());
    } else {
      $customer_yalst_show = '';
    }
    return $customer_yalst_show;
  }

  // gibt den Wert "true" zurück, wenn ein Operator online ist
  function yalst_operator_status(){
    $fd=@fopen('http://' . YALST_DOMAIN . '/' . YALST_DIR . '/online.php?site=' . YALST_SITE ,'r');
    if ($fd){
      $buffer=trim(fgets($fd,4096));
      @fclose($fd);
      if ($buffer==2)
        {return true;}
      else
        {return false;}
    }
    else{
      return false;
    }
  }

  // übergibt den Gesamtwarenwert zum Abschluss der Bestellung
  // (soll an dieser Stelle statt dem reinen Warenwert der gesamte Warenkorbwert inkl. Versand übergeben werden, ist class= 'ot_subtotal' gegen class= 'ot_total'auszutauschen!)
  function order_total_success($oid) {
    $ot_query = tep_db_query("select value from " . TABLE_ORDERS_TOTAL . " where orders_id = '" . (int)$oid . "' and class= 'ot_subtotal'");
    $ot = tep_db_fetch_array($ot_query);
    return $ot['value'];
  }

?>

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');

  include(DIR_WS_FUNCTIONS . 'yalst.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 //-->

  <script language="JavaScript">
  <!--
  <?php
  if (stristr($_SERVER['PHP_SELF'],'checkout_success.php')) {
    $yalstwarenkorb='y_cartcomplete=true;'."\n";
    $yalstwarenkorbtracking='<script language="JavaScript" src="http://' . YALST_DOMAIN . '/' . YALST_DIR . '/conversion.js.php?event=Verkauf&amp;ref=1&amp;volume=' . number_format(order_total_success($orders['orders_id']) , 2) . '&amp;tan=' . $orders['orders_id'] . '&amp;comment='.tep_output_string_protected($customer_first_name).'%20'.tep_output_string_protected($customer_last_name).'%20'.tep_output_string_protected($customer_id).'" type="text/javascript"></script>';
  }else{
    $yalstwarenkorb='y_cartitems='.$cart->count_contents().';'."\n";
    $yalstwarenkorb .='y_cartvalue='.$cart->show_total().';'."\n";
  }
  echo $yalstwarenkorb;
  ?>
  // -->
  </script>
  <?php echo $yalstwarenkorbtracking; ?>

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

  <?php
  $yalstwarenkorb_string = '';
  if ($cart->count_contents() > 0) {
    $yalstwarenkorb_string =  '<script language="JavaScript">'."\n";
    $yalstwarenkorb_string .= '<!--'."\n";
    $yalstwarenkorb_string .= 'y_track = new Array();'."\n";
    $yalstwarenkorb_string .= 'y_track[0]= new Array();'."\n";
    $yalstwarenkorb_string .= 'y_track[0][0]="' . BOX_HEADING_SHOPPING_CART . '";'."\n";
    $yalstwarenkorb_string .= 'y_track[0][1]="-";'."\n";
    $products = $cart->get_products();
    for ($i=0, $n=sizeof($products); $i<$n; $i++) {
      $j=$i+1;
      $yalstwarenkorb_string .= 'y_track['.$j.'] = new Array();'."\n";
      $yalstwarenkorb_string .= 'y_track['.$j.'][0]="' . BOX_HEADING_SHOPPING_CART . ' (' . $products[$i]['id'] . ')";'."\n";
      $yalstwarenkorb_string .= 'y_track['.$j.'][1]="';
      $yalstwarenkorb_string .= $products[$i]['quantity'] .' x ';
      $yalstwarenkorb_string .= $products[$i]['name'].'";'."\n";
    }
    $yalstwarenkorb_string .= '// -->'."\n";
    $yalstwarenkorb_string .= '</script>';
  }
 echo $yalstwarenkorb_string;
 ?>

<!-- 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>

<?php
  echo tep_customer_yalst();
  echo '<script language="JavaScript" src="http://' . YALST_DOMAIN . '/' . YALST_DIR . '/yalst.js.php?site=' . YALST_SITE . '&amp;button=no' . tep_customer_yalst_show() . '" type="text/javascript"></script>';
?>

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

RSS 2.0 Feed

nach oben


Startseite	Features	Kaufen oder Mieten	Editionen/Preise	Bestellen	Testen	Support	Kontakt
Changelog	Was ist yalst?	Voraussetzungen Kauflsg.	Preise der Kauflsg.	Mietlösung	Online-Demo	Dokumentation	AGB
Release Notes	Online-Beratung	Besonderheiten Kauflsg.	Preise der Mietlsg.	Kauflösung	Testzugang	Einbindungsbsp.	Datenschutz
Sitemap	Webcontrolling		Update-Preise	Enterprise-Mietlsg.	Trial-Version	Einbindg. in Shops	Impressum
	E-Marketing		Upgrade-Preise	Enterprise-Kauflsg.		Videoanleitungen	Newsletter
Blog	Featureübersicht			Free-Edition			Status
	Screenshots		Preisliste	Design-Paket		Benutzerhandbuch	Partnerprog.
Kundenb. Mietlsg.	Referenzen			Supporteinheiten		Installationsanltg.	Reseller
Kundenb. Kauflsg.						Updateanleitung
Kundenb. Rechnungen	Produktblatt