econda Integration
Das econda Integration Modul bietet eine einfache Möglichkeit das intelligente Cross Selling von econda in OXID eShop zu nutzen - egal ob Community, Professional oder Enterprise / B2B Edition.
Dabei bietet das Modul sowohl eine einfache Möglichkeit alle oder ausgewählte Kategorien und Artikel automatisiert oder wahlweise mit wenigen Klicks in einem von econda lesbaren Format zu exportieren, sodass diese als Datenbasis bei econda genutzt werden können.
Das Modul bringt außerdem vordefinierte Integrationen für Cross Selling auf der Startseite, den Kategorieseiten, den Artikel Detailseiten sowie der Warenkorb-Seite die je nach Bedarf separat konfiguriert und aktiviert/deaktiviert werden können. Diese stehen in jeder OXID eShop Edition zur Verfügung.
Für Inhaber einer Professional oder Enterprise / B2B Edition bietet das Modul zusätzlich ebenfalls ein Visual CMS Widget um mit wenigen Handgriffen intelligentes Cross Selling in jede CMS Seite oder Landingpage zu integrieren.
In Verbindung mit unserem Modul „evoEDIT for Visual CMS“ können mit Hilfe dieses Visual CMS Widgets auch verschiedene Cross Selling Widgets nach Belieben in Kategorie- oder Artikelbeschreibungen sowie Blog-Beiträgen vom unserem Blog-Modul „evoBLOG“ integriert werden.
Das Modul ist derzeit nur auf Anfrage erhältlich. Kontaktieren Sie uns einfach!
- E-Mail: [email protected]
- Telefon: +49 (0) 5246 / 9099110
- Kontaktformular: http://www.digidesk.de/kontakt
Die Funktionen unseres econda Integration Moduls im Überblick:
- Automatischer und manueller Export von Kategorien und Artikeln für den Import bei econda.
- Vordefinierte, intelligente econda Cross Sell Widgets für
- die Startseite *¹
- die Kategorie Seiten
- die Artikel Detailseiten
- die Warenkorb Seite
- Integriertes Visual CMS Widget um auf CMS Seiten und Landingpages das intelligente Cross Selling genau so einfach verwenden zu können wie mit den vordefinierten Widgets
- Drei unterschiedliche Darstellungsmöglichkeiten der Cross Selling Artikel:
- Galerie - zeigt 4 Artikel pro Zeile nebeneinander
- Galerie Zweispaltig - zeigt 2 Artikel pro Zeile nebeneinander
- Liste - zeigt 1 Artikel pro Zeile mit mehr Informationen
- Automatische Übertragung von Artikel- oder Kategorie-IDs an econda als Kontext für die Personalisierung der Artikelvorschläge
- Für das vordefinierte Widget für die Startseite sowie für das Visual CMS Widget kann zusätzlich eine Kategorie aus dem Shop gewählt werden, die als Kontext an econda übertragen wird
- Automatische Generierung von econda Tracking Parametern in den Artikel Links der Cross Selling Artikel damit econda die Interessen des Kunden noch besser verstehen und immer zutreffendere Vorschläge machen kann
- Nahtlose Integration mit unserem Modul „evoEDIT for Visual CMS“ um mit Hilfe des Visual CMS Widgets verschiedene econda Cross Selling Widgets nach Belieben in Kategorie- oder Artikelbeschreibungen sowie Blog-Beiträgen vom unserem Blog-Modul „evoBLOG“ zu platzieren.
*¹ Für die Nutzung des vordefinierten Startseiten Widgets muss dem Startseiten Template ein Smarty-Block hinzugefügt werden!
Alternativ dazu können Sie auch das Visual CMS Widget benutzen, sofern Sie die Professional oder Enterprise Edition von OXID eShop im Einsatz haben.
Mehr Informationen dazu finden Sie unter "Konfiguration der vordefinierten Widgets"
- PHP 5.6
- PHP 7.0 (OXID 6.0.x)
- PHP 7.1 (OXID 6.1.x)
- PHP 7.2 - 7.4 (OXID 6.2.x - 6.3.x)
- PHP 8.0 (OXID 6.3.x - 6.4.x)
- PHP 8.1 (OXID 6.5.x)
- IonCube Loader (mind. v5.0)
- Flow
- Wave
- RoxIVE
- OXID CE/PE 4.9.x bis 4.10.x
- OXID EE 5.2.x bis 5.3.x
- OXID CE/PE/EE 6.0.x bis 6.5.x
- 1.Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. Sie erhalten dieses kostenlos unter: https://www.digidesk.de/produkte/basis-modul
- 2.Für dieses Modul erstellen Sie nun einen weiteren Unterordner "econda-integration" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird.
- 3.Führen Sie anschließend den folgenden Befehl aus dem Hauptverzeichnis des Shopsystems heraus aus:composer require digidesk/econda-integration
- 4.Nun kann das Modul im OXID eShop Admin aktiviert werden
- 5.Ggf. Tmp-Verzeichnis leeren und Views neu generieren
- 6.Bitte fahren Sie nun mit der Einrichtung des Moduls fort
- 1.Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. Sie erhalten dieses kostenlos unter: https://www.digidesk.de/produkte/basis-modul
- 2.Fügen Sie den Inhalt des Modulverzeichnisses "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein
- 3.Nun kann das Modul im OXID eShop Admin aktiviert werden
- 4.Ggf. Tmp-Verzeichnis leeren und Views neu generieren
- 5.Bitte fahren Sie nun mit der Einrichtung des Moduls fort
- 1.Bitte aktualisieren Sie zunächst das Basis-Modul gemäß der darin enthaltenen Installationsanleitung.
- 2.Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/econda-integration"
- 3.Deaktivieren Sie das Modul im OXID eShop Admin
- 4.Führen Sie anschließend den folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:composer update digidesk/econda-integration
- 5.Aktivieren Sie dieses Modul im OXID eShop Admin.
- 6.Ggf. Tmp-Verzeichnis leeren und Views neu generieren.
- 1.Bitte aktualisieren Sie zunächst das Basis-Modul gemäß der darin enthaltenen Installationsanleitung.
- 2.Deaktivieren Sie dieses Modul im OXID eShop Admin.
- 3.Fügen Sie den Inhalt des Modulverzeichnisses "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein und überschreiben Sie dabei die vorhandenen Dateien des Moduls.
- 4.Aktivieren Sie dieses Modul im OXID eShop Admin.
- 5.Ggf. Tmp-Verzeichnis leeren und Views neu generieren.
Tab "Grundeinstellungen" im Admin Backend unter econda Integration -> Einstellungen
- econda Account ID: Geben Sie hier Ihre Account ID an, diese ist typischer Weise im Format xxxxxxxx-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx-x
- Cronjob Schlüssel: Tragen Sie hier ein "Passwort" ein, welches verwendet werden muss um den Artikel/Kategorie Export automatisch per Cronjob auszuführen
- econda Recommendations aktivieren: Hier können Sie sämtliche econda Cross Selling Widgets in Ihrem Shop auf einmal aktivieren / deaktivieren
Einstellungen für das Startseiten Widget
- Recommendations anzeigen: Aktiviert / Deaktiviert das Widget auf der Startseite
- Recommendation-Widget-ID: Geben Sie hier die Recommendation-Widget-ID von econda für die Startseite an.
- Artikelanzahl: Geben Sie hier die Anzahl der Artikel, die auf der Startseite angezeigt werden sollen an.
- Produktlistentyp: Wählen Sie hier eine der drei möglichen Darstellungsformen der Cross Selling Artikel aus.
- Kategorie Kontext: Suchen und wählen Sie hier bei Bedarf eine Kategorie aus, die im Startseiten Widget als Kontext an Econda übergeben werden soll indem Sie den Namen der Kategorie eingeben.
Suche nach Kategorie für den Startseiten Kontext
Damit Sie das vordefinierte Startseiten Widget verwenden können, ist es neben der Konfiguration im Backend zusätzlich nötig, einen Smarty-Block zum Template der Startseite hinzuzufügen.
Bearbeiten Sie hierzu das Template
page/shop/start.tpl und fügen Sie an der gewünschten Stelle an der das Cross Selling ausgegeben werden soll folgende Code-Zeile hinzu:[{block name="dd_econda_recommendation_start"}][{/block}]
Hinweis:
Wenn Sie eine Professional oder Enterprise Lizenz besitzen, empfehlen wir Ihnen stattdessen das Visual CMS zu verwenden, um das econda Widget auf der Startseite zu platzieren.
Achten Sie außerdem darauf, niemals die Templates des Themes direkt zu verändern. Nutzen Sie dazu stets ein Child-Theme. Andernfalls kann es vorkommen, dass Ihre Anpassung bei einem Update verloren geht!
Die Konfiguration für die restlichen vordefinierten Widgets befindet sich unter der für die Startseite und unterscheidet sich nur minimal.
Einstellungen für die restlichen vordefinierten Widgets
- Recommendations anzeigen: Aktiviert / Deaktiviert das Widget auf der jeweiligen Seite
- Recommendation-Widget-ID: Geben Sie hier die Recommendation-Widget-ID von econda für die jeweilige Seite an.
- Artikelanzahl: Geben Sie hier die Anzahl der Artikel, die auf der jeweiligen Seite angezeigt werden sollen an.
- Produktlistentyp: Wählen Sie hier eine der drei möglichen Darstellungsformen der Cross Selling Artikel aus.
Wenn Sie Inhaber einer Professional oder Enterprise Lizenz von OXID eShop sind, können Sie mit Hilfe des Visual CMS Widgets für econda das Cross Sell beliebig auf CMS Seiten und in Snippets verwenden.
Fügen Sie dazu einfach das Widget in Visual CMS hinzu und konfigurieren es ähnlich wie das vordefinierte Startseiten Widget.
Hinzufügen des Visual CMS Widgets zu einem CMS Inhalt
Beispielkonfiguration für das Widget
Je nach gewähltem Produktlistentyp werden die Cross Selling Widgets im Frontend unterschiedlich ausgegeben.
Produktlistentyp Galerie: 4 Artikel nebeneinander pro Reihe
Produktlistentyp Galerie Zweispaltig: 2 Artikel nebeneinander pro Reihe
Produktlistentyp Liste: Ein Artikel pro Zeile mit Kurzbeschreibung
Mit dem Visual CMS Widget haben Sie den Vorteil, dass Sie andere Widgets mit dem econda Widget kombinieren und somit noch individuellere Darstellungen erzielen können.
econda Visual CMS Widget kombiniert mit dem Angebot Widget
Export Einstellungen im Admin Backend unter econda Integration -> Cross Selling Export
Wenn Sie nicht alle Kategorien und Artikel aus Ihrem Shop zu econda exportieren möchten, haben Sie hier die Möglichkeit einzelne Artikel oder ganze Kategorien vom Export auszuschließen.
Außerdem gibt es die Möglichkeit, kostenlose Artikel grundsätzlich vom Export auszuschließen.
Wenn Sie bestimmte, einzelne Artikel vom Export ausschließen wollen, suchen Sie in diesem Feld nach dem Namen oder der Artikelnummer des Artikels und wählen Sie ihn per Klick aus.
Volltextsuche nach Artikeln zum Ausschluss vom Export
Bei Bedarf können Sie auch problemlos mehrere Artikel nacheinander Suchen und Auswählen um sie vom Export auszuschließen.
Problemlose Mehrfachauswahl zum Ausschluss vom Export
Wenn Sie alle Artikel einer Kategorie vom Export und damit vom Cross Selling ausschließen wollen, suchen Sie hier nach dem gleichen Prinzip wie bei den Artikeln einfach nach dem Namen der Kategorie(n) und wählen diese per Klick aus.
Volltextsuche nach Kategorien zum Ausschluss vom Export
Auch hier ist selbstverständlich eine Mehrfachauswahl problemlos möglich.
Problemlose Mehrfachauswahl zum Ausschluss vom Export
Wenn Sie, z.B. zum Testen der Exporte bei der Einrichtung, den Export manuell ausführen wollen, können Sie dies auf der Seite der Export Einstellungen mit den dafür vorgesehenen Buttons am unteren Bildschirmrand vornehmen.
Hierbei werden zwei Dateien exportiert, mit jedem Button eine. In der Datei
products.csv werden die Artikeldaten die zu econda Exportiert werden gespeichert. Die Kategorie Daten werden in der Datei categories.csv gespeichert.
Die Dateien werden nach erfolgreichem Export im Pfad <shop-root>/export/dd_econda_crosssell/ auf dem Dateisystem des Webservers abgelegt, sodass econda sich die Export Daten automatisch abrufen und importieren kann.
Nach einem erfolgreichem manuellen Export wird Ihnen angezeigt, wie viele Datensätze jeweils exportiert wurden, sowie ein Link um die jeweilige Export Datei über den Browser abrufen zu können. Diese Links werden von econda benötigt, um die Daten automatisch abzurufen.
Erfolgreicher manueller Export von Artikeldaten.
Achtung:
Sofern Sie den Zugriff auf diese Dateien nicht limitieren, können sie theoretisch von jeder beliebigen Person aufgerufen und gelesen / gespeichert werden!
Wir empfehlen hier, den Zugriff auf das Verzeichnis
<shop-root>/export/dd_econda_crosssell/per htaccess-Autorisierung mit einem Passwort zu versehen und dieses ausschließlich econda mitzuteilen.Für den automatischen Export der Kategorie- und Artikeldaten enthält das econda Integration Modul einen Cronjob, um in regelmäßigen Abständen die Export-Dateien zu aktualisieren, damit die Datenbasis bei econda immer auf dem aktuellen Stand ist. Dieser kann über folgende URL aufgerufen werden:
https://www.ihre-shop-url.de/index.php?cl=dd_econda_cron&key=XXXXXXXXX
Bitte beachten Sie:
Im oben stehenden Link muss XXXXXXXXX durch den in den Grundeinstellungen definierten Cronjob Schlüssel ersetzt werden, damit der Cronjob ausgeführt wird.
Um diesen Cronjob automatisiert auszuführen empfehlen wir bei Linux Systemen "crontab". Für crontab sieht der Eintrag z.B. folgendermaßen aus:
0 0 * * * https://www.ihre-shop-url.de/index.php?cl=dd_econda_cron&key=XXXXXXXXX
Dies startet das Cronjob Script einmal täglich um Mitternacht, wobei das Script alle Kategorien und Artikel, ausschließlich der definierten Ausschlüsse, exportiert und wie der manuelle Export im Pfad
<shop-root>/export/dd_econda_crosssell/ auf dem Dateisystem des Servers ablegt.Ein hilfreiches Tool für die einfache Erstellung von crontab Einträgen nach Ihren Wünschen ist "crontab.guru".
Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Kontaktieren Sie uns einfach!
- E-Mail: [email protected]
- Telefon: +49 (0) 5246 / 9099110
- Kontaktformular: http://www.digidesk.de/kontakt