Module

Konfigurieren Sie Ihre PrestaShop-Modul-Einstellungen, verwalten Sie Datenabgleichsoptionen und passen Sie Such-, Empfehlungs- und Protokollierungsfunktionen an.

Einstellungen für die Daten-Synchronisation #

Gehen Sie zu Data > Configuration in my.clerk.io, um Ihre Prestashop-Sync-Optionen anzuzeigen.

• Legen Sie Ihre Shop-URL, die Seitengröße Ihrer synchronisierten Daten und den Zeitpunkt fest, zu dem Ihre Webshop-Daten mit Clerk synchronisiert werden (Standard ist „Bei Bedarf“).

Moduleinstellungen #

Wenn Sie v 6.7.0 oder eine neuere Version der Erweiterung verwenden (die neueste Version können Sie hier nachsehen), haben Sie nach dem Hinzufügen Ihrer Public- und Private Keys zum Modul auf zwei Arten Zugriff auf die folgenden Einstellungen:

• Über das Prestashop-Backend in Modules > Clerk

• Über my.clerk.io unter Developers > Extensions

Es spielt keine Rolle, wo Sie die Änderungen vornehmen, da die Erweiterung mit allen Änderungen in my.clerk.io synchronisiert wird und umgekehrt.

In my.clerk.io können Sie außerdem Ihre aktuelle Version der Erweiterung, Ihre Plattform und die PHP-Version sehen.

Klicken Sie einfach auf “Edit” bei einer Einstellung, um die verfügbaren Optionen zu sehen:

Modulübersicht #

Wählen Sie in Ihrem Prestashop-Admin-Account Clerk aus Ihren „Modules“, um die Optionen Ihres Clerk-Moduls anzuzeigen und anzupassen.

Legen Sie die Standardsprache für das Modul unter „Shop & Language“ fest und greifen Sie auf Ihre API-Keys, die Shopsprache und die Datenimport-URL unter „General“ zu.

Sync #

Legen Sie Ihre wichtigsten Datenabgleicheinstellungen im nächsten Abschnitt fest.

• Use Real-time Updates aktualisiert Produktdaten in Clerk, sobald sie in Prestashop geändert werden.

• Include Pages sendet Ihre Blogs & Artikel an Clerk, damit sie in Search angezeigt und Empfehlungen auf ihren Seiten dargestellt werden können.

• Additional Fields / For Pages ermöglicht das Hinzufügen benutzerdefinierter Attribute zu Ihren Produkten und Seiten, die dann in der Suche und visuell in einem Design verwendet werden können.

• Include Out Of Stock Products importiert Produkte zu Clerk, unabhängig von ihrem Lagerstatus.

• Collect Emails schließt E-Mail-Adressen in Bestellungen ein. Dies ist für Audience und personalisierte Empfehlungen basierend auf Bestellungen erforderlich.

• Sync Subscribers ermöglicht es Ihnen, den Status von E-Mail-Abonnenten aus Prestashop abzurufen, zur Verwendung mit Auto-Email.

• Collect Baskets verfolgt, was ein Nutzer im Warenkorb hat, damit Sie Abandon Cart-E-Mails verwenden können.

• Disable Order Synchronisation ermöglicht es Ihnen, den Import neuer Bestellungen zu stoppen. Oft werden diese Bestellungen von der Live-Sales-Tracking-Funktion erfasst, sodass sie nicht importiert werden müssen.

• Include Variant References ermöglicht es Ihnen, Attribute basierend auf den verfügbaren Varianten für Produkte zu importieren. Standardmäßig importieren wir Listen von Varianten-IDs, Namen, Preisen und SKUs.

• Include Product Features importiert die speziellen Attribute, die Product Features von Prestashop genannt werden.

Search #

Aktivieren Sie Ihre Search Page, indem Sie den Schalter auf „Enabled“ stellen.

• Include Categories bewirkt, dass Clerk passende Kategorien bei der Suche zurückgibt.

• Number of Categories / Pages erlaubt es Ihnen zu entscheiden, wie viele potenzielle Treffer für jeden Typ zurückgegeben werden.

