Zuletzt angesehene Produkte

Installation – Admin

• Kaufen und laden Sie das Plugin aus dem Shopware Store herunter oder beziehen Sie es von Ihrem Entwickler.
• Laden Sie das Plugin über Ihr Shopware-Admin-Panel hoch:
• Navigieren Sie zu Erweiterungen > Meine Erweiterungen.
• Klicken Sie auf Erweiterung hochladen.
• Wählen Sie die heruntergeladene ZIP-Datei aus.
• Installieren und aktivieren Sie das Plugin.
• Aktualisieren Sie Ihre Admin-Ansicht.
• Konfigurieren Sie die Plugin-Einstellungen unter Erweiterungen > Meine Erweiterungen > Zuletzt angesehene Produkte.

Installation – Manuell über Composer und Befehlszeile

• Dieses Modul sollte mit Composer installiert werden:

                                [ composer require digipercep/recently-viewed-products ]

• Führen Sie nach der Installation mit Composer die folgenden Befehle aus Ihrem Shopware-Installationsverzeichnis aus:

                                      ./bin/console plugin:refresh

                                      ./bin/console plugin:install --activate DigiPercepRecentlyViewedProducts

• Für Änderungen an der Storefront:

                                      ./bin/build-storefront.sh

• Für Änderungen an der Administration:

                                     ./bin/build-administration.sh

• Für die Theme-Kompilierung:

                                     ./bin/console theme:compile

• Cache leeren:

                                     ./bin/console cache:clear

• Installation überprüfen:

Gehen Sie zu Shopware Admin > Einstellungen > System > Plugins. Dort sollte „Zuletzt angesehene Produkte” aufgeführt und aktiv sein.

Frontend-Anzeigefunktionen

Integration in die Produktdetailseite

Der Bereich mit den zuletzt angesehenen Produkten ist strategisch auf den Produktdetailseiten positioniert, um maximale Sichtbarkeit und Nützlichkeit zu gewährleisten:

• Strategische Platzierung: Der Slider erscheint unterhalb der Produktbeschreibung und den Bewertungen, sodass Kunden ihn nach dem Ansehen der wichtigsten Produktinformationen sehen.
• Responsives Layout: Passt die Anzahl der pro Zeile angezeigten Produkte automatisch an den Gerätetyp an.
• Intelligente Filterung: Das aktuell angezeigte Produkt wird automatisch aus dem Slider ausgeschlossen, um die Anzeige redundanter Informationen zu vermeiden.
• Visuelle Produktkarten: Jedes Produkt zeigt Folgendes an:
• Hochwertiges Miniaturbild
• Produkttitel
• Produktbeschreibung (falls aktiviert)
• Preisinformationen (falls aktiviert)
• Schaltfläche „In den Warenkorb“ (falls aktiviert)
• Schaltfläche „Details anzeigen“ (falls aktiviert) 

Slider-Funktionalität

Der Produkt-Slider bietet eine intuitive Navigation und eine reibungslose Benutzererfahrung:

• Navigationssteuerung: Mit den Pfeiltasten nach links und rechts (sofern aktiviert) können Kunden manuell durch die Produktliste blättern.
• Paginierungsanzeige: Visuelle Punkte (sofern aktiviert) zeigen die aktuelle Position innerhalb des Sliders und die Gesamtzahl der Slides an.
• Automatische Wiedergabefunktion: Wenn diese Funktion aktiviert ist, blättert der Slider automatisch mit flüssigen Übergängen durch die Produkte.
• Touch-/Wischunterstützung: Mobile Nutzer können nach links oder rechts wischen, um auf natürliche Weise durch die Produkte zu navigieren.
• Flüssige Übergänge: Die Produkt-Slides wechseln flüssig mit professionellen Animationen.
• Lazy Loading: Die Produkte werden effizient geladen, um eine optimale Seitenleistung zu gewährleisten.

Automatische Verfolgung von Produktansichten

Das Plugin verwendet ein intelligentes System mit zwei Ansätzen, um Produktansichten zu verfolgen, ohne dass manuelle Eingaben von Shop-Betreibern oder Kunden erforderlich sind:

