Integration Guide - Trusted Shops

TRUSTED SHOPS KUNDENBEWERTUNG FÜR OSCOMMERCE 

Integration Guide 

14. Juli 2010 

© 2010 Trusted Shops GmbH

Trusted Shops Kundenbewertung in osCommerce Version 1.0 

Trusted Shops Kundenbewertung 

Das Trusted Shops Kundenbewertungssystem stellt eine effektive Bewertungsfunktion eines 

Online-Shops für den Verbraucher dar. Im Anschluss an jede Bestellung haben Online-Käufer 

über ein Bewertungsformular die Möglichkeit, den Online-Shop zu bewerten. Durch diese 

überprüfbaren Bewertungen bekommen Shopbetreiber einen Einblick in das, was die Kunden 

wirklich von Ihrem Online-Shop halten und wie zufrieden sie mit dem Einkaufserlebnis waren. 

Abb 1: Beispiel: Integriertes Bewertungs-Widget 

Zusätzlich bekommt der Online-Shop die Möglichkeit seine Bewertungsergebnisse öffentlich 

darzustellen. Dies geschieht zum einen durch die Anzeige eines Bewertungs-Widgets direkt im 

Online-Shop, welches die Gesamtnote erhaltener Bewertungen ausdrückt. Dieses Widget ist 

direkt mit einem öffentlichen Bewertungsprofil verlinkt, welches erhaltene Bewertungen in 

übersichtlicher Form darstellt. Mit folgender Anleitung können Sie Ihren Shop mit den 

notwendigen Funktionalitäten zum Einholen und Anzeigen der der Kundenbewertungen 

ausstatten. 

Registrierung bei Trusted Shops 

Unter 

https://www.trustedshops.de/shopbetreiber/kundenbewertung_anmeldung.html?shopsw=OSCO 

MMERCE können Sie neben einem kostenlosen Start-Paket zum Bewertungen einholen, auch 

das Pro-Paket zum Anzeigen dieser Bewertungen bestellen. Nach Absenden des Formulars, 

erhalten Sie eine Bestätigungsmail in der Sie nur noch auf den Aktivierungslink klicken, um Ihre 

E-Mail Adresse zu bestätigen. Nach kurzer Prüfung der Daten seitens Trusted Shops erhalten Sie 

dann die Trusted Shops ID für das Kundenbewertungssystem per E-Mail. 

©2010 Trusted Shops GmbH 2


Abb 2: Beispiel: Trusted Shops Bestellformular 

Anleitung zur Integration des Moduls 

Das Online-Shop-System osCommerce enthält keine Funktionen zum automatischen Einspielen 

von Erweiterungen. Daher sind zur Integration geringe Kenntnisse in den Bereichen PHP und 

MySql notwendig. 

Insbesondere ist zu beachten, dass alle Zeilenangaben in dieser Dokumentation einer neuen 

Installation des osCommerce Shops ohne jegliche Anpassungen entsprechen. Dies bedeutet, dass 

bei einem individuell angepassten osCommerce alle Angaben zu überprüfen und ggf. anzupassen 

sind. Weiterhin ist in diesem Fall die Kompatibilität mit anderen durchgeführten Änderungen zu 

überprüfen. 

Aus oben genannten Gründen wird eine vorherige Integration in einen Test-Shop empfohlen. 

Die Integration besteht aus folgenden Teilschritten: 

• Einspielen neuer Dateien in den Online-Shop 

• Änderungen an der Datenbank im Online-Shop 

• Änderung bestehender Dateien im Online-Shop 

• Konfiguration der Kundenbewertung im Administrationsbereich des Online-Shops 

Systemvoraussetzungen 

• PHP mindestens in Version 5.1.6 inklusive Extension SOAP 

• osCommerce in Version 2.2 RC 2a 

• Zugriff auf 



o Die Dateien des Online-Shops 

o Den Administrationsbereich des Online-Shops 

o Die MySql-Datenbank des Online-Shops (phpMyAdmin) 

Einspielen neuer Dateien 

Folgende Dateien sind neu und können durch kopieren in den Online-Shop eingefügt werden. 

Dazu nehmen Sie öffnen Sie einfach den Ordner „Neue Dateien“ und kopieren den gesamten 

Inhalt in Ihr osCommerce-Verzeichnis, somit werden die neuen Dateien automatisch an die 

richtigen Stellen ergänzt. 

• admin\ts_rating.php 

