econda Integration

Modulbeschreibung

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: support@digidesk.de

  • Telefon: +49 (0) 5246 / 9099110

  • Kontaktformular: http://www.digidesk.de/kontakt

Funktionsumfang

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"

Systemvoraussetzungen

PHP-Version OXID 4 & 5

  • PHP 5.6

PHP-Version OXID 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)

Webserver-Konfiguration

  • IonCube Loader (mind. v5.0)

Kompatibel mit den Themes

  • Flow

  • Wave

  • RoxIVE

Kompatibel mit den OXID Versionen

  • 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

Installation

Ab OXID 6

  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

Bis OXID 5.3.x/4.10.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ü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

Update

Ab OXID 6

  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.

Bis OXID 5.3.x/4.10.x

  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.

Grundeinstellungen

  • 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

Konfiguration der vordefinierten Widgets

Startseite

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

Zusätzliche Maßnahmen für das Startseiten Widget

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!

Listenansicht | Detailseite | Warenkorb

Die Konfiguration für die restlichen vordefinierten Widgets befindet sich unter der für die Startseite und unterscheidet sich nur minimal.

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

Konfiguration des Visual CMS Widgets

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.

Darstellung im Frontend

Je nach gewähltem Produktlistentyp werden die Cross Selling Widgets im Frontend unterschiedlich ausgegeben.

Galerie

Galerie Zweispaltig

Liste

Visual CMS Widget

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.

Kategorie- und Artikeldaten Export

Export Konfiguration

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.

Ausschluss von einzelnen Artikeln

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.

Bei Bedarf können Sie auch problemlos mehrere Artikel nacheinander Suchen und Auswählen um sie vom Export auszuschließen.

Ausschluss von Kategorien

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.

Auch hier ist selbstverständlich eine Mehrfachauswahl problemlos möglich.

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

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.

Automatischer Export per Cronjob

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

Hilfe & Support

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: support@digidesk.de

  • Telefon: +49 (0) 5246 / 9099110

  • Kontaktformular: http://www.digidesk.de/kontakt

Last updated