• Für angemeldete Kunden:

  • Wenn ein registrierter Kunde eine Produktdetailseite aufruft, zeichnet das Plugin diese Ansicht automatisch in der Datenbank auf

  • Produktansichten werden mit dem Kundenkonto in einer Kundentabelle verknüpft

  • Dies gewährleistet eine durchgängige Verfolgung über alle Geräte hinweg, auf denen sich der Kunde anmeldet.

  • Die Datenbank verwaltet die konfigurierte maximale Anzahl von Produkten (Standard: 50).

  • Ältere Produktansichten werden automatisch entfernt, wenn das Limit erreicht ist.

• Für Gastbenutzer:

  • Produktansichten werden mithilfe sicherer HttpOnly-Cookies verfolgt

  • Cookies werden mit SameSite-Schutz eingerichtet, um die Sicherheit und den Datenschutz zu verbessern.

  • Die Lebensdauer der Cookies kann im Admin-Panel konfiguriert werden (Standard: 30 Tage).

  • Der Verlauf von Gastbenutzern wird lokal im Browser gespeichert.

  • Wenn ein Gastbenutzer ein Konto erstellt, kann sein Verlauf gespeichert werden.

Anzeige und Darstellung

Wenn ein Kunde eine Produktdetailseite aufruft, führt das Plugin folgende Schritte aus:

• Es ruft die zuletzt vom Kunden angesehenen Produkte aus dem entsprechenden Speicher (Datenbank oder Cookie) ab.
• filtert das aktuell angezeigte Produkt heraus, um Redundanzen zu vermeiden
• lädt Produktinformationen, einschließlich Bildern, Preisen und Beschreibungen
• rendert den Slider mit den konfigurierten Einstellungen und Anzeigeoptionen
• wendet je nach Gerätetyp responsive Layoutanpassungen an. Initialisiert die Slider-Funktionalität mit Navigation und automatischer Wiedergabe, sofern aktiviert

Plugin-Konfiguration

Das Plugin bietet umfassende Konfigurationsoptionen in der Shopware-Administration, um das Verhalten und das Erscheinungsbild der Funktion „Zuletzt angesehene Produkte” anzupassen:

• Navigieren Sie zu Erweiterungen → Meine Erweiterungen.
• Suchen Sie „Zuletzt angesehene Produkte” und klicken Sie auf „Konfigurieren”.

Allgemeine Einstellungen

Steuern Sie die Kernfunktionalität und Lokalisierung des Bereichs „Zuletzt angesehene Produkte“:

• Zuletzt angesehene Produkte aktivieren: Master-Schalter zum Aktivieren oder Deaktivieren der gesamten Funktionalität.
• Titel (Englisch): Passen Sie die Überschrift des Bereichs an, die englischsprachigen Kunden angezeigt wird (Standard: „Recently Viewed Products“).
• Titel (Deutsch): Passen Sie die Überschrift des Bereichs für deutschsprachige Kunden an (Standard: „Zuletzt angesehene Produkte“).

Anzeigeeinstellungen

Konfigurieren Sie, wie viele Produkte im Tracking-System angezeigt und gespeichert werden sollen:

• Maximal anzuzeigende Produkte: Legen Sie die Anzahl der im Slider angezeigten Produkte fest (Standard: 7). Damit wird gesteuert, wie viele Produkte im sichtbaren Slider auf den Produktdetailseiten angezeigt werden.
• Maximal zu speichernde Produkte: Legen Sie die Speichergrenze für nachverfolgte Produkte fest (Standard: 50). Damit wird die maximale Anzahl von Produkten bestimmt, die im Verlauf des Benutzers gespeichert werden.
• Aktuelles Produkt ausschließen: Wenn diese Option aktiviert ist, wird das aktuell angezeigte Produkt nicht im Schieberegler für kürzlich angezeigte Produkte angezeigt. Dadurch werden redundante Anzeigen vermieden und die Benutzererfahrung verbessert.

Slider-Einstellungen

Passen Sie die Navigations- und Interaktionsfunktionen des Sliders an:

• Navigationspfeile anzeigen: Zeigen Sie Pfeiltasten nach links/rechts für die manuelle Navigation im Slider an. Die Pfeile werden auf beiden Seiten des Sliders angezeigt, um das Blättern zu erleichtern.
• Paginierungspunkte anzeigen: Zeigen Sie am unteren Rand des Sliders Punkte an, die jede Produktseite darstellen. Die aktive Seite wird für eine bessere visuelle Rückmeldung hervorgehoben.
• Automatische Wiedergabe aktivieren: Blättern Sie automatisch in regelmäßigen Abständen durch die Produkte, ohne dass der Benutzer eingreifen muss. Schafft eine ansprechende, dynamische Produktpräsentation.

