Referenzen

Modulbeschreibung

Dieses Modul bietet Ihnen die Möglichkeit, Ihre Referenzen im Shop mit Bildern und Text zu präsentieren. Ausserdem bringt es Visual CMS Widgets für Referenzen und Kundenstimmen mit.

Funktionsumfang

Die Funktionen dieses Moduls im Überblick:
    Referenz-Kategorien erstellen und verwalten
    Referenzen erstellen und verwalten
    Kundenstimmen/Kundenmeinungen anlegen und verwalten
      Wichtig: Dieses Feature kann nur in den PE/EE Editionen des Oxid eShop per Visual CMS Widget genutzt werden
    Übersichtsseite für Referenzen mit Vorschau-Bildern
    Benutzerdefinierte Anzahl von Bildern pro Referenz
    Optionale Darstellung der Referenzen in einer Lightbox (ohne Beschreibungstext) statt als Detailseite
    Visual CMS Widget für Referenzen
      Wichtig: Dieses Feature kann nur in den PE/EE Editionen des Oxid eShop genutzt werden
    Visual CMS Widget für Kundenstimmen
      Wichtig: Dieses Feature kann nur in den PE/EE Editionen des Oxid eShop genutzt werden

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.0.x bis 6.2.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
    2.
    Für dieses Modul erstellen Sie nun einen weiteren Unterordner reference 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:
    1
    composer require digidesk/reference
    Copied!
    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/reference
    3.
    Deaktivieren Sie das Modul im OXID eShop Admin
    4.
    Führen Sie anschließend den folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:
    1
    composer update digidesk/reference
    Copied!
    5.
    Aktivieren Sie dieses Modul im OXID eShop Admin.
    6.
    Ggf. Tmp-Verzeichnis leeren und Views neu generieren.

Anlegen von Kategorien

Zum Anlegen von Kategorien gehen Sie bitte wie folgt vor:
1. Wählen Sie im Admin Backend unter Referenzen den Punkt Kategorien bearbeiten aus 2. Klicken Sie in der rechten oberen Ecke auf das grüne Plus-Icon
Bearbeitungsmaske für Referenz-Kategorien
3. Setzen Sie den Haken in der Aktiv Checkbox um die Kategorie im Frontend sichtbar zu machen. Lassen Sie diese Checkbox ohne einen Haken, wird Ihre Kategorie im Frontend nicht ausgegeben werden. 4. Geben Sie der Kategorie einen Namen 3. Tragen Sie bei Bedarf unter Sortierung eine Zahl ein. Die Kategorien werden, falls vorhanden, anhand dem Wert in diesem Feld aufsteigend sortiert ausgegeben (also zuerst die 0, dann die 1, ..., dann die 5 usw.). Lassen Sie das Feld Sortierung leer, um die Kategorien alphabetisch sortieren zu lassen. 6. Speichern Sie Ihre Eingaben

Anlegen von Referenzen

Grundeinstellungen

Um eine neue Referenz hinzuzufügen gehen Sie bitte wie Folgt vor:
1. Wählen Sie im Admin Backend unter Referenzen den Punkt Referenzen bearbeiten aus 2. Klicken Sie in der rechten oberen Ecke auf das grüne Plus-Icon
Bearbeitungsmaske für Referenzen
3. Setzen Sie den Haken in der Aktiv Checkbox um die Referenz im Frontend sichtbar zu machen. Lassen Sie diese Checkbox ohne einen Haken, wird Ihre Referenz im Frontend nicht ausgegeben werden. 4. Setzen Sie den Haken der Checkbox Auf der Übersichtsseite anzeigen um die Referenz auf der Referenzen-Seite aufzulisten 5. Geben Sie der Referenz einen Namen 6. Wählen Sie eine oder mehrere zutreffende Kategorien aus 7. Tragen Sie nach belieben passende Tags ein 8. Tragen Sie bei Bedarf unter Sortierung eine Zahl ein. Die Referenzen werden, falls vorhanden, anhand dem Wert in diesem Feld aufsteigend sortiert ausgegeben (also zuerst die 0, dann die 1, ..., dann die 5 usw.). Lassen Sie das Feld Sortierung leer, um die Referenzen alphabetisch sortieren zu lassen. 9. Geben Sie eine URL ein, falls Sie statt auf die Detailseite der Referenz auf eine andere Seite beim Klick auf die Referenz öffnen möchten 10. Tragen Sie Passende Beschreibung der Referenz ein

Hinzufügen von Bildern

Um Ihrer neuen oder bestehenden Referenz Bilder hinzuzufügen gehen Sie bitte wie folgt vor:
Bild-Einstellungen für einzelne Referenzen
1. Wechseln Sie auf den Reiter Bilder während Sie eine Referenz Bearbeiten oder neu Anlegen 2. Wählen Sie ein Vorschaubild für die Übersichtsseite aus In der Regel empfiehlt es sich, dass die Vorschau-Bilder aller Referenzen die selbe Auflösung haben 3. Wählen Sie bei Bedarf Bilder für die Detailseite einer Referenz aus 4. Wenn Sie mehr als 3 Bilder benötigen, klicken Sie auf das grüne Plus-Icon um weitere Bilder auswählen zu können