• Pages Type ermöglicht es Ihnen, einen bestimmten Seitentyp für den Import festzulegen. Zum Beispiel nur Artikel oder Service / CMS-Seiten. Standardmäßig werden alle Seiten importiert.

• Template sollte dem Namen entsprechen, der im Embed-Code Ihres Search Page Elements in my.clerk.io angegeben ist. Das ist normalerweise „search-page“.

Facettennavigation #

Schalten Sie dies auf „Enabled“, um Ihrer Search Page Filter hinzuzufügen.

• Design ermöglicht Ihnen die Wahl eines optionalen individuellen Designs für Ihre Facetten. Siehe „Customising Your Search Page Facets“ unten.

• Add facet attributes ermöglicht es Ihnen, auszuwählen, nach welchen Attributen Nutzer filtern dürfen. Diese müssen mit den Attributen übereinstimmen, die Sie mit Clerk synchronisiert haben. Prüfen Sie, welche Attribute unter my.clerk.io > Data > Products verfügbar sind.

• Facet Attributes erlaubt es Ihnen, jede Facette mit dem Titel zu versehen, wie er den Nutzern auf Ihrer Ergebnisseite angezeigt werden soll, sowie der Position, also der Reihenfolge entsprechend der hinzugefügten Anzahl.

Facetten anpassen #

Clerk ermöglicht Ihnen, Ihre Suchseiten-Facetten innerhalb des Designs zu gestalten, und Sie können diese anzeigen, indem Sie auf das Feld Design-ID Bezug nehmen.

Die Design-ID finden Sie im Clerk Backend, in der ganz linken Spalte jedes Designs auf der Designübersichtsseite und unten links auf der Seite, sobald Sie das Design zum Bearbeiten betreten.

Hinweis: Sie können jetzt die Daten für Kategorien und Seiten auf Ihrer Search-Seite genauso abrufen wie in Ihrer Live search, was Ihnen einen größeren Informationsumfang zur Ansprache Ihrer Kunden bietet. Weitere Informationen finden Sie hier.

Live search #

Aktivieren Sie Clerk Live Search in diesem Abschnitt, indem Sie beim ersten Punkt auf „Enabled“ schalten.

• Include Categories sorgt dafür, dass Clerk bei der Suche passende Kategorien zurückgibt.

• Number of Suggestions / Categories / Pages erlaubt Ihnen festzulegen, wie viele potenzielle Treffer pro Typ angezeigt werden sollen.

• Pages Type ermöglicht die Steuerung eines bestimmten Seitentyps für den Import, z. B. nur Artikel oder Service- / CMS-Seiten. Standardmäßig werden alle Seiten importiert.

• Dropdown Positioning steuert, in welche Richtung die Instant Search im Verhältnis zum Suchfeld angezeigt wird. Befindet sich Ihr Suchfeld z. B. auf der linken Seite Ihres Webshops, wählen Sie left.

• Template sollte dem Namen entsprechen, der im Embed Code Ihres Search Page Elements in my.clerk.io steht. Das ist normalerweise „search-page“.

• Search field input selector sollte verwendet werden, wenn Sie ein benutzerdefiniertes Suchfeld haben. Fügen Sie hier die Klasse oder ID des input-Tags hinzu, um die Instant Search mit dem Feld zu verbinden, damit sie beim Suchen angezeigt wird.

• Search field form selector wird ebenfalls für benutzerdefinierte Suchfelder verwendet und erlaubt es Clerk, die Weiterleitung an die von uns hinzugefügte Suchseite anzupassen.

Powerstep #

Aktivieren Sie Ihren Powerstep, indem Sie oben auf Enabled schalten.

Der Powerstep wird ausgelöst, wenn ein Nutzer ein Produkt zum Warenkorb hinzufügt.

