Shopgate unterstützt xt:Commerce als Shopsystem.

Nach Einrichtung des Shopgate-Plugins für Ihren "xt:Commerce 3"-Shop, können Sie von einer Reihe an Features profitieren:

Shopgate-Plugin installieren

Das Shopgate-Plugin für xt:Commerce 3 kann ab der Version 3.0.4. installiert werden. Laden Sie hierfür Ihr Plugin einfach auf Ihren xt:Commerce-3-Server und aktivieren Sie es in Ihrem xt:Commerce-3-Backend. 

Plugin herunterladen

Sie können das Plugin über diesen Link herunterladen: http://files.shopgate.com/plugins/xtcommerce3.zip.
Anschließend extrahieren Sie die Zip-Datei in 4 Ordner: "admin", "includes", "lang" und "shopgate".

Plugin auf Ihren Server laden

Nutzen Sie ein FTP-Programm, wie etwa FileZilla, um das Plugin auf Ihren xt:Commerce-Server zu übertragen.

Verbinden Sie das FTP-Programm mit Ihrem Server.

1. Auf der linken Seite sehen Sie Ihren lokalen Rechner, auf der rechten Seite Ihre Server-Verzeichnis-Struktur. Verschieben Sie die extrahierten Plugin-Ordner in den Stammordner Ihres Shops.
2. Bestätigen Sie, dass bestehende Dateien überschrieben werden können, sollte das Programm danach fragen.

Einstellungen der Datei-Zugriffsberechtigungen

Es ist notwendig, dass Sie die Zugriffsrechte für die Dateiordner "temp" und "config" einrichten bzw. festlegen.

1. Wechseln Sie in das Verzeichnis "shopgate/shopgate_library" und markieren Sie die Ordner "temp" und "config". Mit einem Rechtsklick auf die markierten Order öffnen Sie das Kontextmenü in FileZilla. Dort finden Sie den Menüpunkt "Dateiberechtigungen".
2. Im Eingabefeld unten in der Maske tragen Sie "774"* ein. Außerdem muss der Haken bei Änderungen auf "alle Unterordner und Dateien" gesetzt werden.
   *Wenn sich Ihre Einstellungen bzw. Änderungen nicht speichern lassen, definieren Sie bitte die Zugriffsrechte mit dem Wert "777". 
   

Code anpassen

Damit das Shopgate-Plugin in Ihrem xt:Commerce-System installiert werden kann, müssen zunächst einige Shop-Dateien manuell angepasst werden.

Bearbeiten Sie bitte alle Dateien, die unten aufgeführt sind. Kopieren Sie den markierten Code und geben Sie ihn in die entsprechende Zeile in Ihrer Datei ein. Die Zeilennummerierung im folgenden Code-Abschnitt verweisen auf eine nicht bearbeitete Dateiversion. Wenn Sie Ihre Dateien bereits bearbeitet haben, können die Nummerierungen abweichen. Nur die hervorgehobenen Abschnitte müssen in die Dateien übernommen werden.

Die Pfade stehen in Relation zum Hauptordner Ihres Shops. Haben Sie beispielsweise Ihren xt:Commerce Shop unter /public_html/catalog/ installiert, verweist der Pfad includes/filenames.php auf /public_html/catalog/includes/filename.php.

In dieser Anleitung wird der Standard-Name "admin" für den Ordner im Stammverzeichnis verwendet.

define('TXT_GROUPS','Gruppen:');
define('TXT_SYSTEM','System');
define('TXT_CUSTOMERS','Kunden/Bestellungen');
define('TXT_PRODUCTS','Artikel/Kategorien');
define('TXT_STATISTICS','Statistiktools');
define('TXT_TOOLS','Zusatzprogramme');
define('TEXT_ACCOUNTING','Zugriffseinstellungen für:');
/******* SHOPGATE **********/
include_once rtrim(DIR_FS_CATALOG,"/").'/shopgate/base/lang/german/admin/german.php';
/******* SHOPGATE **********/
//Dividers text for menu
define('BOX_HEADING_MODULES','Module');
define('BOX_HEADING_LOCALIZATION','Sprachen/Währungen');
define('BOX_HEADING_TEMPLATES','Templates');
define('BOX_HEADING_TOOLS','Hilfsprogramme');
define('BOX_HEADING_LOCATION_AND_TAXES','Land / Steuer');
define('BOX_HEADING_CUSTOMERS','Kunden');
define('BOX_HEADING_CATALOG','Katalog');
define('BOX_MODULE_NEWSLETTER','Rundschreiben');

