# Einleitung ## Herzlich Willkommen! Auf dieser Seite finden Sie die Dokumentation zur unseren OXID eShop Modulen und Shopware Plugins. Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Für Individualentwicklungen stehen wir Ihnen ebenfalls gerne zur Verfügung. Kontaktieren Sie uns einfach über eine der folgenden Adressen: * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt)​ # Aktionslayouts ## Modulbeschreibung Mit dem Aktionslayouts-Modul können Sie das Design Ihres Shops für bestimmte Anlässe, wie z.B. Weihnachten oder Ostern, anpassen.\ Im Backend haben Sie einige Einstellungsmöglichkeiten und können genau bestimmen, in welchem Zeitraum das neue Logo oder Hintergrundbild aktiv sein soll und auf welchen Seiten: * Global * Startseite * Kategorieseite * Artikelseite * oder CMS-Seiten. Dank der mitgelieferten Mediathek können Sie die Bilder direkt im Modul hochladen und verwalten. Das Modul ist derzeit nur auf Anfrage erhältlich. ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### PHP-Version OXID 6 * PHP 7.0 * PHP 7.1 ### 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.1.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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `periodactions` im Ordner `packages/digidesk`, in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer require digidesk/periodactions ``` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ### Bis OXID 4.10.x/5.3.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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. ��Fügen Sie den Inhalt des Ordners `modules/digidesk/` via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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/periodactions`. 3. Deaktivieren Sie das Modul im OXID eShop Admin. 4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/periodactions ``` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 5. Aktivieren Sie das Modul im OXID eShop Admin. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.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 Ordners "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. ## Funktionsbeschreibung Mit diesem Modul können Sie den Hintergrund, das Logo, Kategorie- und Artikelbilder für einen von Ihnen festgelegten Zeitraum ändern.\ Im Backend haben Sie die Möglichkeit für verschiedene Anlässe die Änderungen festzulegen. Die Einstellungen sind unter dem Punkt Backend-Einstellungen erklärt. ## Backend-Einstellungen Im Backend können Sie für verschiedene Anlässe, wie zum Beispiel Weihnachten oder Ostern, einzelne Aktionen anlegen. Folgende Einstellungsmöglichkeiten haben Sie dabei: ![Einstellung mit dem Typen "Kategorie" ](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXqb5hmyK8FhPmdD5g%2F-LOXqgMs7MsDS4fh_VHO%2FAktionslayout-2.png?alt=media\&token=288bc471-b35b-48a2-85f7-5fd4bc50b25d) ## Frontend-Ansicht Nach den Einstellungen ist es möglich, diese im Frontend anzusehen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LeWyXBYjwJnskXIedBz%2F-LeX3QrS81FbbTDHB4Vm%2FBildschirmfoto%202019-05-10%20um%2016.06.42.png?alt=media\&token=ff11ea1d-4604-4497-8e65-1514b233a8fd) ## 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:**** * Telefon:**+49 (0) 5246 / 9099110** * Kontaktformular:[**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Artikellistenverwaltung ## Modulbeschreibung Dieses Backend-Modul ermöglicht es Ihnen, Artikellisten zu erstellen und diese dann im Administrationsbereich anzeigen zu lassen. Zum Beispiel könnten Sie sich eine Liste aller Produkte aus der Kategorie „Schuhe“ erstellen, welche mehr als 100 Euro kosten und von einer bestimmten Marke sind. Somit haben Sie eine geordnete Übersicht, in der Sie dann die Artikeldaten (Titel, Kurzbeschreibung, Attribute, etc.) bearbeiten können. Die Listen können dann gespeichert und können zu einem späteren Zeitpunkt wieder aufgerufen werden. Alle Listen lassen sich auch als CSV-Datei exportieren. Das Modul eignet sich also auch dafür, eine Übersicht von bestimmten Artikelgruppen zu erhalten. Doch nicht nur die Verwaltung ist möglich, sondern auch die Überwachung Ihrer Produkte:\ In einer anderen Liste können Sie sich beispielsweise alle Artikel aus Ihrem Shop anzeigen lassen, bei denen kein Artikelbild hinterlegt ist oder der Preis 0 Euro ist.\ Somit können Sie fehlerhafte Artikel direkt erkennen und schnell handeln. Das Modul ist erhältlich auf ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * 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 ## Installation 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. �Fügen Sie den Inhalt des Ordners `modules/digidesk/` via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ## Update 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 Ordners `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. ## Funktionsbeschreibung ### Artikelliste erstellen 1. Wechseln Sie im Backend auf ***"Artikelliste">"Einträge bearbeiten"***. Sie erhalten dann eine Übersicht mit den angelegten Artikellisten. 2. Wenn Sie eine neue Artikelliste erstellen möchten, klicken Sie auf das ***grüne Plus oben rechts***. Die verschiedenen Einstellungsmöglichkeiten sehen Sie in den folgenden Screenshots. ![Backend-Bereich ](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrUjMGAxkqoLJt-clh%2FBildschirmfoto%202018-10-15%20um%2013.21.23.png?alt=media\&token=62eda8c3-4e96-43c0-a841-3276f358de4c) ![Einzelansicht](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrUhf_-_pKrB5Lhvou%2FBildschirmfoto%202018-10-15%20um%2013.28.43.png?alt=media\&token=848bd3f9-d0c6-4b28-ab87-da04492ae6f7) ![Filter-Einstellungen](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrUngjHNLDDbi5XJ86%2FBildschirmfoto%202018-10-15%20um%2013.29.19.png?alt=media\&token=066083de-ab9f-4cfc-8142-d0d96ee10b4c) ![Filter spezifizieren](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrUq3HGY9vfly8ymEZ%2FBildschirmfoto%202018-10-15%20um%2013.30.17.png?alt=media\&token=f4a59cca-e851-4b60-878f-a535f495f959) #### ![editierbare Attribute](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrUse__qQNhFgZ0d4C%2FBildschirmfoto%202018-10-15%20um%2013.30.28.png?alt=media\&token=977613de-e3e9-4493-b10d-c8746db529f7) ### Artikellisten-Übersicht Für jede erstelle Artikelliste erscheint **links in der Sidebar** ein neuer Eintrag. Wenn Sie auf den jeweiligen Eintrag wechseln, können Sie sich die Artikelliste anschauen: ![Artikellisten-Ansicht](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrVU4A2pdkebwSRW15%2FBildschirmfoto%202018-10-15%20um%2013.33.41.png?alt=media\&token=d0aba899-61ce-433a-810a-f47b430db7ab) #### ### CSV-Export Sie können die Artikellisten auch als CSV-Datei exportieren. Klicken Sie dafür auf den **blauen Button oben rechts**. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOrVuOu767oqJHQxgRz%2F-LOrVnGblOnSo3FWrhVu%2FBildschirmfoto%202018-10-15%20um%2013.35.22.png?alt=media\&token=c2276b56-e56e-45c9-b00e-c1721bdc6039) ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular:[**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Badge Modul ## Modulbeschreibung Mit dem Badge Modul können Sie kurze relevante Informationen in Form eines Produkt-Badges anzeigen lassen. Die Badges können sie individuell pro Artikel und/oder Kategorie angelegen. Dabei sind Sie völlig frei in der Auswahl der Schrift- und Hintergrundfarbe, da diese ganz simpel über eine Farbauswahl ausgewählt werden können, sowie in der Auswahl, welcher Text auf dem Badge ausgegeben wird. Den Kunden können damit zum Beispiel Informationen wie Lieferzeit, dass ein Artikel pflanzlich oder vegan ist, für welches Alter das Produkt geeignet ist, ob ein Produkt gerade im Sale ist, oder viele andere Informationen angezeigt werden. Das Modul ist erhältlich auf ## Funktionsumfang * Freitext-Eingabe des Badge-Inhaltes * Erstellung mehrerer verschiedener Badges für einen Artikel möglich * Badges können individuell angepasst werden: * Die Schrift und Hintergrundfarbe kann selbst mit einer Farbauswahl ausgewählt werden * Position der Badges anpassbar * Form-Auswahl der Badges * Freie Wahl der Schriftgröße * Anzeigeort frei wählbar. Dadurch können Sie beispielsweise 2 unterschiedliche Badges für einen Artikel in den Listings und auf der Detailseite erstellen um in den Listings z.B. nur ein %-Zeichen auszugeben um zu signalisieren dass der Artikel im Sale ist und auf der Detailseite, wo für das Badge mehr Platz ist, ein Badge mit dem Inhalt % Black Friday Sale % \ Sie haben dabei die Auswahl zwischen: * Produkt-Box * Detailseite * Definition von Badges für alle Artikel von einer oder mehreren Kategorien und/oder bestimmten Artikeln * Suche nach Artikeln und Kategorien per Titel oder Artikel-Nr. bei der Zuweisung * Möglichkeit zum Ausschluss von Artikeln vom Badge\ Wenn Sie z.B. allen Artikeln einer Kategorie ein bestimmtes Badge zuweisen wollen **außer** einigen bestimmten Artikeln. ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.3.x) * PHP 8.4 (OXID 7.3.x) ### Kompatibel mit den Themes * Flow (OXID 6) * RoxIVE (OXID 6) * Wave (OXID 6 und 7.0) * Apex ab OXID 7.0 ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0.x bis 7.3.x ## Installation 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. 2. Sie erhalten dieses unter:​ 3. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "**badge**" im Ordner "**packages/digidesk**", in den die heruntergeladene Zip-Datei entpackt wird. 4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/badge` 5. Nun kann das Modul im OXID eShop Admin aktiviert werden. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Update 1. Entpacken Sie die neue Modulversion in den Ordner "**packages/digidesk/badge**". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/badge`\ Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "**Y**". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Funktionsbeschreibung ### Badge bearbeiten/erstellen Wählen Sie im Admin-Menü den Punkt **"Badge"** aus und öffnen anschliessend den Menüpunkt **"Badges bearbeiten".** #### **Badges Erstellen:** 1. Drücken sie auf das **"+"-Symbol,** wenn sie ein neues Badge erstellen wollen. 2. Es öffnet sich ein Fenster mit geöffneten Reiter **"Stamm".** 3. Hier können Sie Informationen in das Formular eintragen. 4. Aktivieren sie ganz oben "**Aktiv**" wenn sie den Badge im Frontend anzeigen lassen wollen. 5. Stellen Sie den Badge über die weiteren Reiter ein. 6. Wenn sie dann alle Werte angeben haben müssen sie auf **"Speichern"** drücken, um den Badge zu speichern. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FVBj0JjnyTCX05TiokOAx%2FBildschirmfoto%202025-11-10%20um%2017.33.37.png?alt=media\&token=55620800-3f69-4d08-961c-8f6ad0e848c6)
#### **Badge Bearbeiten:** 1. Bewegen sie ihren Mauszeiger über die Zeile von Ihrem bereits erstellten Badge welches Sie bearbeiten wollen. 2. Danach sehen sie auf der rechten Seite zwei Buttons mit einem Icon. 3. Zum bearbeiten müssen sie auf den "**Editieren Button"** (den Button mit dem Stift Icon) klicken. 4. Es öffnet sich das selbe Fenster wie beim erstellen, nur das schon die Daten von Ihrem bereits erstellten Badge eingetragen sind. Diese Daten können sie dann einfach wieder ändern. 5. Anschliessend müssen sie auf **"Speichern"** klicken, um die Änderungen zu übernehmen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F1wtFsGMYj0Knx4TiHp0u%2FBildschirmfoto%202022-05-13%20um%2010.18.34.png?alt=media\&token=eb066539-cef2-4795-ae3a-14cfe7ee1c39) #### **Badge Löschen:** 1. Um ein Badge zu löschen müssen Sie Ihren Mauszeiger über die Spalte von Ihrem Badge bewegen das Sie löschen möchten. 2. Danach sehen Sie auf der rechten Seite zwei Buttons mit einem Icon. 3. Zum löschen müssen Sie auf den "**Löschen Button**" (Den Button mit dem Mülleimer Icon) klicken. 4. Am Ende müssen sie das löschen dann nochmal mit dem "**OK Button**" bestätigen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FDKNAfcmvuLhpP3QpGKD6%2FBildschirmfoto%202022-05-13%20um%2010.44.36.png?alt=media\&token=01634520-ed16-4652-a67a-bcca96208b86) ## Frontend Nach dem sie ein Badge erstellt und aktiviert haben, wird dieser nun im Frontend angezeigt. ### Apex {% tabs %} {% tab title="Produkt-Box" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FxtMsxxNnoJTbf30Fvk73%2FBildschirmfoto%202025-11-10%20um%2017.30.50.png?alt=media\&token=ba9d902d-563d-4a30-8299-aa8614eba9ae) {% endtab %} {% tab title="Artikel-Detail-Seite" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FPjTsEaRRMcwr35AqDkl6%2FBildschirmfoto%202025-11-10%20um%2017.30.33.png?alt=media\&token=30dbaf71-fb37-41ec-a1a5-6c9fa1e99c9e) {% endtab %} {% endtabs %} ### RoxIVE Theme {% tabs %} {% tab title="Produkt-Box" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fsw38viQUl5vhq51yCFRv%2FBildschirmfoto%202022-05-24%20um%2011.10.08.png?alt=media\&token=b60f1e1f-8440-460e-9b8d-e561342e6480) {% endtab %} {% tab title="Artikel-Detail-Seite" %}
{% endtab %} {% endtabs %} ### Flow Theme {% tabs %} {% tab title="Produkt-Box" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FWNSPw2Qg8H8TkwLrgGRd%2FBildschirmfoto%202022-05-24%20um%2011.13.57.png?alt=media\&token=52d61b51-4d3a-4029-ab0a-dc59a9e265f1) {% endtab %} {% tab title="Artikel-Detail-Seite" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FbvrxA7kkUXD03Nl8JU3Y%2FBildschirmfoto%202022-05-24%20um%2011.19.29.png?alt=media\&token=bdc122f1-2901-4bad-9fa5-c7ba641e472b) {% endtab %} {% endtabs %} ### Wave Theme {% tabs %} {% tab title="Produkt-Box" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FFs3kIum1nDl8PxFxS1hI%2FBildschirmfoto%202022-05-24%20um%2011.26.35.png?alt=media\&token=6a39314d-b11b-44a3-a546-c88a9fe60a43) {% endtab %} {% tab title="Artikel-Detail-Seite" %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FOE5m1tHYeK7c4jcGzWFN%2FBildschirmfoto%202022-05-24%20um%2011.31.24.png?alt=media\&token=3addf932-a8a7-46fb-a83a-c8318aa6c07b) {% endtab %} {% endtabs %} ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Basis-Modul ## Modulbeschreibung Dieses Modul wird als Basis für diverse digidesk-Module verwendet und bietet und verschiedene Programmiertechnische Grundfunktionen wie z.B. erleichterte Handhabung der Konfigurations-Funktionen, Versions- und Updatemanagement, eine Basis für Cronjobs oder Vorlagen für die Backend Ansichten. Außerdem bietet es eine einfache Möglichkeit die Caches des Shops zu leeren. Das Modul ist kostenfrei erhältlich unter [https://www.digidesk.de/produkte/basis-modul/](https://www.digidesk.de/produkte/oxid-eshop-module/basis-modul/) ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.5.x) * PHP 8.4 (OXID 7.3.x - 7.5.x) * PHP 8.5 (OXID 7.5.x) ### Webserver-Konfiguration * IonCube Loader (v14 - v15) ### Kompatibel mit den Themes * Flow (OXID 6) * RoxIVE (OXID 6) * Wave (OXID 6 und 7.0) * Apex ab OXID 7.0 ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0.x bis 7.5.x ## Installation ### Ab OXID 6 / 7 {% hint style="warning" %} In der Modulversion 3.0.0 - 3.0.7 für OXID 7 wird das Modul für die Template-Engines "Smarty" und "Twig" unterschiedlich ausgeliefert. Bitte verwenden Sie daher die Zip-Datei (Dateiname beachten) entsprechend der in Ihrem Shop verwendeten Template-Engine. {% endhint %} 1. Erstellen Sie den Verzeichnispfad "packages/digidesk" in der selben Verzeichnisebene, in der die Ordner "source" und "vendor" liegen. 2. Für das Basis-Modul erstellen Sie nun einen weiteren Unterordner "base", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer config repositories.digidesk '{"type":"path", "url": "./packages/digidesk/*"}' composer require digidesk/base ``` 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. ## Update ### Ab OXID 6 / 7 {% hint style="warning" %} In der Modulversion 3.0.0 - 3.0.7 für OXID 7 wird das Modul für die Template-Engines "Smarty" und "Twig" unterschiedlich ausgeliefert. Bitte verwenden Sie daher die Zip-Datei (Dateiname beachten) entsprechend der in Ihrem Shop verwendeten Template-Engine. {% endhint %} 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/base". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/base ``` 4. Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 5. Aktivieren Sie das Modul im OXID eShop Admin. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Backend-Einstellungen 1. Wechseln Sie im Backend-Bereich zu "**Erweiterungen**" und klicken Sie auf "**Module**". 2. Es öffnet sich ein Fenster, wo Ihre Module aktiviert und deaktiviert werden können. 3. Gehen Sie auf das Basis-Modul. Dort befindet sich der Reiter "**Einstell.**" in dem Sie alle Einstellungsmöglichkeiten des Basis Moduls finden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F5ijVRRscdq5shqKb3V16%2FBildschirmfoto%202024-06-18%20um%2018.09.49.png?alt=media\&token=f13f0810-5e52-46d4-9238-b798f7a1719e) * **Mediendateien shopabhängig verwenden (nur für OXID 6):**\ Wenn diese Option aktiviert ist, werden die Mediendateien die über die Mediathek hochgeladen werden nicht zwischen den Mandanten geteilt. Diese Einstellung hat nur dann einen Effekt, wenn Sie eine Enterprise oder B2B Edition von OXID verwenden. * **Benutzerdefinierte Theme-ID:**\ In verschiedenen Templates unserer Module werden 4 Grund-Themes unterschiedlich behandelt: Azure, Flow, Wave und Roxive. Falls Sie Ihr eigenes Theme einsetzen, welches wie eines der 4 Hauptthemes behandelt werden soll - können Sie Ihre eigene Theme-ID hier eintragen und bei "Theme nachahmen" ein Eltern-Theme zuweisen. Die Theme-ID sollte aus mindestens 2 Zeichen bestehen. * **Theme nachahmen:**\ Falls Sie Ihr eigenes Theme einsetzen, welches wie eines der 4 Hauptthemes behandelt werden soll, wählen Sie das passende Elterntheme hier aus. Die ID Ihres Themes sollte im oberen Feld "**Benutzerdefinierte Theme-ID**" eingetragen werden und sollte aus mindestens 2 Zeichen bestehen. * **Cronjob Schlüssel:**\ In diesem Feld wird standardmäßig eine zufällig generierte Zeichenfolge erstellt und gespeichert. Dieser Schlüssel wird zum Aufruf von Cronjobs die mit Hilfe der neuen Cronjob-Grundfunktionen aus dem Basis Modul erstellt wurden benötigt. Wenn Sie diesen Cronjob Schlüssel benötigen, werden Sie darauf im Bereich Cronjob der Dokumentation des jeweiligen Moduls hingewiesen. * **Cache Clear:**\ Wählen Sie hier die Caches aus, die gelöscht werden sollen, wenn Sie den "Alle Caches leeren"-Button in der linken Navigation oben des Backends klicken. * **jQuery Einbindung im Frontend (ab v3.0.5)**\ Über die Moduloption kann ausgewählt werden, ob jQuery aus dem Basismodul im Frontend eingebunden werden soll. Bei aktivierter Option wird jQuery v3.7.1 mit jQuery Migrate v3.5.0 im Frontend geladen. ## "Alle Caches leeren" - Button ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FMAKWOEVdbqjlwyqVBOsp%2FBildschirmfoto%202024-06-18%20um%2018.14.08.png?alt=media\&token=94666db9-7b4c-4de4-a82b-fee6e4f6fea2) Dieser Button ermöglicht es Ihnen im Backend den Shop-Cache mit nur einem Klick zu leeren. Dieser Schritt ist in der Regel nach jeder Modulinstallation und jedem Modulupdate notwendig. Welche Caches dieser Button löscht, können Sie wie unter "**Backend-Einstellungen**" beschrieben selbst entscheiden. Standardmäßig werden der Sprach-Cache, der Datenbank-Cache, der Smarty-Cache sowie der Seo-Cache gelöscht. Optional kann über die Moduleinstellungen die Option "tmp-Verzeichnis" hinzugefügt werden. Mit dieser Option wird das tmp-Verzeichnis des Shops komplett geleert. Bei Bedarf kann mit dem Dreieck im rechten Bereich des Buttons ein einzelner Cache zum Leeren ausgewählt und mit einem weiteren Klick auf den Button geleert werden. {% hint style="info" %} Nach einer Cache Leerung ist es vollkommen normal, wenn die Unterseiten Ihres Shops beim ersten Aufruf länger laden, da der gelöschte Cache erst wieder aufgebaut werden muss. {% endhint %} ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # Bestellbare Gutscheine ## Modulbeschreibung Das kennen Sie doch bestimmt auch: Egal zu welchem Anlass ist die Frage *„Was soll ich bloß verschenken?“* ein großes Problem. Mit dem Modul **„Bestellbare Gutscheine“** können Ihre Kunden im Shop Gutscheine, wie normale Artikel kaufen. Der Kunde kann sich sein Geschenkgutschein individuell unter der Angabe von Wunschbeträgen, Aussehen, persönlicher Nachricht und E-Mail des Beschenkten zusammenstellen. Für den Shopbetreiber bietet das Modul von der Erstellung eines Gutscheins bis hin zu der Verwaltung und dem endgültigem Versand der Gutscheine eine einfache Handhabung. Es können Vorlagen mit vielen verschiedenen Hintergründen und Entwürfen erstellt werden, die dem Kunden im Frontend zur Auswahl gestellt wird. Die Platzierung von bestimmten Textfeldern sind im Backend frei einstellbar. Ablaufdatum der Gutscheine lässt sich unter Moduloptionen beliebig einstellen. Der Kunde kann zwischen den Entwürfen auswählen und die Gutscheinvariante je nach Wunschbetrag wählen. Bestellbare Gutscheine können vom Kunden wie gewohnt in den Warenkorb gelegt, bestellt und bezahlt werden. Der Käufer kann unter Angabe der E-Mailadresse des Beschenkten, den Gutschein auch direkt als PDF-Datei zukommen lassen. Das Modul wurde mit folgenden Zahlart-Modulen unter Oxid 6.1 - 6.4 getestet: PayPal, AmazonPay, Klarna und Payone. Das Modul ist erhältlich auf ## Funktionsbeschreibung Mit diesem Modul können Gutscheine in Ihrem Shop bestellt werden.\ Sie haben die Möglichkeit, wie in der [*Einrichtung des Moduls unter Punkt 2*](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) beschrieben, bestimmte Artikel als Gutschein-Artikel festzulegen. In dem **Gutschein- Konfigurator** können Ihre Kunden diese Gutscheine dann konfigurieren (Wert, Text, Design) und bestellen. Nachdem die Bestellung erfolgreich abgelaufen ist, werden die Gutscheine als PDF an den Kunden rausgeschickt. Die einzelnen Gutschein-Designs können Sie im Backend definieren. Der Gutscheincode ist eine zufällige Zeichenkette, die mithilfe der Shop-ID und den PHP-Funktionen "microtime" und "uniqid" generiert wird. Der Code ist immer 10 Zeichen lang. ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### PHP-Version OXID 6 * PHP 7.0 * PHP 7.1 * PHP 7.2 - 8.0 (OXID 6.2.x - 6.4.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.4.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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `couponselling` im Ordner `packages/digidesk`, in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer require digidesk/couponselling ``` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ### Für Oxid 4.10.x/5.3.x und darunter 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordners `modules/digidesk/` via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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/couponselling`. 3. Deaktivieren Sie das Modul im OXID eShop Admin. 4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/couponselling ``` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 5. Aktivieren Sie das Modul im OXID eShop Admin. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Für Oxid 4.10.x/5.3.x und darunter 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 Ordners "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. ## Einrichtung des Moduls 1. Zunächst sollten Sie einen (oder auch mehrere) Artikel als Gutschein definieren. Legen Sie hierfür einen neuen Artikel an oder verwenden Sie einen bereits vorhandenen Artikel im Shop-Backend unter **"Artikel verwalten"** -> **"Artikel"** aus. Wechseln Sie anschließend auf den Reiter **"Erweitert"** und setzen den Haken bei den Checkboxen **"Versandkostenfrei"** und bei **"Gutschein"**. Falls diese Einstellungen nicht gespeichert werden- hilft es eventuell den Shop-Cache zu leeren. Anschließend speichern**.** 2. Unter **"Shopeinstellungen"** -> **"Versandkostenregeln"** neue Regel **"Gutschein"** erstellen. Den Haken bei der Checkbox **"Immer aktiv"** anklicken und nochmal Speichern. Auf den Button **"Länder zuordnen"** klicken, im neu geöffnetem Popup- Fenster die gewünschte Länder per Drag & Drop ins Fenster **"Zugeordnete Länder"** verschieben. Popup- Fenster schliessen. 3. Unter "**Shopeinstellungen**" -> "**Versandarten**" neue Versandart "**Email**" anlegen und Speichern. \ Den Haken bei der Checkbox **"Immer aktiv"** anklicken und nochmal Speichern. \ Auf den Button **"Versandkostenregeln zuordnen"** klicken, im neu geöffnetem Popup- Fenster den **Gutschein** per Drag & Drop ins Fenster **"Zugeordnete Versandkostenregeln"** verschieben. Popup- Fenster schliessen. (*Popups könnten von Ihrem Browser blockiert werden, in diesem Fall muss man die Popups zulassen.*) Auf den Button **"Länder zuordnen"** klicken, im neu geöffnetem Popup- Fenster die gewünschte Länder per Drag & Drop ins Fenster **"Zugeordnete Länder"** verschieben. Popup- Fenster schliessen. \ Im Reiter **"Zahlungsarten"** den Button **"Zahlungsarten zuordnen"** anklicken und im neu geöffnetem Popup- Fenster gewünschte Zahlungsarten per Drag & Drop ins Fenster **"Zugeordnete Zahlungsarten"** verschieben und Popup- Fenster schliessen. \ Auf die eben erstellte Versandart **"Email"** rechtsklicken und die Adresse des Links kopieren. Der Link beinhaltet unter anderem die ID dieser Versandart, die wir beim nächsten Schritt benötigen. \
4. Den vorhin in die Zwischenablage kopierten Link in einem Texteditor oder in die Browserleiste einfügen und die lange Zeichenfolge ohne die Anführugszeichen in die Zwischenablage kopieren . Der Link könnte z.B. so aussehen: *javascript:top.oxid.admin.editThis('af9866c942b236ff154f7968d9f4b36d');* \ dabei wird nur af9866c942b236ff154f7968d9f4b36d benötigt.\ Unter "**Erweiterungen"** -> **"Module"** auf "**digidesk - Bestellbare Gutscheine"** klicken, dann im Reiter **"Einstellungen"** auf "**Allgemein"** klicken. In das Feld **"E-Mail Versandart ID"** die ID aus der Zwischenablage einfügen und auf Button **"Speichern"** klicken. 5. Unter "**Erweiterungen"** -> **"Module"** auf "**digidesk - Bestellbare Gutscheine"** klicken und dann im Reiter "**Einstellungen**" unter "**Allgemein**" im Feld "**Erlaubte Zahlungsmethoden**" die IDs der Zahlungsmethoden überprüfen und ggf. anpassen. Geben Sie hier die IDs zeilenweise ein. Hier sollten die IDs der Zahlungsarten eingetragen werden, die dem Kunden beim Kauf eines Gutscheins angeboten werden sollen. Die IDs der Zahlungsarten erhalten Sie wie unter Punkt 3 und 4 für die Versandart beschrieben über den Link der benötigten Zahlungsarten. Die Zahlungsarten finden Sie im Backend unter "**Shopeinstellungen**" -> "**Zahlungsarten**". 6. Der **Gutschein-Konfigurator** kann wie folgend aufgerufen werden: 1. Im Backend unter **"Bestellbare Gutscheine"** -> **"Vorlagen"** rechts oben auf **"Gutscheinkonfigurator"** klicken\ 2. Oder im Shop-Frontend unter folgender Adresse: ## Einrichtung der Gutscheine mit frei bestimmbaren Betrag Zunächst sollte unter Moduleinstellungen die Option `Individueller Coupon-Preis` aktiviert werden. Im selben Zug können sie andere optionale Einstellungen zum individuellem Coupon- Preis einstellen die selbsterklärend sind:
Als nächstes sollte man entweder einen neuen Gutschein-Artikel mit einem Preis von **0** anlegen oder bei einem bestehenden Gutschein-Artikel den Preis auf **0** korrigieren. Detaillierte Anleitung zum Anlegen eines Gutschein-Artikels ist weiter oben im Abschnitt [**Einrichtung des Moduls**](https://docs.digidesk.de/moduldokumentationen/bestellbare-gutscheine#installation-1) beschrieben. Jetzt kann der Kunde im Gutscheinkonfigurator seinen Wunschbetrag eintragen, wenn er einen Gutschein mit Wert **individuell** auswählt. Die Eingaben des Kunden werden validiert und falls die Eingabe nicht korrekt ist, wird ein Hinweis angezeigt. ## Backend-Einstellungen Nach der Modulinstallation finden Sie im OXID eShop Admin den neuen Punkt links in der Leiste **"Bestellbare Gutscheine"**.\ An dieser Stelle können die Vorlagen für den **Gutschein-Konfigurator** verwaltet werden. Sie können den Hintergrund bestimmen und die Ausrichtung und Textgröße der einzelnen Textbereiche (Gutscheinwert, Von, Für, Grußtext) festlegen. In der Vorschau können Sie sich direkt die Änderungen ansehen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXl-USk5N7i0hXvlY_%2F-LOXl28sx6w4rijzOLKT%2Fbestellbare-gutscheine-1.png?alt=media\&token=63c618b8-c0a6-4a77-8d2a-10f48d1e5038) ## Gutschein-Konfigurator im Frontend Ihre Kunden können den **Gutschein-Konfigurator** über folgende URL erreichen: Hier besteht die Möglichkeit, eines der von Ihnen festgelegten Motive auszuwählen und den Gutschein zu personalisieren. Unter dem Dropdown bei **"Wert"** werden die von Ihnen als Gutschein-Artikel gekennzeichneten Artikel mit deren Wert (Kaufpreis des Artikels) angezeigt. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXl-USk5N7i0hXvlY_%2F-LOXl3Meyue1kxEq_lMR%2Fbestellbare-gutscheine-2.png?alt=media\&token=54e49c66-bca4-4a56-ba7b-b1e503b18e4d) ## Troubleshooting ### Derzeit ist keine Versandart für dieses Land definiert. * In der Versandkostenregel **"Gutschein"** muß eine Menge oder Preis eingestellt werden * Die Versandkostenregel **"Gutschein"** muß dem Land zugeordnet sein * Die Versandart **"Email"** muß der Versandkostenregel **"Gutschein"** zugeordnet sein * Die Versandart **"Email"** muß den Zahlungsarten zugeordnet sein * Der Zahlungsart müssen Benutzergruppen zugeordnet sein ### Es wird im Gutscheinkonfigurator bei "Wert" nichts angezeigt. > Dann wurde kein Gutschein-Artikel festgelegt, siehe [Einrichtung des Moduls](#einrichung-des-moduls). Überprüfen Sie ggfs. im Artikel-Reiter "Erweitert" ob der Gutscheinartikel als "Gutschein" markiert ist. ### Im Backend wird bei der Vorschau der Gutschein-Designs eine Fehlermeldung angezeigt. > Wenn ein Shop mit einer `.htaccess` geschützt ist, kann das Bild im der Backend-Vorschau nicht geladen werden. Hierzu bitte die Zugangsdaten für die einfache HTTP-Authentifizierung in der Moduleinstellung unter **Einstellungen für die Entwicklungsumgebung** eintragen. ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # 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“**](https://www.digidesk.de/produkte/evoedit-for-visual-cms-visual-editor) 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“**](https://www.digidesk.de/produkte/evoblog-magazin-modul/) integriert werden. Das Modul ist derzeit nur auf Anfrage erhältlich. Kontaktieren Sie uns einfach! * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** ## 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“**](https://www.digidesk.de/produkte/evoedit-for-visual-cms-visual-editor) 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“**](https://www.digidesk.de/produkte/evoblog-magazin-modul/) zu platzieren. {% hint style="info" %} ***\*¹*** 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"** {% endhint %} ## 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](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](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 ![Tab "Grundeinstellungen" im Admin Backend unter econda Integration -> Einstellungen](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90NtHvrt8pAmf90buw%2FBildschirmfoto%202020-06-05%20um%2000.10.52.png?alt=media\&token=8599ff34-5ad6-452c-a085-a3885d93cc79) * **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 ![Einstellungen für das Startseiten Widget](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90i592kLo5EyusaaOC%2FBildschirmfoto%202020-06-05%20um%2001.39.42.png?alt=media\&token=12d54772-9910-4401-97be-ee21c89a6c03) * **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](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M90mCJHenWsy1NLtZGe%2F-M90mW4doKz7LwBTlXaB%2FBildschirmfoto%202020-06-05%20um%2001.40.19.png?alt=media\&token=29b37fc5-691e-4140-8db0-cd91f59886a7) #### 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}] ``` {% hint style="warning" %} **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! {% endhint %} ### Listenansicht | Detailseite | Warenkorb 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](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M90mCJHenWsy1NLtZGe%2F-M90pnlKR671LEkorvKO%2FBildschirmfoto%202020-06-05%20um%2002.17.28.png?alt=media\&token=4836106d-8d11-496a-aed3-d6bba5d4d57c) * **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. ![Hinzufügen des Visual CMS Widgets zu einem CMS Inhalt](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M90mCJHenWsy1NLtZGe%2F-M90svBg51siXPKUKgWD%2FBildschirmfoto%202020-06-05%20um%2002.19.54.png?alt=media\&token=8a8c7d49-16a6-4eb7-a087-b30fd5ea1645) ![Beispielkonfiguration für das Widget](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M90mCJHenWsy1NLtZGe%2F-M90t0gQtvz8uyhuXGFr%2FBildschirmfoto%202020-06-05%20um%2002.23.12.png?alt=media\&token=699b59d4-0825-4074-a42f-f1a8d5215362) ## Darstellung im Frontend Je nach gewähltem Produktlistentyp werden die Cross Selling Widgets im Frontend unterschiedlich ausgegeben. ### Galerie ![Produktlistentyp Galerie: 4 Artikel nebeneinander pro Reihe](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90kRJ_RH_26YCC_rzH%2FBildschirmfoto%202020-06-05%20um%2001.47.02.png?alt=media\&token=e0e36506-4ff7-48c3-b61d-5dd0d4515a18) ### Galerie Zweispaltig ![Produktlistentyp Galerie Zweispaltig: 2 Artikel nebeneinander pro Reihe](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90lN2QcaphAs8Bn3b0%2FUnbenannt-1.png?alt=media\&token=ec3cba86-b7e5-455f-b409-7eaa27bb280e) ### Liste ![Produktlistentyp Liste: Ein Artikel pro Zeile mit Kurzbeschreibung](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M90lPBeiNFWjKlpyKWo%2F-M90llmIHQf53nGg5XSI%2FBildschirmfoto%202020-06-05%20um%2001.49.32.png?alt=media\&token=a0cce146-61c9-4132-9225-716d61001e6c) ### 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. ![econda Visual CMS Widget kombiniert mit dem Angebot Widget](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M90mCJHenWsy1NLtZGe%2F-M90tN3Ftyo9_iNIpEKw%2FBildschirmfoto%202020-06-05%20um%2002.26.36.png?alt=media\&token=15b51648-91cd-4bb3-8454-5c576b83a9e9) ## Kategorie- und Artikeldaten Export ### Export Konfiguration ![Export Einstellungen im Admin Backend unter econda Integration -> Cross Selling Export](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90_ow_2I5lpi8BDwhk%2FBildschirmfoto%202020-06-05%20um%2000.59.22.png?alt=media\&token=828b9dbe-f9d5-4088-bb02-21a473570149) 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. ![Volltextsuche nach Artikeln zum Ausschluss vom Export](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90aReyxJAcdTHyh2jR%2FBildschirmfoto%202020-06-05%20um%2001.08.23.png?alt=media\&token=cde53521-292c-4c34-abab-6fda43e2ee2b) 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](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90b4axOGzfOwUyTblb%2FBildschirmfoto%202020-06-05%20um%2001.09.06.png?alt=media\&token=577bd012-a2f3-4c4e-9560-ac706903ac96) #### 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. ![Volltextsuche nach Kategorien zum Ausschluss vom Export](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90aV1e0bfxuLys5vmf%2FBildschirmfoto%202020-06-05%20um%2001.09.40.png?alt=media\&token=3dae98da-4f7d-41e4-9648-3e449461273a) Auch hier ist selbstverständlich eine Mehrfachauswahl problemlos möglich. ![Problemlose Mehrfachauswahl zum Ausschluss vom Export](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90aZO3QDDMkKqOI43Q%2FBildschirmfoto%202020-06-05%20um%2001.09.57.png?alt=media\&token=44527a49-df15-4c95-8281-f2802ab61728) ### 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 `/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.](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M9-VffLhGPUt4eCDk-I%2F-M90fhdRIaLCEj5Kg7f0%2FBildschirmfoto%202020-06-05%20um%2001.33.06.png?alt=media\&token=1503b9af-7376-4f23-9ee9-19f186a33366) {% hint style="warning" %} **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 `/export/dd_econda_crosssell/`per htaccess-Autorisierung mit einem Passwort zu versehen und dieses ausschließlich econda mitzuteilen. {% endhint %} ### 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 ``` {% hint style="info" %} **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. {% endhint %} Um diesen Cronjob automatisiert auszuführen empfehlen wir bei Linux Systemen **"**[**crontab**](https://wiki.ubuntuusers.de/Cron/)**"**. 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 `/export/dd_econda_crosssell/` auf dem Dateisystem des Servers ablegt. {% hint style="info" %} Ein hilfreiches Tool für die einfache Erstellung von crontab Einträgen nach Ihren Wünschen ist **"**[**crontab.guru**](https://crontab.guru/#0_0_*_*_*)**"**. {% endhint %} ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # evoEDIT for Visual CMS ## Modulbeschreibung **Sie möchten mit dem Drag & Drop Editor vom** [**Visual CMS**](https://www.digidesk.de/visual-cms-editor/) **oder** [**Visual Editor**](https://www.digidesk.de/visual-cms-editor/) **auch die Produktbeschreibungen in Ihren OXID eShop bearbeiten? Das ist jetzt mit dieser Erweiterung möglich!** Sofern Sie eines der Module in Ihrem Shop installiert haben, können Sie mit dieser zusätzlichen Erweiterung nicht nur die CMS-Seiten mit dem Drag & Drop Editor bearbeiten sondern auch Produkt- und Kategoriebeschreibungen.\ Somit können Sie von dem Vorteil profitieren, dass Sie ohne Programmierkenntnisse einzigartige Beschreibungen in kurzer Zeit erstellen können. Ihnen stehen dabei alle gewohnten Funktionen & Widgets zur Verfügung.\ Sie können diesen Editor jeweils bei einzelnen Produkten oder Kategorien aktivieren und deaktivieren. {% hint style="info" %} **Tipp:** Sie verwenden unser [evoBLOG-Modul](https://www.digidesk.de/produkte/oxid-eshop-module/evoblog-das-magazin-modul/) als Blog-Funktion in Ihrem OXID eShop? Mit diesem Modul kann auch der Editor zum Bearbeiten der Blog-Beiträge gegen den Drag & Drop Editor ausgetauscht werden! {% endhint %} Das Modul ist erhältlich auf ## Funktionsbeschreibung **Die Funktionen von evoEDIT im Überblick:** * Erweitert das bereits vorhandene Visual CMS oder Visual Editor. * Mit dem Drag & Drop Editor Produkt- oder Kategoriebeschreibungen bearbeiten. * Schnell einzigartige responsive Beschreibungen erstellen – ohne Programmierkenntnisse. * Lässt sich bei einzelnen Produkten oder Kategorien aktivieren. * Erweitert auch unser [**Blog-Modul „evoBLOG“**](https://www.digidesk.de/produkte/oxid-eshop-module/evoblog-das-magazin-modul/). ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.3.x) * PHP 8.4 (OXID 7.3.x) ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow (OXID 6) * RoxIVE (OXID 6) * Wave (OXID 6 und 7.0) * Apex ab OXID 7.0 ### Benötigte Module * Visual CMS ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0.x bis 7.3.x ## Installation ### Ab OXID 6/7 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `evoedit` im Ordner `packages/digidesk`, in den die heruntergeladene Zip-Datei entpackt wird 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer require digidesk/evoedit ``` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6/7 1. Bitte aktualisieren zunächst Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Entpacken Sie die neue Modulversion in den Ordner `packages/digidesk/evoedit`. 3. Deaktivieren Sie das Modul im OXID eShop Admin. 4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/evoedit ``` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 5. Aktivieren Sie das Modul im OXID eShop Admin. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Backend-Einstellungen Stellen Sie bitte sicher, dass die Einstellung *"Artikelbeschreibung und Kategorienbeschreibung mit Smarty ausführen" unter "Stammdaten->Grundeinstellungen->Perform." aktiviert ist.* ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M3HuglrsG172A-8fY7X%2F-M3HvRmXoOPJ_3z9wvoh%2Fimage.png?alt=media\&token=0bf9af6a-de23-408c-afcb-488603eed96c) Wenn Sie im Backend unter "Artikel verwalten" dann bei "Artikel" einen Artikel anklicken und bearbeiten möchten - erscheint im unteren Bereich der Button "Visual CMS verwenden": ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lt9PWJhmAcCqDG0Jv_D%2F-Lt9RK6TVzCpXJ-uBBY7%2FevoEdit-EE_5_compressed.png?alt=media\&token=b179aae5-1b99-4385-9196-9ddcc954232a) Dort können Sie beispielsweise die Allgemeinen Einstellungen bearbeiten: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lt9PWJhmAcCqDG0Jv_D%2F-Lt9R_YM68RNCSdBIvJc%2FevoEdit-EE_3_compressed.png?alt=media\&token=9fea6292-b4bc-490a-ac18-54f490bb75af) Oder auch die Designs anpassen: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lt9PWJhmAcCqDG0Jv_D%2F-Lt9RkEcG65rc8k4AF2t%2FevoEdit-EE_4_compressed.png?alt=media\&token=1fba8d32-8d02-4453-a713-f654a6280699) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # evoBLOG ## Modulbeschreibung **Mit unserem evoBLOG Modul können Sie Ihren eigenen Blog im OXID eShop erstellen – ganz ohne Programmierkenntnisse!** Haben Sie schonmal nach einer Möglichkeit gesucht die Funktionen von WordPress in OXID zu integrieren? Dieses Modul macht es möglich, einzelne Blog-Beiträge, Ratgeber oder Anleitungen zu erstellen – direkt im Backend Ihres OXID eShops. Damit können Sie nicht nur Ihre Kunden begeistern – auch für Suchmaschinen ist Content auf Webseiten sehr wichtig. Das Modul ist erhältlich auf ## Funktionsumfang **Die Funktionen dieses Moduls im Überblick:** * Blog-Beiträge erstellen und verwalten. * Vorschau-Bilder können bei den Beiträgen hinterlegt werden. * Gruppierung der Beiträge in verschiedene Kategorien. * Passende Produkte können bei einem Beitrag angezeigt werden. * Autoren-Profile können angelegt und Beiträgen zugeordnet werden. * Diverse SEO-Einstellungen: Meta-Beschreibung, Meta-Keywords und SEO-URL. * Mit Hilfe von Visual CMS-Widgets können bestehende Beiträge oder Gruppen mühelos in VisualCMS-Snippets eingebunden werden (nur in OXID EE) * mit Hilfe von eigenem Smarty-Tag odder eigener Twig-Funktion können bestehende Beiträge oder Gruppen mühelos in CMS-Snippets oder Templates eingebunden werden ## Systemvoraussetzungen ### PHP-Version OXID 7 * PHP 8.0 - 8.1 (OXID 7.0.x - 7.3.x) * PHP 8.2 (OXID 7.0.x - 7.5.x) * PHP 8.3 - 8.4 (OXID 7.1.x - 7.5.x) * PHP 8.5 (OXID 7.4.x - 7.5.x) ### Webserver-Konfiguration * IonCube Loader (v14 - v15) ### Kompatibel mit den Themes * Apex ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 7.0.x bis 7.5.x * bei OXID 7.0 wird das "WYSIWYG Editor + Mediathek" von OXID benötigt ### Template-Engine * Smarty bis OXID 7.0.x * Twig ab OXID 7.0.x ## Installation ### Ab OXID 6/7 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 unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `magazin` im Ordner `packages/digidesk`, in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer require digidesk/magazin ``` 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 ## Update ### Ab OXID 6/7 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/magazin` 3. Deaktivieren Sie das Modul im OXID eShop Admin 4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/magazin ``` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 5. Aktivieren Sie dieses Modul im OXID eShop Admin. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Funktionsbeschreibung ### Einträge bearbeiten/erstellen Hier können Sie ihre Blog-Einträge nach Ihren Interessen gestalten: 1. Klicken Sie auf **"evoBLOG"** rechts in Ihrer Leiste und öffnen Sie den Reiter **"Einträge bearbeiten"** 2. Drücken sie auf das **"+"-Symbol** um einen neuen Eintrag zu erstellen 3. Es öffnet sich ein Fenster mit geöffneten Reiter **"Stamm"** 4. Hier können Sie Informationen in das Formular eintragen (Titel,Kurzbeschreibung usw.) 5. Falls es schon **Gruppen** und **Autoren** gibt, können Sie den Eintrag zu den gewünschten Beiträgen zuordnen 6. Unter dem Reiter **"Zuordnungen"** können Sie Artikel zuweisen, welche dann in Ihrem Blog angezeigt werden sollen 7. Sollten Sie auf den Reiter **"SEO"** zutreffen, werden Sie die Möglichkeit haben, die URL Ihres Blogs ändern zu können. 8. Wenn Sie dann zufrieden mit Ihren Einstellungen sind, drücken Sie auf **"Speichern"** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MrUWYjc67L767riBV%2FEintra%CC%88ge.png?alt=media\&token=176282ea-bd43-4174-9632-3761b08164a3) ### Gruppen bearbeiten/erstellen Wenn Sie Ihre Blog-Einträge nach Gruppen sortieren möchten, können Sie hier welche erstellen: 1. Navigieren Sie links zum Reiter **"Gruppen bearbeiten"** 2. Erstellen Sie einen neuen oder bearbeiten Sie einen bereits erstellte Gruppe 3. Folgend öffnet sich ein Fenster mit dem Reiter **"Stamm"** 4. In dem Fenster können Sie den Titel der Gruppe, sowie zum Beispiel ein Vorschaubild festlegen 5. Ist alles festgelegt - klicken Sie auf **"Speichern"** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_Mrfaa8MGNuyohJfym%2Fgruppen.png?alt=media\&token=c701c5d1-41d7-4553-8f9c-4af2cff4f607) ### Autoren bearbeiten/erstellen Falls Sie noch Autoren zu dem erstellen Blog-Eintrag hinzufügen möchten, können Sie das wie folgt: 1. Navigieren Sie zum Reiter **"Autoren bearbeiten"** 2. Erstellen Sie einen neuen oder bearbeiten Sie einen bereits erstellten Autor 3. Ein Fenster öffnet sich mit einigen Einstellungsmöglichkeiten 4. Dort können Sie ein Bild festlegen, sowie einen Namen und eine Kurzbeschreibung hinzufügen 5. Anschließend auf **"Speichern"** klicken ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MrjwDqa1vqqb3WGe2%2FAutor.png?alt=media\&token=72b35dcd-de44-4fd3-8070-3fd1934fa38f) Möchten Sie Ihren Blog in Ihrem Shop betrachten, drücken Sie auf **"Blog öffnen"** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MrnFO4V0yKivqmHvD%2FBlog%20o%CC%88ffnen.png?alt=media\&token=a555105e-9c53-4705-acd5-f8800fdb71c7) Anschließend werden Sie weitergeleitet und können Ihre Einstellungen in Ihrem Shop nun ansehen ### Frontend-Ansicht Die Blog-Seite bzw. die Übersichtsseite können Sie durch die folgende URL öffnen: **\/?cl=dd\_magazin** öffnen. Über das Shop-Backend können Sie für die Übersichtsseite eine sprechende URL hinterlegen. Öffnen Sie hierzu Ihr Shop-Backend und öffnen Sie den SEO-Reiter über **Stammdaten > Grundeinstellungen > SEO-Reiter**. Hier können Sie unter "**Statische URLs**" eine sprechende URL wie folgt hinterlegen: ![SEO-URL für die Blog-Seite anlegen](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MGgisuSWP6xMh8nOw7c%2F-MGgjEJw-VSJ-Iu6wimC%2Fimage.png?alt=media\&token=642b56be-9c0b-43e2-a00e-432b82790f4d) Beim Öffnen der Blogseite werden Ihnen zunächst Ihre **Gruppen** angezeigt, welche Sie erstellt haben. Wenn Sie dann eine Gruppe anklicken, wird rechts daneben Ihre Kurzbeschreibung zum Blog-Eintrag angezeigt. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MtMuAD4nt-7dETKDX%2FBLOG%20frontend.png?alt=media\&token=4a4d914a-92b5-48b0-9576-da49d47d84e0) Drücken Sie auf **"Weiterlesen"** und Sie werden zu Ihrem Eintrag weitergeleitet Hier wird der von Ihnen erstellte Eintrag angezeigt mit dem von Ihnen zugehörigen Autor. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MtZ8QsBubVkCSXtLq%2FEINTRAG%20frontend.png?alt=media\&token=9a96eb79-5667-48d7-a191-e0f596ce1e9a) ### Kommentare bearbeiten Natürlich gibt es die Möglichkeit, Ihren Blog von anderen Shop-Usern kommentieren zu lassen und Sie können diese dann nach Ihren Präferenzen bearbeiten: 1. Um die Kommentar-Funktion nutzen zu können, müssen Sie nach ***"Erweiterungen-> Module-> evoBLOG-> Einstell.->***** Einträge*****"*** wechseln. 2. Unten finden Sie dort die Option **"Kommentar aktiveren"** 3. Wenn Sie die Option eingestellt haben, **speichern** Sie anschließend. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MF5fcsouR9_bfemxHXV%2F-MF5gURS8ECEok6wpqpN%2Fimage.png?alt=media\&token=10fef67d-047a-4263-a2a0-0182ed587017) Dementsprechend wird ein **neues Feld** in Ihrem Shop angezeigt, wo andere Shop-User ein Kommentar zu Ihrem Blog-Eintrag schreiben können. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_Mw4Bub4-L3qoNcdW0%2FFrontend%20Kommentar.png?alt=media\&token=94a89797-c20e-4784-883e-84db1134de1a) Wird dann ein Kommentar abgeschickt, ist er nicht automatisch aktiv. In Ihrem Backend-Bereich können Sie alle eingegangenen Kommentare unter dem Reiter **"Kommentar bearbeiten"** finden: 1. Drücken Sie auf das **"Stift"-Symbol** (rechts neben dem gewünschten Eintrag, wenn Sie mit der Maus über den Eintrag gehen) 2. Es öffnet sich ein Fenster mit verschiedenen Daten: * Der **Blog-Eintrag** wo kommentiert wurde und wann kommentiert wurde (**Datum**) * **Name** und **Email** des Absenders * Der **Kommentar** des Absenders * Möglichkeit eine **Antwort** zu schreiben (**Autor**) 3. Möchten Sie, dass der Kommentar angezeigt wird, dann setzen Sie einen Haken bei **"Freigegeben?"** 4. Anschließend auf **"Speichern"** drücken ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MyyUmLP6lhRmJ-zO7%2FBACKEND%20KOMMENTAR%20EINS.png?alt=media\&token=76ac6818-be03-4a49-8512-7a69826c7995) Wenn Sie sich dann wieder auf Ihren Eintrag in Ihrem Shop bewegen, werden Sie feststellen dass der Kommentar inklusive Antwort angezeigt wird. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_MXx17G6h33hjf5LM5%2F-L_MzBvf5tDfnt55-NeL%2FFRONTEND%20KOMMENTAR%20eins.png?alt=media\&token=c8230638-c28f-4070-a058-bf826ce58603) ### Meta-Beschreibung bzw. Meta-Description für die Blog-Übersichtsseite bearbeiten Die Meta-Beschreibung für die Blog-Übersichtsseite kann man über das CMS-Snippet mit dem Ident "**dd\_magazin\_metadesc**" bearbeiten. Wenn das CMS-Snippet aktiv und Inhalt besitzt, wird der Inhalt auf der Blog-Übersichtsseite als eine Meta-Beschreibung automatisch hinzugefügt. {% hint style="warning" %} Falls die Einstellung vorgenommen wurde, dass auf der Übersichtsseite die erste Gruppe angezeigt werden soll, dann wird nur die Meta-Beschreibung der ersten Gruppe angezeigt und nicht der Text aus dem CMS-Snippet. {% endhint %} ## Mandantenfähigkeit (nur in der EE - Edition) Die Einträge des Hauptshops werden seit der Version **4.5.3** nicht mehr an Subshops vererbt. In einem Subshop erstellte Einträge sind nur in diesem Shop sichtbar. In früheren Versionen war die Vererbung nicht ganz korrekt. ## Visual CMS Natürlich ist es auch möglich die Blog-Beiträge im Visual CMS für Landing Pages oder ähnliches selektiv zu nutzen: 1. Öffnen Sie zunächst **"Visual CMS"** im Backend Ihres Shops (unter ***Kundeninformationen***) 2. Links im Reiter **"Einstell."** können Sie dann ein bereits vorhandenen CMS-Inhalt aussuchen oder ein neuen hinzufügen 3. Haben Sie sich für einen CMS-Inhalt entschieden, drücken Sie dann auf das **"+"-Symbol** um ein neues Widget zu erstellen 4. Anschließend öffnet sich ein Fenster mit **Widget-Übersicht**, wo Sie dann unter der Option **"evoBlog-Gruppe"** oder **"evoBlog"** Ihre bereits erstellten Gruppen oder Beiträge aussuchen und in den **Allgemeinen Einstellungen** die Art der Anzeige der Blog-Beiträge vornehmen können 5. Anschließend auf **"Speichern"** clicken ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fc1SMlIwQCKzPx5C39tYo%2Fimage.png?alt=media\&token=33fbd865-9344-475e-b0e5-ff9ecf760de3) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FEGPwxElMqBuodnALKEpY%2Fimage.png?alt=media\&token=9ac54234-1a3b-4f84-aae7-b9a45ecde469) ## **Einbindung von Blog-Beiträgen per Smarty in Template oder in einen CMS Beitrag** Bei Oxid CE Editionen hat man keinen Visual CMS Editor, trotzdem kann man die vorhandene Blog-Beiträge in eigenen Templates oder CMS-Beiträgen wie im folgendem Beispiel einbinden: Smarty: ```smarty [{ddmagazinlist group="Gruppe2" limit="6" blShowSubgroups=true blShowCreateDate=true blHideBlogImage=false blHideShortDesc=false}][{/ddmagazinlist}] ``` Twig: ```twig {{ ddMagazinList( sGroupTitle='groupTitle', iLimit=10, blShowSubgroups=true, blShowCreateDate=true, blHideBlogImage=false, blHideShortDesc=false ) }} ``` Bei der **group (Smarty)** oder **sGroupTitle (Twig)** tragen Sie bitte den Titel der gewünschten Gruppe ein, **limit (Smarty)** oder **iLimit (Twig)** begrenzt die Gesamtzahl der Blog-Beiträge, **blShowSubgroups** erlaubt die Anzeige von Untergruppen vor den Blog-Beiträgen, **blShowCreateDate** blendet das Erstellungsdatum eines Blog-Beitrags ein, **blHideBlogImage** kann die Bilder bei den Blog-Beiträgen ein oder ausblenden und mit **blHideShortDesc** kann die Kurzbeschreibung ein oder ausgeblendet werden. ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # evoMENU ehemals MegaMenu ## Modulbeschreibung Mit diesem Modul können Sie das Erscheinungsbild und den Inhalt der Menüs in Ihrem OXID eShop verbessern. Im Backend haben Sie die Möglichkeit die Menüs zu verwalten. Die Menüpunkte, die Linkstruktur und die Sortierung können Sie dort erstellen und per Drag & Drop verwalten. Mit dem **evoMENU** können Sie entweder normale Dropdown-Menüs erstellen, die dann nur aus den Unterkategorien bestehen, oder ein besonderes Full-Width Dropdown-Menü, wo Sie neben den Kategorien auch Widgets einbinden. Ein Widget ist beispielsweise ein Bild oder ein Textblock. Natürlich sind die Menüs, die Sie erstellen responsive. Das Modul ist erhältlich auf ## 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) * Magic Quotes müssen deaktiviert sein () ### 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 unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "evomenu" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer require digidesk/evomenu -n ``` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp- Verzeichnis leeren und Views neu generieren ### 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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/evomenu" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/evomenu ``` Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp- Verzeichnis leeren und Views neu generieren ### Bis OXID 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung ### Neuen Menüeintrag erstellen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOcKlyM1pOdC3Fto7oo%2F-LOcFKUjTEmpWscb9RBl%2FBildschirmfoto%202018-10-12%20um%2014.24.57.png?alt=media\&token=9f8ec4e3-b315-49e4-ab41-0106611717f1) 1. **"Plus"-Symbol** anklicken 2. Der neue Menüeintrag öffnet sich und kann bearbeitet werden ### Menüeinträge sortieren ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOcKlyM1pOdC3Fto7oo%2F-LOcHafEVp0qG6Qp8I8S%2FBildschirmfoto%202018-10-12%20um%2014.38.46.png?alt=media\&token=95e5998f-3eef-43cc-96a7-248209af3aac) Die Einträge können ganz einfach per Drag & Drop sortiert werden: 1. Menüeintrag auswählen und Maus gedrückt halten 2. Menüeintrag zu der gewünschten Stelle schieben 3. Maus loslassen ### Menüeinträge verlinken ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOcKlyM1pOdC3Fto7oo%2F-LOcI9J06pqYGLzvpB4H%2FBildschirmfoto%202018-10-12%20um%2014.41.09.png?alt=media\&token=3b165445-260e-4e8e-80b9-63ca652db4f4) Es gibt zwei Möglichkeiten Menüeinträge zu verlinken: #### **Mit einer URL verlinken** 1. Typ **"Link"** auswählen 2. URL eintragen 3. Bei Bedarf auswählen, dass sich der Link im neuen Fenster öffnen soll #### **Mit einer Kategorie verlinken** 1. Typ **"Kategorie"** auswählen 2. Kategorie heraussuchen und auswählen ### Untermenü bearbeiten **Kategorie** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOcKlyM1pOdC3Fto7oo%2F-LOcJYo0Nsb0VmUyaI6w%2FBildschirmfoto%202018-10-12%20um%2014.48.06.png?alt=media\&token=cf5c6990-6a76-4b34-b3a4-8b9f9dd880fc) 1. Untermenü aktivieren 2. Untermenü Typ **"Kategorie"** auswählen 3. Kategorie heraussuchen und auswählen 4. Untermenü Ebenen einstellbar. (Anzahl der Ebenen im Untermenü) ### **Widgets** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOcKlyM1pOdC3Fto7oo%2F-LOcJzsxWcq03S8pXK8o%2FBildschirmfoto%202018-10-12%20um%2014.49.59.png?alt=media\&token=b2d93a7a-248b-416e-8868-6224a1a6fd8b) 1. Untermenü aktivieren 2. Untermenü Typ **"Widgets"** auswählen 3. Widgets auf der rechten Seite per Drag & Drop in den "Zugeordnet"-Bereich schieben 4. Zugeordnetes Widget aufklappen 5. Einstellungen vornehmen 6. Speichern klicken ### **Zusätzliche CSS-Klassen** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MKFqT88wtUQ6Rp53Kgu%2F-MKFrg1yFgAUCAsxLALK%2FBildschirmfoto%202020-10-22%20um%2017.11.27.png?alt=media\&token=bad8e139-25a9-413d-8b2f-d111bed33c8b) Für jeden Menüpunkt und jedes Widget können Sie zusätzliche CSS Klassen angeben die zum Stylen des jeweiligen Elements im Menü verwendet werden können. {% hint style="warning" %} Beachten Sie, dass es sich hierbei um CSS-**Klassen** handelt, nicht um CSS-**Anweisungen**. Die CSS-Klassen die Sie hier angeben müssen in den Styles des verwendeten Themes bereits definiert und mit Anweisungen versehen sein, damit diese Einstellung einen Effekt hat. {% endhint %} ## {% hint style="info" %} **Tipp**: Nach jeder Änderung am Menü oder bei Neuanlage des Menüs bzw. eines Menüpunktes sollten Sie den Modul-Cache und eventuell den Shop-Cache leeren - sonst wird die Änderung im Frontend keine Wirkung zeigen. {% endhint %} ## Troubleshooting #### Problem nach einem Update und beim aktivieren aus der Konsole Wenn Sie das Modul nach dem Update in der Konsole aktivieren und es dabei zu einem Fehler in der Datenbank kommt, z.B.: `Row size too large. The maximum row size for the used table type, not counting BLOBs, is 8126. This includes storage overhead, check the manual. You have to change some columns to TEXT or BLOBs..` könnte folgender Befehl in der Datenbank-Konsole Abhilfe schaffen: `ALTER TABLE ddmenu ROW_FORMAT=DYNAMIC;` ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # evoSLIDER ## Modulbeschreibung Mit dem **evoSLIDER** Modul ist es endlich möglich, schnell und einfach Slider für Ihren OXID eShop zu erstellen und zu verwalten. Sie können beliebig viele individuelle Slider erstellen und diese auf der Startseite oder auf jeder anderen Unterseite einbinden. Das Anlegen eines Sliders erfolgt in wenigen Minuten: Sie wählen einfach die Bilder aus, die angezeigt werden sollen und verlinken gegebenenfalls noch auf einen bestimmten Artikel, eine Kategorie oder eine URL. Mit dem eingebauten WYSIWYG-Editor können Sie jedem Slide noch einen Text beifügen. Jetzt müssen Sie nur noch eine Animation wählen und schon ist es geschafft! Bei der Entwicklung haben wir besonderen Wert auf eine intuitive und einfache Bedienung gelegt. Sie können beispielsweise die Reihenfolge der Bilder einfach per Drag & Drop festlegen. Standardmäßig wird ein von uns voreingestellter Slider mitgeliefert, an den Sie sich beim Anlegen orientieren können. Das Einbinden des Sliders auf der Startseite erfolgt mit nur einem Klick in den Slider-Einstellungen. Falls Sie beispielsweise auf einer Kategorieseite einen Slider einbauen möchten, müssen Sie den entsprechenden Code im Template einbauen oder bei Verwendung von OXID PE/EE mit Hilfe des [evoEDIT Moduls](https://docs.digidesk.de/moduldokumentationen/evoedit-for-visual-cms) über das VisualCMS. Das Modul ist erhältlich auf ## 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) * Magic Quotes müssen deaktiviert sein () ### 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. 1. Sie erhalten dieses unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "evoslider" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/evoslider` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ### 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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/evoslider" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/evoslider`\ Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ### Bis OXID 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung ### Slider erstellen 1. Auf die graue Schaltfläche **"Slider hinzufügen"** klicken 2. Es öffnet sich ein Fenster mit geöffneten Reiter **"Allgemeine Einstellungen"** 3. Hier können Sie Informationen in das Formular eintragen (Name, Animation usw.) 4. Mit der Einstellung "**Promoslider überschreiben**" legen Sie fest, ob der neue Slider den Standard Promoslider überschreiben soll (meist der Slider auf der Startseite) 5. 6. Wechseln Sie zu **"Designeinstellungen"** um noch kleinere Änderungen vorzunehmen 7. Zum Beispiel können Sie einstellen, ob der Slider auf bestimmten Bildschirmgrößen deaktiviert wird 8. Anschließend auf **"Speichern"** klicken ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FvdbAaRRlfUSfn6yKHiI8%2FBildschirmfoto%202022-11-03%20um%2011.35.02.png?alt=media\&token=4ba48072-3490-4647-b6f1-2381d9c7f51f) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FCIu2QV8vuxOxnrItT846%2FBildschirmfoto%202022-11-03%20um%2011.37.32.png?alt=media\&token=72890f73-602a-4fe8-9386-3a1864a73557) ### Slides erstellen 1. Mit der Maus über einen Slider fahren und das Bearbeitungs-Symbol (Stift-Symbol) klicken 2. Auf die graue Schaltfläche **"Slide hinzufügen"** klicken 3. Je nachdem welchen Slider-Typ Sie gewählt haben, können weitere Informationen zum Slide in das Formular eintragen werden. (siehe: [Bild-Slider](#bild-slides) oder [Artikel-Slider](#undefined-1)) 4. Nachdem Sie die Einstellungen für einen Slide gemacht haben, klicken Sie auf den Button **"Speichern".** #### Bild-Slider Wenn Sie als Slide-Typ "Bild-Slider" ausgewählt haben, haben Sie im Reiter "Allgemeine Einstellungen" die folgenden Möglichkeiten um den Slide zu Konfigurieren: * Immer Aktiv / Aktiv von .. bis: Hiermit können Sie steuern, ob der Slide im Frontend ausgegeben wird oder nicht bzw. in welchem Zeitraum der Slide autom. ausgegeben und wieder ausgeblendet wird * Name: Dient lediglich zur Unterscheidung der Slides für das Backend * Hintergrundbild: Wählen Sie das Bild für den Slider aus der Mediathek oder laden Sie ein neues Bild hoch * Anzeigeart: Definiert, wie das hochgeladene Bild angezeigt werden soll. * Bei "Volle Breite" wird die volle Breite des Bildes im Slide ausgegeben und das Bild ggf. unten abgeschnitten und hoch- oder runterskaliert um die volle Breite des Sliders auszufüllen. * Bei "Volle Höhe" wird die volle Höhe des hochgeladenen Bildes im Slider ausgegeben und das Bild dazu ggf. hoch- oder runterskaliert um die volle Höhe des Bildes im Slider anzeigen zu können. * Alt-Attribut / Titel-Attribut: Alt-/Titel-Attribut für die Verlinkung bzw. das Bild * Hintergrundfarbe: Definiert eine Hintergrundfarbe hinter dem Bild. Sofern das hochgeladene Bild den vollen Slider-Bereich ausfüllt, ist diese Hintergrundfarbe nicht sichtbar. * Verlinkung: Wählen Sie wie das Bild verlinkt werden soll: * Artikel: Nach der Auswahl dieses Punktes erscheint ein Suchfeld unter dem Auswahlfeld in dem Sie nach einem Artikel auf Ihrem Shop suchen können. Bei einem Klick auf den Slide wird dann auf die Detailseite des ausgewählten Artikels verlinkt * Kategorie: Ähnlich wie "Artikel", nur mit Kategorien und Verlinkung auf die jeweilige Kategorieseite * Hersteller: Ähnlich wie "Kategorie", nur mit Herstellern * URL: Nach der Auswahl dieses Punktes erscheint ein Textfeld unter dem Auswahlfeld in dem Sie die interne oder externe URL auf die verlinkt werden soll eintragen können. Außerdem erscheint eine Checkbox, mit der Sie die URL in einem neuen Fenster öffnen können, z.B. bei externen Verlinkungen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FwV7NI7X2SdJ6W8QpT5ms%2FBildschirmfoto%202022-11-03%20um%2011.44.28.png?alt=media\&token=5ef0c77e-658b-4b98-b6aa-b14414b711ca) Im Reiter "Videoeinstellungen" finden Sie die EInstellungsmöglichkeiten, wenn Sie statt einem Bild ein Video in dem Slide anzeigen wollen. Es können sowohl Bild- als auch Video-Slides kombiniert in einem Bild-Slider ausgegeben werden. * Video: Wählen Sie hier, ob sie ein Youtube, Vimeo oder lokales MP4 Video ausgeben wollen, oder kein Video. * Video URL: Wenn Sie ein Video ausgeben lassen wollen, geben Sie hier die jeweilige URL zu dem Video ein: * Youtube: Video URL `https://www.youtube.com/watch?v=XXXXXXXXXXX` oder nur die Video ID `XXXXXXXXXXX` * Vimeo: Video URL `https://vimeo.com/XXXXXXXXX` oder nur die Video ID `XXXXXXXXX` * Lokales MP4 Video: URL `https://video.meinshop.de/video.mp4` oder Pfad ausgehend vom out-Ordner `/videos/video.mp4` * Video am Ende von Vorn beginnen lassen: Wenn aktiviert, startet das Video autom. von Vorn, wenn es durchgelaufen ist * Video in einer Lightbox öffnen: Wenn aktiviert, startet das Video erst bei einem Klick auf den Slide und wird in einer Lightbox geöffnet. Vor allem Nützlich bei Video-Slidern die auf Landingpages eingebunden werden. * Lightboxbreite, -höhe und Lightbox Hintergrund: Geben Sie hier die Breite, Höhe und die Durchsichtigkeit des Lightbox Hintergrundes an
Im Reiter "Inhalt" haben Sie die Möglichkeit Ihrem Bild-Slide einen Caption-Text mittels WYSIWYG-Editor oder eine Call-To-Action mit Button hinzuzufügen. Dazu haben Sie die folgenden Einstellungsmöglichkeiten: * Position: Geben Sie an, wie der Inhalt auf dem Bild positioniert werden soll, relativ zur Größe des Sliders * Typ: Wählen Sie hier den Inhaltstyp aus. Je nach gewähltem Inhaltstyp haben Sie unterschiedliche Einstellungsmöglichkeiten * Text: Caption-Text mittels WYSIWYG-Editor * Aktion: Call-To-Action mit Überschrift, WYSIWYG-Editor Text und CTA-Button * Abstand: Geben Sie hier bei bedarf einen zusätzlichen Innenabstand Ihres Inhalts relativ zur Größe des Sliders an
#### Artikel-Slider Wenn Sie als Slide-Typ "Artikel-Slider" ausgewählt haben, haben Sie im Reiter "Allgemeine Einstellungen" die folgenden Möglichkeiten um den Slide zu Konfigurieren: * Immer Aktiv / Aktiv von .. bis: Hiermit können Sie steuern, ob der Slide im Frontend ausgegeben wird oder nicht bzw. in welchem Zeitraum der Slide autom. ausgegeben und wieder ausgeblendet wird * Verlinkung: Wählen Sie ob sie einen bestimmten Shop-Artikel oder einen zufälligen Artikel aus einer Aktion ausgeben wollen * Artikel/Aktion: Suchen Sie hier nach dem Artikel über den Titel oder die Artikelnummer oder nach einer Aktion anhand des Titels
### Slides sortieren ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOclaoSScj6Th-2H3ih%2F-LOclDkIL_deGJLQ5ntz%2FBildschirmfoto%202018-10-12%20um%2016.51.53.png?alt=media\&token=51727b34-3b46-4a01-8dcb-282bf8696266) ## Integration ### Als Promoslider Mit der Einstellung "**Promoslider überschreiben**" legen sie fest, ob der neue Slider den Standard Promoslider überschreiben soll (meist der Slider auf der Startseite) ### Im Visual Editor / Visual CMS Das Modul beinhaltet ein Widget für den Visual Editor bzw. Visual CMS, damit Sie die erstellten Slider mit wenig Klicks an der gewünschten Stelle platzieren können. Drücken Sie zunächst auf das **"Plus-Symbol"**. Es öffnet sich das Fenster **"Widget"**, wo Sie unterschiedliche Kategorien aussuchen können. Klicken Sie auf **"Slider"** und dort können Sie weitere Einstellungen vornehmen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqzdx6c7h6Y9CzLeyp%2F-LOr5pBS21HCSobOGZOy%2FBildschirmfoto%202018-10-15%20um%2011.40.55.png?alt=media\&token=2f619a25-7fc6-4903-b1a7-6f8bfcbbaff4) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqzdx6c7h6Y9CzLeyp%2F-LOr6C6U0vNMEr8RNuAf%2FBildschirmfoto%202018-10-15%20um%2011.41.05.png?alt=media\&token=7b4cdcd0-d48c-4263-ad08-520165080332) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqzdx6c7h6Y9CzLeyp%2F-LOr6TAN-GJ4yW8rY6-N%2FBildschirmfoto%202018-10-15%20um%2011.40.33.png?alt=media\&token=dae90553-e243-4689-96e8-a5506f6ec5fc) {% hint style="info" %} Selbstverständlich ist es auch möglich, dieses VisualCMS Widget mit Hilfe des [evoEDIT](https://docs.digidesk.de/moduldokumentationen/evoedit-for-visual-cms) Moduls in Kategorie- oder Artikelbeschreibungen zu verwenden. {% endhint %} ### Theme-Integration Slider können auch direkt im Theme per Smarty-Tag eingebunden werden: ``` [{ddslider ident="myslider"}] ``` Alternativ kann auch der als Promoslider markierte Slider eingebunden werden: ``` [{ddslider promoslider=1}] ``` ### ### Import der alten Slider-Daten beim Umstieg auf die Version 3.x.x Ab der Version 3.0.0 des Moduls ist keine Kompatibilität mehr zu der vorherigen Versionen gegeben. Beim Update wird ein Backup der alten Tabelle `ddsliderslides` mit dem Namen `ddsliderslides_backup` angelegt. Falls Sie die Daten der Backup-Tabelle `ddsliderslides` weiter nutzen möchten, können Sie versuchen diese mit unserem Import-Skript `import.php` im Verzeichnis bin zu importieren. Wechseln Sie bitte in der console in das Verzeichnis `modules/digidesk/dd_slider/bin` und führen das Skript mit dem Befehl `php import.php` aus. Führen Sie bitte das Skript mit der php-Version aus, die Sie auch im Shop im Einsatz haben. Die Bedienung des Skripts ist selbsterklärend. Sie haben die Möglichkeit die alten Daten von der Backup-Tabelle `ddsliderslides_backup` in die neue Tabelle `ddsliderslides` zu importieren oder bei Bedarf die neue Tabelle `ddsliderslides` zu leeren. Es werden eventuell mehr Slider-Slides für die einzelnen Sprachen importiert als Sie angelegt haben. Dies könnte dadurch verursacht worden sein, dass das Sprachhandling in den vorherigen Versionen nicht ganz korrekt funktionierte. Sie können die überflüssigen Slider-Slides im Backend löschen. Mit der 3.0er Version werden in einer ausgewählten Sprache nur die Slider-Slides geladen, die auch in dieser Sprache angelegt wurden. {% hint style="danger" %} **Die Nutzung des Import-Skripts geschieht auf eigene Gefahr, wir können hier leider keinen kostenlosen Support anbieten.** {% endhint %} ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Cache Modul ## Modulbeschreibung Lange Ladezeiten sind ein KO-Kriterium für jeden Onlineshop und sind in vieler Hinsicht problematisch – oft wirken sie sich direkt negativ auf den Umsatz eines Shops aus. Mit unserem Cache-Modul beschleunigen Sie Ihren Shop auf Raketengeschwindigkeit.\ Alle Unterseiten Ihres Onlineshops werden in einem Cache abgelegt und ab diesem Zeitpunkt von dort aus aufgerufen. Dadurch müssen die verschiedenen Unterseiten nicht bei jedem Aufruf komplett neu aufgebaut werden. In den Modul-Einstellungen können Sie bestimmen, welche Seiten gecached werden sollen und wie lang die Aufbewahrungszeit sein soll.\ Natürlich ist das Zurücksetzen des Caches jederzeit möglich. Mit der Cache-Warm-Up-Funktion können bestimmte Seiten automatisch neu gecached werden. ## Funktionsumfang * Schnellere Ladezeiten direkt nach der Installation des Moduls. * Google PageSpeed Optimierung. * Cache kann auch während einer Session aktiv genutzt werden. * Dynamische Inhalte können per Ajax nachgeladen werden. * Sie können entscheiden, welche Bereiche des Shops gecached werden sollen. * TTL einstellbar. * Im Adminbereich kann der gesamte Cache gelöscht werden, oder nur von einzelnen Bereichen (Detailseiten, Listenansicht, Startseite) oder einzelnen Artikeln / Kategorien. * Cronjob zur automatischen Invalidierung und Aufwärmen des Caches * Über die Moduleinstellung einstellbar, welche Seiten automatisch über die Cache-Warm-Up Logik gecached werden sollen {% hint style="warning" %} Zu beachten ist, dass für die Nutzung von Amazon Pay Express und PayPal Express eine individuelle Erweiterung für das Caching-Modul erforderlich ist! Gerne unterstützen wir Sie dabei. Bitte kontaktieren Sie uns einfach. {% endhint %} ## Systemvoraussetzungen ### 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) ### PHP-Version OXID 7 * PHP 8.0 - 8.1 (OXID 7.0.x - 7.1.x) * PHP 8.2 (OXID 7.1.x) * PHP 8.3 (OXID 7.2.x) ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * Wave * RoxIVE * Apex ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0 bis 7.3.x ### Template-Engine * Smarty bis OXID 6.5.x * Twig ab OXID 7.0.x ## Installation ### Ab OXID 6/7 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. 1. Sie erhalten dieses unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "cache" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/cache` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ## Update ### Ab OXID 6/7 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/cache" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/cache`\ Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ## Automatische Invalidierung des Caches und Cache-Warm-Up Für die automatische Invalidierung des Caches und das nachfolgende Aufwärmen der wichtigsten Seiten enthält das Cache Modul einen Cronjob, um regelmäßig abgelaufene Seiten aus dem Cache zu löschen, so dass diese neu gecached werden können. Das neue Cachen für die wichtigen Einstiegsseiten (in der Moduleinstellung genauer einstellbar) erfolgt autmatisch. Dieser kann über folgende URL aufgerufen werden: ``` https://www.ihre-shop-url.de/?cl=dd_cache_cron&fnc=clearandwarmup&key=[Cronjob Schlüssel in der Modul-Einstellung] ``` Für crontab sieht der Eintrag z.B. folgendermaßen aus: {% code title="OXID 6" %} ``` */15 * * * * https://www.ihre-shop-url.de/?cl=dd_cache_cron&fnc=clearandwarmup&key=[Cronjob Schlüssel in der Modul-Einstellung] ``` {% endcode %} {% code title="OXID 7" %} ``` */15 * * * * /vendor/bin/dd-clearandwarmup --key=[Cronjob Schlüssel in der Modul-Einstellung] ``` {% endcode %} Dies startet das Cronjob-Skript alle 15 Minuten, wobei das Skript die in den Moduleinstellungen definierten TTL-Zeiten berücksichtigt, prüft, welche der gecachten Seiten neu gecached werden müssen und diese dann entfernt, damit sie automatisch oder beim nächsten Aufruf neu gecached werden können. ## Entwickler Informationen Im digidesk Cache-Modul können mehrere Möglichkeiten genutzt werden, um das Modul im größeren Umfang nutzbar zu machen. Durch das Bearbeiten einzelner Code-Fragmente lassen sich diese implementieren. Somit können bestimmte Bereiche dynamisch gehalten werden, auch wenn diese aus dem Cache geladen werden. #### Smarty Plugin/Twig-Funktion Um Widgets trotz aktiviertem Cache-Modul aus dem Cache auszuschließen und weiterhin dynamisch zu halten, integriert das digidesk Cache-Modul ein Smarty Plugin (OXID 6) und eine Twig-Funktion (OXID 7) welches die standard Widget Funktion von OXID ersetzen kann. Nehmen wir zum Beispiel ein Code-Fragment des Templates **"footer.tpl"** (OXID 6) oder **"footer.html.twig"** (OXID 7). Wenn man das oxwServiceList Widget vom Cache ausschließen wollte, braucht man lediglich den Aufruf der `oxid_include_widget`-Funktion mit `dd_cache_include_widget` zu ersetzen: *Vorher:* {% code title="Smarty" %} ```smarty [{block name="dd_footer_servicelist_inner"}] [{oxid_include_widget cl="oxwServiceList" noscript=1 nocookie=1}] [{/block}] ``` {% endcode %} {% code title="Twig" %} ```twig {% block dd_footer_servicelist_inner %} {{ include_widget({ cl: "oxwServiceList", noscript: 1, nocookie: 1, force_sid: force_sid }) }} {% endblock %} ``` {% endcode %} *Nachher:* {% code title="Smarty" %} ``` [{block name="dd_footer_servicelist_inner"}] [{dd_cache_include_widget cl="oxwServiceList" noscript=1 nocookie=1}] [{/block}] ``` {% endcode %} {% code title="Twig" %} ```twig {% block dd_footer_servicelist_inner %} {{ dd_cache_include_widget({ cl: "oxwServiceList", noscript: 1, nocookie: 1, force_sid: force_sid }) }} {% endblock %} ``` {% endcode %} {% hint style="warning" %} ***Wichtig:*** Damit ein Inhalt über das Smarty-Plugin oder über die Twig-Funktion geladen und damit vom Cache ausgeschlossen werden kann, muss dieser wie bisher bei der OXID Standard Funktion über einen Widget-Controller gerendert werden. {% endhint %} ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) #### # Elasticsearch (OXID eShop) ## Modulbeschreibung Mit diesem Modul binden Sie die hochperformante Such- und Analytic-Engine "Elasticsearch" in die Suche Ihres OXID eShops ein.\ Das Modul erstellt täglich automatisch einen Index aller Artikel, bietet Ihren Kunden eine fehlertolerante, schnelle Suchfunktion und Ihnen die Möglichkeit bereits über die Suchfunktion bestimmte Artikel oder Hersteller besonders hervorzuheben. ## Funktionsumfang * Suche ist fehlertolerant. * Direkte Suche nach Artikelnummern möglich. * Hochperformater Artikel-Index mit tägl. Export der Artikel. * Livesuche, sodass bei Eingabe des Suchbegriffs bereits passende Artikel angezeigt werden. * Anzeige von relevanten Kategorien und CMS-Seiten in der Livesuche. * Filtermöglichkeiten auf den Suchergebnis-Seiten: * Filter werden automatisch anhand der Artikel-Attribute aufgebaut. * Preisfilter & Mehrfachauswahl möglich. * Intuitiv bedienbares Backend mit folgenden Funktionen: * Synonym-Mapping * Antonym-Mapping * Category-Mapping: Suchbegriff X zeigt nur Artikel aus festgelegten Kategorien. * URL-Mapping: Suchbegriff leitet auf bestimmte URL um. Zum Beispiel CMS-Seite. * Artikel-Mapping: Anzeige von bestimmten Artikeln bei der Suche nach X. * Detaillierte Auswertung der Suchanfragen: * Was wurde wie oft gesucht? * Die Auswertung kann gut verwendet werden, um mögliche Aktionen oder Werbung festzulegen. * Welche Suchen haben keine Treffer erzielt? Hiermit können Sie das Synonym-Mapping optimieren. * Anzahl der Treffer. Hiermit können Sie prüfen, ob der Min-Score passend gesetzt ist. Werden häufig sehr viele Artikel gefunden, sollte dieser dann hoch gesetzt werden. * Export der Auswertung als PDF, Excel-Tabelle oder CSV-Datei * Hersteller- und Artikel-Boost: Hiermit können bestimmte Artikel gepusht werden. ## Systemvoraussetzungen ### PHP-Version * PHP 7.0 * PHP 7.1 * PHP 7.2 * PHP 7.3 * PHP 7.4 ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * Wave * RoxIVE ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.0.x bis 6.2.x ### Elasticsearch * Ein separater Elasticsearch-Server, entweder lokal oder Extern, wird benötigt * Elasticsearch Version 5.6.x bis 6.4.x ## Installation {% hint style="info" %} Wir empfehlen für die Installation Ihre Wartungsseite zu aktivieren damit es zu keinen Problemen für Ihre Kunden kommt. {% endhint %} 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 unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "elasticsearch" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer require digidesk/elasticsearch -n ``` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp- Verzeichnis leeren und Views neu generieren 6. Geben Sie in den Moduleinstellungen Ihre Serverdaten an: 1. In dem Feld **Protokoll** geben Sie das Übertragungsprotokoll für Ihren Elasticsearch-Server ein: **Http** / **Https** 2. Bei **Hostname** müssen Sie die **URL** oder **IP** ihres Elasticsearch-Servers angeben. 3. Unter **Port** tragen Sie den Port Ihres Elasticsearch-Servers ein, standardmäßig 9200. 4. Falls Ihr Elasticsearch Server das **X-Pack Plugin** installiert hat und dadurch Passwortgeschützt ist, geben Sie unter **Benutzername / Passwort** die Login Daten an.\ Die Standard Logindaten sind Benutzername: elastic und Passwort: changeme 7. Abschliessend müssen Sie den Artikelexport manuell starten, indem Sie folgenden Befehl aus dem Hauptverzeichnis des Shopsystems ausführen: ``` php source/modules/digidesk/dd_elasticsearch/bin/cron.php --key IHR_CRONKEY ``` Ersetzen Sie dabei `IHR_CRONKEY` durch den Key den Sie in den Modul-Einstellungen des **Basis-Moduls** definiert haben. Achten Sie dabei darauf, dass die auf der Kommandozeile verwendete PHP-Version der Version entspricht die in Ihrem Shop verwendet wird. Danach können Sie die Wartungsseite wieder deaktivieren. Für den automatischen täglichen Artikelexport muss auf Ihrem Server ein täglicher Cronjob eingerichtet werden, der den oben genannten Befehl ausführt. Für crontab sieht der Eintrag folgendermaßen aus: ``` 0 0 * * * /usr/bin/php /pfad/zu/ihrem/shop/source/modules/digidesk/dd_elasticsearch/bin/cron.php --key IHR_CRONKEY >/dev/null 2>&1 ``` Dies startet den Artikelexport täglich um Mitternacht. Achten Sie darauf den Pfad zu dem Script anzupassen und **/pfad/zu/ihrem/shop/** mit dem tatsächlichen Pfad zu Ihrem Shop auf dem Server zu ersetzen. ## Update {% hint style="info" %} Wir empfehlen für das Update ihre Wartungsseite zu aktivieren damit es zu keinen Problemen für Ihre Kunden kommt. {% endhint %} 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/elasticsearch" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: ``` composer update digidesk/elasticsearch ``` Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp- Verzeichnis leeren und Views neu generieren 6. Abschliessend müssen Sie den Artikelexport manuell starten, indem Sie folgenden Befehl aus dem Hauptverzeichnis des Shopsystems ausführen: ``` php source/modules/digidesk/dd_elasticsearch/bin/cron.php --key IHR_CRONKEY ``` Ersetzen Sie dabei `IHR_CRONKEY` durch den Key den Sie in den Modul-Einstellungen des **Basis-Moduls** definiert haben. Achten Sie dabei darauf, dass die auf der Kommandozeile verwendete PHP-Version der Version entspricht die in Ihrem Shop verwendet wird. Danach können Sie die Wartungsseite wieder deaktivieren. ## Konfiguration Nach der Installation des Moduls haben Sie verschiedene Möglichkeiten, das Modul nach Ihren Wünschen anzupassen. Im Navigationsmenü befindet sich der neue Reiter **Elasticsearch**. Ein Klick auf diesen öffnet das Modulmenü. Das Modul ist nun aktiv. Ihre Besucher haben nun auch Zugriff auf verschiedene Filter, damit ihre Suchanfragen noch genauere Ergebnisse liefern. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjdhWB4gfNubt14FP%2FElasticsearch-1.png?alt=media\&token=973a86f8-16d0-4889-9fd9-ec3fb30ce74f) ### Auswertung ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjfNI1BlkD833WVuc%2FElasticsearch-2.png?alt=media\&token=faec7f9d-0b2e-4c9f-8e45-2b42f35bf39e) * Unter diesem Menü erhalten Sie eine ausführliche Auswertung der Suchanfragen. Besonders im Hinblick auf die weitere Optimierung des Moduls sind diese Daten sehr wichtig. Außerdem können Sie anhand dieser Daten besser einschätzen, welche Produkte in Ihrem Shop sehr beliebt sind. * Das Fenster **"Top-Suchen"** listet alle Suchen auf und sortiert diese nach Anzahl der Anfragen. Diese Ergebnisse können Sie als Excel-Tabelle, PDF-Dokument oder als CSV-Datei exportieren. * Daneben finden Sie **"Suchen ohne Treffer"**. Hier sehen Sie alle Suchen, die Ergebnislos blieben. Wichtig wären diese beispielsweise für das Synonym-Mapping. Auch hier können Sie die Daten als Excel-Tabelle, PDF-Dokument oder als CSV-Datei exportieren. * Das Diagramm liefert Ihnen Informationen über die **Anzahl der Treffer** einzelner Suchbegriffe und den jeweils erreichten Such-Score. Diese Informationen helfen Ihnen dabei den Minimal-Score einzustellen. ### Allgemeine Einstellungen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjhIsoRSUEM9ZlnHj%2FElasticsearch-3.png?alt=media\&token=b75e3377-1f57-48d4-b15d-72d0e4407e8d) * Mit der Konfiguration **Minimal-Score** legen Sie einen Score fest, der mindestens erreicht werden muss, damit ein Artikel in der Suche angezeigt wird. Behalten Sie erstmal den voreingestellten Wert bei. Wenn Sie merken, dass zu viele Produkte gefunden werden, sollten Sie diesen Wert nach oben korrigieren. * Die **Livesuche-Einstellung** aktiviert bzw. deaktiviert die Livesuche * Mit **Varianten anzeigen** können Sie Varianten von der Suche ausschliessen oder berücksichtigen. * Die Konfiguration **Auswertung-Rhytmus** gibt Ihnen die Möglichkeit festzulegen ob die Suchergebnisse für den Tag, Monat oder das Jahr zusammengefasst und ausgewertet werden soll. Je kleiner die Zeitspanne desto präziser die Auswertung - jedoch erhöht sich dadurch auch der benötigte Datenbank-Speicherplatz. * Außerdem können sie festlegen, **wieviele Artikel in der Livesuche angezeigt werden** sollen. * Die **Maximale Artikel-Anzahl in der normalern Suche sowie in der Livesuche** können Sie ebenfalls begrenzen. * Die Einstellung **Kein Treffer** gibt Ihnen die Möglichkeit einen eigenen Text zu verfassen, der Kunden angezeigt werden soll, wenn die Suche keine Ergebnis liefert. * Die **Suche mit Autocomplete** können Sie nach belieben aktivieren und deaktivieren. Dabei wird dem Kunden anhand des bisher eingegebenen Suchbegriffs ein Artikel vorgeschlagen. Siehe Bild: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjieMcqN79TqviSOt%2FElasticsearch-4.png?alt=media\&token=ca52ae47-795f-484a-a2d4-c7dc9666f749) * Die Einstellung **Suggest anzeigen** gibt an ob eine Suche ohne Ergebnis ähnliche Suchbegriffe vorschlagen soll. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjjv3O-F3Sbq2Dbkt%2FElasticsearch-5.png?alt=media\&token=28f8c90e-3233-4fb3-ab9e-fe8ff7aca425) * Mit der **Filter-Verknüpfung** stellen Sie ein, ob das Suchergebnis auf alle aktiven Filter passen muss (Und), oder ob die aktiven Filter unabhängig voneinander Suchergebnisse liefern (Oder). * Die Einstellungen **alternativer Einstieg** lässt Sie auswählen, ob und was Ihren Kunden angezeigt wird, wenn die Suche kein Ergebnis liefert. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjlhWKSE99qS5NyZy%2FElasticsearch-6.png?alt=media\&token=d9155a9d-d52a-43e8-95ac-85c31a549333) * Die Konfiguration **Produkt-Attribut Berücksichtigung** gibt Ihnen die Möglichkeit, verschiedene Attribute bei der Suche mit ein zu beziehen. Zum Beispiel können Sie die Farbe des Artikels zu 100% berücksichtigen, was dazu führt, dass die Suche nach "blaues Board" Boards mit dem Attribut "Farbe: blau" viel höher in der Suche anzeigen werden, als Boards, die keine blaue Farbe besitzen. ### Boost Einstellungen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjnp18j1CzfF7VFpP%2FElasticsearch-7.png?alt=media\&token=aa65eeca-0bf0-4a4d-82f3-4286c7d22c86) Hier können Sie Artikeln von bestimmten Herstellern einen **Boost** geben.\ Das bedeutet, dass alle Artikel dieses Herstellers weiter oben in den Suchergebnissen angezeigt werden. Ein **Boostwert von 100** garantiert, dass die Artikel dieses Herstellers in den Suchergebnissen an erster Stelle stehen. ### Mapping Einstellungen Hier können Sie verschiedene Mapping-Einstellungen vornehmen und Suchbegriffe zusammenfassen, umleiten oder ausschließen. Die notwendigen Informationen über Suchbegriffe und Suchanfragen finden Sie unter dem Menüpunkt\ [**Auswertung**](https://digidesk1.gitbooks.io/elasticsearch/content/3-Konfig/3_1-auswertung.html) in der Navigationsleiste des Admin-Bereichs. * Das **Synonym Mapping** gibt Ihnen die Möglichkeit verschiedene Suchbegriffe mit anderen zu verbinden. So können Sie Tippfehler von Kunden abfangen und trotzdem das richtige Ergebnis anzeigen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjpOcgNnEAOtUJ4Nt%2FElasticsearch-8.png?alt=media\&token=d5cb3a28-4324-4450-bfa9-b4fd293f438d) * Mithilfe des **Antonym Mapping** können Sie Begriffe anhand des eingegebenen Suchbegriffs ausschliessen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjqti8D86Omoy_S46%2FElasticsearch-9.png?alt=media\&token=653506d9-7ab2-47eb-a77f-f0293e617dcc) * Dank dem **Kategorie Mapping** haben Sie die Möglichkeit Kategorien an Suchbegriffe zu binden. Im unteren Beispiel werden dem Kunden alle Kategorien, die mit Kitesport zu tun haben angezeigt, wenn nach *kite* gesucht wird. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjsao6milYwGvdU2l%2FElasticsearch-10.png?alt=media\&token=6f012d21-56a3-4a5a-9535-a7b2edb41125) * Mithilfe des **URL Mapping** können Sie eine Umleitung einrichten, die den Kunden bei Eingabe des bestimmten Suchbegriffs auf eine andere Seite weiterleitet. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjtmlL6ohLzsXRdNZ%2FElasticsearch-11.png?alt=media\&token=41dd6326-a7fb-485d-a2dc-95441a57845e) * Mit dem **Artikel Mapping** können Sie bestimmen, welche Artikel bei einer bestimmten Suche zusätzlich angezeigt werden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjv4I6HbAOFV9J_FK%2FElasticsearch-12.png?alt=media\&token=954a69f0-748b-4887-bccb-6ecdb09d830a) ### Frontend Einstellungen * Mithilfe der **Farb-Mapping** Einstellungen können Sie die Farbfilter erweitern. Wenn Sie diese Einstellung einrichten, erscheint dem Kunden anstatt zB. dem text "Blau" ein Kästchen mit der gemappten Farbe in der Filterauswahl. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXj_DnttEpsqrEQTm_%2F-LOXjwQKPxuTAokdQWb0%2FElasticsearch-13.png?alt=media\&token=299c1ff4-5672-4a26-960c-447727a6ca34) ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # FAQ FAQ-Modul für den OXID eShop ## Modulbeschreibung Das kennen Sie doch bestimmt auch: Sie möchten ein Produkt kaufen, doch Sie sind sich unschlüssig, da Ihnen noch einige Fragen zum Produkt auf dem Herzen liegen oder Sie möchten eine Frage hinsichtlich einer Kategorie beantwortet haben, welches ggf. zum Produkt gehört. Mit dem Modul **„FAQ“** können Ihre Kunden Fragen zu einem bestimmten Produkt oder zu bestimmten Shop-Kategorien stellen. Fragen anderer Kunden sind auch sichtbar. Für den Shopbetreiber bietet das Modul von der Verwaltung verschiedener Fragen und Antworten bis hin zu der Erstellung von Kategorien und eigener Fragen/Antworten eine einfache Handhabung. Es können bereits vom Kunden gestellte Fragen verwaltet werden und eigene Fragen erstellt werden, welche auch direkt von Ihnen beantwortet werden können. Je nach Bedarf lassen sich beliebig viele Themen erstellen, wofür Ihre Kunden sich interessieren könnten. ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.3.x) * PHP 8.4 (OXID 7.3.x - 7.4.x) ### Webserver-Konfiguration * IonCube Loader (v14 - v15) ### Kompatibel mit den Themes * Flow (OXID 6) * RoxIVE (OXID 6) * Wave (OXID 6 und 7.0) * Apex ab OXID 7.0 ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0.x bis 7.4.x * bei OXID 7.0 wird das "WYSIWYG Editor + Mediathek" von OXID benötigt * ab OXID 7.1 wird das "Mediathek"-Modul von OXID benötigt {% hint style="warning" %} Ab der Modulversion 5.0.5 muss für das FAQ-Modul die Einbindung der jQuery-Bibliothek über das Basismodul erfolgen. Siehe . Wird jQuery bereits im Theme verwendet, kann dieser Schritt entfallen. {% endhint %} ## Installation ### Ab OXID 6/7 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "faq" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/faq` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ## Update ### Ab Oxid 6/7 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/faq" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/faq` Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y", alle anderen können Sie mit "Enter" überspringen. 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ## Backend-Einstellungen Nach der Modulinstallation finden Sie im OXID eShop Admin den neuen Punkt links in der Leiste **"FAQ-Modul"**. An dieser Stelle befinden sich 5 weitere Reiter: ### 1. Grundeinstellungen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FZ17CrzZfqQVjBMzlkdjx%2FBildschirmfoto%202024-07-24%20um%2008.52.19.png?alt=media\&token=b353bdaa-d56b-491d-b34f-81096f84ef9e) #### Allgemeine Einstellungen Hier können Sie unter anderem die "Hilfe"-Seite durch die Shop-FAQ Seite ersetzen und überschreiben.\ Wenn Ihr Shop in weitere Subshops aufgeteilt ist und Sie andere Artikel besitzen, empfiehlt es sich die Produkt-FAQ-Zuordnung für ShopId's zu aktivieren. Praktisch ist die Benachrichtigungsemail, wenn eine neue Frage gestellt wurde. Auf den Produktseiten haben Sie die Möglichkeit Artikel-FAQ zu aktivieren. Die Fragen-Formulare können nach Bedarf aktiviert oder deaktiviert werden, dazu lässt sich einstellen ob Jeder oder nur Angemeldete Benutzer Fragen stellen dürfen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FN5oVo3rprGLYk6NM20YM%2FBildschirmfoto%202024-07-24%20um%2008.57.20.png?alt=media\&token=17b679d0-129b-416c-a2bc-7193cd32b0d9) #### FAQ - Startseite Einstellungen **Zeichen in Kategorien-Filter-Buttons begrenzen auf** - mit dieser Einstellung können Sie bei sehr Langen Kategorienamen die Filter-Buttons auf der FAQ-Hauptseite klein halten. Bei Mouseover wird der komplette Name der Kategorie angezeigt. Mit der Einstellung **Anzahl der Kategorien-Filter-Buttons** haben Sie die Möglichkeit nur eine bestimmte Anzahl der aktiven Kategorien als Filter-Buttons anzeigen zu lassen. **Benutzerdefinierte Kategorien für Filter-Buttons** - mit dieser Einstellung können Sie eine eigene Auswahl an der Kategorien auswählen, die im Frontend als Filter-Buttons angezeigt werden sollen. Falls dieses Feld nicht gefüllt wird, werden alle aktiven FAQ-Kategorien im Frontend angezeigt. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FTKjG80Q26cNBRSPN6DEz%2Fimage.png?alt=media\&token=a2d94a8e-2a7b-4945-a5db-7213eafe4099) #### FAQ-Seite Button-Einstellungen Hier können die Farben für die Filter-Buttons im Frontend definiert werden. Mit einem Mausklick in ein Farbfeld wird eine Farbskala eingeblendet, wo Sie bequem per Schiebeschalter eine Farbe auswählen können. Alternativ können Sie auch einen Farben-HEX-Code eingeben. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FfINQzc5C3MBAgtN3Tzgh%2Fimage.png?alt=media\&token=e80976ef-90ea-4691-ac7a-5e978514ab4f) #### Beispiel FAQ-Daten importieren ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FazvNIjElCwGimnDV12dJ%2FBildschirmfoto%202024-07-24%20um%2008.52.19.png?alt=media\&token=4d4b95a2-8f6e-4a0e-becb-95d1862fb4d9) Wenn Sie das Modul neu installieren und sich zuerst einen Überblick über dir Funktionen verschaffen möchten, haben Sie die Möglichkeit unsere Beispiel-FAQ´s zu importieren. Klicken Sie dafür im oberen rechten Bereich auf den Button **Beispiel FAQ-Daten importieren.** Sobald die Daten importiert wurden, bekommen Sie eine grüne Benachrichtigung über den Import und der Button ändert seinen Namen zu **Beispiel FAQ-Daten entfernen** - damit können Sie bequem die Beispiel-Daten wieder entfernen. Natürlich dürfen Sie unsere Beispiel-FAQ´s nach belieben ändern und für Ihren Shop anpassen. #### #### Zu der FAQ-Seite im Frontend wechseln ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FcYm0Vi6DBrYSTDHdDrjX%2FBildschirmfoto%202024-07-24%20um%2008.52.19.png?alt=media\&token=868c79b0-ba55-48ed-b10a-f2c43f04fa7d) Aus dem admin-Bereich können Sie bequem per Mausklick auf den Button **FAQ öffnen** die FAQ- Frontend- Seite im neuen Fenster öffnen. ### 2. Shop-FAQ-Kategorien ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQpTvRaK5bo8k2pBs7R%2F-MQraDo50TRlmdrOQUzt%2Fimage.png?alt=media\&token=fbe28d60-4d30-4ed2-a19e-1f37fa07d89d) Im Reiter **Shop-FAQ-Kategorien** lassen sich neue Themen/Kategorien erstellen, damit Kunden Fragen zu diesen stellen können und es lassen sich bereits vorhandene Kategorien anzeigen. \ 1\. Klicken Sie auf das grüne "+"-Symbol in der rechten oberen Ecke um eine neue Kategorie anlegen zu können.\ 2\. Setzen den Haken auf aktiv, geben Sie einen Namen ein und ggf. geben Sie eine Sortierung als Zahl an. Wenn Sortierung nicht angegeben oder = 0 - wird standardmäßig alphabetisch sortiert. Ansonsten wird die Reihenfolge nach Zahlen sortiert (0 oben, 1 drunter, danach die 2 usw.)\ 3\. Anschließend auf **Speichern** drücken.
### 3. Shop-FAQ bearbeiten ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQpTvRaK5bo8k2pBs7R%2F-MQrgNtZ26QTeQWuol2T%2Fimage.png?alt=media\&token=e257c928-e0d0-42dd-8789-b905ede74480) Nun ist es möglich eingegangene Fragen zu bestimmten Kategorien/Themen zuzuordnen oder welche neu anzulegen, insofern Bedarf besteht. Eingegangene Fragen sind zunächst auf "inaktiv" gesetzt und beinhalten nur die Kundenfrage.\ 1\. Klicken Sie auf das "Stift"-Symbol eines bestehenden Eintrags (wird erst eingeblendet wenn man die Maus ganz nach rechts entlang des Eintrags bewegt) oder auf das "+"-Symbol in der oberen rechten Ecke, dann öffnet sich ein Fenster mit Einstellungsmöglichkeiten.\ 2\. Hier ist es möglich, den Eintrag (in)aktiv zu setzen, die Kategorie auszusuchen, wo die Frage und die Antwort zugeordnet werden kann und diese zu bearbeiten.\ 3\. Natürlich ist es wieder möglich eine Sortierung anzugeben. Wenn Sortierung nicht angegeben oder = 0 - wird standardmäßig alphabetisch sortiert. Ansonsten wird die Reihenfolge nach Zahlen sortiert (0 oben, 1 drunter, danach die 2 usw.)\ 4\. Anschließend auf **Speichern** drücken. {% hint style="warning" %} Fragen müssen unbedingt einer FAQ-Kategorie zugeordnet werden, da sie sonst nicht im Frontend angezeigt werden. {% endhint %} ### 4. Produkt-FAQ bearbeiten ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQpTvRaK5bo8k2pBs7R%2F-MQrjiOi15Xzw0DeF2Q_%2Fimage.png?alt=media\&token=b707e20d-6f8e-4f11-828a-17eab797c958) Im letzten Reiter, lassen sich die die Fragen und Antworten, welche von Ihren Kunden zu bestimmten Produkten gestellt worden sind anzeigen.\ 1\. Klicken Sie auf das "Stift"-Symbol eines bestehenden Eintrags (wird erst eingeblendet wenn man die Maus ganz nach rechts entlang des Eintrags bewegt) oder auf das "+"-Symbol in der oberen rechten Ecke, dann öffnet sich ein Fenster mit Einstellungsmöglichkeiten.\ 2\. Im Fenster sind 2 Reiter zu sehen: **FAQ** und **Artikel**\ 3\. Im Reiter **FAQ** (wo Sie automatisch landen) ist es möglich, den Eintrag (in)aktiv zu setzen, die Sortierung anzugeben, die Frage und die Antwort zu bearbeiten. Wenn Sortierung nicht angegeben oder = 0 - wird standardmäßig alphabetisch sortiert. Ansonsten wird die Reihenfolge nach Zahlen sortiert (0 oben, 1 drunter, danach die 2 usw.)\ 4\. Im Reiter **Artikel** lässt sich der Eintrag zu bestimmten Artikeln zuordnen. Wenn es sich um eine Kundenfrage handelt, ist ein Artikel bereits schon vorhanden. Sie haben die Möglichkeit, diese FAQ anderen Artikeln zusätzlich zuzuordnen. Klicken Sie dafür in das Feld und geben Sie die Artikel-Nummer oder Suchbegriff ein. Es öffnet sich eine Auswahl mit passenden Suchergebnissen, die Sie selektieren können.\ 5\. Anschließend auf **Speichern** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQpTvRaK5bo8k2pBs7R%2F-MQrlEhhFF5n9kHUfado%2Fimage.png?alt=media\&token=9bf6c507-dc18-4e11-9376-69a3bd3338f4) ### **5. Overlay-FAQ bearbeiten** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FWzAFV4isUbbROoHYrtMk%2FBildschirmfoto%202026-04-28%20um%2010.50.18.png?alt=media\&token=cd2e364b-1ac1-4c30-bb1e-92badd08f702) Hier können Sie das Aussehen des Overlay-FAQ´s im Frontend einstellen und definieren. Es gibt 2 unterschiedliche Overlay- Buttons die FontAwesome- Icons benutzen. Es kann nur einer zugleich aktiv sein, man kann aber beide deaktivieren. {% hint style="warning" %} Bei Verwendung der Twig-Engine werden anstelle der FontAwesome-Webfont-Icons die im Modul hinterlegten SVG-Grafiken von FontAwesome verwendet. {% endhint %} ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQuZL1aWW0Ly72gauBK%2F-MQudfaID5VJD-OcrHT2%2Fimage.png?alt=media\&token=d5cd6a68-d330-4ff2-bcc4-295114ba4ea5) Bei dem Punkt **Button Z-Index** können Sie den Button und das Overlay in den Vordergrund bringen, falls diese von anderen Elementen verdeckt werden sollten. **Button Offset Y** definiert den vertikalen Versatz von oben oder von unten, je nachdem was Sie bei dem **Button/Widget Position** einstellen. Button Offset X **i**st für horizontalen Versatz zuständig, entweder vom linken oder vom rechten Rand, je nachdem was Sie bei dem **Button/Widget Position** einstellen. Und beim letzten Punkt **Button/Widget Position** definieren Sie die Grundpositionierung des Overlay- Buttons und des Overlay- Fensters. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQuZL1aWW0Ly72gauBK%2F-MQufZlMbL4dSImd2-Zp%2Fimage.png?alt=media\&token=2a2a10d0-7dce-4537-b155-b2fbef59153e) Die Einstellungen für **Overlay mit eckigem Sticky Button** sind ähnlich. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQuZL1aWW0Ly72gauBK%2F-MQuiUCHz41qJ-9Q8Uh_%2Fimage.png?alt=media\&token=ca3d143c-ddb1-43bb-ac9b-1e367b5d00c9) Allgemeine EInstellungen**:** wenn **Button Verlinkung zu FAQ-Seite** aktiviert ist, wird man beim Klick auf den Overlay- Button auf die FAQ- Seite weitergeleitet. Andernfalls wird das Overlay- Fenster eingeblendet. \ Aktivierung von **FAQ-Seite im neuen Fenster** wirkt zusammen zum einen mit dem oberen Punkt, wenn dieser aktiv ist- oder mit dem Link im Overlay- Fenster. Wenn **Mobile Ansicht kein Overlay** aktiviert ist- wird in der mobilen Ansicht keine Overlay-Button angezeigt. Mit Überschrift des Overlays , Überschrift des Footers und den beiden Farbeinstellungen definieren Sie die die Überschriften und Farben im Overlay- Fenster. Der Footer ist gleichzeitig ein Link zu der FAQ- Seite. Hier ist ein Beispiel wie das Overlay- Fenster im Frontend bei den oben definierten Einstellungen aussehen kann: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FPPoEYOygbRnPybMSN8UW%2FBildschirmfoto%202026-05-05%20um%2014.59.47.png?alt=media\&token=ea26ae4e-9e64-4a92-a23b-f31b9cb67ef0) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F5Nx9w5IIQe5btOZ6Qw4f%2FBildschirmfoto%202026-04-28%20um%2010.53.01.png?alt=media\&token=0816c0c2-f449-45bd-b593-b845f24dfed3) Falls Sie eigene Bilder anstatt der mitgelieferten SVG-Icons im Overlay nutzen möchten, können Sie als **Alternative Icons** eigene Bilder definieren. Der X-Button wird angezeigt um das Overlay-Fenster zu schliessen, der ?- Button ist der Anfangs-Button, beim Klick auf dieses wird das Overlay-Fenster eingeblendet. Der Pfeil-Button wird angezeigt wenn man im Overlay-Fenster auf eine Frage klickt und dabei die Ansicht zu dieser Frage wechselt. Um zurück zu der Hauptansicht zu gelangen, wird ein Klick auf den Zurück-Pfeil benötigt. Der Suche-Button wird rechts neben dem Input für die Suche angezeigt. \ Um die Einstellungen zu übernehmen, klicken Sie bitte auf Speichern. ### **Produkt-FAQ bei Artikel-Varianten** Bei Artikel- Varianten, die keine eigene FAQ haben ist die Nutzung des FAQ vom Vater- Artikel möglich. Dazu setzen Sie bitte bei dem FAQ-Modul im Shop-Admin unter **Erweiterungen->Module** unter Reiter **Einstell. -> Allgemein** den Hacken bei der Checkbox **Verwende Parent-FAQ** **bei Varianten** und Speichern Sie ab. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FmxE45AKYfrv7Nf0iwoNR%2FBildschirmfoto%202026-04-28%20um%2011.06.27.png?alt=media\&token=6e3d5722-c95d-416e-bbdf-ed1ed58fd25c) ### FAQ-Einträge in eine andere Sprache übersetzen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQpTvRaK5bo8k2pBs7R%2F-MQrmNQBy-qG1ZlYw43h%2Fimage.png?alt=media\&token=b8720fb9-c950-44dd-9799-3143e5a2fc6d) Jeder Menu-Punkt im FAQ-Modul hat den Button für andere Sprachen (Sprachen können Sie im Shop-admin unter Menu-Punkt **Stammdaten -> Sprachen** anlegen und aktivieren) . Wenn Sie die Einträge bereits in einer Sprache angelegt haben, haben Sie die Möglichkeit diese Einträge (Kategorien, FAQ´s, Produkt-FAQ´s) in eine andere Sprache zu übersetzen. Klicken Sie dafür auf den Sprachbutton oben rechts und selektieren Sie gewünschte Sprache. Damit Sie die Einträge auch identifizieren können, werden diese in der Liste ausgegraut und mit dem Sprach- Kürzel am Ende angezeigt, in der sie schon angelegt worden sind. Bewegen Sie die Maus zu der rechten Seite eines Eintrags, um die Editier-Icons einzublenden und klicken Sie auf das "Stift"-Symbol um den Eintrag anzeigen zu lassen und in die ausgewählte Sprache zu übersetzen. ## Frontend-Ansichten ### FAQ-Ansicht ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FqTIUWk2nGH5WSUTLeaqV%2FBildschirmfoto%202026-05-05%20um%2015.00.44.png?alt=media\&token=aa00823e-d5bf-4c46-80c7-1b043ccd95d0) Im Frontend können Sie die im Backend angelegten und aktiven Kategorien als **Kategorien-Filter-Buttons** sehen, die FAQ-Einträge lassen sich mit einem Klick auf einen Filter-Button nach bestimmten Kategorien Filtern. Standardmäßig werden alle FAQ´s angezeigt. ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FF3LfzoqgxVryTnDw2m7n%2FBildschirmfoto%202026-05-05%20um%2015.02.14.png?alt=media\&token=517e2f14-5d5a-4dd0-8bfd-f796b221ecb0) Im unteren Bereich kann man zu der nächsten Seite wechseln. Standardmäßig werden 10 FAQ´s pro Seite angezeigt. Mit dem Klick auf den Button **Schreiben Sie uns Ihre Frage** haben Ihre Kunden die Möglichkeit Fragen zu Ihren erstellten Kategorien/Themen zu stellen. Diese Fragen landen im admin unter dem Menüpunkt '**Shop-FAQ bearbeiten**' und sind zuerst deaktiviert. Erst wenn diese durch den admin beantwortet und aktiviert werden- sind die Kundenfragen im Frontend sichtbar. Falls Sie die FAQ-Startseite einbinden möchten, lautet der Link: **`https://ihreshopdomain/?cl=dd_faq`**
Wenn Sie bei den Grundeinstellungen die Option **Shop-Hilfe URL mit FAQ URL überschreiben** aktiviert haben, dann ist diese Seite über "Hilfe" des Shops auch aufrufbar. ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FWFQahElDMYfM5uyhyUYH%2FBildschirmfoto%202026-05-05%20um%2015.03.15.png?alt=media\&token=517027ac-c955-4514-b15a-9b8e2592e2df) ### Produkt-FAQ Ansicht ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FgKwsKRwXLvU8wAEZqL98%2FBildschirmfoto%202026-05-05%20um%2015.09.51.png?alt=media\&token=182ec6cf-d274-44ca-80f8-812b0f45903c) Um eine Frage zu einem Produkt erstellen zu können, ist es nötig auf die Detailseite eines Artikels zu gelangen.\ Dort wird der Reiter **FAQ** angezeigt. Wird darauf geklickt, erscheinen Fragen und Antworten zu dem Produkt und darunter ist ein Kontaktformular, wo eigene Fragen zum Produkt gestellt werden können. In Backend-Einstellungen kann man den FAQ-Reiter bei Bedarf komplett deaktivieren. Ausserdem lässt es sich einstellen dass nur angemeldete Kunden Fragen stellen dürfen. Die von Kunden gestellten Fragen landen im admin unter dem Menüpunkt 'Produkt-FAQ bearbeiten' und sind zunächst inaktiv. Erst wenn diese durch den admin beantwortet und aktiviert werden- sind die Kundenfragen im Frontend im zugeordneten Artikel auch sichtbar. {% hint style="warning" %} **Bei Verwendung des Apex-Themes in OXID 7:**\ Aufgrund der fehlerhaften CSS-Anweisung `display: block` in der CSS-Regel `.details .accordeon .collapse` im Apex-Theme werden die "Accordion"-Elemente nicht korrekt zusammengeklappt. Dieser Fehler betrifft auch den FAQ-Block auf der Produktseite. Um das Problem zu beheben, sollte die oben genannte Css-Anweisung aus der Css-Regel innerhalb eines Child-Themes entfernt werden. {% endhint %} ### Overlay im Frontend ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fo2FcCd4rwAxiIeeLNPN7%2FBildschirmfoto%202026-05-05%20um%2015.13.31.png?alt=media\&token=04f3b61e-4f2d-4786-8f62-64cb52c39c33) Um nach einer Frage zu suchen, geben Sie bitte ein Stichwort in das Suchfenster und klicken Sie auf das Suchen- Icon rechts neben dem Suchfeld oder bestätigen Sie mit Enter. In der Unteren Hälfte werden die Ergebnisse gelistet. ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FLmFNQbWLgry314FkdgKj%2FBildschirmfoto%202026-05-05%20um%2015.14.37.png?alt=media\&token=5027d676-5b91-454e-b3e5-d60b8aca0bc3) Beim Klick auf eine der angezeigten Fragen gelangt man zu der Frage. Um wieder zurück zu gelangen, klicken Sie bitte auf den Pfeil- Button in der linken oberen Ecke. ![Ansicht mit Apex-Theme](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FatIibc8V2vZjipWnfN8l%2FBildschirmfoto%202026-05-05%20um%2015.15.28.png?alt=media\&token=7780e4b8-d724-47bb-884e-ac2534ce9ff3) Beim Klick auf den Button unten im Footer "**Zu allen FAQ´s von uns.**" wird man zu der FAQ-Seite umgeleitet und das Overlay- Fenster wird geschlossen. ### Einbindung der jQuery-Library Für dieses Modul wird die jQuery-Bibliothek benötigt. Sie kann über das Basis-Modul eingebunden werden, sofern sie nicht bereits mit dem Theme geladen wird. Siehe ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Gutschein Guthaben ## Modulbeschreibung Mit dem Modul **Gutschein Guthaben** können Ihre Kunden endlich Wertgutscheine in Teilbeträgen einlösen.\ Nach dem Einlösen eines Gutscheins im Shop, wird Ihren Kunden das Restguthaben im Warenkorb bei der Einlösung des Gutscheins angezeigt. \ Das Modul bietet den Vorteil, dass das Restguthaben nicht nach einem Einkauf verfällt, sondern der Gutschein so lange gültig ist, bis das gesamte Guthaben aufgebraucht ist. Das Modul wurde mit folgenden Zahlart-Modulen unter Oxid 6.1 - 6.4 getestet: PayPal, AmazonPay, Klarna und Payone. ## 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 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "couponscredit" 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/couponscredit` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ### Bis OXID 4.10.x/5.3.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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/couponscredit". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/couponscredit` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Dieses Modul ermöglicht es, Gutscheine mit nur einem Klick für Ihre Kunden attraktiver zu gestalten. Durch die Einstellungen im Backend legen Sie bestimmte Werte fest (Name, Wert, Menge, Gutscheinnummer, Gültigkeitsbereich usw.) und durch das Aktivieren des **"Guthabens"** können diese an den Kunden verteilt werden, damit die Kunden dann Ihren **Gutschein** als Guthaben einlösen können. Im Folgenden Abschnitt wird Ihnen näher erläutert, wie Sie die Gutscheine im Backend einstellen können. Außerdem wird die Ansicht Ihrer Kunden dargestellt. ## Backend-Einstellungen 1. Wechseln Sie im Backend-Bereich zu **"Shopeinstellungen"** und drücken Sie auf **"Gutscheinserien"** 2. Es öffnet sich ein Fenster, wo Sie Einsicht in Ihre **bereits erstellten Gutscheine** haben und diese zu bearbeiten oder **Gutscheine** zu erstellen. 3. Unten sehen Sie dann Einstellungsmöglichkeiten und füllen diese nach Bedarf aus. 4. Setzen Sie ein Häkchen bei **"Guthaben aktivieren (nur mit absoluten Rabatten möglich)"** damit das Modul wirksam wird. (Um nähere Informationen über die Einstellung zu erhalten, können Sie auf das **"?"-Symbol** daneben klicken) 5. Anschließend auf **"Speichern"** drücken 6. Danach können Sie auf der rechten Seite, weitere Einstellungen vornehmen. (Gutscheinnummer, Anzahl usw.) 7. Füllen Sie diese aus und klicken Sie anschließend auf **"Generieren",** dann sind alle wichtigen Einstellungen vorgenommen. ![Einstellungsmöglichkeiten für Gutscheine](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfkn2p3J_ALMEMwxGb%2FBildschirmfoto%202018-10-25%20um%2015.50.39.png?alt=media\&token=09a51bf4-ce38-4c88-b073-6f2d588bd002) \ Sie können auch einsehen, wie viel **Guthaben** auf den jeweils **ausgewählten Gutschein** noch verfügbar ist. ![verfügbares Guthaben](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfm0fWHHi-ETnteX7p%2FBildschirmfoto%202018-10-25%20um%2016.03.52.png?alt=media\&token=2c771ee0-b96f-410d-9ef5-282942cadc95) ## Frontend-Ansicht Nachdem der Kunde nun einen Artikel ausgesucht, einen Gutschein von Ihnen erhalten hat und bereit ist zu zahlen, kann der Kunde diesen Gutschein einlösen. Nach der Eingabe des Gutscheines, kann der Kunde rechts einsehen, welche Gutscheinnummer eingelöst wird und wie viel Restguthaben nach dem Einkauf übrig bleiben würde. ![Gutschein-Einlösung](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfnc6z0O1MZstifVME%2FBildschirmfoto%202018-10-25%20um%2016.15.06.png?alt=media\&token=9604f56d-9ff0-47a7-b37d-1b4b7786c31a) \ Vor dem endgültigen Bezahlen, hat der Kunde noch ein letztes mal die Möglichkeit einzusehen, welche Gutscheine benutzt werden und wie viel Restguthaben nach dem Einkauf übrig bleibt. Nach dem Bezahlen kann der Kunde durch andere Artikel Ihres Shops stöbern und den Gutschein einlösen, bis dieser komplett verbraucht wird. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LPfdWfFkIJ4w7TeH3ov%2F-LPfoc0TeXtT-G8yLT2S%2FBildschirmfoto%202018-10-25%20um%2016.22.44.png?alt=media\&token=0a15f550-f0cf-4fac-9972-94ec6299e9f4) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Gutscheine für kostenlosen Versand ## Modulbeschreibung Mit dem Modul **Gutscheine für kostenlosen Versand** können Gutscheine für kostenlosen Versand angelegt werden. Das Modul ist erhältlich auf [https://www.digidesk.de/produkte/gutscheine-kostenloser-versand/](https://www.digidesk.de/produkte/versandkosten-mit-gutschein-bezahlen/) ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.2 - 7.4 (OXID 6.3.x - 6.4.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/EE 6.3.x bis 6.5.x ## Installation ### Ab OXID 6.3.x 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. 1. Sie erhalten dieses unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "freeshippingcoupons" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/freeshippingcoupons` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ## Update ### Ab OXID 6.3.x 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/freeshippingcoupons" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/freeshippingcoupons`\ Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ## Backend-Einstellungen Nach der Modulaktivierung kann im admin unter **Shopeinstellungen -> Gutscheinserien** neue Gutscheinserie für kostenlosen Versand angelegt werden. Im Register "**Stamm**" sollte die Option "**Für kostenlosen Versand benutzen**" aktiviert werden, das Feld **Rabatt** bleibt leer. Die restlichen Einstellungen können nach Bedarf vorgenommen werden. Nach dem Speichern können in der rechten Fensterhälfte Gutscheine generiert werden: empfohlen ist eine feste Gutscheinnummer (z.B. versandfrei2022) und eine voraussichtlich benötigte Anzahl, da jeder Gutschein nach dem Einlösen verfällt. ## Ansicht im Warenkorb Nach dem Einlösen eines Gutscheins für kostenlosen Versand werden die Versandkosten in der Tabelle auf 0 gesetzt. Der Kunde hat die Möglichkeit den eingelösten Gutschein wieder zu entfernen, mit dem Klick auf den Link **Entfernen** wie im Screenshot markiert.
## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Image-Optimizer ## Modulbeschreibung Mit dem **"Image-Optimizer"** können Sie alle JPEG oder PNG - Bilder in Ihrem OXID eShop mit nur einem Klick komprimieren. Durch die Komprimierung der Bilder wird die Dateigröße verringert und somit verbessern Sie die Ladezeiten in Ihrem Shop. Ausserdem können alle JPEG oder PNG - Bilder in platzsparendes WEBP Format konvertiert und im Frontend angezeigt werden. Das Modul ist erhältlich auf ## 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 * Unix basierter Webserver * IonCube Loader (mind. v5.0) * Kommandozeilen-Programm: jpegoptim () * Kommandozeilen-Programm: OptiPNG () * cwebp Encoder Tool () * PHP Extension GD Library: die weniger effiziente Alternative zu den oberen 3 Tools mit jpeg/png/webp Unterstützung wird bei fehlenden Tools eingesetzt * PHP Erweiterung: zip () * Erlaubnis "**exec**" per PHP auszuführen ### 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 ### Installation von Jpegoptim Voraussetzung ist ein SSH-Benutzer (sofern kein Direktzugriff zum Server besteht) und die Rechte zum Installieren von Paketen/Binaries. 1. Mit dem Server über eine Konsole verbinden (z.B. Putty) ``` ssh benutzer@meinserver.de ``` 2. Source-Code herunterladen (Stand 22.02.2022: jpegoptim v1.4.6): ``` wget https://www.kokkonen.net/tjko/src/jpegoptim-1.4.6.tar.gz ``` 3. Paket entpacken, konfigurieren und installieren (Dateibezeichnung ist ggf. unterschiedlich): ``` zcat jpegoptim-1.4.6.tar.gz | tar xf - cd jpegoptim-1.4.6 ./configure make make strip make install ``` ### Installation von OptiPNG Voraussetzung ist ein SSH-Benutzer (sofern kein Direktzugriff zum Server besteht) und die Rechte zum Installieren von Paketen/Binaries. 1. Mit dem Server über eine Konsole verbinden (z.B. Putty) ``` ssh benutzer@meinserver.de ``` 2. Source-Code herunterladen (Stand 22.02.2022: optipng v0.7.7): ``` wget http://prdownloads.sourceforge.net/optipng/optipng-0.7.7.tar.gz ``` 3. Paket entpacken, konfigurieren und installieren (Dateibezeichnung ist ggf. unterschiedlich): ``` zcat zvxf optipng-0.7.7.tar.gz cd optipng-0.7.7 ./configure make make install ``` ### ### Installation von WEBP Encoder Tool Voraussetzung ist ein SSH-Benutzer (sofern kein Direktzugriff zum Server besteht) und die Rechte zum Installieren von Paketen/Binaries. 1. Mit dem Server über eine Konsole verbinden (z.B. Putty) ``` ssh benutzer@meinserver.de ``` 2. Source-Code herunterladen (Stand 22.02.2022: libwebp v1.2.2): ``` wget https://storage.googleapis.com/downloads.webmproject.org/releases/webp/libwebp-1.2.2.tar.gz ``` 3. Paket entpacken, konfigurieren und installieren (Dateibezeichnung ist ggf. unterschiedlich): ``` tar xvzf libwebp-1.2.2.tar.gz cd libwebp-1.2.0 ./configure make make install ``` Falls die Installation des Tools auf dem Server nicht möglich ist, kann man eine precompiled Version herunterladen: \ und den vollen Dateipfad unter Moduleinstellungen eintragen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FD81E1afFh49f3dT7PuZ0%2Fimage.png?alt=media\&token=c9df173f-2153-47b4-98e5-ccd1827ae5d1) ### Modulinstallation 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 unter:[ https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "imageoptimizer" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/imageoptimizer` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ### Modulinstallation 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/imageoptimizer". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/imageoptimizer` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Es werden **JPEG/PNG-Bilder** des Shops optimiert, welche sich im Pfad **/out/pictures/** befinden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F5esRLxAGhEE9bBnsHBka%2Fimage.png?alt=media\&token=75139bdb-02f2-477e-8dc9-0ab166f92244) ### Optimierungs-Stufe festlegen Die Optimierungs-Stufe bestimmt wie sehr die Bilder komprimiert bzw. optimiert werden sollen. Niedrig ist dabei eine weniger sichtbare Komprimierung als Hoch. Die verlustfreie Komprimierung entfernt Informationen aus Bilddateien, die für die Anzeige nicht nötig sind. Einige Bilder können jedoch durch die verlustfreie Komprimierung dunkler werden. Außerdem ist eine zeitliche Eingrenzung möglich, welche sich nach dem Änderungsdatum richtet. Somit besteht die Möglichkeit, unterschiedlich viele Bilder zu finden. ### Analyse durchführen Die Analyse simuliert eine Optimierung mit der ausgewählten Optimierungs-Stufe und wertet das Ergebnis aus. Die Auswertung zeigt den zu sparenden Speicherplatz und weitere Informationen zu den Dateien und Traffic an. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F07YpSHX51WMJ3A4aLdf2%2Fimage.png?alt=media\&token=6865e175-4f19-427a-8722-c78ab0c45d84) ### Optimierung durchführen Die Optimierung führt die Komprimierung der **JPEG/PNG-Bilder** durch. Anschließend werden Informationen zum gesparten Speicherplatz angezeigt. Je nach Voreinstellung, kann eine Sicherung der Bilder nach der Optimierung heruntergeladen werden. {% hint style="info" %} *Es empfiehlt sich die Option "Sicherung der Bilder vor Optimierung durchführen" zu aktivieren, da eine Optimierung ohne Einspielen einer Sicherung nicht rückgängig zu machen ist!* Die Sicherungen finden Sie im Tab 'Sicherungen' und auf dem Server im Ordner "export". {% endhint %} ### Konvertierung der JPG/PNG-Bilder zum WEBP-Format Hier hat man die Möglichkeit die JPEG und PNG - Bilder in WEBP-Format zu konvertieren. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FN5BiS8xW3Tpi5zl4yuVL%2Fimage.png?alt=media\&token=84b7f472-ed2a-4ad3-bde9-6e5e3e9f1024) ### Austauschen der jpeg-Bilder durch webp-Bilder im Frontend Wenn die Bilder im Backend bereits zu webp konvertiert sind, kann man diese wie folgt im Frontend einsetzen: setzt man unter Moduleinstellungen die Optionen für Artikelbilder/Kategoriebilder/Herstellerbilder im webp-Format anzeigen, so werden die webp-Bilder (sofern vorhanden) im Frontend eingesetzt. Die Ersetzung der jpeg/png Bilder funktioniert in den Standardthemes wie RoxIVE, Flow und Wave. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fqu6XW3iIrTrWXoPZk5Cv%2Fimage.png?alt=media\&token=7db655e5-a39f-4503-863e-6e25adfc5ba2) Die Mediathek-Bilder aus dem Ordner ddmedia können in unterschiedlichen Modulen oder VCMS-Seiten eingesetzt werden. Um diese Bilder ebenfalls durch webp-Bilder ersetzen zu können benötigt man einen Eintrag in der .htacces Datei (diese befindet sich im source-Ordner des Shops). Dieser Eintrag ersetzt die jpg/png Bilder durch die im webp-Format, wenn passendes webp-Bild existiert und der Browser webp unterstützt. Suchen Sie bitte in der .htacces Datei folgender Zeile ``` RewriteCond %{REQUEST_URI} (\/out\/pictures\/generated\/) ``` und fügen Sie oberhalb diese 5 Zeilen ein: ``` RewriteCond %{REQUEST_URI} (\/out\/pictures\/ddmedia\/) RewriteCond %{HTTP_ACCEPT} image/webp RewriteCond %{REQUEST_FILENAME} (.*)\.(jpg|png)$ RewriteCond %1\.webp -f RewriteRule ^(.*)\.(jpg|png)$ $1.webp [L,T=image/webp] ``` Jetzt werden die webp-Bilder aus der Mediathek (sofern vorhanden) im Frontend geladen. Besonderheit liegt hier darin dass die webp-Bilder noch im herkömmlichen Container (jpg/png) geladen werden. In der Entwicklerconsole vom Browser erkennt man dass der Typ des Bildes webp ist obwohl das Bild z.B.: eine **.jpg** Abkürzung am Ende hat: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FGYzC2DUYwkOmtkTeye1t%2Fimage.png?alt=media\&token=4d957d6b-9bab-49a7-910f-417e1aa5ecc2) ## Troubleshooting - Die häufigsten Fehler ### *Das Vorschaubild wird nicht geladen* Dieses Problem tritt ein, wenn das **Tmp-Verzeichnis** eine Regel hat, die den Zugriff auf die Dateien innerhalb des Ordners verhindert. Ersetzen Sie die vorhandene ``Regel durch die folgende: ``` Require all denied order allow,deny deny from all ``` ## 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 über einer der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Kategorie Bestseller ## Modulbeschreibung Das OXID eShop Modul "Kategoriebestseller" macht es endlich möglich, dem Kunden die best verkauften Produkte der jeweils aktiven Kategorie anzuzeigen. Mit unserem Modul "Kategoriebestseller" wird die natürliche, menschliche Eigenschaft "was mein Nachbar hat, möchte ich auch haben!" und "wenn viele andere den Artikel gekauft haben, muss er ja gut sein!" ausgenutzt. Dieses Grundwissen eines guten Verkäufers sollte sich jeder Shopbetreiber zu Eigen machen! Das Modul wird nicht weiterentwickelt. Bei Interesse kontaktieren Sie uns bitte über ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * 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 ## Installation 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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Das Oxid eShop Modul „Kategoriebestseller“ macht es endlich möglich, dem Kunden die best verkauften Produkte der jeweils aktiven Kategorie anzuzeigen. ## Backend-Einstellungen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M-jCP7J8YL2IfOKa-yz%2F-M-jIcQSS8Bq_xVeA5Pk%2FBildschirmfoto%202020-02-10%20um%2014.33.31.png?alt=media\&token=45b5360e-37b4-4968-8cc4-ea7cfe2134db) ## 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:**** * Telefon:**+49 (0) 5246 / 9099110** * Kontaktformular:[**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Live-Auswahllisten ## Modulbeschreibung Dieses Modul aktualisiert den Preis eines Artikels auf der Detailseite automatisch, wenn Preisaufschläge durch eine Option einer Auswahlliste berechnet werden müssen. ## 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "liveselection" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/liveselection` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ### Bis OXID 4.10.x/5.3.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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. ��Fügen Sie den Inhalt des Ordners "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/liveselection". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/liveselection` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Zunächst erstellen Sie wie gewohnt im Backend unter **Artikel verwalten->Auswahllisten** eine Auswahlliste und ordnen Sie zu dieser die gewünschten Artikeln zu. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M3QGl7NN55afvJEV7mz%2F-M3R2gRmprJ_X-kIVBAV%2FBildschirmfoto%202020-03-27%20um%2013.48.37.png?alt=media\&token=d83adbfe-dbee-4ffd-9d45-d02e20b880a0) Dann sollten Sie unter **Stammdaten->Grundeinstellungen->Perform**. folgende Einstellungen für Auswahllisten vornehmen: **Auswahllisten laden** und **Preisänderungen durch Auswahllisten unterstützen**. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M3en33Gd6_fmG99JirT%2F-M3enyTDK9aQfaFckAD7%2Fimage.png?alt=media\&token=5ef82f50-fc51-4bde-bd0c-09821a4c8b8a) Nun können Sie im Frontend bei den Artikeln, welche Sie zu der Auswahlliste hinzugefügt haben, folgendes sehen: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M3QGl7NN55afvJEV7mz%2F-M3R2gRkPlFNaXezvFRY%2FBildschirmfoto%202020-03-27%20um%2013.50.33.png?alt=media\&token=9f3bea0e-aa5f-4257-bbc1-b4294d294ddf) Wenn Sie nun eine andere Auswahl selektieren, ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M3QGl7NN55afvJEV7mz%2F-M3R2gRiO3xPZ5_fhtmL%2FBildschirmfoto%202020-03-27%20um%2013.50.39.png?alt=media\&token=64872aee-7dd9-4b6f-8aae-e765d45a3068) aktualisiert sich der Preis entsprechend. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M3QGl7NN55afvJEV7mz%2F-M3R2gRhYIl3tBotFJUK%2FBildschirmfoto%202020-03-27%20um%2013.50.49.png?alt=media\&token=62e4af11-2603-40dd-8fe6-c7f1019f76f7) ## 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:**** * Telefon:**+49 (0) 5246 / 9099110** * Kontaktformular:[**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Matomo ## Modulbeschreibung Dieses Modul bietet Ihnen die Möglichkeit das [Matomo](https://matomo.org/) (ehemals Piwik) Ecommerce Trackings in Ihrem OXID-Shop zu integrieren. [Matomo](https://matomo.org/) ist einer der wichtigsten Webanalyse Tools und bietet eine datenschutzkonforme Alternative zu Google Analytics, da es auf eigenem Server gehostet werden kann und Open-Source ist. Ausser diesem Modul wird also noch eine [Matomo-Installation](https://matomo.org/download/) benötigt, google bietet genug Anleitungen dafür. Der Begriff Matomo kommt aus dem Japanischem und bedeutet **anständig**. ## Funktionsumfang **Die Funktionen dieses Moduls im Überblick:** * einfach zu konfigurierende Schnittstelle zwischen Ihrem Oxid eShop und Matomo-Dashboard * Datenschutz - vollständige Kontrolle über die Tracking-Daten * Cookieless Tracking - Betrieb ohne Cookies möglich * keine Limits * erfüllt rechtliche Anforderungen * bessere Datenqualität durch vergleichsweise weniger blockiertem Traffik durch AdBlocker im Vergleich zu Google Analytics ## Systemvoraussetzungen ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * Wave * RoxIVE ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.3.x bis 6.5.x ## **Installation** 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](https://www.digidesk.de/produkte/basis-modul) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner `dd_matomo` 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/dd_matomo ``` 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 ## Update 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/dd_matomo` 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/dd_matomo ``` 5. Aktivieren Sie dieses Modul im OXID eShop Admin. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Backend-Einstellungen
**Matomo Server URL** - hier tragen Sie bitte Ihre Matomo-Server URL ein **Auth Token** - kann auf dem Matomo-Server unter **Administration -> Persönlich -> Sicherheit** vom entsprechenden Benutzer angelegt werden **Matomo Seiten-ID** - kann auf dem Matomo-Server unter **Administration ->Websites/Webseiten** entnommen werden. **Unbehandelte Frontend JavaScript-Fehler tracken** - Diese Option trackt unbehandelte JavaScript-Fehler im Shop-Frontend in Matomo's [Event Tracking](https://matomo.org/docs/event-tracking/). **E-Mail Pixel aktivieren** - wenn aktiv, wird in den vom Shop verschickten E-Mails ein PageView Tracking Pixel integriert. **Tracking Snippet über dynamisches Widget vom digidesk HTML Cache ausschließen** - funktioniert nur, wenn das **digidesk Caching Modul** installiert und aktiviert ist!
**Benutzerdefinierte Dimensionen** und **Ziele** - hier kann man die Voreinstellungen lassen.
**Tracking Snippet Script-Parameter** - Geben Sie hier bei Bedarf die für Ihre CMP benötigten Script-Parameter an, um das Matomo Tracking Snippet über die CMP zu steuern. ## ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Nicht verwendete Bilder löschen ## Modulbeschreibung Ab sofort haben Sie die Möglichkeit mit dem Modul „Nicht verwendete Bilder löschen“ Bilder in Ihrem Shop ausfindig zu machen, welche nicht benutzt werden. Durch Analysen auf dem Server werden die Bilder ausgelesen, welche keinem Artikel zugewiesen worden sind. Sie können dann entscheiden wie viele Bilder gelöscht werden sollen oder auch heruntergeladen werden müssen. ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### PHP-Version OXID 6 * PHP 7.0 * PHP 7.1 ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### 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.1.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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "deletepictures" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/deletepictures` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ### Für OXID 4.10.x/5.3.x und darunter 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/deletepictures". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/deletepictures` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Für OXID 4.10.x/5.3.x und darunter 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Backend-Einstellungen Bevor Sie Bilder suchen, löschen und ggf. herunterladen möchten, wechseln Sie zunächst im Modul auf ***"Einstell. -> Allgemein"*** um einzustellen, wie viele Bilder gelöscht und heruntergeladen werden dürfen. Anschließend klicken Sie auf **Speichern**, wenn Sie die Einstellungen vorgenommen haben. ![Allgemeine Einstellungen im Backend des Moduls](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LcUuKFHg-vBbhty8Bnr%2F-LcV0QKO1OKl1ZicGyJ0%2FBackend_allgemeineEinstellungen.png?alt=media\&token=d5a79f6b-ea99-449c-9f6d-9524734ea35e) Haben Sie die allgemeinen Einstellungen vorgenommen, wechseln Sie dann zu dem Menüpunkt ***"nicht verwendete Bilder löschen."*** Klicken Sie dafür auf **"Bilder suchen"** und die Analyse wird gestartet. Anschließend werden Ihnen dann die gefundenen Bilder angezeigt, welche Sie dann löschen und/oder herunterladen können. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LcUuKFHg-vBbhty8Bnr%2F-LcV1E3finu_JZSQmr2-%2FOverlay%20des%20Backends.png?alt=media\&token=5739c5ee-85b1-4c5d-b5be-74c98a1bc8c6) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Overlays ## Modulbeschreibung Mit diesem Modul können Sie eigene Overlays für Ihren OXID eShop ganz einfach im Admin-Bereich erstellen und verwalten. **Was sind Overlays?**\ Wenn ein Kunde Ihren Onlineshop besucht, sieht er ein kleines Fenster, dass sich über die Inhalte im Shop legt. Dies wird "**Overlay"** genannt.\ In diesem Fenster können Sie wichtige Informationen, beispielsweise über eine Sommer-Rabatt-Aktion oder andere wichtige Informationen für Ihre Kunden, hinterlegen. \ Natürlich lässt sich das Overlay wieder ganz einfach schließen, damit das Einkaufserlebnis nicht gestört wird. Bei der Umsetzung haben wir besonders darauf geachtet, dass die Overlays nicht nur auf einem Desktop-PC gut aussehen, sondern auch auf mobilen Endgeräten. Das Modul ist kompatibel mit unserem [responsive Theme „RoxIVE“](http://www.digidesk.de/produkte/roxive-responsive-oxid-eshop-theme/)und dem Flow-Theme. Das Modul ist erhältlich auf ## 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 - 8.1 (OXID 6.2.x - 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "overlay" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/overlay` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ### 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neuen Modulversion in den Ordner "packages/digidesk/overlay" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/overlay` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ### Bis OXID 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung ### Overlay erstellen 1. Wechseln Sie im Admin-Bereich zu **"Overlays">"Overlays bearbeiten"**. Sie erhalten dort eine Liste mit den bereits angelegten Overlays. Dort können Sie Ihre Overlays bearbeiten und neue Overlays durch einen Klick auf den **grünen + Button** erstellen. 2. Nach dem Klick auf den grünen Button erhalten Sie die Oberfläche zum Bearbeiten. Siehe Screenshots: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOc-6xOKfv4-fCs-pya%2F-LOc-HTk83OcMTac_tNE%2FBildschirmfoto%202018-10-12%20um%2013.18.27.png?alt=media\&token=c907f1ea-4473-4067-8278-d423034c6545) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Mjhrb_A04sJmdGM8Y_9%2F-MjhsmtafiLF49iTICK9%2Fimage.png?alt=media\&token=7d78010f-dce9-4ef7-b4b4-f347eac7fbb0) ### Overlay-Einstellungen * Overlay aktivieren/deaktivieren. * Zeitraum festlegen, in dem das Overlay aktiv sein soll. * Titel und Inhalt des Overlays. * Priorität festlegen bei mehreren aktiven Overlays * Checkbox anzeigen, die das Overlay beim Kunden dauerhaft deaktiviert. * Overlay erst anzeigen, wenn der Kunde den Shop mit der Maus verlässt. * Festlegen, wann das Overlay angezeigt werden soll: immer oder nur einmalig. * Verzögerung einstellen, ab wann das Overlay erscheinen soll in ms. * Festlegen auf welchen Seiten das Overlay angezeigt werden soll. * Eine oder mehrere Kategorien auswählen wo das Overlay angezeigt werden soll. ![Anzeige auf der Shopseite](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOc0GjisDjyZs03r6eA%2F-LOc0zpttuJ_8c7X07r_%2FBildschirmfoto%202018-10-12%20um%2013.26.17.png?alt=media\&token=239465a4-7de5-47cb-91bf-4b402dec3e5f) ## Einbindung von Smarty-Tags Seid der Version v.2.3.0 ist die Nutzung von Smarty-Tags im Overlay-Content möglich. ## Nutzung von Formularen Seid der Version v.2.3.0 ist die Nutzung von **\
**-Tags in Overlays Möglich. Beim Einsatz von evoEdit sollte man die **\**-Tags in der Codeansicht wie folgend beschrieben mit einfachen HTML-Kommentaren auskommentieren: Ansonsten passiert das Auskommentieren beim Verlassen der Code-Ansicht im Editor automatisch. Im Frontend werden die Kommentare automatisch entfernt und somit ist die Formular-Nutzung möglich. ## Moduleinstellungen Unter Moduleinstellungen kann man die Einbindung von jQuery durch das Modul deaktivieren, falls die Einbindung bereits an einer anderen Stelle geschieht. Für Modulfunktionalität wird jQuery jedoch zwingend benötigt. Eine weitere Einstellung ermöglicht es, die Overlays im Frontend mit einem Mausklick außerhalb des Overlays zu schliessen. Falls das Visual CMS im Shop verfügbar ist (PE oder EE- Editionen) und das Modul evoEdit installiert ist, kann man die Overlay-Einträge mit VisualCMS bearbeiten.
## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: # Packstation ## Modulbeschreibung Das Modul Packstation bietet eine Funktion an, die vorteilhaft in vielen Shops zum Einsatz kommt. Wenn der Kunde/Besteller unter Angabe seiner Adresse die Bestellung abschließen möchte, kann der Shopbetreiber dem Kunden mit dem Modul Packstation die Möglichkeit bieten, die bestellten Artikel an eine Packstation oder zu einer Postfiliale liefern zu lassen.\ Mit der Erweiterung der entsprechenden Felder, erübrigt sich eine Kontaktaufnahme und Klärungsbedarf mit dem Besteller. Der Kunde kann wie gehabt die eigene Adresse angeben oder eine Packstation und Postfiliale wählen und die benötigten Informationen zur Versendung an die gewünschten Adresse angeben. ## 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "packstation" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/packstation` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ### Bis OXID 4.10.x/5.3.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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. ��Fügen Sie den Inhalt des Ordners "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/packstation". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/packstation` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Backend-Einstellungen Unter **Shopeinstellungen -> Versandarten** aktiviert man noch bei der gewünschten Versandarten die Option *Packstation / Postfiliale erlauben*. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M2nZrlnUIM54TaDI_OB%2F-M2n_FU_KnU8PLwdbULV%2Fimage.png?alt=media\&token=d6b93169-a332-4064-a018-4f5fe9c48152) ## Funktionsbeschreibung Der Kunde hat im Warenkorb die Möglichkeit die Lieferadresse auch für eine Packstation oder Postfiliale anzugeben. ## Frontend-Ansicht ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LuCy2dJsgTpc3DfJZht%2F-LuDPEwgyUB0JHy5qTXo%2FPackstation_1_compressed.png?alt=media\&token=d7643f61-2780-4ef2-a9fe-99834df575d0) ## 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:**** * Telefon:**+49 (0) 5246 / 9099110** * Kontaktformular:[**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Pfand Berechnung ## Modulbeschreibung Dieses Modul sorgt dafür, dass bei Produkten, denen ein entsprechender Pfand-Artikel zugeordnet ist, automatisch das Pfand berechnet und im Warenkorb ausgewiesen wird, sodass der Kunde bereits im Warenkorb darüber informiert wird, welchen Pfandbetrag er zu zahlen hat. Das Modul wird nicht weiterentwickelt. Bei Interesse kontaktieren Sie uns bitte über ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * 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 ## Installation ### Bis OXID 4.10.x/5.3.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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. ��Fügen Sie den Inhalt des Ordners "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ## Update ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Modul zur automatische Pfandermittlung bei entsprechenden Artikeln.\ Beispiel:\ \- Der Kunde legt 5x den Artikel "1L Wasser" in den Warenkorb.\ \- Dabei wird dann direkt als zusätzliche Position 5x "Pfand 0,25 EUR" in den Warenkorb gelegt und auf den Gesamtpreis gerechnet. ## Backend-Einstellungen In der Artikelverwaltung unter dem Reiter "Erweitert" befindet sich die Möglichkeit ein Modul als Pfand-Artikel zu kennzeichnen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-M-jIgezKlFY6havZqM4%2F-M-jN0uEsnoq07_Atfxv%2FBildschirmfoto%202020-02-10%20um%2014.41.11.png?alt=media\&token=db90abb5-37e8-43f6-863f-01dd45fb6620) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Product2PDF ## Modulbeschreibung Mit dem Modul Product2PDF können Ihre Kunden, aus den Informationen eines Artikels ein Produktblatt erstellen. Ihre Kunden können somit beim Besuch einer Detailseite, per klick auf einen Link, eine PDF des jeweiligen Produkts erzeugen. Alle grundlegenden Informationen, wie Artikelname, Preis, Artikelnummer, Hersteller, Artikel-Bild und Produkt-Beschreibung werden somit als PDF exportiert. ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### Webserver-Konfiguration * IonCube Loader (mind. v5.0) ### Kompatibel mit den Themes * Flow * 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 ## Installation ### Bis OXID 4.10.x/5.3.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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Vorschau So würde beispielsweise die PDF Datei von dem Artikel "Neoprenanzug NPX ASSASSIN" aussehen: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lt9TVF1wW15hfkpiZQ4%2F-Lt9XVP1pMq-KgpZtmAf%2FProduct2PDF_1_compressed.png?alt=media\&token=167dc70b-f9f2-44aa-b30b-e2d50064bedf) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # Productstream ## Modulbeschreibung Mit unserem Modul „Productstream“ definieren Sie über einen Filter, welche Eigenschaften die Produkte haben müssen, um auf einer Seite angezeigt zu werden. Völlig unabhängig von der eigentlichen Kategorie.\ So können Sie problemlos und schnell Artikel einer bestimmten Marke, einer Preis-Spanne oder eines Anlege-Datums zusammenstellen. Fügen Sie nachträglich neue Produkte mit den entsprechenden Eigenschaften hinzu, **aktualisiert sich der Stream automatisch**. So werden Ihre Seiten immer auf dem neuesten Stand gehalten – ohne jeglichen Aufwand! Zudem bietet es die Möglichkeit diese auch mit Visual CMS als Slider/Widget in z.B. Landing Pages einzubauen.\ Im Backend haben Sie die Möglichkeit diese dann festzulegen und einzustellen. ## 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "productstream" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/productstream` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ### Bis OXID 4.10.x/5.3.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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/productstream". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/productstream` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Durch verschiedene Filtermöglichkeiten können Sie mehrere Attribute für Ihre Artikel durch logische Operatoren (UND,ODER,GRÖßER/KLEINER ALS, usw.) filtern. Ob die Artikel zum Beispiel nach Größe, Hersteller, Länge, Menge usw. gefiltert werden sollen, können Sie entscheiden. Durch Gruppierungen der Attribute, lassen sich komplexere Verknüpfungen herstellen. Wenn das getan ist, ist es möglich, sich die Ergebnisse auf einer separaten Seite anzusehen. ## Backend-Einstellungen Um zunächst einen "Productstream" erstellen zu können, müssen Sie auf den Reiter ***"Productstream hinzufügen"*** klicken. In dem neuen Fenster erscheint dann eine Übersicht von bereits erstellten Einträgen, insofern welche vorhanden sind. Um die bereits erstellten Einträge bearbeiten zu können, müssen Sie auf das ***"Stift-Symbol"*** neben dem erstellten Eintrag drücken. Wenn Sie einen neuen Eintrag erstellen möchten, dann können Sie auf das ***"+"-Symbol*** drücken. Anschließend öffnet sich ein Fenster mit verschiedenen Auswahlmöglichkeiten: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LZ_Ixm5VqTSogeM6kT9%2F-LZ_D5VqQP2QXbhsauAH%2Ffoto1NeuerEintrag.png?alt=media\&token=b233d0d4-f4d5-4537-be55-c6bd7cca5ac6) Im Menüpunkt ***"Stamm"*** lassen sich die Grundeinstellungen vornehmen, wie der Titel oder ob die Option immer aktiv sein soll. Im Menüpunkt ***"Filter"*** können Sie nun verschiedene Filtermöglichkeiten anpassen, damit dann bestimmte Gruppen von Artikeln angezeigt werden können. Im folgendem Fall werden Artikel nach dem Kriterium *"**Hersteller ist nicht leer**"* ausgefiltert, welche dann angezeigt werden sollen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LZ_Ixm5VqTSogeM6kT9%2F-LZ_G3R2nof_hVIAIMNt%2Ffiltermo%CC%88glichkeit2.png?alt=media\&token=8c567492-ba5f-49fd-b636-f53d2bf1bd10) Natürlich ist es auch möglich komplexere Verknüpfungen der Filter zu erstellen. Im folgendem Beispiel werden ***zwei Filtergruppen*** mit einem logischen ODER verknüpft. Innerhalb der beiden Gruppen, sind noch einmal UND/ODER Verknüpfungen eingebaut. Dieses Schema lässt sich nach belieben anpassen. Prinzipiell können Sie die Einstellungen von **Links nach Rechts** lesen. In dem jetzigen Beispiel wäre das unter anderem: **"EU-Größe || ist nicht || 20"** *UND* ** "Lieferumfang || ist kleiner als || 20"** *ODER* ** "restlicher Teil der Gruppe."** *ODER* **"Filteroptionen der anderen Gruppe"** Im Menüpunkt ***"Zuordnung"*** lässt sich lediglich die Option einstellen, ob bestimmte Artikel ausgeschlossen werden sollen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_N-k4Hw2OE2WFk0gSY%2F-L_N3SUenXwjTtvE2ut9%2FKomplexe%20Product.png?alt=media\&token=5a66e4af-be30-44bf-ac63-cee5d405bc1d) Im letzten Menüpunkt ***"SEO"*** besteht unter anderem die Möglichkeit die URL und/oder den Titel der Seite anzupassen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LZ_Ixm5VqTSogeM6kT9%2F-LZ_H2TJYe2IGL8txzFl%2FBildschirmfoto%202019-02-25%20um%2016.31.05.png?alt=media\&token=8330c97d-7319-4951-8e30-689bac1e6cdd) Anschließend auf ***"Speichern"*** drücken. Um den neuen oder bearbeiteten Eintrag ansehen zu können, steuern Sie mit der Maus rechts neben dem Eintrag den ***"Globus***" an. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LZ_Ixm5VqTSogeM6kT9%2F-LZ_HwjrF09SgSm_PeaH%2FBildschirmfoto%202019-02-25%20um%2016.33.40.png?alt=media\&token=43dcd58c-c2eb-43e7-a358-a153d099e021) Wenn Sie dann auf das ***"Globus-Icon"*** gedrückt haben, öffnet sich dann Ihr erstellter Link mit den gefilterten Artikeln (Aussehen und Anordnung der Artikel ist unterschiedlich und abhängig von den Shop-Einstellungen) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LZ_Ixm5VqTSogeM6kT9%2F-LZ_IklvWUQ2FxkYpmkQ%2FBildschirmfoto%202019-02-25%20um%2016.37.19.png?alt=media\&token=2009ec52-4bdb-48d0-a444-4cb86270c65d) ### Visual CMS Natürlich ist es auch möglich die Productstreams im Visual CMS für Landing Pages oder ähnliches anzupassen: 1. Öffnen Sie zunächst **"Visual CMS"** im Backend Ihres Shops (unter ***Kundeninformationen***) 2. Links im Reiter **"Einstell."** können Sie dann ein bereits vorhandenen CMS-Inhalt aussuchen oder ein neuen hinzufügen 3. Haben Sie sich für einen CMS-Inhalt entschieden, drücken Sie dann auf das **"+"-Symbol** um ein neues Widget zu erstellen 4. Anschließend öffnet sich ein Fenster mit **"Allgemeine Einstellungen"**, wo Sie dann unter der Option **"Productstream"** Ihren bereits erstellten Productstream aussuchen und in den anderen Optionen Einstellungen für die Art der Anzeige der Artikel vornehmen können 5. Anschließend auf **"Speichern"** drücken ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_vkvHq7AdVVNc__rA3%2F-L_vz9bLXATLmXPFzT-a%2FBildschirmfoto%202019-03-14%20um%2012.04.40.png?alt=media\&token=84eb581c-234a-476a-93ad-86625b0cf1b6) Nun erscheint Ihr Widget auf der Seite. Sie können das Widget nach Ihren Präferenzen verschieben, vergrößern/verkleinern usw. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-L_vkvHq7AdVVNc__rA3%2F-L_vzvmg6q8nUwmdznUD%2FBildschirmfoto%202019-03-14%20um%2012.35.15.png?alt=media\&token=70305d9c-1ce8-4a15-95de-9cedaa18ce28) Sind Sie zufrieden mit den Einstellungen, dann drücken sie auf **"Speichern"** ### **Einbindung von Productstream per Smarty in Template oder in einen CMS Beitrag** Bei Oxid CE Editionen hat man keinen Visual CMS Editor, trotzdem kann man die vorhandene Productstreams in eigenen Templates oder CMS - Beiträgen wie im folgendem Beispiel einbinden: \[{`ddproductstream`` `**`id`**`="504e5a393c7796f169a5e61b7e1a888a"`` `**`articleAmount`**`="6"`` `**`articlesPerRow`**`="3"`` `**`useSlider`**`=false}]` Bei der **id** tragen Sie bitte die **ID** des gewünschten Streams ein, **articleAmount** begrenzt die Gesamtzahl der Artikel, **articlesPerRow** gibt an wieviele Artikel pro Zeile angezeigt werden und **useSlider** aktiviert oder deaktiviert den Slider (**true oder false**). Die **ID** eines Streams finden Sie im admin unter Menüpunkt **Productstream**, dafür sollte vorher in den Moduleinstellungen die Moduloption *"Id der Productstreams im admn anzeigen"* aktiviert werden. ### **Weitere Moduleinstellungen** Ab der Version 2.3.0 kann die Sidebar unter Moduleinstellungen ausgeblendet werden. Außerdem kann die Anzahl der Produkte für die Pagination im Frontend festgelegt werden. ## 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:**** * Telefon:**+49 (0) 5246 / 9099110** * Kontaktformular:[**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Produkt-Export ## Modulbeschreibung Mit dem Produkt-Export Modul ist es möglich, die Daten der Shop-Artikel als CSV-Dateien zu exportieren. Es können eigene, individuelle Exporte angelegt werden, für welche umfassende Konfigurationsmöglichkeiten vorhanden sind. Diese können komfortabel über das Shop-Backend verwaltet werden.\ Für einige Dienste, wie „Google Shopping“, „Preisroboter“, usw. sind schon Beispiel-Konfigurationen im Modul enthalten. Das Modul ist erhältlich auf ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.4.x) * PHP 8.4 (OXID 7.3.x - 7.4.x) ### Webserver-Konfiguration * IonCube Loader (v14 - v15) ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0 bis 7.4.x ### Template-Engine * Smarty bis OXID 7.0.x * Twig ab OXID 7.0.x ## Installation ### Ab OXID 6/7 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 unter:[ https://www.digidesk.de/produkte/basis-modul/](https://www.digidesk.de/produkte/basis-modul/) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "export" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/export` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren ## Update ### Ab OXID 6/7 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/export". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/export` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Funktionsbeschreibung Mit dem Produkt-Export Modul ist es möglich, Export-Dateien der Shopartikel zu erstellen. Dabei können Dateien für beliebige Dienste erstellt werden, welche CSV-Dateien benötigen, z.B. „Google Shopping“, „Preisroboter“, „Idealo“, usw\..\ Neben den bereits vorkonfigurierten Diensten ermöglicht es das Modul, eigene individuelle Exporte anzulegen, wofür umfangreiche Konfigurationsmöglichkeiten vorhanden sind. ### Ausführen des Exports Die Ausführung eines Exports kann mit folgendem Link angestoßen werden: **`http://www.testshop.de/?cl=dd_export_cron&key=KeyDesExports`** Der auszuführende Export wird über den Key bestimmt. Bei der Konfiguration der Exporte im Backend (Reiter **Export**) können Sie diesen frei bestimmen. Es sollte dort im Eingabefeld **Key** ein eindeutiger, generierter Schlüssel hinterlegt werden, so dass nicht jeder den Export ausführen kann. Bspw.: **`http://www.testshop.de/index.php?cl=dd_export_cron&key=b024ae1015c58a4d56dbaff4c0e48a2a`** Anschließend finden Sie den fertigen Export unter dem im Eingabefeld **Dateiname** angegebenen Pfad. ### Automatischer Export per Cronjob / CLI-Aufruf {% hint style="info" %} Der automatische Export per Cronjob ist erst ab der Version 5.0.0 möglich. {% endhint %} Für den automatischen Export enthält das Export-Modul einen Cronjob, mit dessen Hilfe in regelmäßigen Abständen automatisch ein Export erstellt werden kann. Um den Cronjob auszuführen, muss folgender Befehl aus dem Hauptverzeichnis des Shops ausgeführt werden: ``` ./vendor/bin/dd-export --key= [--shop=] ``` {% hint style="info" %} In den OXID Editionen Community und Professional kann der Parameter `--shop` grundsätzlich weggelassen werden, da dort nur ein Shop existiert. Der Parameter ist **ausschließlich** für die Enterprise Edition gedacht. {% endhint %} Wie bei der manuellen Ausführung muss der Key des Exports im Befehl angegeben werden. Siehe [Ausführen des Exports](#ausfuhren-des-exports). ### Konfiguration der Exporte Sie finden die Übersicht zur Verwaltung der verschiedenen Exporte im Shop-Backend unter **Export > Exporte bearbeiten** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FsafHlJz87DknKmQoNt4n%2Fimage.png?alt=media\&token=b3649f84-05b9-474d-9946-7d7f4963a91d) **Die Konfiguration ist dabei in vier Reiter unterteilt:** * [**Export**](#export) * [**Inhalt**](#inhalt) * [**Attribute**](#attribute) * [**Filter**](#filter) ### Export **Export,** hier können die grundlegenden Einstellungen für den Export wie bspw. Name und Pfad, berücksichtigte Artikel und Varianten, benutzte Trennzeichen, Zahlen, Währungsformat, usw. festgelegt werden.\ Manche der Einstellungen wirken sich nur dann aus, wenn die zugehörigen Felder im Tab Inhalt zu dem Export hinzugefügt werden. Wird beispielsweise die Verfügbarkeit nicht exportiert, dann müssen die entsprechenden Einstellungen hier nicht unbedingt vorgenommen werden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FtVj5ZaOH042RfED0oHr1%2Fimage.png?alt=media\&token=cde70eaa-5987-4b1e-9b65-4a3c067ef803) **Die folgenden Konfigurationsmöglichkeiten stehen Ihnen unter dem Reiter Export zur Verfügung:** **- Aktiv:** Legt fest, ob der Export aktiv ist. Inaktive Exporte können nicht ausgeführt werden. **-** **Bezeichnung:** Eine beliebige Bezeichnung des Exports für die Übersicht. **- Dateiname:** Der Dateiname des Exports. Dieser ist ausgehend vom Shop-Hauptverzeichnis anzugeben. **- Key:** Der Key ist ein eindeutiger Schlüssel, der beim Aufruf des Export-Cronjobs mit übergeben werden muss. **- Sprache:** Legt die Sprache des Exports fest. **- Trennzeichen Spalten:** Das Trennzeichen (standardmäßig \t für einen Tab), welches zwischen 2 Feldern eingefügt wird. **- Trennzeichen Zeilen:** Das Zeichen, das am Ende einer Zeile eingefügt wird (standardmäßig \n für einen Zeilenumbruch). **- Varianten exportieren:** Wenn die Checkbox aktiviert ist, werden Varianten exportiert, sonst nur Vaterartikel. **- Varianten-Titel:** Ist der Varianten-Export aktiviert, wird hier festgelegt, wie der Titel zusammengesetzt wird. **- Inaktive Artikel exportieren:** Ist die Checkbox aktiv, werden auch Artikel exportiert, die nicht aktiv sind. **- Nur suchbare Artikel exportieren:** Ist die Checkbox aktiv, werden nur Artikel exportiert, die als suchbar markiert sind. **- Nicht lieferbare Artikel exportieren:** Ist die Checkbox gesetzt, werden auch Artikel ohne Lagerbestand exportiert, sonst nur die Artikel mit Bestand. **- Lieferstatus berücksichtigen:** Wenn die vorherige Option inaktiv ist, also nur lieferbare Artikel exportiert werden, dann wird hiermit festgelegt, ob das Statusflag berücksichtigt wird oder nicht. **- Text lieferbar:** Text für das Export-Feld Verfügbarkeit bei Artikeln mit Bestand. **- Text niedriger Bestand:** Text für das Export-Feld Verfügbarkeit bei Artikeln mit niedrigem Bestand (1-5 Artikel auf Lager). **- Text nicht lieferbar:** Text für das Export-Feld Verfügbarkeit bei Artikeln ohne Bestand. **-** **Alle Kategorien exportieren:** Ist die Checkbox aktiv, werden alle dem Artikel zugewiesenen Kategorien exportiert, sonst nur die Hauptkategorie. **- Trennzeichen Kategorien:** Wenn alle Artikel-Kategorien exportiert werden, dann wird dieses Zeichen als Trenner verwendet. **- Kompletten Pfad exportieren:** Ist die Checkbox aktiv, wird für jede Kategorie der komplette Kategoriepfad vom Shop-Root ausgehend ausgegeben (entspr. BreadCrumb), sonst nur der eigentliche Kategoriename. **- Trennzeichen Kategoriepfad:** Dieses Zeichen wird zwischen die einzelnen Kategorien gesetzt, die zum Pfad gehören, wenn die vorherige Option aktiv ist. **- Versandkosten Berechnung:** Die Art, wie die Versandkosten für einen Artikel berechnet werden. Dies erfolgt über eine feste Zuordnung nach Artikelpreis, Gewicht oder Größe, die im nächsten Feld festgelegt werden kann. **- Versand Zuordnung:** Tabelle für die Berechnung der Versandkosten. Pro Zeile ist ein Wert angegeben, z.B. wenn Gewicht ausgewählt wird dann das Gewicht, Pfeil (=>) und Versandkosten (ohne Währungsangabe). **- Zahlenformat:** Hiermit wird eingestellt, wie die Zahlenwerte im Export ausgegeben werden. **- Währung anhängen:** Ist die Checkbox aktiv, wird die Währung hinter Preisangaben angehängt. **- Währung:** Währung für den Export. **- Google Produktkategorie:** Inhalt für das Feld Google Produktkategorie. **- Google Datei:** Aus dieser Datei werden die möglichen Werte für die Google Produktkategorie ausgelesen. Die Datei kann hier heruntergeladen werden: ### Inhalt Unter **Inhalt** können die Artikel-Werte festgelegt werden, die im Export berücksichtigt werden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FeaOht7KO7AFEf4KBqAgZ%2Fimage.png?alt=media\&token=da4672a9-15e3-4b0c-90d2-52916babd7e0) Über die vorangestellte Checkbox werden die Felder festgelegt, die in diesem Export berücksichtigt werden. Alle aktiven Felder werden beim erneuten Aufruf der Einstellungen oben angezeigt. Um die Reihenfolge in der Export-Datei festzulegen, können die Felder per Drag & Drop verschoben werden (nur relevant für aktive Felder).\ Über das Eingabefeld, das sich bei jedem Feld befindet, kann die Überschrift der Export-Spalte festgelegt werden. ### Attribute im Reiter **Attribute** können die Shop-Attribute ausgewählt werden, die für die Felder „Attribut Größe“, „Attribut Farbe“ und „Attribut 1“ bis „Attribut 5“ eingesetzt werden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FsXhWMMpYgymduWK1ThBt%2Fimage.png?alt=media\&token=b5c28c29-0d7b-4d86-9305-f0435ac95473) Hat man hier ein Shop-Attribut für ein Feld festgelegt, wird dessen Wert im zugehörigen Feld eingefügt, wenn man dieses unter **Inhalt** aktiviert hat. ### Filter In dem letzten Reiter **Filter** können Artikel oder Kategorien eingegeben werden, die vom Export ausgeschlossen werden sollen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FGbDaBAhulQEsEM0TTWKa%2Fimage.png?alt=media\&token=34ba7e42-14bd-4872-aeef-95cff83d024f) **Auszuschließende Artikel:** Hier können beliebig viele Artikel ausgewählt werden, die nicht exportiert werden. **Auszuschließende Kategorien:** Hier können ganze Kategorien vom Export ausgeschlossen werden. **Achtung:** Alle Artikel, die in den ausgewählten Kategorien enthalten sind, werden ausgeschlossen. Es ist dabei egal, ob diese auch in anderen Kategorien zugewiesen sind oder nicht! ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Redirects Modul ## Modulbeschreibung Nach einer gewissen Zeit, insbesondere bei einem Relaunch oder einem größeren Update, tauchen alte URLs auf, die nicht mehr verfügbar oder für Ihren Shop nicht mehr passend sind. Mit unserem Redirects Modul können Sie jetzt ganz einfach aus dem Backend heraus die alten URLs auf die neuen umleiten. Zum Beispiel könnten Sie nicht mehr vorhandene Produkt-, Kategorie-, Blog- oder anders artige Seiten an eine von ihnen selbst gewählte URL weiterleiten. Das Modul ist erhältlich auf: [https://www.digidesk.de/produkte/redirects-modul/](https://www.digidesk.de/produkte/redirects-modul) ## Funktionsumfang * Sie können erstellte Weiterleitungen in der Backend-Oberfläche ganz einfach verwalten und bei Bedarf auch vorübergehend deaktivieren und aktivieren. * Das Modul ermöglich es ihnen, Weiterleitungen mit dem HTTP-Statuscode 301, 302, 307 & 308 zu konfigurieren. * HTTP-Statuscode `301` bedeutet Permanent Redirect (dauerhaft umgeleitet). * **Beispiel:** Ein altes Produkt wird entfernt und durch ein neueres ersetzt. So könnte man von der alten Produktseite dauerhaft auf die des neuen Produktes verweisen. * Dieser Redirect Typ ist außerdem optimal für Suchmaschinen, damit Inhalte weiterhin problemlos gefunden werden können. * HTTP-Statuscode `302` bedeutet Temporary Redirect (vorübergehend umgeleitet). * **Beispiel:** Sobald ein Produkt vorübergehend nicht verfügbar oder ausverkauft ist, kann man innerhalb dieser Zeit vorübergehend auf ein alternatives Produkt weiterleiten. * HTTP-Statuscode `307` bedeutet Temporary Redirect (vorübergehend umgeleitet). * **Beispiel**: Wenn eine Webseite vorübergehend auf eine andere URL umgeleitet werden muss, ohne die ursprüngliche Anfragemethode zu ändern, kann der Statuscode 307 verwendet werden. Dies ist nützlich, wenn ein Produkt vorübergehend auf einer anderen Seite angezeigt wird, die ursprüngliche URL aber weiterhin gültig bleibt. * HTTP-Statuscode `308` bedeutet Permanent Redirect (dauerhaft umgeleitet). * **Beispiel**: Wenn eine Webseite dauerhaft auf eine neue URL verschoben wird und alle zukünftigen Anfragen an diese neue Adresse geleitet werden sollen, kann der Statuscode 308 verwendet werden. Dies ist ideal, wenn eine Domain dauerhaft geändert wird oder eine Ressource dauerhaft verschoben wurde. * Import/Export über CSV Dateien * **Export** * Sie haben die Möglichkeit, alle bereits erstellen Weiterleitungen als CSV Datei zu exportieren. Damit haben Sie beispielsweise die Möglichkeit, die vorhandenen Weiterleitungen schnell in Excel und co. zu bearbeiten oder neue Umleitungen in Test- und Entwicklungsumgebungen zu testen und von dort zu exportieren um sie im Produktivsystem zu importieren. * **Import** * Es gibt auch die Option, Weiterleitungen per CSV Datei auf den Server zu Importieren. Die in der CSV Datei definierten Weiterleitungen werden dann automatisch neu angelegt wenn sie noch nicht existieren und vorhandene Weiterleitungen werden aktualisiert. Die hochgeladenen Dateien werden anschließend in ein Archiv verschoben. * **Archiv** * Im Archiv befinden sich alle bereits importieren CSV Dateien. Das Archiv bietet dann die Möglichkeit, Dateien, die importiert wurden, wieder herunterzuladen, falls diese verloren gegangen sind und wieder benötigt werden. Es besteht aber auch die Möglichkeit, die Dateien im Archiv löschen. ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.4.x) * PHP 8.4 (OXID 7.3.x - 7.4.x) ### Webserver-Konfiguration * IonCube Loader (v14 - v15) ### Kompatibel mit den Themes * Flow (OXID 6) * RoxIVE (OXID 6) * Wave (OXID 6 und 7.0) * Apex ab OXID 7.0 ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0.x bis 7.4.x ## Installation 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. 2. Sie erhalten dieses unter:​ 3. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "redirects" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 4. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/redirects`
5. Nun kann das Modul im OXID eShop Admin aktiviert werden. 6. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Update 1. Entpacken Sie die neue Modulversion in den Ordner "**packages/digidesk/redirects**". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer update digidesk/redirects`\ Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "**Y**". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Funktionsbeschreibung ### Weiterleitungen bearbeiten/erstellen Wählen Sie im Admin-Menü den Punkt **"Weiterleitungen"** aus und öffnen anschliessend den Menüpunkt **"Weiterleitungen bearbeiten".** **Weiterleitungen erstellen:** 1. Klicken Sie auf das **"+"-Symbol,** wenn Sie eine neue Weiterleitung erstellen wollen. 2. Es öffnet sich ein Fenster mit geöffneten Reiter **"Stamm".** 3. Hier können Sie Informationen zur gewünschten Weiterleitung in das Formular eintragen. 4. Setzen Sie den Haken "**Aktiv**" um die Weiterleitung zu aktivieren. Andernfalls hat der Eintrag im Frontend keinen Effekt. 5. Wenn Sie alle Felder ausgefüllt haben klicken Sie auf **"Speichern"** um die Weiterleitung zu speichern. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FlSnhR6fuYT8Hd7DG5lYj%2FBildschirmfoto%202022-09-15%20um%2009.21.25.png?alt=media\&token=522b299a-4846-486d-bab5-125d02350f66) #### **Weiterleitungen bearbeiten:** 1. Bewegen Sie ihren Mauszeiger über die Zeile von Ihrer bereits erstellten Weiterleitung die Sie bearbeiten wollen. 2. Danach sehen Sie auf der rechten Seite zwei Buttons mit einem Icon. 3. Zum bearbeiten müssen Sie auf den "**Editieren Button"** (den Button mit dem Stift Icon) klicken. 4. Es öffnet sich das selbe Fenster wie beim erstellen, nur das dort schon die Daten von Ihrer bereits erstellten Weiterleitung eingetragen sind. Diese Daten können Sie dann einfach wieder ändern. 5. Anschliessend müssen Sie auf **"Speichern"** klicken, um die Änderungen zu übernehmen. #### **Weiterleitung löschen:** 1. Um eine Weiterleitung zu löschen müssen Sie Ihren Mauszeiger über die Spalte von Ihrem Badge bewegen das Sie löschen möchten. 2. Danach sehen Sie auf der rechten Seite zwei Buttons mit einem Icon. 3. Zum löschen müssen Sie auf den "L**öschen Button**" (Den Button mit dem Mülleimer Icon) klicken. 4. Am Ende müssen Sie das löschen dann nochmal mit dem "**OK Button**" bestätigen. ### Import / Export #### **Dateien hochladen:** 1. Um eine Datei hochzuladen, klicken Sie entweder auf die grpße graue Box, oder auf den Button "**Datei auswählen**". Alternativ kann die Datei auch per Drag\&Drop im Feld abgelegt werden. 2. Klicken Sie anschließend auf "**Hochladen**" ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FreHSbQSphnmJCZiHq064%2FBildschirmfoto%202024-11-26%20um%2010.44.32.png?alt=media\&token=ba1e855d-c8da-4b7e-bb7c-119b6d00b02c) * Nachdem eine oder mehrere Datei(en) hochgeladen wurden, werden sie in die Warteschlange aufgenommen: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FVIG2M9OrkZW5qIvjeqry%2FBildschirmfoto%202024-11-26%20um%2010.48.00.png?alt=media\&token=d6757773-0393-4c89-a47e-337f607369c2) #### **Funktion-Buttons:** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fsuojxs9vXH9ab3otylAW%2FBildschirmfoto%202024-11-26%20um%2010.48.49.png?alt=media\&token=dd9e8abb-f1b4-4bda-9db4-a465f21fbd5d) *Mit den Funktion-Buttons lassen sich verschiedene Funktionen ausführen.* 1. **Alle Dateien löschen**: Löscht alle Dateien in der Warteschlange. 2. **Exportieren**: Alle im aktuell aktiven Shop angelegten Weiterleitungen werden als CSV-Datei heruntergeladen. 3. **Importieren**: Importiert alle CSV Dateien aus der Warteschlange in die Datenbank und verschiebt sie anschliessend in das Archiv. ### Archiv Im Archiv finden Sie alle Dateien die bereits importiert wurden. Sie werden nach dem importieren direkt verschoben. * **Download**: Das Archiv bietet die Möglichkeit, Dateien, die importiert wurden, wieder herunterzuladen, falls diese verloren gegangen sind und wieder benötigt werden. * **Löschen**: Sie können die archivierten Dateien selbstverständlich auch löschen. Nachdem eine Datei aus dem Archiv gelöscht wurde, kann diese nicht wieder hergestellt werden! ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FkDUEzw1XVuJGGw2oKSWm%2FBildschirmfoto%202022-07-07%20um%2013.44.00.png?alt=media\&token=feebfad4-c53e-49b2-9f63-974a7a522924) {% hint style="info" %} **Bitte beachten Sie:** Derzeit werden Dateien im Archiv überschrieben, wenn Sie eine neue Datei mit dem gleichen Dateinamen importieren. Wenn Sie ein vollumfängliches Archiv führen wollen, achten Sie bitte darauf, die Import-Dateien voneinander unterschiedlich zu benennen, z.B. indem Sie einen Zeitstempel im Dateinamen mit aufnehmen. {% endhint %} ## 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 über eine der unten stehenden Adressen. * E-Mail: * Telefon: +49 (0) 5246 / 9099110 * Kontaktformular:
# Responsive Kalender Modul / Aktionskalender ## Modulbeschreibung Mit dem Kalender-Modul haben Sie die Möglichkeit, Ihren Umsatz während den Aktionszeiten noch zusätzlich anzukurbeln. Hinter den beliebig vielen Türchen des Kalender-Moduls befinden sich attraktive Angebote, die Sie selbst bestimmen können und die sich Ihre Kunden sicherlich nicht entgehen lassen werden. Das Modul wird schon seit mehreren Jahren erfolgreich von vielen Shops eingesetzt. Die Türchen des Kalender-Moduls haben eine Öffnungs-Animation und das Hintergrundbild des Kalenders lässt sich ganz einfach nach Ihren Wünschen anpassen. Das Modul basiert auf den modernsten Techniken des Webdesigns. Es ist außerdem responsive und kann von jedem Gerät bedient werden. Das Kalender-Modul kann also auch perfekt in Shops eingebaut werden, die unser responsive Theme [RoxIVE](https://www.digidesk.de/produkte/roxive-responsive-oxid-eshop-theme/) oder das Flow-Theme einsetzten. Mit dem Modul können Sie Ihre Kunden während des gesamten Jahres mit vielen verschiedenen Aktionen wie zum Beispiel mit einer Valentinstag- Aktion, einer Sommer-Aktion, einer Herbst- Aktion, einer Vorweihnachtszeit- und Weihnachts- Aktion begeistern und diese bleiben auch bestimmt im Kopf Ihrer Kundschaft. Das Modul ist erhältlich auf ## Systemvoraussetzungen ### PHP-Version OXID 4 & 5 * PHP 5.6 ### PHP-Version OXID 6 * PHP 7.0 * PHP 7.1 ### 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.1.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 unter:[ https://www.digidesk.de/produkte/basis-modul/](https://www.digidesk.de/produkte/basis-modul/) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "adventskalender" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/adventskalender` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren ### 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/adventskalender". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/adventskalender` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Mit dem **Responsive Adventskalender** Modul für OXID lassen sich für die 24 Türchen des Adventskalenders attraktive Angebote hinterlegen, wobei Sie die Angebote selbst bestimmen und als Verlinkung zwischen Artikel, Kategorie, CMS-Seite oder URL wählen können. Zudem stellt das Modul zahlreiche Konfigurationsmöglichkeiten zur Verfügung mit welchen sich bspw. Schneefall aktivieren oder die Animation mit welcher die Türen öffnen festlegen lässt und der Adventskalender so von Ihnen individuell optisch angepasst werden kann. ### Adventskalender bearbeiten Sie finden die Übersicht zur Verwaltung der unterschiedlichen Adventskalender im Backend unter **Adventskalender > Kalender bearbeiten** Hier können Sie über die "**+ Hinzufügen**" Schaltfläche weitere Adventskalender erstellen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqw4pR5EgcRFtJqKvT%2FBildschirmfoto%202018-10-15%20um%2009.48.30.png?alt=media\&token=c8a27e2c-dd97-4db9-a0f3-37a604ab526e) Wenn Sie mit der Maus über einem bestehenden Adventskalender schweben, kann dieser durch Drücken auf das ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTQiz2eUm5eGp0YQHI%2F-LOTQmxbjTL39ggh0CNq%2Fadventskalender_1.png?alt=media\&token=23ffc953-4c6a-4cc3-a7c8-d5ce83a43cd9) Icon bearbeitet werden. Auch kann entnommen werden, wie viele "Türchen" konfiguriert worden sind. Es öffnet sich anschließend ein Fenster, in welchem Sie die Möglichkeit haben die Verlinkungen der einzelnen Tage zu bearbeiten. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqw8_h83hKQ7eK1UcV%2FBildschirmfoto%202018-10-15%20um%2010.04.26.png?alt=media\&token=5bea6a4c-9f1b-4f18-bf55-e96b256e0aba) Sie können als Art der Verlinkung zwischen Artikel, Kategorie, CMS-Seite oder URL wählen. Daraufhin kann dann für den Tag je nach ausgewählter Art der Verlinkung ein Artikel, eine Kategorie, CMS-Seite oder URL hinterlegt werden. Außerdem ist es möglich die Höhe und Breite für das Türchen und die Position des Bildes einzustellen. Anschließend auf Speichern klicken und das Fenster schließt sich. Nach dem Drücken auf das ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTQiz2eUm5eGp0YQHI%2F-LOTQoTEVChHb7e9Jssa%2Fadventskalender_2.png?alt=media\&token=494a5ac3-9383-4bd0-b6c2-a8539289158a) Icon, welches angezeigt wird wenn sie mit der Maus über einem bestehenden Kalender schweben, werden als weitere Optionen das Duplizieren oder Löschen des Adventskalenders eingeblendet. ### Einstellungsmöglichkeiten Wenn Sie mit der Maus über einem bestehenden Adventskalender schweben, können durch Drücken auf das ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTQiz2eUm5eGp0YQHI%2F-LOTQpafw4wTEesEGX0Y%2FAdventskalender_3.png?alt=media\&token=68f09aad-f7fa-4802-9960-aa6655a065a1) Icon die Einstellungen für diesen bearbeitet werden. Im Modal welches sich anschließend öffnet, sind die Einstellungen in folgende Reiter aufgeteilt: * **Stamm:**\ Hier können Sie die Grundeinstellungen des Adventskalenders festlegen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqwBNMvBxTjCfhVutC%2FBildschirmfoto%202018-10-15%20um%2010.23.30.png?alt=media\&token=b31436d8-a507-462f-b905-1cef3214d967) * **Optik:** Legen Sie fest ob für den Adventskalender Schneefall aktiv ist, mit welcher Animation die Türchen geöffnet werden und ob ein Spruch angezeigt werden soll, wenn versucht wird ein Türchen des Kalenders zu früh zu öffnen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqwD_8SK08u0ISJmr0%2FBildschirmfoto%202018-10-15%20um%2010.24.32.png?alt=media\&token=ef049a5c-f703-45ac-bbf1-4a0fd7d113f0) * **SEO:** Im Reiter SEO können Sie einige Einstellungen für eine bessere Darstellung in Suchmaschinen vornehmen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqwF0koaH2ltQ6d6Hx%2FBildschirmfoto%202018-10-15%20um%2010.27.00.png?alt=media\&token=66afbb08-3320-411a-8130-a1c98bee0cf7) ## Moduleinstellungen Die Einstellungen des Moduls finden Sie im Backend unter **Erweiterungen > Module,** dort wählen Sie dann das Modul "**digidesk - Responsive Adventskalender**" aus der Liste der verfügbaren Module aus. Unter dem Reiter **Stamm** ist der Link aufgelistet, mit welchem Sie den Adventskalender aufrufen können. Zudem finden Sie dort die Smarty Tags zum Einbinden des Adventskalenders in eine CMS-Seite. Über den Ident welcher zuvor in den Einstellungen des Adventskalenders festgelegt wurde kann auch die Einbindung eines bestimmten Adventskalenders erfolgen. Im Abschnitt **"Simulation"** können Sie wenn der Test-Modus im Reiter **"Einstell."** aktiviert wurde, einen Tag eingeben den Sie simulieren möchten. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqwGUxtp74fgMz3Bfk%2FBildschirmfoto%202018-10-15%20um%2010.43.57.png?alt=media\&token=58a34107-dbf1-4eb0-9417-a4d61f4f8643) Unter dem Reiter **"Einstell."** können Sie den Test-Modus aktivieren um das Verhalten des Adventskalenders bereits im Vorfeld zu testen. Zudem haben Sie hier die Option zur Auswahl, dass Türen von vergangenen Tagen im Adventskalender geöffnet bleiben. *Bitte beachten Sie, dass für die Vorschau des Kalenders im Testmodus das Startdatum des Kalenders auf das aktuelle Datum gesetzt werden sollte.* ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOqi6esEFU6ztL_9StS%2F-LOqwHjpi7fTLlX5HO9D%2FBildschirmfoto%202018-10-15%20um%2010.55.25.png?alt=media\&token=1c51ccff-d575-4ea5-9531-7a4ebb64c4dd) ## Troubleshooting Trotz korrekter Installation lässt sich das Modul im admin nicht aufrufen und verursacht Logout aus dem admin-Bereich: mögliche Fehlerursache wäre ein serverseitig installiertes Apache Modul "PageSpeed". ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Review Reminder ## Modulbeschreibung Das **"Review Reminder"** Modul ermöglicht es, individuelle E-Mails an Benutzer zu versenden, um diese aufzufordern eine Bewertung für den Shop abzugeben. Sie können dabei den Zeitraum in Tagen festlegen, welcher ab der Bestellung oder den Versand des Artikels vergangen sein muss, damit der Benutzer eine E-Mail erhält, welche ihn auffordert eine Bewertung abzugeben. Außerdem ist es möglich festzulegen, dass hierfür nur Bestellungen ab einem bestimmten Datum berücksichtigt werden. Der Text der E-Mail kann in den (V)CMS-Snippets mit dem Ident, der mit `dd_review_reminder` anfängt bearbeitet werden. Das Modul ist erhältlich auf ## 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 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 unter:[ https://www.digidesk.de/produkte/basis-modul/](https://www.digidesk.de/produkte/basis-modul/) 2. Für dieses Modul erstellen Sie nun einen weiteren Ordner "reviewreminder" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus `composer require digidesk/reviewreminder -n` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/reviewreminder". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/reviewreminder` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Ab OXID 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Das **"Review Reminder"** Modul ermöglicht es, individuelle E-Mails an Benutzer zu versenden, um diese aufzufordern eine Bewertung für den Shop abzugeben. Dabei wird nach Ablauf eines festgelegten Zeitraums nach der Bestellung oder Versand eine E-Mail an den Benutzer versendet, welche diesen auffordert eine Bewertung abzugeben. ## Einrichtung des Cronjobs Der Versand von den E-Mails an die Kunden kann mit einem Klick auf den Link unter den **Moduleinstellungen -> Stamm -> Manueller Versand** des Moduls oder durch Eingabe von einem Link im Browser wie im folgendem Beispiel angestoßen werden: `https://ihre-shopurl/?cl=dd_reviewreminder&key=123456789` Ersetzen Sie bitte **`https://ihre-shopurl`** und **`123456789`** mit Ihren Daten. Den Key finden Sie unter Moduleinstellungen vom Basis-Modul. Auf die Dauer empfehlen wir hierfür einen **Cronjob** anzulegen, damit die E-Mails in gewissen Zeitabständen automatisch versendet werden. Ab Modul Version 2.2.0 Um den Cronjob auszuführen muss folgender Befehl aus dem Hauptverzeichnis Ihres Shops ausgeführt werden: ``` php source/modules/digidesk/dd_reviewreminder/bin/cron.php --key=IHR_CRONKEY ``` Ersetzen Sie dabei **`IHR_CRONKEY`** durch den Key den Sie in den Modul-Einstellungen des **Basis-Moduls** definiert haben. Achten Sie dabei darauf, dass die auf der Kommandozeile verwendete PHP-Version der Version entspricht die in Ihrem Shop verwendet wird. Um diesen Cronjob automatisiert auszuführen empfehlen wir bei Linux Systemen **"**[**crontab**](https://wiki.ubuntuusers.de/Cron/)**"**. Für crontab sieht der Eintrag z.B. folgendermaßen aus: ``` 0 0 * * * php /source/modules/digidesk/dd_reviewreminder/bin/cron.php --key=IHR_CRONKEY ``` {% hint style="info" %} **Bitte beachten Sie:**\ Im oben stehenden Crontab Eintrag muss **\** durch den absoluten Pfad zum Hauptverzeichnis Ihres Shops ersetzt werden! {% endhint %} Dieses Beispiel startet den Cronjob Script einmal täglich um Mitternacht. ## Modul konfigurieren 1. Navigieren Sie im OXID eShop Admin zu ***Erweiterungen > Module*** 2\. Wählen Sie das Modul "**Review Reminder**" aus der Liste aus und öffnen Sie dann den Reiter "**Einstell.**" 3\. Unter dem Punkt "**Allgemeine Konfiguration**" sind die Optionen selbsterklärend ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FQYSqcxiNVTRFo2Zp6r4v%2FBildschirmfoto%202025-01-17%20um%2015.11.21.png?alt=media\&token=e965cf85-84f8-46d8-99da-3b988c9f4cc8) 4\. Unter dem Punkt "**Test-Modus**" können Sie den Testmodus aktivieren und die noch nicht versandte E-Mails an eine bestimmte E-Mail Adresse senden, der Status der Datensätze wird dabei nicht verändert. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FxG5NKKkLF0C562uv8M43%2Fimage.png?alt=media\&token=69050663-78d2-402f-81a0-a8bc6136e0d5) 5\. Unter dem Punkt "**Cronjob**" können Sie diverse Einstellungen bezüglich des Cronjobs vornehmen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FA90vNu54lAHPQEDRsOif%2Fimage.png?alt=media\&token=76eeea11-8d3f-4e29-8ab8-0547c8f42b70) ## CMS-Seiten anpassen CMS Seiten beinhalten 4 Snippets und werden für die Bildung der E-Mails verwendet. Die Snippets mit der Anmerkung "Plain" sind reine Texte ohne Formatierung. 1. Navigieren Sie im OXID eShop Admin zu **Kun*****deninformation > CMS-Seiten*** 2. Sie haben dort die Möglichkeit, den Inhalt der E-Mail individuell anzupassen. Wählen Sie dazu einfach eine der CMS-Seiten zur Bearbeitung aus, um den Text im Editor anpassen zu können 3. Anschließend übernehmen Sie Ihre Änderungen mit dem "**Speichern**" Button ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FMSweDnGXAzsTngbGcs6e%2Fimage.png?alt=media\&token=b790d5a2-219b-4d9e-879e-38f19908c907) ## Admin-Übersicht In der Listenansicht sehen Sie die Liste mit anstehenden Aufforderungen, falls diese noch nicht versendet wurden. Hier besteht die Möglichkeit diese aus der Liste aus einzeln manuell zu versenden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FjsOqFrVs4vRBlaQ7FzRp%2Fimage.png?alt=media\&token=2c52e014-cabf-4f33-9f6f-e1e5baa841ea) ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # RoxIVE - responsive Theme RoxIVE Theme-Manager ## **Modulbeschreibung** **"RoxIVE"** ist ein responsive Theme für den OXID eShop, welches auf den aktuellsten Technologien der Web-Entwicklung basiert. Dadurch wird Ihr Shop auf allen Endgeräten optimal angezeigt und kann in wenigen Schritten an das Corporate Design des Shop-Betreibers angepasst werden. Mit dem Modul **'RoxIVE Theme-Manager'** können Sie aus dem Admin Ihres Shops komfortabel **RoxIVE -** Theme installieren, aktualisieren und dessen CSS-Styles editieren. Das Modul ist erhältlich auf ## 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) * PHP Erweiterung: "cURL" * PHP Erweiterung: "Zip" ### 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 ### Dateirechte Folgende Ordner müssen vom Webserver-User beschreibbar sein. Warum? Weil RoxIVE über den OXID eShop admin installiert und aktualisiert wird. Es muss also gewährleistet sein, dass der Webserver alle Dateien an den vorgesehenen Stellen schreiben kann. * `Shop-Hauptverzeichnis` * `/application/views/` * `/modules/digidesk/dd_roxive_manager/` * `/out/` ## Installationsanleitung ### 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "roxivemanager" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/roxivemanager` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ### Für Oxid 4.10.x/5.3.x und darunter 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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Laden Sie den Inhalt des Ordners "modules/digidesk/" via FTP/SFTP in das gleichnamige Ordnerverzeichnis "modules/digidesk/" Ihres Shops. 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) for ## Update ### Ab Oxid 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/roxivemanager" 2. Deaktivieren Sie das Modul im OXID eShop Admin 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/roxivemanager` Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren ### Für Oxid 4.10.x/5.3.x und darunter 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Laden Sie den Inhalt des Ordners "/modules/digidesk/" via FTP/SFTP in das gleichnamige Ordnerverzeichnis "/modules/digidesk/" Ihres Shops. 4. Aktivieren Sie dieses Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Theme updaten ### Erhalte ich eine Information, wenn ein Update verfügbar ist? Navigieren Sie dazu im OXID eShop admin zu **digidesk > RoxIVE Theme-Manager > Übersicht**. Auf der rechten Seite erscheint dann ein Formular, über welches Sie beim RoxIVE Update Newsletter anmelden können. Sie erhalten nach Bestätigung der Newsletter-Anmeldung dann automatisch eine E-Mail, sobald eine neue Version von RoxIVE verfügbar ist. ### Wann sollte ich RoxIVE updaten? Diese Frage lässt sich ziemlich einfach beantworten: ***Am besten immer!*** Natürlich ist dies beim Einsatz von stark modifizierten Child-Themes mit Aufwand verbunden, jedoch wird dieser immer größer, je mehr Updates man auslässt. ### Was ist beim Update zu beachten? Sofern **RoxIVE** bzw. eines der Standard-Child-Themes nicht verändert wurde, sondern nur Anpassungen in den Theme-Einstellungen gemacht wurden, kann **RoxIVE** problemlos aktualisiert werden. Wenn **RoxIVE** bzw. eines der Standard-Child-Themes verändert wurde, was nicht empfohlen wird, sollten Sie zuerst ein eigenes Child-Theme mit den Anpassungen erstellen, da Änderungen an den Standard-Dateien beim Update überschrieben werden. Informieren Sie sich in diesem Fall bitte, wie man ein [Child-Theme anlegen](https://digidesk-media-solutions.gitbooks.io/roxive-responsive-oxid-theme/content/sites/customize/content.html) kann. Wenn ein eigenes Child-Theme erstellt wurde, sollte man im **Changelog** schauen, ob Dateien aktualisiert werden, die Ihr Child-Theme verwendet. Sollte dies der Fall sein, sollte das Update zuerst in einer Testumgebung (auch *"Staging-System"* genannt) durchgeführt werden, um dann die Änderungen durch das Update in die eigens angepassten Dateien zu übernehmen. Dafür vergleicht man die Dateien aus dem Theme `dd_roxive` mit denen des eigenen Child-Themes am besten mit einem **"Diff-Tool"** wie z.B. [*WinMerge*](http://winmerge.org/?lang=de). ### Update des Theme durchführen 1. Navigieren Sie im OXID eShop admin zu ***digidesk > RoxIVE Theme-Manager > Übersicht***. 2. Falls ein Update verfügbar ist, befindet sich ein Hinweis auf der Übersichtsseite. 3. Klicken Sie in dem Hinweis auf den Button **RoxIVE jetzt updaten**. 4. Folgen Sie den Anweisungen. ## Theme einstellen Im OXID eShop admin unter ***Erweiterungen > Themes > Einstellungen*** finden Sie Standard-Einstellungen von **RoxIVE**. Darüber hinaus können Sie dort auch die erweiterten Einstellungen wie z.B. Google Analytics und Kontaktseite bearbeiten. ### Theme anpassen Als Entwickler haben Sie die Möglichkeit ein [Child-Theme von **RoxIVE**](https://oxidforge.org/de/ein-eigenes-childtheme-anlegen-ab-4-7.html) zu erstellen, um Farb-, Sprach- und Template-Anpassungen vorzunehmen. Der entscheidende Vorteil eines Child-Themes ist, dass die Update-Fähigkeit von **RoxIVE** nicht beeinträchtigt wird. Sie können **RoxIVE** somit immer automatisiert über den **RoxIVE Theme-Manager** aktualisieren und, wenn nötig, Ihr Child-Theme dementsprechend anpassen. Weitere Informationen und Hilfen finden Sie in unserer [YouTube-Playlist zu **RoxIVE**](https://www.youtube.com/watch?v=3QfhjbGquSo\&list=PLY_9P2OqnW_VYcGR-_OA8BokMmH3JcBrx\&index=1). ## Informationen für Entwickler * **RoxIVE** basiert auf dem Frontend Framework [Bootstrap](http://getbootstrap.com/) * **RoxIVE** kann [durch Child-Themes erweitert](https://oxidforge.org/de/ein-eigenes-childtheme-anlegen-ab-4-7.html) werden, wodurch die Update-Fähigkeit vollständig erhalten bleibt. (Tutorials gibt es in unserer [YouTube-Playlist zu **RoxIVE**](https://www.youtube.com/watch?v=3QfhjbGquSo\&list=PLY_9P2OqnW_VYcGR-_OA8BokMmH3JcBrx\&index=1)) * [**LESS**](http://lesscss.org/) wird als CSS-Preprocessor verwendet * Responsive E-Mail-Templates * Blocks im gesamten Theme, die durch Module überladen werden können, wie man es vom Standard-OXID-Theme gewohnt ist * optimale Anzeige auf allen Endgeräten * Google Analytics Page Tracking * Google Analytics Ecommerce Tracking * Google Zertifizierte Händler konfigurierbar * FontAwesome Icons für Retina-Displays optimiert * kompatibel mit den meisten Standard-Modulen, wie z.B. PayPal * einstellbare Google Maps-Karte auf Kontaktseite * Theme-Updates per Knopfdruck installieren * Einstellbarer Hintergrund ## PayPal Plus Integration Für die Installation von **PayPal Plus** in einem OXID eShop mit dem **RoxIVE-Theme** sind Einstellungen in dem PayPal Plus Modul notwendig. Im Folgenden erklären wir Ihnen, wo Sie diese Einstellungen vornehmen müssen: 1. Installieren Sie **PayPal Plus**, wie in der Modulanleitung beschrieben 2. Rufen Sie im Backend Ihres OXID eShop die Module unter ***Erweiterungen->Module*** auf und wählen Sie das **PayPal Plus** Modul aus 3. Wechseln Sie auf die Tab Einstell. Und öffnen Sie den Reiter PayPal Plus **"Templateeinstellungen"** 4. Ändern Sie den Wert in \[paypPayPalPlusNextLinkParent] auf **li** 5. Ändern Sie den Wert in \[paypPayPalPlusPaymentRadio] auf **input** 6. Ändern Sie den Wert in \[paypPayPalPlusListItem] auf **div.well** Bitte beachten Sie, dass sich diese Anleitung nur auf eine **Standard-RoxIVE** Installation bezieht. Sofern Anpassungen an der Zahlarten-Seite gemacht wurden, müssen die oben genannten Einstellungen gegebenenfalls darauf abgestimmt werden. Für die Sicherung und Wiederherstellung der **RoxIVE-Einstellungen** benötigen Sie Zugriff auf Ihre Shop-Datenbank. Dafür empfehlen wir beispielsweise *phpMyAdmin*. ## RoxIVE-Einstellungen sichern Um die **RoxIVE-Einstellungen** zu sichern gehen Sie wie folgt vor: * In *phpMyAdmin* (oder ähnliches Tool) mit den Zugangsdaten Ihrer Datenbank einloggen. * Folgenden Select-Befehl ausführen: `SELECT * FROM oxconfig WHERE oxmodule = 'theme:dd_roxive'` * Das Resultat über das Datenbank-Tool als Datei exportieren. Die Export-Möglichkeit finden Sie dann in *phpMyAdmin* ganz unten auf der Seite. Wählen Sie auf der nächsten Seite **„Schnell“** aus und das Format **„SQL“**. * Nun haben Sie Ihre **RoxIVE-Einstellungen** in Form von SQL-Anweisungen gesichert. ## RoxIVE-Einstellungen wiederherstellen **WICHTIG**: Bei diesem Prozess werden Ihre aktuellen **RoxIVE-Einstellungen** entfernt! Befolgen Sie nun die weiteren Schritte, wenn Sie die gesicherten Einstellungen zurück in Ihrem Shop einspielen möchten: * In *phpMyAdmin* (oder ähnliches Tool) mit den Zugangsdaten Ihrer Datenbank einloggen. * Damit bei der Wiederherstellung der Einstellungen keine Konflikte mit den aktuell vorhandenen Einstellungen entstehen, müssen die aktuellen Einstellungen von der Datenbank gelöscht werden. Führen Sie hierfür folgenden SQL-Befehl aus: `DELETE FROM oxconfig WHERE oxmodule = 'theme:dd_roxive'` * Nun spielen Sie die gesicherten **RoxIVE-Einstellungen** ein, indem Sie die zuvor gesicherte **SQL-Datei** über Ihr Datenbank-Tool importieren: In *phpMyAdmin* klicken Sie auf **„Importieren“** über die obere Navigationsleiste und folgen den Anweisungen. ## Troubleshooting #### Ich finde keine Einstellungen im RoxIVE-Theme! Falls Sie in den Theme-Einstellungen von RoxIVE keine Einstellungen finden, sind nicht alle in den Systemvoraussetzungen genannten Verzeichnisse "schreibbar". Bitte prüfen Sie die Dateirechte. #### Beim Installieren bzw. Updaten von RoxIVE erhalte ich eine Fehlermeldung "No error." Auch hier gibt es Probleme mit den Dateirechten. Bitte prüfen Sie die Dateirechte der in den [Systemvoraussetzungen](https://digidesk-media-solutions.gitbooks.io/roxive-responsive-oxid-theme/content/sites/requirements/content.html) genannten Verzeichnisse. #### Im Frontend werden Icons nur als Kästchen oder Fragezeichen dargestellt. Dieser Fehler tritt in den meisten Fällen ein, wenn Ihr Shop sowohl unter **[www.meinshop.de](http://www.meinshop.de)** und **meinshop.de** aufrufbar ist. Bitte stellen Sie sicher, dass Ihr Shop nur unter einer Adresse erreichbar ist. Dies löst man am besten über eine Regel in der Datei `.htaccess`, welche sich im Hauptverzeichnis Ihres Shops befindet. Dies verhindert nicht nur "Duplicate Content", sondern auch, dass die Icons fehlerhaft dargestellt werden. Des Weiteren sollte sichergestellt sein, dass die korrekte URL in der Datei `config.inc.php`, welche sich ebenfalls im Hauptverzeichnis Ihres Shops befindet, eingetragen ist. #### Beim Aktivieren von PayPal Express auf der Detailseite rutscht der Button "In den Warenkorb" eine Zeile tiefer. Wir haben nun schon des Öfteren mitbekommen, dass das Standard-PayPal-Modul die Detailseite etwas zerschießt, wenn der PayPal-Express Checkout auf der Detailseite aktiviert wird. Dies ist leider nicht RoxIVE-seitig lösbar, sondern nur im PayPal-Modul selbst. Dazu bitte in die Datei `/modules/oe/oepaypal/views/blocks/page/details/oepaypalexpresscheckoutdetailspage.tpl`gehen und folgende Zeile entfernen: `[{oxscript add='$("#toBasket").prependTo($("#paypalExpressCheckoutDetailsBox"))'}]` #### Dropdown-Menüs gehen nicht auf. Dieser Fehler tritt in den meisten Fällen ein, wenn Bootstrap mehrfach eingebunden wird. Falls Sie den "Visual Editor" oder den "Visual CMS" einsetzen, dann beachten Sie, dass die Option "**Eigenes Gridsystem verwenden (deaktiviert Bootstrap)**" unter der Modul-Einstellung für Frontend **aktiv** ist. Somit wird die doppelte Einbindung von Bootstrap vermieden. **Bei der Verwendung des LESS-Parsers wird die Skriptlaufzeit (max\_execution\_time) überschritten** Es kann vorkommen, dass bei dem Parsen der Less-Dateien das Skript mehr Zeit in Anspruch nimmt. Hierzu bitte die **max\_execution\_time** auf z. Bsp. 120 Sekunden oder auf einem angemessenen Wert erhöhen. ## 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 über einer der unten stehenden Adressen. E-Mail: ****\ Telefon: **+49 (0) 5246 / 9099110**\ Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Seo-Suite ## Modulbeschreibung Mit dem Seo-Suite Modul sind Sie in der Lage, deutlich zeit- und kosten-effizienter zu arbeiten - und so ganz "nebenbei" auch Ihre Suchmaschinen-Ergebnisse zu optimieren. Das Modul wurde von den SEO-Experten von **Bloofusion** geprüft. ## 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. 1. Sie erhalten dieses unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "seosuite" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/seosuite` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ### Bis OXID 4.10.x/5.3.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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/seosuite". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/seosuite` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ### Funktionsbeschreibung Besonders bei vielen Shop-Artikeln wirken sich da schon kleine Verbesserungen sehr deutlich aus: Sie sparen viel Zeit und dementsprechend viel Geld. Mit der SEO-Suite wird die Pflege der relevanten Informationen deutlich vereinfacht. #### So greifen Sie mit unseren komfortablen Editoren direkt auf alle wichtigen Bereiche zu: * Artikel * Kategorien * CMS-Seiten #### Über folgende Einstellungen erleichtert Sie sich und Ihren Mitarbeitern die Arbeit: * Meta Tag: Title und Meta-Description können per Drag & Drop aufgebaut und global eingestellt werden * Robots-Tags: Diese können für die verschiedenen Seiten-Typen global gesetzt werden * Robots.txt-Editor: Für ein einfaches Bearbeiten der robots.txt im Admin-Bereich ## Backend-Einstellungen Im Backend unter Seitentitel können Sie die Generierung des Seitentitels aktivieren und Ihre gewünschten Anpassungen vornehmen:
Unter Meta-Beschreibung können Sie die Generierung der Meta-Beschreibung aktivieren und Anpassungen an der Meta Beschreibung vornehmen:
Unter Indexierung können Sie den Robots-Metatags aktivieren und Anpassungen vornehmen:
Unter robots.txt Editor befindet sich der Bereich für die robots.txt Datei, die Sie ebenfalls, wie gewünscht anpassen können:
## Seitentitel und Beschreibungstext für Meta-Tags in der Artikel- und Kategorieverwaltung In der Artikel- und Kategorieverwaltung im Backend unter Reiter SEO kann man bei einzelnen Artikeln und Kategorien eigenen Seitentitel und Beschreibungstext für Meta-Tags festlegen. Falls diese Felder einen Inhalt beinhalten - haben sie dann im Frontend Priorität vor dem modul-generiertem Inhalt .
## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # Shop Lexikon ## Modulbeschreibung Mit dem Lexikon-Modul können Begriffe erklärt werden, die auf den ersten Blick nicht jedem Interessenten klar sind. Was sind Polymere? Wozu benötigt man einen Sextanten? All diese Begriffe lassen sich leicht über das Lexikon-Modul erklären. Dazu wird auf der Webseite nachgeschaut, welche Begriffe verwendet wurden und diese werden automatisch verlinkt und kenntlich gemacht. ## 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. 1. Sie erhalten dieses unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "lexikon" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:\ `composer require digidesk/lexikon` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ### Bis OXID 4.10.x/5.3.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 unter:[https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein 3. Aktivieren Sie das Modul im OXID eShop Admin 4. Ggf. Tmp-Verzeichnis leeren und Views neu generieren 5. Bitte fahren Sie nun mit der [Einrichtung des Moduls](https://digidesk-media-solutions.gitbooks.io/bestellbare-gutscheine-modul/content/einrichtung-des-moduls.html) fort ## Update ### Ab OXID 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/lexikon". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgende Befehle aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/lexikon` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis OXID 4.10.x/5.3.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Backend #### Konfiguration: Eintrag unter **Stammdaten** ->**Grundeinstellungen**- >**SEO**: \ 1\. Scrollen Sie bitte runter bis zum Punkt "**Statische URLs**"\ 2\. Tragen Sie im Feld "**Standard URL"** folgendes ein: **index.php?cl=dd\_lexikon\_list**\ 3\. Unter den Sprachen können Sie beliebige selbsterklärende Einträge mit einem "**/**" am Ende vornehmen (siehe Beispiel- Screenshot)\ 4\. Speichern Sie diese Einstellungen.
![Beispiel- Screenshot Einstellungen](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MESkODCrT5j8v9KUw3J%2F-MESmI2fSXlh1ZQ6TQDb%2Fimage.png?alt=media\&token=24b56e03-595f-4e9f-a413-bc88dcda34e9) Im Backend Bereich können Sie als Shopbetreiber ganz einfach und bequem die Begriffe eintragen, die im Frontend unterstrichen dargestellt werden und bei *mouseover* die Kurzbeschreibung anzeigen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lt9jJDetGf-JCuylTFx%2F-Lt9mwhGC6S2HzpYfEUh%2FLexikon_2_compressed.png?alt=media\&token=2a3f8254-5144-4138-860b-f187ce3f157f) ## Frontend Nach den Einstellungen ist es möglich, diese im Frontend anzusehen: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lt9jJDetGf-JCuylTFx%2F-Lt9nB-hYVLPal3Ug_cf%2FLexikon_1_compressed.png?alt=media\&token=f1278b6f-aa04-4bc6-9525-7cfc64c3f479) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # Topbar-Modul ## Modulbeschreibung Dieses Modul ermöglicht Ihnen eine **"Topbar"**, mit aufklappbaren Inhalten, zu ihrem Shop hinzuzufügen. Die Reiter und der Inhalt sind dabei frei wählbar und können unabhängig voneinander gestaltet werden. ## Allgemeine Moduleinstellungen Unter dem Punkt **Topbar > Grundeinstellungen** finden sie allgemeine Einstellungen mit denen Sie grundlegende Konfigurationen vornehmen können. ### **Einstellungen der Topbar** * **Ausrichtung der Topbar** lässt Sie die Reiter der Topbar ausrichten. Hiermit können Sie die Reiter zentrieren (wenn kein Reiter eine eigene Ausrichtung besitzt) oder einen Standardwert für Reiter ohne eigene Ausrichtung festlegen. * **Hintergrundfarbe der Topbar** lässt Sie die Farbe der Topbar einstellen. ### **Allgemeine Reiter-Konfiguration** * **Abgerundete Reiter** lässt Sie eckige oder abgerundete Reiter einstellen. * Die **Schriftgrösse der Reiter** können Sie hier festlegen * Mittels **Grösse der Reiter** legen Sie fest wieviele Pixel Abstand zwischen Reiterrand und Reitertext liegen sollen, der Rand muss dabei nicht aktiv sein. ### **Konfiguration des Topbar-Randes** * Hier können Sie den **Rand am unteren Ende des Moduls** **anzeigen** oder ausblenden. * Auch die **Höhe des Modulrandes** ist einstellbar * Die **Farbe des Modulrandes** können Sie hier auswählen ### **Zusätzliche Abstände festlegen** * **Abstand der Reiter zum oberen Seitenrand** lässt Sie die Reihe der Reiter weiter nach unten verschieben, oder nach oben wenn Sie negative Werte eintragen. * **Unterer Abstand der Reiter** legt den Abstand zwischen Reiter und aufklappbarem Inhalt fest. * **Seitlicher Abstand zwischen den einzelnen Reitern** gibt ihnen die Möglichkeit die Reiter weiter auseinander zu ziehen. * **Linker Abstand der Topbar** lässt Sie die Topbar einrücken. * **Rechter Abstand der Topbar** bestimmt wie breit die Topbar sein darf. * **Oberer Rand des aufklappbaren Inhalts** bestimmt den oberen Abstand zwischen dem Beginn des aufklappbarem Inhaltes und dessen Text. * **Unterer Rand des aufklappbaren Inhalts** legt den unteren Abstand fest. ### **Standardfarben des Moduls festlegen** Hier legen Sie die standardmässig verwendeten Farben der Einträge fest. ## Reiter konfigurieren Um Reiter und Inhalte anzulegen navigieren sie im OXID eShop Admin zu **Topbar > Einträge bearbeiten**. Dort finden sie eine Auflistung ihrer eingestellten Reiter. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTJn7uYrHJHUTg_pLj%2F-LOTL61Bq3yA6XL9QibS%2FTopbar_1.png?alt=media\&token=8ab1aa6f-6558-4ef5-a88a-ae40b06eae78) Schweben Sie mit der Maus über einen der Einträge erscheinen rechts zwei Symbole. Mit einem Klick auf ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTR8s5LYCmp2fPPM7A%2F-LOTRGRlTInDI6UJyCZF%2FTopbar_1.png?alt=media\&token=3906b7cc-d5c5-47e4-a9c1-1ea58666d861) **löschen** Sie den Eintrag. Wenn Sie den **Eintrag bearbeiten** möchten drücken Sie auf ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTR8s5LYCmp2fPPM7A%2F-LOTRI8780TVvrBkQnfh%2FTopbar_2.png?alt=media\&token=819c2f9f-baf7-4ade-adad-0277d37b66c4) . Um einen **neuen Eintrag** anzulegen klicken sie oben rechts auf das ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTR8s5LYCmp2fPPM7A%2F-LOTRJ5f-Vgb2xbqsQAA%2FTopbar_3.png?alt=media\&token=1b111684-ca3e-48a3-b9c6-40741cfd3f9f) . Es erscheint ein Fenster in dem Sie Einstellungen vornehmen können. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTJn7uYrHJHUTg_pLj%2F-LOTL7L1d3Rw1WjoUTC3%2FTopbar_2.png?alt=media\&token=6ed4bd5e-4d6a-429a-876b-4f23ce2591c7) * Mit der **Aktiv**-Checkbox können Sie die Elemente aktivieren oder deaktivieren. * Die **Ausrichtung** ermöglicht Ihnen das Element nach Links oder Rechts zu positionieren (So können Sie bspw. Hinweise von anderen Elementen abgrenzen). * Sie können auch ein **Icon** auswählen, das vor dem Reitertext angezeigt werden soll. Geben Sie hierfür den Namen des Icons ein (zB: phone). Eine Liste mit den verfügbaren Icons finden Sie [hier](http://fontawesome.io/icons/). * Den Schriftzug des Reiters können Sie in **Reitertext** eingeben. * Mit der **Reiterreihenfolge** geben Sie an in welcher Reihenfolge die Reiter angezeigt werden. Um maximale Kontrolle über die Reihenfolge zu haben, achten Sie darauf, dass jeder Reiter einen unterschiedlichen Wert besitzt. * Mit der Einstellung eines **CMS-Ident** können Sie ihre CMS-Seiten als Inhalt der Topbar einbinden. Hierfür einfach den Ident der zu benutzenden Seite eintragen (zB: oxagb). * In **Inhalt** können Sie den Text schreiben, der bei einem Klick auf den Reiter angezeigt werden soll. Hier können Sie auch Bilder, Videos oder ganze Html-Seiten einfügen. * Sie können auch die Inhalte (CMS-Ident, Inhalt) freilassen um nur den Reiter anzeigen zu lassen (zB: für eine Hotline-Nummer oder einen Link). * Wenn Sie einen Link in der Topbar einfügen möchten, geben sie die Url in **Verlinkung** an. Um den Reiter auch optisch zu gestalten klicken Sie auf den Tab **Optik** ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOTJn7uYrHJHUTg_pLj%2F-LOTL99-o4OADoR99roK%2FTopbar_3.png?alt=media\&token=7153e3fe-7906-4e2b-bfd1-0008f92e7366) Hier können Sie alle Farben auswählen, die dieser Eintrag verwenden soll. Die Felder **Bei aktivem Reiter** lassen Sie extra Farben einstellen, um den momentan aufgeklappten Reiter hervorzuheben. Sie können aber auch die Checkbox "**Standardfarben benutzen**" aktivieren und das Element benutzt die Farbeinstellungen, die in den [**Allgemeinen Einstellungen**](https://digidesk-media-solutions.gitbooks.io/aufklappbare-topbar/content/3-Konfiguration/3_1-Allgemein.html) konfiguriert wurden. Wenn Sie mit Ihren Einstellungen zufrieden sind, drücken sie auf **"Speichern"**. ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Verfügbarkeitsbenachrichtigung ## Modulbeschreibung Artikel ausverkauft? Kein Problem - Informieren Sie Ihre Kunden, wenn er wieder verfügbar ist!\ Über dieses Modul können sich Shopkunden für ausverkaufte Artikel registrieren, um benachrichtigt zu werden, wenn diese wieder verfügbar sind. Der Shopinhaber hat über dieses Modul auch eine Aussage, für welche Produkte sich seine Kunden interessieren, um entsprechende Nachkäufe zu organisieren oder bei Rückläufern die Kunden entsprechend zu benachrichtigen. ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.3.x) * PHP 8.4 (OXID 7.3.x) ### Webserver-Konfiguration * IonCube Loader (mind. v14.0) ### Kompatibel mit den Themes * Flow (OXID 6) * RoxIVE (OXID 6) * Wave (OXID 6) * Apex ab OXID 7.1 ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0.x bis 7.3.x ## Installation ### Ab OXID 6 / 7 1. Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung. 1. Sie erhalten dieses unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "articlereminder" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/articlereminder` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ## Update ### Ab OXID 6 / 7 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/articlereminder". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/articlereminder` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Backend Im Backend Bereich werden Sie benachrichtigt, wenn ein Kunde sich für ein Produkt interessiert und diesen auch erwerben möchte: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F7TplpVuMRa8sUSU4vPrZ%2FVerfuegbarkeits-Benachrichtigung-Backend.png?alt=media\&token=219e7c2d-9e9d-4005-bcfb-5ea64a4c75b6) Ebenfalls können Sie im Backend die Benachrichtigungen, dass ein Artikel wieder vorhanden ist manuell senden, indem Sie auf das Brief-Icon klicken: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FEJ9aYeR8TGCGI3v2E2ih%2FVerfuegbarkeits-Benachrichtigung-Backend-2.png?alt=media\&token=22805fa8-bd23-435c-a0c8-0a80e7cfd58b) Wenn der Double Opt-In für den E-mail Versand aktiviert ist, sehen Sie im Backend außerdem eine zusätzliche Spalte, die anzeigt ob der Kunde den Double Opt-In abgeschlossen hat oder nicht. Sollte der Kunde den Double Opt-In noch nicht abgeschlossen haben, können Sie die Benachrichtigung auch nicht manuell verschicken. ### Cronjob Für den automatischen Versand der Benachrichtigungen gibt es einen Cronjob, der ausgehend vom Shop-Root-Ordner auf dem Server über die CLI wie folgt aufgerufen werden kann: `vendor/bin/dd-articlereminder --key=cronjobkey` Damit der Cronjob automatisch ausgeführt wird, muss ein zeitlich geplanter Aufruf des CLI-Commands auf Ihrem Server eingerichtet werden. Falls Sie dabei Hilfe benötigen, können Sie uns gerne kontaktieren. Der Cronjob Schlüssel `cronjobkey` befindet sich in den Moduleinstellungen und wird automatisch vom System generiert: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F4GyTgNTr4y1z1v5fnfAy%2FVerfuegbarkeits-Benachrichtigung-Backend-3.png?alt=media\&token=16421b4e-3369-470b-b699-9679d83d6c28) ### Benachrichtigungsintervall Das **Benachrichtigungsintervall** legt fest, wie viele Tage der Kunde vor der Wiedereinlagerung informiert werden soll. Wenn man das **Benachrichtigungsintervall** bspw. auf "**2**" setzt, wird der Kunde 2 Tage vor dem vorhanden sein des Artikels informiert. Wenn das **Benachrichtigungsintervall** jedoch auf "**0**" gesetzt wird, besteht kein Intervall und der Kunde wird erst an dem Tag informiert wo der Artikel wieder vorhanden ist. Bei aktiviertem **Benachrichtigungsintervall** wird der **Schwellenwert** ignoriert. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FIMvn9FV4K8WvPEgMyZDL%2FVerfuegbarkeits-Benachrichtigung-Backend-4.png?alt=media\&token=6ddc1615-2344-4497-b277-8fd633f7a9be) Ausserdem muss dazu bei dem jeweiligen Artikel unter "**Artikel verwalten**" in dem Reiter "**Lager**" das "**Wieder lieferbar am**" Feld entsprechend gesetzt sein. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FmgJADOrKQHeNW4yRpC4E%2FVerfuegbarkeits-Benachrichtigung-Backend-5.png?alt=media\&token=67798f62-d385-488f-a93e-7db2237f5567) ### Schwellenwert Der **Schwellenwert** gibt an, ab welcher Menge der verfügbaren Artikel der Kunde informiert werden soll. Wenn der **Schwellenwert** nicht aktiviert ist, kann der Kunde im Frontend die Anzahl der Artikel selber eintragen. Beim aktiviertem **Schwellenwert** wird die Eingabe für die Anzahl der Artikel im Frontend ausgeblendet. Bei aktiviertem **Benachrichtigungsintervall** wird der **Schwellenwert** ignoriert. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2F87B65Uj2merIw1USIusu%2FVerfuegbarkeits-Benachrichtigung-Backend-6.png?alt=media\&token=e2d331d8-931b-44da-9082-f18098b46a15) ### Anpassen der E-Mail Vorlagen Um die E-Mail-Vorlagen für die Benachrichtigungs-Mails anpassbar zu halten werden die Texte aus den CMS-Inhalten `ddinfomailoperator` , `ddaroptincustomermail` und `dduserinfomailcustomer` geladen. Somit können Sie wahlweise über Kundeninformationen -> CMS-Seiten oder in PE und EE Versionen über Kundeninformationen -> VisualCMS die Texte der Benachrichtigungs-Mails anpassen, indem Sie diese CMS-Snippets bearbeiten. ## Frontend :exclamation:Damit der Button **Benachrichtigen** im Frontend sichtbar wird, sollte der Artikel einen Lieferstatus **Wenn ausverkauft nicht bestellbar** haben. \ So sieht das ganze dann für Ihre Shopkunden im Frontend aus: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FOkDNtwD59noU4YfjUuDe%2FVerfuegbarkeits-Benachrichtigung-Frontend.png?alt=media\&token=be804a9f-1112-4e08-903e-4ea110b80742) ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2FI2Eal0g1omvUPBpjRowf%2FVerfuegbarkeits-Benachrichtigung-Frontend-2.png?alt=media\&token=ca10cf0e-bdbe-45fd-ac96-c81e3d52ff87) ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # Versandkosten mit Gutschein bezahlen voucherwithshipping ## Modulbeschreibung Mit diesem Modul können Sie Ihren Kunden anbieten, Versandkosten mit Gutscheinen verrechnen zu lassen. Diese Möglichkeit ist bei den Standard OXID-Gutscheinen nicht möglich. Zu beachten ist jedoch, dass nur im „Bruttomodus“ die Verrechnung vollkommen greift. Das Modul wurde mit folgenden Zahlart-Modulen unter Oxid 6.1 - 6.4 getestet: PayPal, AmazonPay und Payone. Das Modul ist erhältlich auf ## Systemvoraussetzungen ### 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/EE 6.0.x bis 6.5.x * für ältere Shop-Versionen auf Anfrage ## Installation 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "voucherwithshipping" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/voucherwithshipping` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ## Update ### Ab Oxid 6 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/voucherwithshipping". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgende Befehle aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/voucherwithshipping` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Backend-Einstellungen Nach der Modulaktivierung wird im Modul zuerst rote Meldung **"Die Zahlart Coupon (ddcoupon) ist noch zu keiner Versandart zugeordnet!"** angezeigt. Die Zuordnung erfolgt wie folgend: 1. Im Backend im Menu auf der linken Seite bei den **Shopeinstellungen->Versandarten** muss man zuerst eine **Versandart** auswählen, die für Coupons (Gutscheine) gelten soll. 2. Dann in dieser Versandart auf den Reiter **Zahlungsarten** gehen und auf **Zahlungsarten zuordnen** klicken. Es öffnet sich ein Popup- Fenster, in diesem Sie den **Coupon** aus dem linken ins rechte Fenster mit der Maus rüberziehen. Fenster schliessen, fertig. 3. Wenn Sie jetzt im Menu **Erweiterungen->Modul**e auf dieses Modul klicken, muss anstatt der roten Meldung eine Blaue erscheinen: **Die Zahlart "Coupon (ddcoupon)" ist zu folgenden Versandarten zugeordnet: xxxxxxx (ihre ausgewählte Versandart)** ## **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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # Versandzeitpunkt ## Modulbeschreibung Mit dem Modul "**Versandzeitpunkt"** kann der Shopbetreiber die Uhrzeiten, ab denen der Versand stattfindet, im Shop hinterlegen, um den Besuchern des Shops anzuzeigen, bis wann eine Bestellungen noch am selben Tag versendet wird. Die Besucher des Shops bekommen bei jedem Artikel die verbleibende Zeit bis zum Versand angezeigt. Sollte diese Zeit schon überschritten sein, wird die entsprechende Anzeige ausgeblendet. Das Modul ist erhältlich auf ## 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 ## Installationsanleitung ### 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 unter:[ https://www.digidesk.de/produkte/basis-modul/](https://www.digidesk.de/produkte/basis-modul/) 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "todayshipping" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/todayshipping` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### 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 unter: [https://www.digidesk.de/produkte/basis-modul](https://www.digidesk.de/produkte/basis-modul/) 2. Fügen Sie den Inhalt des Ordnerverzeichnisses des Moduls "modules/digidesk/" via FTP/SFTP unter dem gleichnamigen Pfad in Ihren Shop ein. 3. Aktivieren Sie das Modul im OXID eShop Admin 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. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/todayshipping". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/todayshipping` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ### Bis Oxid 5.3.x/4.10.x 1. Bitte aktualisieren Sie das Basis-Modul gemäß der darin enthaltenen Installationsanleitung. 2. Deaktivieren Sie dieses Modul im OXID eShop Admin. 3. Fügen Sie den Inhalt des Ordners "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. ## Funktionsbeschreibung Im OXID eShop admin unter dem Punkt ***"Versandzeitpunkt > Grundeinstellungen"*** befindet sich das Formular zur Eingabe der Uhrzeiten. ### Generelle Versandzeiten Unter **"Grundeinstellungen"** befinden sich die generellen Versandzeiten für jeden Wochentag. Die Checkboxen aktivieren die Felder zur Eingabe der Uhrzeiten und kennzeichnen diesen Tag als Versandtag. Die eingegebene Uhrzeit, ist die Zeit ab wann der Versand stattfindet. Außerdem ist es möglich den Mindest-Lagerbestand durch das Anklicken der Checkbox zu berücksichtigen und auch den Mindest-Lagerbestand anzugeben. Anschließend nur noch auf **"Speichern"** drücken. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOccm-MXP7RJcuYWadp%2F-LOcY3NHhevM5Ktubc0A%2FBildschirmfoto%202018-10-12%20um%2015.51.38.png?alt=media\&token=cb214899-609f-486b-8d67-55424a035329) ### Spezifische Versandtermine Im Reiter **"spezielle Einstellungen"** können spezifische Versandtermine wie z.B. Feiertage eingetragen und bearbeitet werden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOccm-MXP7RJcuYWadp%2F-LOcZdR1pgFaWNI-LmJ5%2FBildschirmfoto%202018-10-12%20um%2015.58.31.png?alt=media\&token=a58ac26f-2edd-4f5e-9d49-93359683414e) Ein Klick auf ein Datum oder ein **"gedrücktes Ziehen"** über ein Zeitraum öffnen ein Overlay für die Eingabe eines Versandtermins. Dabei kann eine abweichende Uhrzeit eingegeben werden oder der Versand für den Tag bzw. den Zeitraum kann komplett deaktiviert werden. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOccm-MXP7RJcuYWadp%2F-LOc_Xs5a6765pgP9cxc%2FBildschirmfoto%202018-10-12%20um%2016.02.05.png?alt=media\&token=3ffd09ae-5abc-44cb-94de-e3a85ab25e5d) Um einen Versandtermin zu bearbeiten, reicht ein Klick auf den Balken des Termins im Kalender. Hier können die Einstellungen überarbeitet oder der Termin gelöscht werden. ### Anzeige im Frontend Die Besucher des Shops bekommen nun im Shop Frontend den Hinweis angezeigt, bis wann ein Artikel bestellt werden kann, damit die Bestellung noch an diesem Tag versendet wird. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOccm-MXP7RJcuYWadp%2F-LOcanGG1SkG2Dw_veMy%2FBildschirmfoto%202018-10-12%20um%2016.07.22.png?alt=media\&token=18381571-ff78-4e87-bc18-a5e3ea76f722) ## 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 über einer der unten stehenden Adressen. E-Mail: ****\ Telefon: **+49 (0) 5246 / 9099110**\ Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) # XML Sitemap ## Modulbeschreibung Eine XML-Sitemap ist eine Liste von allen URLs auf einer Website. Suchmaschinen verwenden Sitemaps als eine Art Wegweiser, um die Gesamtstruktur und den Aufbau einer Webseite besser zu verstehen. Wir empfehlen jedem Shop-Betreiber, eine Sitemap zu erstellen ## Systemvoraussetzungen ### PHP-Version OXID 6 * PHP 7.4 - 8.1 (OXID 6.5.x) ### PHP-Version OXID 7 * PHP 8.1 - 8.2 (OXID 7.1.x) * PHP 8.2 - 8.3 (OXID 7.2.x - 7.4.x) * PHP 8.4 (OXID 7.3.x - 7.4.x) ### Webserver-Konfiguration * IonCube Loader (v14 - v15) ### Kompatibel mit den OXID Versionen * OXID CE/PE/EE 6.5.x * OXID CE/PE/EE 7.0 bis 7.4.x ### Template-Engine * Smarty bis OXID 7.0.x * Twig ab OXID 7.0.x ## Installation ### Ab OXID 6/7 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 unter: 2. Für dieses Modul erstellen Sie nun einen weiteren Unterordner "sitemap" im Ordner "packages/digidesk", in den die heruntergeladene Zip-Datei entpackt wird. 3. Führen Sie anschließend folgende Befehle aus dem Hauptverzeichnis des Shopsystems aus: `composer require digidesk/sitemap` 4. Nun kann das Modul im OXID eShop Admin aktiviert werden 5. Ggf. Tmp-Verzeichnis leeren und Views generieren 6. Bitte fahren Sie nun mit der Einrichtung des Moduls fort ## Update ### Ab OXID 6/7 1. Entpacken Sie die neue Modulversion in den Ordner "packages/digidesk/sitemap". 2. Deaktivieren Sie das Modul im OXID eShop Admin. 3. Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus: `composer update digidesk/sitemap` Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y". 4. Aktivieren Sie das Modul im OXID eShop Admin. 5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren. ## Funktionsbeschreibung Mit dem Modul XML Sitemap können Sie alle Artikel und Kategorien in Ihrem OXID eShop exportieren und daraus eine XML Sitemap erstellen. Der Export kann per URL-Aufruf manuell oder per Cronjob angestoßen werden. Wir empfehlen die Einrichtung eines Cronjobs, denn somit bleibt die XML Sitemap immer aktuell und Sie müssen sich nicht mehr darum kümmern. Dies sind die **Moduleinstellungen**:
{% hint style="info" %} Die Dateinamen, welche in den Moduleinstellungen einstellbar sind, werden um ein Sprachkürzel erweitert, z.B.: google\_sitemap*\_*de.xml oder google\_sitemap\_1*\_*de.xml - je nach Shop Edition. Dies hat den Vorteil, dass wenn man einen mehrsprachigen Shop hat, die Dateien der verschiedenen Sprachen sich nicht überschreiben. {% endhint %} ### Manueller Export Der manuelle Export per URL würde zum Beispiel so aussehen: ``` https://www.ihre-shop-url.de/index.php?cl=ddsitemap&key=IHR_CRONKEY ``` Zusätzlich zum Parameter `key` gibt es auch noch den Parameter `lang` um die zu exportierende Sprache anzugeben. Beim Parameter `lang` muss die Sprach-ID, welche für die jeweilige Sprache definiert wurde, angegeben werden. Wird der Parameter `lang` nicht angegeben, werden die Sitemaps für alle Sprachen des jeweiligen Shops nacheinander exportiert. (**Bei der Modulversion <= 3.3.1**: Dabei werden alle für den jeweiligen Shop **definierten** Sprachen exportiert, **unabhängig davon ob sie aktiv sind oder nicht**.) Ein Manueller Export für die Sprache mit der Sprach-ID 1 würde z.B. so aussehen: ``` https://www.ihre-shop-url.de/index.php?cl=ddsitemap&key=IHR_CRONKEY&lang=1 ``` {% hint style="warning" %} **Bitte beachten Sie:**\ In den oben stehenden Links muss **IHR\_CRONKEY** durch den Cronjob-Schlüssel ersetzt werden. Ab Modul-Version **3.2.0** wird dieser Schlüssel in den Moduleinstellungen des **Basis Moduls** definiert. Bis einschließlich Modul-Version **3.1.7** wird dieser Schlüssel in den Grundeinstellungen des **Sitemap Moduls** definiert. {% endhint %} Der manuelle Export kann alternativ aus dem Stamm des Moduls im Admin-Backend durch einen Klick auf den jeweiligen Link gestartet werden. Der korrekte Cronjob-Schlüssel wird dabei automatisch geladen, der Parameter `lang` wird dabei allerdings **nicht** verwendet: ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Mj4I3_dJxhsLkB1Jk7d%2F-Mj4IZ2M2oo_0fDdxWze%2Fimage.png?alt=media\&token=bf92271e-4e9c-45ee-9024-11bc2827a4a4) Die exportierten Dateien werden standardmäßig im export Ordner gespeichert: ### Automatischer Export per Cronjob Für den automatischen Export der Sitemap enthält das XML Sitemap Modul einen Cronjob, um in regelmäßigen Abständen automatisch die Sitemap-Dateien zu aktualisieren. #### Ab Modul Version 4.0.0 {% hint style="info" %} Ab der Modul-Version 4.0.0 hat sich der Pfad zum Cronjob wie folgt geändert: \ **vendor/digidesk/sitemap/src/bin/cron.php.** \ Der vollständige Aufruf lautet:\ `php vendor/digidesk/sitemap/src/bin/cron.php --key=IHR_CRONKEY` {% endhint %} Für die weitere Einstellung befolgen Sie bitte die Anleitung ab der Modul-Version 3.2.0 #### Ab Modul Version 3.2.0 Um den Cronjob auszuführen muss folgender Befehl aus dem Hauptverzeichnis Ihres Shops ausgeführt werden: ``` php source/modules/digidesk/dd_sitemap/bin/cron.php --key=IHR_CRONKEY ``` Ersetzen Sie dabei **`IHR_CRONKEY`** durch den Key den Sie in den Modul-Einstellungen des **Basis-Moduls** definiert haben. Achten Sie dabei darauf, dass die auf der Kommandozeile verwendete PHP-Version der Version entspricht die in Ihrem Shop verwendet wird. Zusätzlich zum Parameter `--key` gibt es auch noch die Parameter `--shop` und `--lang` um den zu exportierenden Shop und/oder die Sprache anzugeben. Beim Parameter `--shop` muss die Shop-ID (numerisch) angegeben werden. Diese finden Sie im Admin Backend unter **Stammdaten -> Grundeinstellungen** hinter dem Shop-Namen in Klammern.\ Wird der Parameter `--shop` nicht angegeben, wird immer für den Hauptshop (ID: 1) exportiert. Beim Parameter `--lang` muss die Sprach-ID, welche für die jeweilige Sprache definiert wurde, angegeben werden. Wird der Parameter `--lang` nicht angegeben, werden die Sitemaps für alle Sprachen des jeweiligen Shops nacheinander exportiert. (**Bei der Modulversion <= 3.3.1**: Dabei werden alle für den jeweiligen Shop **definierten** Sprachen exportiert, **unabhängig davon ob sie aktiv sind oder nicht**.) Beispiel CLI-Aufruf um die Englische Sitemap des Shops mit der ID 2 zu exportieren: ``` php source/modules/digidesk/dd_sitemap/bin/cron.php --key=IHR_CRONKEY --shop=2 --lang=1 ``` Ersetzen Sie dabei wieder **`IHR_CRONKEY`** durch den Key den Sie in den Modul-Einstellungen des **Basis-Moduls** definiert haben. {% hint style="info" %} **Hinweis:**\ In den OXID Editionen Community und Professional kann der Parameter `--shop` grundsätzlich weggelassen werden, da dort nur ein Shop existiert. Der Parameter ist **ausschließlich** für die Enterprise Edition gedacht. {% endhint %} Um diesen Cronjob automatisiert auszuführen empfehlen wir bei Linux Systemen **"**[**crontab**](https://wiki.ubuntuusers.de/Cron/)**"**. Für crontab sieht der Eintrag z.B. folgendermaßen aus: ``` 0 0 * * * php /source/modules/digidesk/dd_sitemap/bin/cron.php --key=IHR_CRONKEY ``` {% hint style="info" %} **Bitte beachten Sie:**\ Im oben stehenden Crontab Eintrag muss **\** durch den absoluten Pfad zum Hauptverzeichnis Ihres Shops ersetzt werden! {% endhint %} 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 `/source/export/` auf dem Dateisystem des Servers ablegt. {% hint style="danger" %} **Hinweis:** Um eine parallele Ausführung des Cronjobs zu verhindern, überprüft das Skript zu Anfang auf die Existenz einer Log-Datei namens **dd\_sitemap\_RUN.log** in dem Log-Ordner vom Shop. Falls hier schon die Datei existiert, dann wird der Cronjob nicht fortgesetzt und frühzeitig beendet. Ansonsten wird diese Datei angelegt und im Abschluss des Cronjobs wieder entfernt. Sollte es dazu kommen, dass der Cronjob aus irgendeinem Grund irregulär abgebrochen wird, dann wird diese Datei nicht automatisch gelöscht. Für einen Neustart des Cronjobs muss dann diese Datei manuell gelöscht werden! In dem Cronjob ist eine Benachrichtigungsfunktion eingebaut, wenn bei dem Start des Cronjobs noch die Datei vorliegt und die Datei vor einer Stunde angelegt worden ist, dass dann der Shopbetreiber eine Info darüber per E-Mail an die im Shop hinterlegte Info-Adresse bekommt. {% endhint %} #### Bis einschließlich Modul Version 3.1.7 Um den Cronjob auszuführen muss folgende URL aufgerufen werden: ``` https://www.ihre-shop-url.de/index.php?cl=ddsitemap&key=IHR_CRONKEY ``` {% hint style="info" %} **Bitte beachten Sie:**\ Im oben stehenden Link muss **IHR\_CRONKEY** durch den in den Grundeinstellungen definierten Cronjob Schlüssel ersetzt werden, damit der Cronjob ausgeführt wird. {% endhint %} Um diesen Cronjob automatisiert auszuführen empfehlen wir bei Linux Systemen **"**[**crontab**](https://wiki.ubuntuusers.de/Cron/)**"**. Für crontab sieht der Eintrag z.B. folgendermaßen aus: ``` 0 0 * * * https://www.ihre-shop-url.de/index.php?cl=ddsitemap&key=IHR_CRONKEY ``` 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 `/export/` auf dem Dateisystem des Servers ablegt. {% hint style="info" %} Ein hilfreiches Tool für die einfache Erstellung von crontab Einträgen nach Ihren Wünschen ist **"**[**crontab.guru**](https://crontab.guru/#0_0_*_*_*)**"**. {% endhint %} ## 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: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: **** # Elasticsearch (Shopware) ## Modulbeschreibung Mit diesem Plugin erweitern Sie die im Shopware Standard enthaltene, hochperformante Such-und Analytic-Engine "Elasticsearch" um Ihre Suche auf ein neues Level zu heben.\ Das Plugin erstellt mit Hilfe eines Cronjobs täglich automatisch einen Index aller Artikel, bietet Ihren Kunden eine fehlertolerante, schnelle Suchfunktion und Ihnen die Möglichkeit bereits über die Suchfunktion bestimmte Artikel oder Hersteller besonders hervorzuheben. ## Funktionsumfang * Direkte Suche nach Artikelnummern möglich * Erweiterte Livesuche, sodass bei Eingabe des Suchbegriffs bereits passende Artikel inklusive der Filtermöglichkeiten in einem ansprechenden und selbsterklärenden Layout direkt unter dem Suchfeld angezeigt werden. * Intuitiv bedienbares Backend mit folgenden Funktionen: * Synonym-Mapping * Antonym-Mapping * Category-Mapping: Suchbegriff X zeigt nur Artikel aus festgelegten Kategorien. * URL-Mapping: Suchbegriff leitet auf bestimmte URL um. Zum Beispiel CMS-Seite. * Artikel-Mapping: Anzeige von bestimmten Artikeln bei der Suche nach X. * Detaillierte Auswertung der Suchanfragen: * Was wurde wie oft und mit welchem Ergebnis gesucht? * Die Auswertung kann gut verwendet werden, um mögliche Aktionen oder Werbemaßnahmen festzulegen. * Welche Suchen haben keine Treffer erzielt? Hiermit können Sie das Synonym-Mapping optimieren. * Anzahl der Treffer. Hiermit können Sie prüfen ob der Min-Score passend gesetzt ist. Werden häufig sehr viele Artikel gefunden, sollte dieser dann hoch gesetzt werden. * Export der Auswertung als PDF, Excel-Tabelle oder CSV-Datei * Hersteller-, Artikel- und Abverkauf-Boost: Hiermit können bestimmte Artikel zusätzlich gepusht werden. ## Systemvoraussetzungen Folgende Voraussetzungen müssen für die Verwendung dieses Plugins erfüllt werden: 1. Funktionsfähige Shopware Installation Version 5.4.0 - 5.5.10 2. Vorhandener Elasticsearch Server Version 5.5.x - 6.4.x 3. Folgende Einstellungen müssen in der Elasticsearch-Konfiguration ggf. vorgenommen werden: ``` script.groovy.sandbox.enabled: true script.inline: on script.indexed: on script.search: on script.engine.groovy.inline.aggs: on script.engine.groovy.inline.update: on ``` ## Installation {% hint style="info" %} Wir empfehlen während der Installation eine Wartungsseite zu aktivieren. {% endhint %} 1. Installieren Sie das Plugin über den **Shopware Plugin Manager**. 2. Für die Installation/Konfiguration von Elasticsearch folgen Sie bitte der Shopware Anleitung: [**https://developers.shopware.com/sysadmins-guide/elasticsearch-setup/**](https://developers.shopware.com/sysadmins-guide/elasticsearch-setup/) ## Konfiguration Nach Installation des Plugins erscheint unter dem Punkt "Marketing" ein neuer Menüeintrag namens **"digidesk Elasticsearch"** Wenn Sie diesen öffnen, können Sie das Plugin nach Ihren Wünschen konfigurieren. Folgende Einstellungen sind möglich: ### Auswertung Hier finden Sie die Suchanfragen und Ergebnisse übersichtlich zusammengefasst. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXot_caliJ_4cKTch0%2FElasticsearch-1.png?alt=media\&token=899c9c49-e4fc-48c6-a853-c0e7b43d8628) * Dank der Möglichkeit einen **Zeitraum** zu spezifizieren, können Sie genauere Bewertungen auslesen oder einen Überblick über einen größeren Zeitraum erhalten. * Das Fenster **Top-Suchen** listet alle Suchen auf und sortiert diese nach Anzahl der Aufrufe. Diese Ergebnisse können Sie als Excel-Tabelle, PDF-Dokument oder als CSV-Datei exportieren. * In dem nebenliegenden Fenster **Suchen ohne Treffer** finden Sie alle Suchen, die ergebnislos blieben. Wichtig wären diese beispielsweise für das Synonym-Mapping. Auch hier können Sie die Daten als Excel-Tabelle, PDF-Dokument oder als CSV-Datei exportieren. * Das Diagramm liefert Ihnen Informationen über die **Anzahl der Treffer** einzelner Suchbegriffe und den jeweils erreichten Such-Score. Diese Informationen helfen Ihnen dabei den Minimal-Score einzustellen. ### Allgemeine Einstellungen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-Lo_NfVXBugBEyvNRm_u%2F-Lo_Pfyj17NUYr12P26i%2FBildschirmfoto%202019-09-12%20um%2014.19.32.png?alt=media\&token=2e72f523-4998-43d0-917e-8b3ecdbfbb14) * Mit der Konfiguration **Minimal-Score** legen Sie den Score fest, der mindestens erreicht werden muss, damit ein Artikel in der Suche angezeigt wird. Behalten Sie erstmal den voreingestellten Wert bei. Wenn Sie merken, dass zu viele Suchergebnisse gefunden werden, sollten Sie diesen Wert nach oben korrigieren. * Mit dem **Auswertungs-Rhytmus** können Sie festlegen, ob die Suchergebnisse für den Tag, Monat oder das Jahr zusammengefasst und ausgewertet werden sollen. Je kleiner die Zeitspanne, desto präziser die Auswertung aber auch um so größer die Datenbank. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXowie32jPgd5Q3ICq%2FElasticserach-3.png?alt=media\&token=6992ce11-310a-4e1a-bf85-9a86c651d389) * Die Konfiguration **Produkt-Attribut Berücksichtigung** gibt Ihnen die Möglichkeit, verschiedene Attribute bei der Suche mit ein zu beziehen. Zum Beispiel können Sie die Farbe des Artikels zu 100% berücksichtigen, was dazu führt, dass die Suche nach "blaues Board" Boards mit dem Attribut "Farbe: blau" viel höher in der Suche anzeigen würde. **Nach jeder Änderung dieser Einstellung ist es zwingend notwendig, den Elasticsearch Index neu aufzubauen!** ### Mapping Einstellungen In dieser Konfiguration können Sie verschiedene Suchbegriffe zusammenfassen, weiterleiten oder von der Suche ausschließen. * Das **Synonym Mapping** macht es möglich, verschiedene Suchbegriffe mit anderen zu verbinden. So können Sie zB. Tippfehler von Kunden abfangen und trotzdem das richtige Ergebnis anzeigen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXozjO86UgNWevCvMx%2FElasticsearch-4.png?alt=media\&token=5d7efc39-5b6a-4f47-be3a-8c6c0bd062bd) * Mithilfe des **Antonym Mapping** können Sie Begriffe anhand des eingegebenen Suchbegriffs von den Ergebnissen ausschliessen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXp-ycFkAGOj8FF_dO%2FElasticsearch-5.png?alt=media\&token=7f2f9ac0-65fc-45e2-bf78-354712436cb4) * Dank dem **Kategorie Mapping** können Sie Kategorien an Suchbegriffe binden. Wenn der Suchbegriff gesucht wird, werden nur Ergebnisse aus den verbundenen Kategorien angezeigt. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXp1O5o-g1tlG5GDSd%2FElasticsearch-6.png?alt=media\&token=28b30022-7e1a-4ef4-a1f9-8502b97b657b) * Mithilfe des **URL Mapping** können Sie eine Umleitung einrichten, die den Kunden bei Eingabe des Suchbegriffs auf eine andere Seite weiterleitet. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXp3Sc2_yAQpqnt9jU%2FElasticsearch-7.png?alt=media\&token=7998512f-0c92-4214-9907-d07e4ea922e4) * Das **Artikel Mapping** lässt Sie Suchbegriffen direkt verschiedene Artikel zuweisen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXp57C9ES3Il_071UV%2FElasticsearch-8.png?alt=media\&token=1e3ec8ca-2cc1-4ec2-870f-301678ef2d2f) ### Boost Einstellungen ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-LOXorHvvdYFaDf-7mXA%2F-LOXpA34MuXMP1CqexMf%2FElasticsearch-10.png?alt=media\&token=b2d8a885-2094-4a8c-8f06-6810012fc9e2) * In der **Hersteller Boost** Konfiguration können Sie einstellen, ob Artikel bestimmter Hersteller bevorzugt werden sollen. * Die Einstellung für den **Allgemeinen Boost** lässt Sie einstellen, ob und welchen Boostwert Artikel erhalten sollen, die als Abverkauf / Highlight / Sale eingestellt wurden. ### Artikel Boost * In der Artikeldetail Ansicht haben Sie die Möglichkeit, über das Freitextfeld **Artikel Boost** für den ausgewählten Artikel einen Boostwert hinterlegen, um diesen in der Suche hervorzuheben. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQVMbq6gThJrq5BVkuI%2F-MQVOfe9G41vUsqzlNsu%2FBildschirmfoto%202021-01-08%20um%2006.07.59.png?alt=media\&token=5d192e32-b4a9-45fe-8c7e-629c562f65be) ### Kategorie Boost * In der Kategoriedetail Ansicht können Sie über das Freitextfeld **Kategorie Boost** einen Boostwert hinterlegen, um Artikel einer Kategorie in der Suche zu bevorzugen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQVMbq6gThJrq5BVkuI%2F-MQVPbFmUfB3r2yZkplN%2FBildschirmfoto%202021-01-08%20um%2006.11.25.png?alt=media\&token=1db02827-e19c-4abb-9df5-f0946b808cba) ### Suche Preview In der **Suchpreview** haben Sie die Möglichkeit Ihre Elasticsearch Konfiguration direkt zu testen. ![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LOSMFs3rIokkTVg0275%2F-MQVMbq6gThJrq5BVkuI%2F-MQVRpYrH1rkoyJYDsIE%2FBildschirmfoto%202021-01-08%20um%2006.17.20.png?alt=media\&token=5c02e29c-a709-4228-bcc0-7037927b428b) * Geben Sie einen Suchbegriff ein und starten Sie die Suche, um sich alle Suchergebnisse anzeigen zu lassen. * Neben dem Namen und der Artikelnummer, wird auch der Score der Suchbegriffe angezeigt, um gegebenenfalls weitere Anpassungen an den Boost- und Mapping Einstellungen zu erleichtern. ## 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 über eine der unten stehenden Adressen. * E-Mail: **** * Telefon: **+49 (0) 5246 / 9099110** * Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt) [
](https://digidesk1.gitbooks.io/elasticsearch-shopware/content/1-Systemvoraussetzungen.html)