• Powerstep Type bietet drei Auswahlmöglichkeiten:

  • Page leitet auf eine vollständige Zwischenseite weiter, die von unserem Modul hinzugefügt wird.

  • Popup zeigt ein neues Popup an, das von unserem Modul hinzugefügt wurde.

  • Embedded fügt Empfehlungen zum bestehenden Add-to-Cart-Popup von Prestashop hinzu.

• Templates erlaubt es Ihnen zu bestimmen, welche Recommendations im Powerstep angezeigt werden, indem Sie deren Element IDs hinzufügen. Dies ist bereits mit den besten Optionen vorausgefüllt.

Recommendations #

Mit diesen Einstellungen können Sie Empfehlungen zu verschiedenen Seiten Ihres Webshops hinzufügen: Kategorieseiten, Produktseiten, dem Warenkorb und einem Exit-Intent-Popup.

• Templates erlaubt Ihnen, zu bestimmen, welche Recommendations auf den jeweiligen Seiten angezeigt werden, indem Sie deren Element IDs hinzufügen. Diese sind bereits mit den besten Optionen vorausgefüllt.

Protokollierung #

Die Protokollierung kann verwendet werden, um Fehler und/oder Warnungen anzuzeigen, die in Prestashop 1.6 auftreten.

Dies ist eine große Hilfe bei der Fehlersuche.

Um die Protokollierung zu aktivieren, gehen Sie wie folgt vor:

1. Gehen Sie in Ihr Prestashop Backend.

2. Gehen Sie zu Modules and Services -> Modules and Services.

3. Suchen Sie nach clerk, um das Modul zu finden, und klicken Sie auf Configure:

4. Scrollen Sie auf der Clerk-Modulseite nach unten, um die Protokollierungseinstellungen zu finden.

5. Stellen Sie Enabled auf Yes:

6. Scrollen Sie zum Ende der Seite und klicken Sie auf Save.

Die Protokollierungseinstellungen beinhalten:

Logging Level

• Only Errors: Protokolliert alle Fehler, die die Funktionsfähigkeit des Moduls beeinträchtigen.

• Error + Warn: Protokolliert zusätzlich Warnungen, die das Modul zwar nicht beeinträchtigen, aber ebenfalls behoben werden sollten.

• Error + Warn + Debug: Protokolliert alles, was das Modul verarbeitet. Das sollte auf einem Live-Webshop nicht aktiviert sein, da es die Seite verlangsamt.

Logging To

• File: Speichert das Protokoll als Datei auf dem Prestashop-Server.

• my.clerk.io: Protokolliert alles unter Developers->Logs im my.clerk.io Backend.

Upgrade #

Wenn Sie eine Version vor 5.0.0 verwenden, wird beim Upgrade Ihr Design nicht mehr funktionieren, da Clerk.js 2 verwendet wird. Bei älteren Versionen befolgen Sie bitte stattdessen diese Anleitung.

Wichtig: Denken Sie daran, Backups aller geänderten Dateien anzulegen, da diese überschrieben werden.

Laden Sie zuerst die neueste Version über diesen Link herunter:

https://github.com/clerkio/clerk-prestashop/releases/latest

Loggen Sie sich dann in Ihr Prestashop Admin ein und gehen Sie zu Modules And Services -> Modules And Services

Führen Sie auf dieser Seite Folgendes aus:

1. Klicken Sie auf Add New Module.

2. Klicken Sie auf Choose a file und laden Sie die clerk.zip Datei hoch, die Sie gerade heruntergeladen haben.

3. Klicken Sie auf Upload this module.

PrestaShop zeigt nun eine Erfolgsmeldung an, die bestätigt, dass Ihr Modul aktualisiert wurde.

Das war’s! Jetzt läuft die neueste Version des Prestashop-Moduls.

Deinstallation #

Melden Sie sich in Ihrem Prestashop-Admin-Portal an und wählen Sie „Modules and Services“ aus dem Menü auf der linken Seite:

Suchen Sie anschließend „Clerk“ in Ihrer Modulliste und wählen Sie „Deaktiver“, um das Clerk-Plugin zu deaktivieren:

Sobald deaktiviert, sollte Clerk aus Ihrem Prestashop-Shop entfernt sein.