English (US)Shopgate unterstützt OpenCart als Shopsystem.
Mit OpenCart und Shopgate stehen Ihnen folgende Features für Ihre App und mobile Website zur Verfügung:
| Support | Import zu OpenCart | ||
| Version | bis 2.2.0 | Bestellungen | ✔ |
| Kundenkonto | Export zu Shopgate | ||
| Login mit Desktop-Shop-Konto | ✔ | Produkte | ✔ |
| Login mit mobilen Konto | ✔ | Kategorien | ✔ |
| Kundengruppen/Staffelpreise | ✔ / ✔ | Bewertungen | ✔ |
| Desktop-Bestellhistorie mobil anzeigen | ✔ | ||
| Sync | Live-Warenkorb-Validierung | ||
| Lieferstatus "versendet" | ✔ | Gutschein | ✔ |
| Bestellstatus "storniert" | ✔ | Versandarten | ✔ |
| Lagerbestand Anzahl (Produkt- Detailseite) | ✔ | Zahlungsarten | ✔ |
| Produktverfügbarkeit | ✔ | ||
| Unterstützte Zahlungsarten | Anmerkungen | ||
| Zahlung per Nachname, Klarna | Das Feature "Validierung von Zahlungsarten" ermöglicht Ihnen, alle für den Kunden und Warenkorb gültigen Zahlungsarten anhand der Regeln im Shopsystem zu validieren und anzuzeigen. Wenn Sie dieses Feature nutzen möchten, wenden Sie sich bitte an den Shopgate Support. | ||
Das Shopgate-Plugin installieren
Das Shopgate-Plugin für OpenCart kann für Version 1.3 und höher installiert werden. Befolgen Sie hierfür die folgenden Arbeitsschritte:
Shop in Wartungsmodus setzen
Um zu verhindern, dass Ihr Shop während der Installation des Shopgate-Plugins fehlerhaft oder gar nicht funktioniert, setzen Sie diesen bitte zuvor in den Wartungsmodus:
- Loggen Sie sich in Ihren OpenCart-Adminbereich ein.
- Gehen Sie zu System → Einstellungen und klicken Sie auf Bearbeiten.
- Wenn die Seite für Einstellungen geöffnet wurde, wechseln Sie zu dem Tab "Server" und setzen dort die Option "Wartungszustand" auf JA.
Plugin herunterladen
Laden Sie zuerst die aktuellste Version des Plugins "shopgate-opencart-module.ocmod.zip" über diesen Link herunter und entpacken Sie den Inhalt.
Plugin bei OpenCart hochladen
Fahren Sie nun damit fort, das Plugin Ihrer Version entsprechend bei OpenCart hochzuladen:
- Gehen Sie in Ihren OpenCart-Adminbereich.
- In der seitlichen Menüleiste wählen Sie
→ Extension Installer aus. - Im Extension Installer klicken Sie auf Upload, bzw Hochladen, und wählen die ZIP-Datei aus, die Sie zuvor heruntergeladen haben. Das Shopgate-Plugin wird automatisch hochgeladen.
- Klicken Sie auf Fortfahren, um den Upload des Plugins abzuschließen.
Ihre Shopgate-Plugin wurde erfolgreich installiert, wenn Sie diesen Text sehen.
Damit Ihre JooCart-Erweiterung in Ihrem mobilen Shop bei Shopgate richtig läuft, müssen einige Zeilen Code zur Quelldatei shopgate/api.php auf Ihrem FTP-Server hinzugefügt werden. Folgen Sie hierfür diesen Schritten:
- Klicken Sie in Ihrem FTP-Server auf den Ordner Shopgate und öffnen Sie die Datei api.php.
- Kopieren Sie den hervorgehobenen Code und geben diesen direkt hinter der Zeile ob_start(); ein. Beachten Sie, dass die Zeilennummerierung für jeden Shop unterschiedlich sein kann.
ob_start();
define('_JEXEC', 1);
define('DS', DIRECTORY_SEPARATOR);
if (file_exists(dirname(_FILE_) . '/../../../defines.php'))
{ include_once dirname(__FILE__) . '/../../../defines.php'; }
if (!defined('_JDEFINES'))
{ define('JPATH_BASE', dirname(__FILE__) . "/../../.."); require_once JPATH_BASE.'/includes/defines.php'; }
require_once JPATH_BASE.'/includes/framework.php';
// Instantiate the application.
$app = JFactory::getApplication('site');
// Initialise the application.
$app->initialise(); - Speichern Sie die Änderungen und laden Sie die Datei, falls notwendig, zurück auf Ihren FTP-Server.
Das Plugin aktivieren
- Melden Sie sich in Ihrem OpenCart-Adminbereich an und gehen Sie zu Erweiterungen → Module.
- Gehen Sie zu dem Eintrag Shopgate und klicken Sie auf Installieren.
- Warten Sie bis der Installieren-Button verschwindet und die Buttons Deinstallieren sowie Bearbeiten erscheinen. Sobald dies geschehen ist, wurde Ihr Plugin erfolgreich in Ihrem OpenCart-Backend installiert.
- Klicken Sie anschließend auf Bearbeiten, um die Seite mit den Einstellungen zu öffnen. Lassen Sie diese Seite vorerst geöffnet – Sie werden in den nachfolgenden Abschnitten erfahren, wie Sie die erforderlichen Informationen finden.
Weiterleitung zur mobilen Seite einrichten
- Gehen Sie zu System → Design → Layouts.
- In der sich öffnenden Liste suchen Sie nach Home, Kategorie und Produkte.
- Klicken Sie auf
, um die Startseite zu bearbeiten. - Fügen Sie als nächstes ein neues Modul hinzu, indem Sie unten auf der Seite auf
klicken (siehe Screenshot rechts). Wählen Sie als "Modul" Shopgate, als "Position" Content Top und als "Sortierreihenfolge" -1. Anschließend klicken Sie oben auf der Seite auf den Speichern-Button. - Wiederholen Sie Schritt 3, um die Shopgate-Module auch für die Layouts von Kategorie und Produkte zu bearbeiten.
- Nachdem zu allen Layoutoptionen (Home, Kategorie, Produkt) ein "Shopgate Modul" hinzugefügt wurde, werden alle mobilen Besucher Ihres Shops auf Ihre mobile Seite weitergeleitet.
Bearbeiten Sie 2 Quelldateien auf Ihrem FTP-Server nach den Anweisungen auf der rechten Seite. Sobald Sie dies abgeschlossen haben, werden alle mobilen Besucher zu Ihrem mobilen Shop weitergeleitet.
- Öffnen Sie die Datei /catalog/controller/common/header.php.
- Kopieren und fügen Sie 'module/shopgate' direkt hinter dieser Zeile ein:
$this->children = array(
'module/shopgate', - Speichern Sie die Datei.
- Öffnen Sie die Datei /catalog/view/theme/(current theme or default)/template/common/header.tpl.
- Öffnen Sie, falls vorhanden, die Datei /catalog/view/theme/(current theme or default)/template/common/header_home.tpl.
- Kopieren und fügen Sie <?php echo $shopgate; ?> direkt nach der Zeile in beiden Dateien ein:
<title><?php echo $title; ?></title>
<?php echo $shopgate; ?>Beachten Sie: Wenn diese Codezeile nicht in Ihrer Version auffindbar ist, fügen Sie einfach <?php echo $shopgate; ?> in beiden Dateien oben ein. - Speichern Sie die Datei.
Ihr Plugin ist jetzt bereit für den Verbindungsaufbau.
Verbindungen herstellen
Nachdem das Shopgate-Plugin erfolgreich installiert wurde, müssen nur noch 2 Optionen bearbeitet werden, um Ihren mobilen Shop (Shopgate) mit dem Backend Ihres Shops zu verbinden:
API-Zugangsdaten erhalten
- Melden Sie sich in Ihrem Shopgate-Adminbereich an.
- Klicken Sie in der Menüleiste auf Integration → Schnittstelle installieren.
- Im Drop-down-Menü "Wählen Sie ein System" beginnen Sie OpenCart einzutippen, bis es in der Liste erscheint und Sie es auswählen können.
- Ein Pop-up-Fenster öffnet sich. Dort finden Sie unter "2. Einstellungen" Ihre API-Zugangsdaten (Kundennummer, Shopnummer, API-Schlüssel und Alias). Diese Informationen werden für die Authentifizierung des Shopgate-Plugins benötigt. Lassen Sie diese Seite zunächst geöffnet, Sie müssen hier zu einem späteren Zeitpunkt Ihre URL eingeben.
- Kopieren Sie Kundennummer, Shopnummer, API-Schlüssel sowie Alias und geben Sie diese Angaben einzeln in die entsprechenden Felder auf der Seite in Ihrem OpenCart-Adminbereich ein, die Sie offen gelassen haben. Klicken Sie abschließend auf Speichern.
Die übrigen Optionen können zu einem späteren Zeitpunkt bearbeitet werden. Informationen dazu finden Sie in dem Abschnitt "Details zu den Plugin-Einstellungen".
Verbindung zu Shopgate herstellen
- Gehen Sie nun zurück in das Pop-up-Fenster, das Sie in Ihrem Shopgate-Adminbereich offen behalten haben. Hinterlegen Sie die URL Ihres Shops unter "3. URL eingeben". Danach klicken Sie auf Verbinden, um die Schnittstelle herzustellen.
- Wurde die Verbindung erfolgreich hergestellt, öffnet sich ein Pop-up-Fenster (siehe Screenshot unten). Stellen Sie sicher, dass Sie alle Optionen aktiviert (auf AN) lassen. Danach übernehmen Sie die Änderungen, indem Sie auf Speichern klicken.
- Nach Abschluss dieser Schritte sehen Sie einen Ladebalken, der den Fortschritt des Produkt-und Kategorieimports anzeigt. Abhängig von der Menge Ihrer Produkte kann der Import einige Minuten bis wenige Stunden in Anspruch nehmen. Der Ladebalken zeigt Ihnen den Fortschritt des Prozesses. Wird kein Ladebalken angezeigt, ist der Import bereits abgeschlossen oder es findet derzeit kein Import statt.
Das war's – welcome to the mobile world!
Plugin aktualisieren
Plugin auf Sonderanpassungen prüfen
Vor der Aktualisierung des Shopgate-Plugins, sollten Sie unbedingt überprüfen, ob Ihr Shop eine Version nutzt, in der eine Sonderanpassung enthalten ist. In diesem Fall wird eine neuere Version des Shopgate-Plugins nämlich NICHT in Ihrem Shop laufen.
Falls Sie eine nicht bearbeitete Version des Plugins verwenden, können Sie dieses bedenkenlos aktualisieren.
Wie kann ich feststellen, ob mein Shop ein benutzerdefiniertes Plugin verwendet? |
Sollte einer der folgenden Fälle auf Ihren Shop zutreffen, verwenden Sie eine angepasste Plugin-Version:
|
Was muss ich tun, wenn mein Shop ein benutzerdefiniertes Plugin verwendet? |
Senden Sie bitte vor jedem Update eine E-Mail mit folgenden Daten an Shopgate:
|
Das Plugin aktualisieren
Um ein bereits existierendes Shopgate-Plugin zu aktualisieren, befolgen Sie die Anweisungen aus dem Abschnitt "Das Shopgate-Plugin installieren".
Falls Sie eine OpenCart-Version vor 2.0 verwenden, gehen Sie bitte folgendermaßen vor:
- Folgen Sie den Schritten aus dem Abschnitt "Shop in Wartungsmodus setzen").
- Für das Update eines angepassten Shopgate-Plugins laden Sie die Datei, die Ihnen von Shopgate per E-Mail übermittelt wird, herunter und entpacken sie.
Für das Update eines nicht angepassten Shopgate-Plugins befolgen Sie die Anweisungen aus dem Abschnitt "Plugin herunterladen". - Öffnen Sie die entpackte Datei in Ihrem FTP-Programm. Sie sehen dann 3 Unterordner: admin, catalog, upload und shopgate.
- Aktualisieren Sie den Shopgate Ordner indem Sie ihn mit der Maus in Ihren Shop Ordner auf dem FTP-Server ziehen. Dadurch wird der alte Shopgate-Ordner überschrieben.
- Aktualisieren Sie die Ordner Admin, Upload und Catalog, indem Sie jede Datei einzeln auf Ihren Server kopieren. Wiederholen Sie deshalb die folgenden Schritte bis alle Dateien in den Ordnern Admin und Catalog auf Ihrem FTP-Server aktualisiert wurden.
- Öffnen Sie die Sub-Ordner in Admin oder Catalog.
- Klicken Sie auf Öffnen für einen der Unterordner, die Sie in der Übersicht sehen und wiederholen Sie diesen Vorgang bis kein Ordner übrig bleibt, um diesen zu “öffnen”.
- Finden Sie exakt den selben Ordner in Ihrem Shopordner auf Ihrem FTP-Server.
- Wählen Sie jetzt die Datei(en) im lokalen Ordner aus ziehen Sie diese zum entsprechenden Ordner auf Ihrem FTP-Server um die Datei zu aktualisieren. Die alte Datei wird daraufhin überschrieben.
- Löschen Sie alle alten "Shopgate" Dateien in den Ordnern Admin und Catalog, die nicht mehr in der neuen Version des Plugins verwendet werden.
- Anschließend können Sie den “Wartungsmodus” Ihres Shops zurück auf “Nein” stellen. Damit wird das Update vervollständigt.
Nach Abschluss dieser Schritte, wurde Ihr Plugin erfolgreich aktualisiert.
Details zu den Plugin-Einstellungen
In diesem Kapiteln finden Sie sämtliche Erläuterungen für alle Einstellungen und Optionen, die Auf der Konfigurationsseite des Plugins vorausgesetzt werden.
| Status | Mit dieser Option aktivieren oder deaktivieren Sie das Plugin. |
| Kundennummer | Ihre Kundennummer bei Shopgate.. |
| API-Key | Dies dient als “Passwort” das vom Plugin genutzt wird, um mit der Shopgate Merchant-API in einem sicheren Channel zu kommunizierenl. |
| Shopnummer | Die Shopnummer Ihres mobilen Shops bei Shopgate. |
| CName | Wählen Sie eine mobile URL unter Ihrer Shop-Domain aus. Zum Beispiel nutzen Sie “m.myawesomeshop.com" anstatt der standardmäßig voreingestellten Shopgate URL "myawesomeshop.shopgate.com". |
| Shop | Wählen Sie den Shop aus, den Sie mit Shopgate verbinden möchten, wenn Sie mehr als einen Shop führen. |
| Alias | Ihr Shop-Alias bei Shopgate. |
| Merchant-API Modus | Diese Option sollte auf "Live" gesetzt sein. |
| Encoding | Der Encoding-Typ wird in Ihrer Datenverwaltung bei Opencart verwendet. UTF-8 ist der am häufigsten vertretene Typ für das Encoding. |
| Comment detail level | Wählen Sie aus, wie viele Informationen Informationen in den Kommentaren angegeben werden sollen, wenn Bestellungen importiert werden. |
|
Order status "shipping blocked" Order status "shipping not blocked" Order status "shipped" Order status "canceled" |
Wählen Sie einen Status aus dem Drop-Down Menü aus, um den Bestellstatus zwischen Ihrem mobilen Shop und Ihrem Webshop abzustimmen. |
Frequently Asked Questions
Nach einem Update des Shopgate Plugins ist mein mobiler Shop nicht mehr erreichbar. Was ist zu tun?
Wenn Sie Ihr Shopgate Plugin seit längerer Zeit nicht mehr aktualisiert haben, ist es möglich, dass die Einstellungen Ihres Plugins nicht korrekt bei einem Update in eine neuere Version übernommen werden können. Dieses Problem lässt sich jedoch leicht beheben.
Gehen Sie in Ihr OpenCart Backend und finden Sie das Shopgate Plugin. Klicken Sie auf den [Bearbeiten] Button um die Seite für Einstellungen zu öffnen. Geben Sie jetzt die Kundennummer, Shopnummer, den API-Schlüssel, Alias und den CName erneut ein, wie in den Schritten in Kapitel 2.1 beschrieben.
Anschließend laden Sie die Seite bzw. Ihren Shop neu wo Ihre Optionen wieder einwandfrei laufen.
Das Plugin auf Ihren FTP Server laden
Für OpenCart Versionen vor 2.0 benötigen Sie ein FTP-Client Tool um Ihr Shopgate Plugin hochzuladen. Viele dieser Programme sind im Internet frei zugänglich. Im nachstehenden Beispiel wurde FileZilla verwendet (Wie Sie FileZilla installieren und verwenden)
Gehen Sie jetzt so vor, wie in den folgenden Schritten beschrieben um das Shopgate Plugin zu laden:
- Verbinden Sie Ihr FTP-Programm mit Ihrem Server.
- Gehen Sie zum Entpacken des Shopgate Plugins in Ihr lokales Verzeichnis (linke Seite).
- Wählen Sie ALLE Dateien im lokalen Ordner Ihres Shopgate Plugins aus.
- Ziehen Sie diese per Maus in den Ordner Ihres Shopsystems auf dem FTP Server (rechte Seite).
- Der Upload wird unmittelbar gestartet.
Fahren Sie jetzt fort mit der Das Plugin in Ihrem OpenCart Backend aktivieren.
Wo kann ich meine FTP-Zugangsdaten angeben?
Um die Zugangsdaten Ihres FTP-Servers anzugeben, folgen Sie bitte diesen Schritten:
- In Ihrem OpenCart Konto gehen Sie in die Einstellungen und klicken dann auf den Button Bearbeiten.
- Auf der Seite Ihrer Einstellungen wechseln Sie zum FTP-Tab.
- Geben Sie hier Ihre Zugangsdaten ein und aktivieren Sie FTP. Klicken Sie dann auf Speichern.
Jetzt haben Sie Ihren FTP Server in Ihrem OpenCart eingerichtet und aktiviert.