SEO-Einstellungen

Damit die Detailseiten Ihrer Referenzen auch in den Suchmaschinen gut gefunden werden können bietet das Modul einige SEO-Einstellungen. Um diese Anzupassen gehen Sie bitte wie folgt vor:
SEO-Einstellungen für einzelne Referenzen
1. Wechseln Sie auf den Reiter SEO während Sie eine Referenz Bearbeiten oder neu Anlegen 2. Die SEO URL wird automatisch beim Speichern der Referenz generiert, Sie können diese aber auch selbst festlegen oder nachträglich ändern. 3. Geben Sie unter Keywords die Meta-Keywords für die Suchmaschinen ein 4. Geben Sue unter Beschreibung die Meta-Description für die Suchmaschinen ein

Referenzen bearbeiten und Löschen

Nach dem Speichern wird Ihre Referenz in einer Liste aufgeführt. Um eine Referenz zu Bearbeiten oder zu löschen bewegen Sie bitte den Mauszeiger in den rechten Bereich der Referenz um die Editier-Icons einzublenden. Mit einem Klick auf das Stift-Icon können Sie die Referenz bearbeiten, mit einem Klick auf das Papierkorb-Icon können Sie die Referenz unwiderruflich löschen.

Anlegen von Kundenmeinungen

Bearbeitungsmaske für Kundenmeinungen
    1.
    Wählen Sie im Admin Backend unter Referenzen den Punkt Kundenmeinungen bearbeiten aus
    2.
    Klicken Sie in der rechten oberen Ecke auf das grüne Plus-Icon
    3.
    Setzen Sie den Haken in der Aktiv Checkbox um die Kundenstimme im Frontend sichtbar zu machen. Lassen Sie diese Checkbox ohne einen Haken, wird die Kundenstimme im Frontend nicht ausgegeben werden.
    4.
    Vergeben Sie einen passenden Titel wie z.B. den Firmennamen des Kunden
    5.
    Tragen Sie bei Bedarf unter Sortierung eine Zahl ein. Die Kundenmeinungen werden, falls vorhanden, anhand dem Wert in diesem Feld aufsteigend sortiert ausgegeben (also zuerst die 0, dann die 1, ..., dann die 5 usw.).
    Lassen Sie das Feld Sortierung leer, um die Kundenstimmen alphabetisch nach Titel sortieren zu lassen.
    6.
    Tragen Sie unter Beschreibung ein, was der Kunde über Sie positives zu sagen hat
    7.
    Tragen Sie unter Autor z.B. den Namen Ihres Ansprechpartners bei Ihrem Kunden ein
    8.
    Unter Bild können Sie passendes Bild auswählen welches über der Kundenmeinung ausgegeben wird. In der Regel wird hierzu das Logo des Kunden oder ein Foto des Autors der Kundenstimme verwendet
    9.
    Klicken Sie anschliessend auf Speichern.

Mehrsprachigkeit

Jeder Menüpunkt im Referenz-Modul hat oben rechts ein Auswahl-Feld für die Sprache in der Sie die Inhalte des jeweiligen Menüpunktes bearbeiten wollen. Die Sprachen die Sie hier auswählen können, werden im Admin Backend unter dem Menüpunkt Stammdaten -> Sprachen angelegt und müssen aktiv sein um in dem Auswahlmenü zu erscheinen.
Wenn Sie eine Kategorie, Referenz oder Kundenmeinung bereits in einer Sprache angelegt haben, haben Sie die Möglichkeit diese mit Hilfe dieses Auswahlfeldes in andere Sprachen zu übersetzen. Klicken Sie dafür auf das Auswahlfeld und wählen die gewünschte Sprache aus. Damit Sie die jeweiligen Einträge auch identifizieren können, werden diese in der Liste ausgegraut und am Ende mit dem Sprachkürzel einer Sprache angezeigt, in der sie schon angelegt wurden. 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.

Referenzen-Übersichtsseite

Aufrufen der Übersichtsseite

Aus dem Admin Backend heraus können Sie bequem per Mausklick auf den Button Referenzen öffnen die Referenzen-Übersichtsseite in einem neuen Fenster/Tab öffnen. Um Ihre Referenzseite im Shop einzubinden nutzen Sie bitte einen Link der wie folgt aufgebaut ist: https://www.ihr-shop.tld/index.php?cl=dd_reference_list
OXID Einstellung: Statische URLs
Bei Bedarf können Sie im Admin Backend unter Stammdaten -> Grundeinstellungen im Tab SEO unter Statische URLs auch eine sprechende URL für alle vorhandenen Sprachen definieren.

Ansicht der Übersichtsseite