• admin\includes\functions\ts_rating.php 

• admin\includes\languages\english\ts_rating.php 

• admin\includes\languages\espanol\ts_rating.php 

• admin\includes\languages\german\ts_rating.php 

• includes\boxes\ts_rating_button.php 

• includes\boxes\ts_rating_widget.php 

• includes\functions\ts_rating.php 

Änderungen an der Datenbank 

Folgende SQL-Statements müssen auf der Datenbank ausgeführt werden. Am einfachsten kann 

dies über das MySQL-Webtool PHPmyAdmin erfolgen. 

Tabellenstruktur für Tabelle `ts_rating` 

CREATE TABLE `ts_rating` ( 

ìd` varchar( 16 ) NOT NULL default 'default', 

`tsid_de` varchar( 33 ) NOT NULL , 

`tsid_de_enabled` tinyint( 1 ) NOT NULL , 

`tsid_en` varchar( 33 ) NOT NULL , 

`tsid_en_enabled` tinyint( 1 ) NOT NULL , 

`tsid_fr` varchar( 33 ) NOT NULL , 

`tsid_fr_enabled` tinyint( 1 ) NOT NULL , 

`tsid_es` varchar( 33 ) NOT NULL , 

`tsid_es_enabled` tinyint( 1 ) NOT NULL , 

`tsid_pl` varchar( 33 ) NOT NULL , 

`tsid_pl_enabled` tinyint( 1 ) NOT NULL , 

`ts_widget` tinyint( 1 ) NOT NULL , 

`ts_button` tinyint( 1 ) NOT NULL , 

`ts_button_checkout` tinyint( 1 ) NOT NULL , 

`ts_mail` tinyint( 1 ) NOT NULL , 

PRIMARY KEY ( ìd` ) 

) ENGINE = MYISAM DEFAULT CHARSET = latin1; 

Daten für Tabelle `ts_rating` 

INSERT INTO `ts_rating` 