define('TXT_GROUPS','Groups:');
define('TXT_SYSTEM','System');
define('TXT_CUSTOMERS','Customers/Orders');
define('TXT_PRODUCTS','Products/Categories');
define('TXT_STATISTICS','Statistics');
define('TXT_TOOLS','Tools');
define('TEXT_ACCOUNTING','Admin-access for:');
/******* SHOPGATE **********/
include_once rtrim(DIR_FS_CATALOG,"/").'/shopgate/base/lang/english/admin/english.php';
/******* SHOPGATE **********/
//Dividers text for menu
define('BOX_HEADING_MODULES', 'Modules');
define('BOX_HEADING_LOCALIZATION', 'Languages/Currencies');
define('BOX_HEADING_TEMPLATES','Templates');
define('BOX_HEADING_TOOLS', 'Tools');
define('BOX_HEADING_LOCATION_AND_TAXES', 'Location / Tax');
define('BOX_HEADING_CUSTOMERS', 'Customers');
define('BOX_HEADING_CATALOG', 'Catalog');
define('BOX_MODULE_NEWSLETTER','Newsletter');

define('TABLE_COUPON_GV_CUSTOMER','coupon_gv_customer');
define('TABLE_COUPON_GV_QUEUE','coupon_gv_queue');
define('TABLE_COUPON_REDEEM_TRACK','coupon_redeem_track');
define('TABLE_COUPON_EMAIL_TRACK','coupon_email_track'); 
define('TABLE_COUPONS','coupons');
define('TABLE_COUPONS_DESCRIPTION','coupons_description');
define('TABLE_BLACKLIST','card_blacklist');
define('TABLE_CAMPAIGNS_IP','campaigns_ip');
/******** SHOPGATE **********/
define('TABLE_SHOPGATE_ORDERS','orders_shopgate_order');
/******** SHOPGATE **********/
?>

               if($order_updated){
                      /******* SHOPGATE **********/
                      include_once rtrim(DIR_FS_CATALOG,"/").'/shopgate/base/admin/orders.php';
                      setShopgateOrderStatus($oID,$status);
                      /******* SHOPGATE **********/
                      $messageStack->add_session(SUCCESS_ORDER_UPDATED,'success');
              }else{
                      $messageStack->add_session(WARNING_ORDER_NOT_UPDATED,'warning');
              }

 if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['whos_online'] == '1')) echo '<a href="' .xtc_href_link(FILENAME_WHOS_ONLINE) . '" class="menuBoxContentLink"> -' . BOX_WHOS_ONLINE . '</a><br>';
 if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['csv_backend'] == '1')) echo '<a href="' .xtc_href_link('csv_backend.php') . '" class="menuBoxContentLink"> -' . BOX_IMPORT . '</a><br>';
 
/******** SHOPGATE **********/
include_once rtrim(DIR_FS_CATALOG,"/").'/shopgate/base/admin/includes/column_left.php';
/******** SHOPGATE **********/
 
if (ACTIVATE_GIFT_SYSTEM=='true') {
 echo ('<div class="dataTableHeadingContent"><b>'.BOX_HEADING_GV_ADMIN.'</b></div>');
 if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['coupon_admin'] == '1')) echo '<a href="' .xtc_href_link(FILENAME_COUPON_ADMIN, '', 'NONSSL') . '" class="menuBoxContentLink"> -' . BOX_COUPON_ADMIN . '</a><br>';
 if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['gv_queue'] == '1')) echo '<a href="' .xtc_href_link(FILENAME_GV_QUEUE, '', 'NONSSL') . '" class="menuBoxContentLink"> -' . BOX_GV_ADMIN_QUEUE . '</a><br>';
 if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['gv_mail'] == '1')) echo '<a href="' .xtc_href_link(FILENAME_GV_MAIL, '', 'NONSSL') . '" class="menuBoxContentLink"> -' . BOX_GV_ADMIN_MAIL . '</a><br>';