Referenzen-Übersichtsseite
Wenn Sie zu der Referenzen-Übersichtsseite im Frontend wechseln, sehen Sie jede Referenz bei der beide Checkboxen aktiv sind (Aktiv und Auf der Übersichtsseite anzeigen) in einer eigenen Box. Im oberen Bereich der Box ist das Vorschaubild positioniert, dadrunter die Überschrift der Referenz und im unteren Bereich die Auflistung der Kategorien, die dieser Referenz zugeordnet sind.
Beim Klick auf eine Referenz (Box) gibt es 3 verschiedene Möglichkeiten, was danach passieren soll: 1. Mit Standardeinstellungen wird eine Referenz-Detailseite mit Bildern und Beschreibung geöffnet:
Referenz- Detailseite mit Bildern und Beschreibung
2. Falls Sie beim Anlegen der Referenz eine URL eingetragen haben, wird diese URL im neuen Fenster geöffnet.
3. Das erste zugeordnete Bild (nicht das Vorschaubild) wird in einer Lightbox mit Slider Funktion geöffnet. In diesem Fall wird die Beschreibung nicht genutzt und braucht nicht gepflegt zu werden, da der Fokus dabei auf den Bildern liegt.
Um diese Möglichkeit zu nutzen, aktivieren Sie bitte unter Moduleinstellungen die Option Lightbox statt Detailseite anzeigen.
Die aktiven Kategorien sind im oberen Bereich der Übersichtsseite als Filter-Buttons dargestellt. Beim Klick auf ein Kategorie-Button werden nur die Referenzen angezeigt, die zu dieser Kategorie zugeordnet sind.

Moduloptionen

Im Admin Backend unter Erweiterungen -> Module gibt es im Reiter Einstell. folgende Einstellungsmöglichkeiten:
    SEO-URL-Prefix: Wird bei der automatischen Generierung von SEO-URLs für die Referenz-Detailseiten verwendet. z.B.: https://www.ihr-shop.tld/seo-url-prefix/name-der-referenz
    Vorschaubilder Breite * Höhe in px: Wird für die Generierung von Thumbnails für die Vorschaubilder verwendet
    Lightbox statt Detailseite anzeigen: Wenn diese Option aktiviert ist, wird bei einem Klick auf eine Referenz auf der Übersichtsseite keine Detailseite sondern eine Lightbox mit einem Bild-Slider geöffnet

Nutzung der Visual CMS Widgets

Visual CMS Widget für Referenzen anlegen

Das Referenz-Modul stellt für Besitzer einer PE oder EE Lizenz von OXID ein Visual CMS Widget für Referenzen zur Verfügung.
Um in Visual CMS ein Referenzen-Widget Ihrer Seite hinzuzufügen, klicken Sie bitte auf das Plus-Icon im oberen Bereich vom Visual CMS Editor. Es öffnet sich eine Übersicht aller in Ihrem Shop zur Verfügung stehenden Widgets.
Wählen Sie hier bitte das Widget Referenzliste aus. Es öffnet sich ein weiteres Fenster mit dem Referenzen-Widget.
Hier können Sie eine oder mehrere Kategorien auswählen. Klicken Sie dafür bitte in das Kategorie(n)-Feld um die Liste der aktiven Kategorien anzeigen zu lassen und wählen die gewünschten Kategorie(n) per Klick aus der Liste aus. Bei Bedarf können Sie im Feld Anzahl die Anzahl der Referenzen die ausgegeben werden begrenzen. Standardmäßig werden die 4 ersten Referenzen, die die ausgewählten Kategorien enthalten ausgewählt. Speichern Sie anschließend Ihre Einstellungen ab.
Sie können das Widget beliebig oft in Ihre Seite hinzufügen und dabei nach Bedarf unterschiedliche Kategorien oder Anzahl an Referenzen verwenden.
Im Frontend Sehen Sie in der in Visual CMS erstellten Seite die Referenzen. Die Ausgabe des Widgets sieht dabei aus und verhält sich ähnlich wie auf der Referenzen-Übersichtsseite.

Visual CMS Widget für Kundenstimmen anlegen

Das Referenz-Modul stellt für Besitzer einer PE oder EE Lizenz von OXID Widget für Kundenstimmen zur Verfügung. Die Kundenstimmen sind derzeit einzig für Besitzer einer PE/EE Lizenz verwendbar durch dieses Widget.
Um in Visual CMS ein Kundenstimmen-Widget Ihrer Seite hinzuzufügen, klicken Sie bitte auf das Plus-Icon im oberen Bereich. Es öffnet sich eine Übersicht aller in Ihrem Shop zur Verfügung stehenden Widgets.
Wählen Sie hier bitte das Widget Kundenstimmen aus. Es öffnet sich ein Weiteres Fenster mit dem Kundenstimmen-Widget. Hier brauchen Sie allerdings keine weiteren Einstellungen vorzunehmen. Es werden grundsätzlich alle aktive Kundenstimmen eingebunden, entweder nach dem Feld Sortierung oder Alphabetisch nach Titel sortiert. Speichern Sie Ihre Einstellungen ab.
So könnte das Kundenstimmen-Widget im Frontend beispielsweise genutzt werden. Die Kundenstimmen rotieren automatisch als Slider, der Kunde hat aber auch die Möglichkeit mit den Pfeil- Buttons dadrunter zu der nächsten oder vorherigen Kundenstimme zu wechseln.

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.
Last modified 8mo ago