> For the complete documentation index, see [llms.txt](https://docs.digidesk.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digidesk.de/moduldokumentationen/evoslider.md).

# 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 erfolgt über die Twig-Funktion `ddSlider` direkt im Theme oder – bei Verwendung von OXID PE/EE – über das im Modul enthaltene VCMS-Widget im VisualCMS. Mithilfe des [evoEDIT Moduls](https://docs.digidesk.de/moduldokumentationen/evoedit-for-visual-cms) können Sie die Widgets darüber hinaus auch in Artikel- und Kategoriebeschreibungen verwenden.

Das Modul ist erhältlich auf <https://www.digidesk.de/produkte/evoslider/>

## Systemvoraussetzungen

### PHP-Version

* PHP 8.1 - 8.4

### Kompatibel mit den OXID Versionen

* OXID CE/PE/EE 7.2.x bis 7.5.x

### Kompatibel mit den Themes

* Apex 2.x / 3.x

### Vorausgesetzte Module

* digidesk Basis-Modul

## Installation <a href="#installation" id="installation"></a>

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:\
   Produktivsystem: `composer require --update-no-dev digidesk/evoslider`\
   Testsystem/Entwicklungssystem: `composer require digidesk/evoslider`
4. Nun kann das Modul im OXID eShop Admin aktiviert werden
5. Ggf. Tmp-Verzeichnis leeren und Views neu generieren

## Update

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:\
   Produktivsystem: `composer update --no-dev digidesk/evoslider`\
   Testsystem/Entwicklungssystem: `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

## Funktionsbeschreibung

Im OXID-Admin finden Sie das Modul im eigenen Menüpunkt **"evoSLIDER"**. Die Übersichtsseite zeigt alle Sliders als Vorschau-Kacheln. Mit dem Stift-Symbol öffnen Sie einen Slider zur Bearbeitung, über das Menü-Symbol (drei Punkte) duplizieren oder löschen Sie einen Slider. Der grüne Punkt unterhalb der Vorschau signalisiert, dass der Slider aktiv ist.

### Slider erstellen

1. Auf die Schaltfläche **"Slider hinzufügen"** klicken
2. Es öffnet sich ein Dialog mit geöffnetem Reiter **"Allgemein"**
3. Informationen in das Formular eintragen (siehe unten)
4. Anschließend auf **"Speichern"** klicken

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-84f05443a7e326f1866664c1e8adca16dbc532f0%2FevoSlider-Slider-Allgemein.png?alt=media)

Der Reiter **"Allgemein"** enthält die folgenden Einstellungen:

* Immer Aktiv / Aktiv von .. bis: Hiermit steuern Sie, ob der Slider im Frontend ausgegeben wird oder nicht bzw. in welchem Zeitraum der Slider autom. ausgegeben und wieder ausgeblendet wird
* Name: Dient zur Unterscheidung der Slider im Backend
* Ident.: Kennung des Sliders, mit der der Slider im Theme bzw. im VisualCMS-Widget eingebunden wird. Leer lassen, um die Kennung automatisch generieren zu lassen
* Slider-Typ: Wahl zwischen **"Bild-Slider"** und **"Produkt-Slider"** (siehe unten)
* Beim Slider-Typ "Bild-Slider" zusätzlich:
  * Animation: Auswahl zwischen "Schieben" und "Einblenden"
  * Anzeigeart: Definiert, wie die Hintergrundbilder der Slides angezeigt werden:
    * Bei "Volle Breite" wird die volle Breite des Bildes im Slide ausgegeben und das Bild hoch- oder runterskaliert, um die volle Breite des Sliders auszufüllen. Die Höhe des Bildes passt sich dabei proportional an.
    * Bei "Volle Höhe" wird die volle Höhe des Bildes im Slide ausgegeben, die Breite passt sich proportional an. Das Bild wird ggf. an den Seiten abgeschnitten und mittig zentriert.
  * Feste Sliderhöhe (px): Nur bei Bild-Slidern mit Anzeigeart "Volle Breite" wirksam. Leer/0 = dynamische Höhe (die Höhe richtet sich nach dem Inhalt).
* Beim Slider-Typ "Produkt-Slider" zusätzlich:
  * Produktanzahl: Anzahl der nebeneinander angezeigten Produkte getrennt nach Desktop, Tablet und Smartphone
  * Produktanzeige: Optionale Darstellungsvarianten wie Peek-Effekt (benachbarte Boxen am Rand sichtbar, inkl. konfigurierbarer Peek-Breite) und Center-Mode (aktive Box zentriert und hervorgehoben)

<figure><img src="https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-6c9635737be19281599a823d313ad3d92cfcdee0%2FevoSlider-Slider-Allgemein-Produkt.png?alt=media" alt=""><figcaption><p>Admin-Maske eines Produkt-Sliders im Reiter "Allgemein"</p></figcaption></figure>

### Darstellung & Verhalten

Im Reiter **"Darstellung & Verhalten"** nehmen Sie weitere Einstellungen am Slider vor:

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-b8845f11e8cfc5b19baf9235246b576b79f00c67%2FevoSlider-Slider-Darstellung.png?alt=media)

* **Darstellung**
  * Hintergrundfarbe (Slider-Container): Hintergrundfarbe des Slider-Containers, sichtbar z. B. während des Ladens oder bei Bildern, die den Slider-Bereich nicht vollständig füllen
  * Standard-Hintergrundfarbe für Slides (Fallback): Hintergrundfarbe, die für Slides verwendet wird, wenn der Slide selbst keine Hintergrundfarbe definiert
* **Verhalten**
  * Anzeigedauer pro Slide (ms): Wie lange jeder Slide angezeigt wird, bevor der nächste Slide erscheint
  * Animationsdauer (ms): Dauer der Übergangsanimation zwischen zwei Slides
  * Navigationspfeile anzeigen: Blendet Pfeile zum Vor- und Zurücknavigieren ein
  * Navigationspunkte anzeigen: Blendet Punkte zur direkten Auswahl eines Slides ein
  * Slideshow automatisch starten: Der Slider wechselt automatisch von Slide zu Slide
  * Play/Pause-Button bei Slideshow anzeigen: Bei automatisch startender Slideshow wird ein Button eingeblendet, mit dem der automatische Wechsel pausiert und fortgesetzt werden kann
  * Slides in zufälliger Reihenfolge anzeigen: Die Slides werden in zufälliger Reihenfolge ausgegeben

### Erweitert

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-e1042e736d1767f9a030b8622e529e7bbfce4e10%2FevoSlider-Slider-Erweitert.png?alt=media)

* Alternative Slider: Hier tragen Sie die Idents weiterer Slider ein (mehrere Slider mit Komma trennen). Diese Slider werden direkt unterhalb des Sliders eingefügt. Dies wird z. B. benötigt, wenn Sie Slider für verschiedene Geräte erstellen möchten. Beachten Sie, dass zu viele Slider die Performance stark beeinträchtigen können
* Auf Geräten ausblenden: Hiermit können Sie den Slider auf bestimmten Bildschirmgrößen deaktivieren (Smartphone < 768px, Tablet 768px - 992px, kleiner Bildschirm 992px - 1200px, großer Bildschirm > 1200px)

### Slides erstellen

1. Öffnen Sie den Slider über das Stift-Symbol zur Bearbeitung
2. Oben wird die Übersicht der vorhandenen Slides als Miniaturansichten angezeigt. Jede Miniaturansicht bietet über das Mouseover Schaltflächen zum Duplizieren und Löschen; der grüne Punkt signalisiert, dass der Slide aktiv ist
3. Auf die Kachel **"Slide hinzufügen"** klicken (bei Produkt-Slidern: **"Produkt hinzufügen"**)
4. Je nachdem welchen Slider-Typ Sie gewählt haben, können weitere Informationen zum Slide in das Formular eingetragen werden (siehe: [Bild-Slider](#bild-slider), [Videoeinstellungen](#videoeinstellungen), [Inhalt](#inhalt) oder [Produkt-Slider](#produkt-slider))
5. Nachdem Sie die Einstellungen für einen Slide gemacht haben, klicken Sie auf den Button **"Speichern"**

#### Bild-Slider

Wenn Sie als Slider-Typ "Bild-Slider" ausgewählt haben, haben Sie im Reiter **"Allgemein"** die folgenden Möglichkeiten, um den Slide zu konfigurieren:

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-6944584b4f279d65cbe0edb484bd9f7530f794ce%2FevoSlider-Slide-Allgemein.png?alt=media)

* 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 Slide über den Datei-Button aus der Mediathek oder laden Sie ein neues Bild hoch
* Alt-Attribut / Titel-Attribut: Alt-/Titel-Attribut für das Bild bzw. die Verlinkung
* Hintergrundfarbe: Definiert eine Hintergrundfarbe hinter dem Bild. Sofern das hochgeladene Bild den vollen Slider-Bereich ausfüllt, ist diese Hintergrundfarbe nicht sichtbar. Die Standard-Fallback-Farbe hierfür können Sie in den Slider-Einstellungen unter "Darstellung & Verhalten" festlegen
* 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 in 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, in dem Sie die interne oder externe URL eintragen können, auf die verlinkt werden soll. Außerdem erscheint eine Checkbox "Im neuen Fenster öffnen", mit der Sie die URL z. B. bei externen Verlinkungen in einem neuen Fenster öffnen lassen können

#### Videoeinstellungen

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.

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-4e050e0380d5809d9318254bde3cfe8d464d197c%2FevoSlider-Slide-Videoeinstellungen.png?alt=media)

* Video: Wählen Sie hier, ob Sie ein YouTube-Video, ein Vimeo-Video oder ein lokales MP4-Video ausgeben wollen ("Kein Video" zeigt immer das gewählte Hintergrundbild). Beachten Sie: Auf mobilen Geräten ist Autoplay deaktiviert. In diesem Fall empfehlen wir, die Video-Slides für mobile Geräte auszublenden und für mobile Geräte einen eigenen Slider anzulegen
* Video URL: Wenn Sie ein Video ausgeben lassen wollen, geben Sie hier die jeweilige Adresse 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 (loop): 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 und Höhe der Lightbox sowie über den Regler die Deckkraft (hell bis dunkel) des Lightbox-Hintergrundes an

#### Inhalt

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:

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-9709bd5ea9b6de96d7236d740e0b97be537ae8c2%2FevoSlider-Slide-Inhalt.png?alt=media)

* Position: Geben Sie an, wie der Inhalt auf dem Bild positioniert werden soll (z. B. "Oben links", "Mittig" oder "Mittig rechts")
* Typ: Wählen Sie hier den Inhaltstyp aus. Je nach gewähltem Inhaltstyp haben Sie unterschiedliche Einstellungsmöglichkeiten:
  * Text: Caption-Text, der Sie mittels WYSIWYG-Editor formatieren können
  * Aktion: Call-To-Action mit Überschrift 1, Überschrift 2, Text (WYSIWYG-Editor), Button-Beschriftung und URL des Buttons. Für Überschrift 1, Überschrift 2 und Text lässt sich jeweils eine eigene Schriftfarbe festlegen
* Schriftgröße proportional zur Slider Breite berechnen: Die Schriftgröße des Inhalts passt sich automatisch der Slider-Breite an. Aktivieren Sie die Option, sollten die Felder Minimale, Ideale und Maximale Schriftgröße ausgefüllt und im Text auf font-size-Styles verzichtet werden. Für die Werte kann die CSS-Funktion `clamp()` mit Einheiten wie px, em, rem oder vw verwendet werden
* Schriftfarbe: Schriftfarbe des Caption-Textes (bei Typ "Text")
* Hintergrundfarbe: Hintergrundfarbe des Inhalts, z. B. für ein halbtransparentes Overlay hinter dem Text
* Abstand: Geben Sie hier bei Bedarf einen zusätzlichen Innenabstand des Inhalts (oben, rechts, unten, links) relativ zur Größe des Sliders an

#### Produkt-Slider

Wenn Sie als Slider-Typ "Produkt-Slider" ausgewählt haben, fügen Sie über die Kachel **"Produkt hinzufügen"** Produkte als Slides hinzu und haben im Reiter "Allgemein" die folgenden Möglichkeiten, um den Slide zu konfigurieren:

* Verlinkung: Wählen Sie, ob Sie einen bestimmten Shop-Artikel oder eine Aktion ausgeben wollen
* Artikel/Aktion: Suchen Sie hier nach dem Artikel über den Titel oder die Artikelnummer bzw. nach einer Aktion anhand des Titels

Die Reiter "Videoeinstellungen" und "Inhalt" stehen bei Produkt-Slidern nicht zur Verfügung. Die Darstellung (Anzahl der Produkte, Peek-Effekt, Center-Mode) stellen Sie in den Slider-Einstellungen unter "Allgemein" bzw. "Darstellung & Verhalten" ein.

<figure><img src="https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-98d7d207d4627e066aceb342b871d205d529c0ef%2FevoSlider-Frontend-Produkt-Slider.png?alt=media" alt=""><figcaption><p>Produkt-Slider im Frontend mit aktiviertem Center-Mode und Peek-Effekt</p></figcaption></figure>

### Slides sortieren

Die Reihenfolge der Slides können Sie einfach per Drag & Drop in der Slide-Übersicht festlegen.

## Integration

### Im Visual Editor / Visual CMS

Das Modul beinhaltet ein Widget für den Visual Editor bzw. Visual CMS, damit Sie die erstellten Slider mit wenigen Klicks an der gewünschten Stelle platzieren können.

{% hint style="info" %}
Die folgende Erläuterung findet exemplarisch auf Basis der **"Visual CMS"-Version 10** (im Lieferumfang von OXID 7.5) statt. Bei älteren Visual CMS-Versionen, z. B. Version 8, sieht die Bedienung etwas anders aus.
{% endhint %}

Zum Einfügen eines Sliders drücken Sie im gewünschten Bereich zunächst auf das **"Plus-Symbol"** der Zeile, in die das Widget eingefügt werden soll:

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-979f39cb2afca5c2745a28d39f178dfdaeed5b02%2FevoSlider-VCMS-Plus-Btn.png?alt=media)

Es öffnet sich das Fenster **"Widget"**, in dem Sie unterschiedliche Widgets aussuchen können. Klicken Sie dort auf die Kachel **"Slider"**:

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-c35a48eeae19f01f8040e380d47161c80bbc03ad%2FevoSlider-VCMS-Slider-Widget.png?alt=media)

In den Widget-Einstellungen wählen Sie im Reiter **"Allgemeine Einstellungen"** bei **"Typ"** die Option "Slider" aus und unter **"Slider"** den gewünschten Slider. Danach bestätigen Sie mit **"Speichern"**:

![](https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-1bfffadac756adbb01312c40cda123c9b4f03b6f%2FevoSlider-VCMS-Slider-Widget_Einstellungen.png?alt=media)

{% 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 Twig-Funktion eingebunden werden:

```
{{ ddSlider(ident="myslider") }}
```

Als `ident` geben Sie die Kennung (Ident) des gewünschten Sliders an. Die Kennung zu einem Slider finden Sie in den Slider-Einstellungen im Bereich "Allgemeine Einstellungen".

<figure><img src="https://3505985395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOSMFs3rIokkTVg0275%2Fuploads%2Fgit-blob-e619c4608a6b81d38ae9af836a2c5da674f59f75%2FevoSlider_Demo_Startseite.png?alt=media" alt=""><figcaption><p>Beispiel: Bild-Slider mit Inhalt (Caption), Navigationspfeilen, Navigationspunkten und Pause-Button auf der Startseite</p></figcaption></figure>

{% hint style="danger" %}
Seit der Version 4.0.0 steht die Einstellung "Promoslider überschreiben" bzw. die Einbindung per Promoslider nicht mehr zur Verfügung, da das Apex-Theme keinen Promoslider (mehr) vorsieht. Bindeglied eines Sliders ist ausschließlich dessen Kennung (Ident).
{% endhint %}

{% hint style="info" %}
In den Modulversionen bis 3.x erfolgte die Einbindung im Theme per Smarty-Tag: `[{ddslider ident="myslider"}]`. Mit dem Umstieg auf OXID 7 (Twig) entfällt diese Syntax.
{% 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: **<support@digidesk.de>**
* Telefon: **+49 (0) 5246 / 9099110**
* Kontaktformular: [**http://www.digidesk.de/kontakt**](http://www.digidesk.de/kontakt)