(ìd`,`tsid_de`,`tsid_de_enabled`,`tsid_en`,`tsid_en_enabled`,`tsid_fr`,`tsid_fr_enabled`,`tsid_es`,`tsid_es_enabled`,`tsi 

VALUES 

('default','',0,'',0,'',0,'',0,'',0,0,0,0,0); 



Änderung bestehender Dateien 

Folgende Dateien sind bereits im Online-Shop vorhanden und müssen angepasst werden. 

Dabei ist der grau markierte Teil jeweils der bereits standardmäßig im Online-Shop vorhandene 

Quellcode, der schwarze Teil der zu ergänzende Quellcode. 

checkout_process.php: Ab Zeile 262 

for ($i=0, $n=sizeof($order_totals); $icontent_type != 'virtual') { 

$email_order .= "\n" . EMAIL_TEXT_DELIVERY_ADDRESS . "\n" . 

EMAIL_SEPARATOR . "\n" . 

tep_address_label($customer_id, $sendto, 0, '', "\n") . "\n"; 

} 

checkout_success.php: Ab Zeile 109 

 

 

 

 

 

if (TS_SHOW_RATING_BUTTON_CHECKOUT) { 

 

 

 

 

 

 

getTSRatingButtonOrder($customer_id, $ts_rating_button_dest_url, 

$ts_rating_button_img); 

echo ' 

 

'; 

} 

 

 

 

admin/includes/configure.php: Am Ende der Datei vor ?> ergänzen: 

define('TS_RATING_QA', false); 

admin/includes/filenames.php: Am Ende der Datei vor ?> ergänzen: 

define('FILENAME_TS_RATING', 'ts_rating.php'); 

admin\includes\boxes/modules.php: Ab Zeile 23 

$contents[] = array('text' => 

'' . 



BOX_MODULES_PAYMENT . '' . 

'' . 

BOX_MODULES_SHIPPING . '' . 

'' 

. BOX_MODULES_ORDER_TOTAL . '' . 

'' . 

BOX_MODULES_TS_RATING . ''); 

admin\includes\languages\english.php: Ab Zeile 69 

define('BOX_MODULES_ORDER_TOTAL', 'Order Total'); 

define('BOX_MODULES_TS_RATING', 'Trusted Shops Customer Ratings'); 

// categories box text in includes/boxes/catalog.php 

admin\includes\languages\espanol.php: Ab Zeile 69 


define('BOX_MODULES_TS_RATING', 'Trusted Shops Customer Ratings'); 


admin\includes\languages\german.php: Ab Zeile 69 


define('BOX_MODULES_TS_RATING', 'Trusted Shops Kundenbewertung'); 


includes\application_top.php: Ab Zeile 69 

// set the application parameters 

$configuration_query = tep_db_query('select configuration_key as cfgKey, configuration_value as cfgValue 

from ' . TABLE_CONFIGURATION); 

while ($configuration = tep_db_fetch_array($configuration_query)) { 

define($configuration['cfgKey'], $configuration['cfgValue']); 

} 

$ts_query = tep_db_query('SELECT tsid_de, tsid_de_enabled, tsid_en, tsid_en_enabled, tsid_fr, 

tsid_fr_enabled, tsid_es, tsid_es_enabled FROM ts_rating WHERE id = \'default\''); 

$ts = tep_db_fetch_array($ts_query); 

define('TS_RATING_ID_DE', $ts['tsid_de']); 

define('TS_RATING_ID_EN', $ts['tsid_en']); 

define('TS_RATING_ID_FR', $ts['tsid_fr']); 

define('TS_RATING_ID_ES', $ts['tsid_es']); 

define('TS_RATING_ID_DE_ENABLED', $ts['tsid_de']); 

define('TS_RATING_ID_EN_ENABLED', $ts['tsid_en']); 

define('TS_RATING_ID_FR_ENABLED', $ts['tsid_fr']); 

define('TS_RATING_ID_ES_ENABLED', $ts['tsid_es']); 

// if gzip_compression is enabled, start to buffer the output 

includes\application_top.php: Ab Zeile 433 

// split-page-results 

require(DIR_WS_CLASSES . 'split_page_results.php'); 

//ts_rating 

require(DIR_WS_FUNCTIONS . 'ts_rating.php'); 

// infobox 

require(DIR_WS_CLASSES . 'boxes.php'); 

includes\column_right.php: Ab Zeile 35 

if (isset($HTTP_GET_VARS['products_id'])) { 

if (basename($PHP_SELF) != FILENAME_TELL_A_FRIEND) include(DIR_WS_BOXES . 'tell_a_friend.php'); 

} else { 

include(DIR_WS_BOXES . 'specials.php'); 



} 

if (TS_SHOW_RATING_WIDGET) { 

require(DIR_WS_BOXES . 'ts_rating_widget.php'); 

} 

if (TS_SHOW_RATING_BUTTON) { 

require(DIR_WS_BOXES . 'ts_rating_button.php'); 

} 

require(DIR_WS_BOXES . 'reviews.php'); 

includes\configure.php: Am Ende der Datei vor ?> ergänzen: 

define('TS_RATING_QA', false); 

includes\languages\english.php: Ab Zeile 131 

define('BOX_TELL_A_FRIEND_TEXT', 'Tell someone you know about this product.'); 

define('BOX_HEADING_TS_RATING_WIDGET', 'Trusted Shops Customer Ratings'); 

define('TS_RATING_WIDGET_PATH', 'https://www.trustedshops.com/bewertung/widget/widgets/'); 

define('TS_RATING_WIDGET_PATH_QA', 'https://qa.trustedshops.com/bewertung/widget/widgets/'); 

define('TS_RATING_WIDGET_DEST_URL', 'https://www.trustedshops.com/buyerrating/info_'); 

define('TS_RATING_WIDGET_DEST_URL_QA', 'https://qa.trustedshops.com/buyerrating/info_'); 

define('TS_RATING_WIDGET_IMG_ALT', 'Customer Ratings of ' . STORE_NAME); 

define('TS_RATING_WIDGET_HREF_TITLE', 'Shop customer Ratings of ' . STORE_NAME); 

define('BOX_HEADING_TS_RATING_BUTTON', 'Rate now'); 

define('TS_RATING_BUTTON_IMG', 'https://www.trustedshops.com/bewertung/widget/img/bewerten_en.gif'); 

define('TS_RATING_BUTTON_DEST_URL', 'https://www.trustedshops.com/buyerrating/rate_'); 

define('TS_RATING_BUTTON_DEST_URL_QA', 'https://qa.trustedshops.com/buyerrating/rate_'); 

define('TS_RATING_BUTTON_IMG_ALT', 'Customer Ratings of ' . STORE_NAME); 

define('TS_RATING_BUTTON_HREF_TITLE', 'Shop customer Ratings of ' . STORE_NAME); 

define('BOX_HEADING_TS_RATING_BUTTON', 'Rate now'); 

define('TS_RATING_BUTTON_IMG', 'https://www.trustedshops.com/bewertung/widget/img/bewerten_en.gif'); 

define('TS_RATING_BUTTON_DEST_URL', 'https://www.trustedshops.com/buyerrating/rate_'); 

define('TS_RATING_BUTTON_DEST_URL_QA', 'https://qa.trustedshops.com/buyerrating/rate_'); 

define('TS_RATING_BUTTON_IMG_ALT', 'Customer Ratings of ' . STORE_NAME); 

define('TS_RATING_BUTTON_HREF_TITLE', 'Shop customer Ratings of ' . STORE_NAME); 

define('TS_RATING_BUTTON_TEXT_TOP', 'We strive to constantly improve the quality of our service. We would 

be very thankful if you could take a few seconds to rate our shop. Please use the following authorized 

link: '); 

// checkout procedure text 

includes\languages\german.php: Ab Zeile 131 

define('BOX_TELL_A_FRIEND_TEXT', 'Tell someone you know about this product.'); 

define('BOX_HEADING_TS_RATING_WIDGET', 'Trusted Shops Kundenbewertung'); 

define('TS_RATING_WIDGET_PATH', 'https://www.trustedshops.com/bewertung/widget/widgets/'); 

define('TS_RATING_WIDGET_PATH_QA', 'https://qa.trustedshops.com/bewertung/widget/widgets/'); 

define('TS_RATING_WIDGET_DEST_URL', 'https://www.trustedshops.com/bewertung/info_'); 

define('TS_RATING_WIDGET_DEST_URL_QA', 'https://qa.trustedshops.com/bewertung/info_'); 

define('TS_RATING_WIDGET_IMG_ALT', 'Kundenbewertungen von ' . STORE_NAME); 

define('TS_RATING_WIDGET_HREF_TITLE', 'Kundenbewertungen von ' . STORE_NAME . ' einsehen'); 

define('BOX_HEADING_TS_RATING_BUTTON', 'Shop jetzt bewerten'); 

define('TS_RATING_BUTTON_IMG', 'https://www.trustedshops.com/bewertung/widget/img/bewerten_de.gif'); 

define('TS_RATING_BUTTON_DEST_URL', 'https://www.trustedshops.com/bewertung/bewerten_'); 

define('TS_RATING_BUTTON_DEST_URL_QA', 'https://qa.trustedshops.com/bewertung/bewerten_'); 

define('TS_RATING_BUTTON_IMG_ALT', 'Kundenbewertungen von ' . STORE_NAME); 

define('TS_RATING_BUTTON_HREF_TITLE', 'Kundenbewertungen von ' . STORE_NAME . ' einsehen'); 

define('TS_RATING_BUTTON_TEXT_TOP', 'Wir bemühen uns stets, unseren Service zu verbessern und die Qualität 

unserer Dienstleistung zu verbessern. Deshalb würden wir uns freuen, wenn Sie sich ein paar Sekunden Zeit 

nehmen, um unseren Shop zu bewerten. Rufen Sie dazu bitte diesen autorisierten Link auf: '); 

// checkout procedure text 

includes\languages\german\checkout_process.php: Am Ende der Datei vor ?> ergänzen: 

define('TS_RATING_EMAIL', 'Bewerten Sie diese Bestellung'); 



includes\languages\german\checkout_success.php: Am Ende der Datei vor ?> ergänzen: 

define('TS_RATING_BUTTON_CHECKOUT_IMG_ALT', 'Bewerten Sie unseren Shop!'); 

define('TS_RATING_BUTTON_CHECKOUT_HREF_TITLE', 'Shop-Bewertung'); 

Konfiguration der Kundenbewertung im Administrationsbereich 

Nach der Anmeldung bei Trusted Shops, sowie der erfolgreichen Integration in die Quellcodes 

des Online-Shops muss die Funktionalität der Trusted Shops Kundenbewertung noch in der 

osCommerce Shopadmin aktiviert werden. 

Abb 3: Navigation in osCommerce Backend. Rot marktiert der Punkt “Trusted Shops Kundenbewertung” 

1. Links in der Hauptnavigation finden Sie unter dem Punkt „Module“ nun einen Link zu 

„Trusted Shops Kundenbewertung“. Nach Klick auf diesen Link gelangen Sie in die 

Konfigurationsmaske, um die Kundenbewertungen zu aktivieren. 



Abb 4: Konfigurationsmaske im osCommerce Backend. 

2. Nach einer kurzen Vorstellung der Funktionsweise und Vorteile der Trusted Shops 

Kundenbewertung finden Sie einen Link „Jetzt kostenlos registrieren“, der Sie nochmals 

auf die Trusted Shops Übersichtsseite führt, wo Sie sich für das System registrieren 

können, falls noch nicht geschehen. 

3. Nach Registrierung erhalten Sie Ihre individuelle Trusted Shops ID pro Sprache per 

Email zugesendet. Diese Trusted Shops ID tragen Sie in das dafür vorgesehene 

Eingabefeld der jeweiligen Sprache ein und klicken anschließend auf „Aktivieren“. 

4. In dem darunter liegenden Abschnitt finden Sie 4 Checkboxen, welche die Anzeige der 

einzelnen Komponenten für alle aktivierten Sprachen bestimmen. 

a. Anzeige des Widgets: Bestimmt, ob das Bewertungswidget direkt prominent im 

Shop in der Seitenleiste angezeigt werden soll. Dies ist zu empfehlen, um mit den 

erhaltenen Kundenbewertungen werben zu können. 

b. Anzeige des Buttons: Der „Bewerten Sie uns“-Button ermöglicht das Einholen 

von Kundenfeedback direkt im Shop. So erhalten Sie jede Menge Feedback, 

welches wiederum zur Shop-Optimierung verwendet werden kann. 



c. Anzeige des Buttons nach dem Checkout: Diese Einstellung ist ebenfalls zu 

empfehlen. Sie bewirkt, dass auf der Bestellbestätigungsseite der „Bewerten Sie 

uns“-Button angezeigt wird, um direkt eine Bewertung zu erhalten. 

d. Anzeige in E-Mail: Diese Einstellung ist ebenfalls zu empfehlen. Sie bewirkt, 

dass in der Bestellbestätigungsmail der „Bewerten Sie uns“-Button angezeigt 

wird, um direkt eine Bewertung zu erhalten. 

Nachdem nun alle Einstellungen vorgenommen wurden sollte die Funktionalität überprüft 

werden. 

Checkliste 

Allgemein 

Sind bei Trusted Shops für die Kundenbewertung registriert und haben Ihre persönliche Trusted 

Shops-Id per E-Mail erhalten? 

Haben Sie Ihre Trusted Shops-ID im osCommerce Backoffice eingegeben und aktiviert? 

Haben Sie die Konfigurationen vorgenommen, so dass die Komponenten Bewertungswidget und 

Bewertungsbuttons angezeigt werden können? 

Bewertungs-Widget 

Wird das Widget korrekt im Shop angezeigt? 

Gelangen Sie per Klick auf das Widget unmittelbar auf das Bewertungsprofils Ihres Online-Shops? 

Button zur Bewertungsaufforderung 

Gelangen Sie beim Klick auf den Button auf das Bewertungsformular Ihres Shops? 

Werden die Werte für die Bestellnummer und Käufer-Email Adresse direkt im Bewertungsformular 

angezeigt? Machen Sie eine Testbestellung und schauen sich auch die Bestellbestätigungs-Email an. 



Wie sieht das Bewertungsprofil aus? 

Klicken Sie auf das Bewertungs-Widget in Ihrem Shop, um das öffentliche Bewertungsprofil 

aufzurufen. Hier erhalten Ihre Besucher einen Überblick über erhaltene Bewertungen. 

Wie sieht das Bewertungsformular aus? 

Das öffentliche Bewertungsformular setzt sich aus den Bewertungskriterien Website, Lieferung, 

Ware und Kundenservice sowie einem Kommentar zusammen. Zur Verifizierung werden vom 

Shopsystem die Parameter Käufer-E-Mail und Bestellnummer direkt an das Formular übergeben. 



Support 

Viele Fragen und Antworten finden Sie auch in de FAQs unter: 

http://www.trustedshops.de/shop-info/faq-haufige-fragen-zu-den-trusted-shopskundenbewertungen/ 

Bei Fragen zur Implementierung von Trusted Shops Kundenbewertung in Ihren Shop, 

kontaktieren Sie bitte unseren Kundenservice: 

Trusted Shops GmbH 

Tel: +49 221 775 36 87 

E-Mail: service@trustedshops.de

Integration Guide - Trusted Shops

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?