define('FILENAME_BLACKLIST','blacklist.php');
define('FILENAME_PRODUCTS_VPE','products_vpe.php');
define('FILENAME_CAMPAIGNS_REPORT','stats_campaigns.php');
define('FILENAME_XSELL_GROUPS','cross_sell_groups.php');
/******** SHOPGATE **********/
define('FILENAME_SHOPGATE','shopgate.php');
define('TABLE_SHOPGATE_ORDERS','orders_shopgate_order');
/******** SHOPGATE **********/
// define the database table names used in the project
define('TABLE_ADDRESS_BOOK','address_book');
define('TABLE_ADDRESS_FORMAT','address_format');
define('TABLE_ADMIN_ACCESS','admin_access');
define('TABLE_BANNERS','banners');

function xtc_remove_order($order_id,$restock=false){
      if($restock=='on'){
              $order_query= xtc_db_query("select products_id, products_quantity from ".TABLE_ORDERS_PRODUCTS." where orders_id = '".xtc_db_input($order_id)."'");
              while($order= xtc_db_fetch_array($order_query)){
                      xtc_db_query("update ".TABLE_PRODUCTS." set products_quantity = products_quantity + ".$order['products_quantity']// [...] Zeile gekürzt
              } 
      }
      xtc_db_query("delete from ".TABLE_ORDERS." where orders_id = '".xtc_db_input($order_id)."'");
      xtc_db_query("delete from ".TABLE_ORDERS_PRODUCTS." where orders_id = '".xtc_db_input($order_id)."'");
      xtc_db_query("delete from ".TABLE_ORDERS_PRODUCTS_ATTRIBUTES." where orders_id = '".xtc_db_input($order_id)."'");
      xtc_db_query("delete from ".TABLE_ORDERS_STATUS_HISTORY." where orders_id = '".xtc_db_input($order_id)."'");
      xtc_db_query("delete from ".TABLE_ORDERS_TOTAL." where orders_id = '".xtc_db_input($order_id)."'");
      /******** SHOPGATE **********/
      xtc_db_query("delete from ".TABLE_SHOPGATE_ORDERS." where orders_id = '".xtc_db_input($order_id)."'");
      /******** SHOPGATE **********/
}

?>
<?php
/******** SHOPGATE **********/
include_once DIR_FS_CATALOG.'/shopgate/base/includes/header.php';
/******** SHOPGATE **********/
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html <?php echo HTML_PARAMS; ?>>
<head>
 
<meta http-equiv="Content-Type" content="text/html; charset=<?php echo $_SESSION['language_charset']; ?>" />
<meta http-equiv="Content-Style-Type" content="text/css" />
 
<?php
/******** SHOPGATE **********/
echo $shopgateJsHeader;
/******** SHOPGATE **********/

/******* SHOPGATE **********/
include_once DIR_FS_CATALOG.'/shopgate/base/includes/header.php';
/******* SHOPGATE **********/
//include needed functions
require_once(DIR_FS_INC.'xtc_check_categories_status.inc.php');
require_once(DIR_FS_INC.'xtc_get_products_mo_images.inc.php');
require_once(DIR_FS_INC.'xtc_get_vpe_name.inc.php');
require_once(DIR_FS_INC.'get_cross_sell_name.inc.php');

Das Plugin installieren

1. Loggen Sie sich in Ihr Shop-Backend ein.
2. Gehen Sie in dem Menü unter "Module" zu Zahlungsmethoden.
3. Wählen Sie Shopgate aus der Liste aller Zahlungsmodule aus und klicken Sie auf Installieren oben rechts.
4. Sobald die Installation erfolgreich abgeschlossen wurde, verschwindet der Installieren-Button. Stattdessen werden Ihnen die Buttons Deinstallieren und Bearbeiten angezeigt. Nach erneutem Laden der Seite sehen Sie auf der linken Seite einen neuen Menüpunkt mit dem Namen "Shopgate".
5. Klicken Sie auf Shopgate → Einstellungen in der linken Menüleiste, um die Konfigurationsseite für das Shopgate-Plugin anzuzeigen. Behalten Sie diese Seite geöffnet.

Verbindung herstellen

Nachdem Sie das Shopgate-Plugin erfolgreich installiert haben, fehlen nur noch 2 Schritte, um Ihren mobilen Shop von Shopgate mit dem Backend Ihres Onlineshops zu verbinden:

API-Anmeldeinformationen erhalten

1. Loggen Sie sich in Ihren Shopgate-Adminbereich ein.
2. Klicken Sie in der Menüleiste auf Integration → Schnittstelle installieren.
3. Im Drop-down-Menü "Wählen Sie ein System" geben Sie xt:Commerce 3 ein und wählen es aus.
4. Ein Pop-up-Fenster öffnet sich. Dort finden Sie unter "2. Einstellungen" Ihre API-Zugangsdaten (Kundennummer, Shopnummer, API-Schlüssel (API-Key) und Alias). Diese Informationen benötigt Ihr Plugin, um das Shopgate-Backend zu authentifizieren. Behalten Sie diese Seite vorerst geöffnet. Sie benötigen Sie zu einem späteren Zeitpunkt, um Ihre URL einzugeben (siehe "Ihren Shop mit Shopgate verbinden").
5. Kopieren Sie Kundennummer, Shopnummer, API Schlüssel sowie Alias und geben Sie diese Daten in die Eingabemaske ein, die Sie im vorherigen Kapitel offen behalten haben. Die übrigen Optionen können Sie zu einem späteren Zeitpunkt bearbeiten (siehe "Plugin konfigurieren"). Klicken Sie auf Speichern.
   

Ihren Shop mit Shopgate verbinden

1. Gehen Sie zurück zu dem Pop-up-Fenster in Ihrem Shopgate-Adminbereich, das Sie zuvor nicht geschlossen haben. 
2. Kontrollieren Sie nun die URL zu Ihrem Onlineshop. Danach klicken Sie auf Verbinden.
3. Wenn die Verbindung erfolgreich hergestellt wurde, öffnet sich ein weiteres Fenster. Lassen Sie dort alle Schalter aktiviert (auf "AN") und klicken Sie auf Speichern.

Das Shopgate-Backend startet jetzt automatisch den Datenimport Ihrer Produkte über die installierte Schnittstelle. Dieser Prozess wird Ihnen in Form eines Ladebalkens angezeigt. Den Status des Importprozesses können Sie jederzeit einsehen. Falls kein Ladebalken angezeigt wird, ist der Import abgeschlossen oder es läuft zur Zeit kein Import.

Das war's – welcome to the mobile world!

Plugin aktualisieren

Um ein Plugin zu aktualisieren, deinstallieren sie zunächst das "Shopgate"-Zahlungsmodul und wiederholen Sie den Installationsprozess wie in dem Kapitel "Shopgate-Plugin installieren" beschrieben. Den Abschnitt "Code anpassen" können Sie überspringen, da dies bei einer Aktualisierung des Plugins nicht nötig ist.

Außerdem ist es nicht nötig, Dateien auf Ihrem Shop-Server zu löschen, bevor Sie das Update des Plugins starten.

Falls Sie das Plugin lediglich zu einer neueren Version aktualisieren möchten, müssen die Einstellungen des Plugins nicht geändert werden.

Auch die Schnittstellenverbindung muss nicht erneut hergestellt werden, da bereits eine verfügbare und aktive Verbindung besteht.

Plugin konfigurieren

Hier finden Sie eine detaillierte Erläuterung zu jedem der Konfigurationsfelder, die auf der Konfigurationsseite des Plugins bereitgestellt werden können. Die Konfigurationsseite ist in mehrere, hier einzeln beschrieben, einzelne Abschnitte unterteilt.

Frequently Asked Questions

Wie kann ich den Codenamen einer Zahlung in meiner Bestellübersicht ersetzen?

Die Bestell-Detailseite Ihres mobilen Shops zeigt Ihnen den jeweiligen Codenamen für jede Zahlungsart an. Zum Beispiel wird Ihnen "AUTHN_CC" angezeigt, wenn ein Kunde die Kreditkartenzahlung via Authorize.net wählt und "COD", wenn ein Kunde die Zahlung per Nachname ausgewählt hat. 

Falls Sie andere Namen für Ihre Zahlungsarten wünschen, können Sie ab sofort das Feature "Payment Mapping" in Ihrem xt:Commerce-Adminbereich nutzen. Um dies zu tun, gehen Sie folgendermaßen vor:  

1. Gehen Sie im Menü Ihres xt:Commerce-Adminbereichs zu Shopgate.
2. Im Abschnitt "Bestellungsimport" suchen Sie die Option "Anzeigename für Zahlungsweisen".
3. Um Ihre Anzeigenamen zu erfassen, geben Sie "Code Name"="Ihr Anzeigename" ein und unterteilen jede Zahlungsart mit einem Semikolon. Beispiel: 
   AUTHN_CC=Kreditkartenzahlung via Authorize;COD=Zahlung per Nachname

Nutzen Sie die nachfolgende Tabelle, um die Codenamen Ihrer Zahlungsweisen zu finden.