Speichereinstellungen

Verwalten Sie, wie Produktansichtsdaten gespeichert und aufbewahrt werden:

• Cookie-Lebensdauer (Tage): Legen Sie die Dauer (in Tagen) fest, für die kürzlich angesehene Produktdaten im Browser des Kunden gespeichert werden (Standard: 30 Tage). Nach Ablauf dieses Zeitraums wird der Verlauf automatisch gelöscht.

Produktanzeigeoptionen

Legen Sie fest, welche Produktinformationen und Aktionen im Slider angezeigt werden sollen:

• Produktpreise anzeigen: Zeigen Sie Produktpreise einschließlich Steuerinformationen und Links zu Versandkosten an.
• Produktbeschreibungen anzeigen: Zeigen Sie Produktbeschreibungen an, um Kunden zusätzliche Informationen zu jedem Artikel zu geben.
• Schaltfläche „Zum Warenkorb hinzufügen” anzeigen: Aktivieren Sie die Schaltfläche „Zum Warenkorb hinzufügen” direkt im Slider, um schnelle Käufe zu ermöglichen, ohne zur Produktseite navigieren zu müssen.
• Schaltfläche „Details” anzeigen: Zeigen Sie die Schaltfläche „Details” an, über die Kunden zur vollständigen Produktdetailseite mit weiteren Informationen gelangen.

Fehlerbehebung

Häufige Probleme und Lösungen

Der Bereich „Zuletzt angesehene Produkte“ wird nicht angezeigt:

• Überprüfen Sie, ob das Plugin unter „Erweiterungen“ → „Meine Erweiterungen“ aktiviert ist.
• Überprüfen Sie, ob „Zuletzt angesehene Produkte aktivieren“ in der Plugin-Konfiguration aktiviert ist.
• Stellen Sie sicher, dass der Kunde tatsächlich andere Produkte angesehen hat (der Bereich wird nicht angezeigt, wenn kein Browserverlauf vorhanden ist).
• Vergewissern Sie sich, dass Sie eine Produktdetailseite anzeigen (der Slider wird nur auf Produktseiten angezeigt).
• Leeren Sie den Cache mit ./bin/console cache:clear.
• Überprüfen Sie die Browserkonsole auf JavaScript-Fehler, die die Initialisierung des Sliders verhindern könnten.

Slider zeigt nicht alle erwarteten Produkte an:

• Überprüfen Sie die Einstellung „Max. Anzahl anzuzeigender Produkte“ – möglicherweise ist sie niedriger als erwartet eingestellt.
• Beachten Sie, dass das aktuell angezeigte Produkt automatisch aus dem Slider ausgeschlossen wird.
• Überprüfen Sie bei Gastnutzern, ob Cookies im Browser aktiviert sind.
• Überprüfen Sie bei angemeldeten Nutzern, ob die Datenbankverbindung ordnungsgemäß funktioniert.
• Überprüfen Sie, ob Produkte seit ihrer Anzeige gelöscht oder deaktiviert wurden.

Gastbenutzer-Verlauf wird nicht gespeichert:

• Überprüfen Sie, ob Cookies im Browser aktiviert sind.
• Überprüfen Sie die Datenschutzeinstellungen des Browsers (einige strenge Datenschutzmodi blockieren Cookies).
• Stellen Sie sicher, dass die „Cookie-Lebensdauer” in den Speichereinstellungen richtig eingestellt ist.
• Überprüfen Sie, ob der Benutzer Cookies löscht oder den Inkognito-/privaten Modus verwendet.
• Überprüfen Sie, ob die Website nicht auf der Cookie-Sperrliste des Browsers steht.

Support

Für technischen Support, Funktionsanfragen oder allgemeine Fragen zum Bundle Products-Plugin wenden Sie sich bitte an:

E-Mail: shopware@perceptiond.com 

Website: https://perceptiond.com 

Unser Support-Team hilft Ihnen gerne dabei, das Potenzial Ihrer Bundle-Angebote voll auszuschöpfen und eine optimale Leistung des Plugins in Ihrer Shopware 6-Umgebung sicherzustellen.