Plugin

Konfigurieren Sie Ihre WooCommerce-Plugin-Einstellungen, verwalten Sie Datenabgleich-Optionen und passen Sie Suche, Empfehlungen und Protokollierungsfunktionen an. Dieser Leitfaden deckt alle verfügbaren Einstellungen und Optionen ab.

Sobald das Plugin erfolgreich installiert wurde, erscheint es im Seitenmenü Ihres Backends:

Allgemein #

Hier finden Sie eine Erklärung zu jeder Option im General-Abschnitt:

• Plugin Version: Die aktuell installierte Version des Clerk Plugins. Die neueste Version finden Sie hier.

• Public Key: Geben Sie hier Ihren Public key, ein, den Sie in my.clerk.io unter Developers > API keys finden.

• Private Key: Geben Sie hier Ihren Private Key ein, erstellt in my.clerk.io unter Developers > API keys.

• Language: Wählen Sie die richtige Sprache der Domain.

• Import URL: Die URL, die von Clerk für die Datensynchronisierung verwendet wird. Fügen Sie diese in Ihrem my.clerk.io-Konto unter Data > Configuration im Feld Store URL hinzu.

• Use Legacy Authentication: Aktivieren Sie diese Option bei Nutzung regulärer WooCommerce API-Schlüssel (consumer key und consumer secret). Dies ist für die meisten Setups erforderlich, um Datenabgleiche korrekt zu authentifizieren.

Datenabgleich: Produkte #

In diesem Abschnitt können Sie anpassen, wie Produktdaten mit Clerk synchronisiert werden. Nachfolgend eine Erklärung zu jeder Option:

• Use Real-Time Updates: Synchronisieren Sie Ihre Daten in Echtzeit mit Clerk, sobald Änderungen in WooCommerce vorgenommen werden.

• Include Out Of Stock Products:** Wenn Sie diese Option aktivieren, importiert Clerk Produkte mit dem Status “Out Of Stock”.

• Image Size: Wählen Sie die Bildgröße, die in Clerk importiert wird. Im Zweifel wählen Sie large, und verwalten Sie die Größe anschließend direkt im Clerk Design.

• Additional Fields: Hier können Sie eine kommagetrennte Liste zusätzlicher Produktdaten-Attribute eingeben, die Sie aus Ihrem WooCommerce-Store zu Clerk synchronisieren möchten.

• Strip/Trim Split Attributes: Wenn “Strip” deaktiviert ist, werden alle Leerzeichen innerhalb von Strings entfernt (z. B. ’ Option 1’ = ‘Option1’). Ist “Trim” aktiviert, werden nur führende und folgende Leerzeichen entfernt, interne Leerzeichen bleiben erhalten (z. B. ‘Option 1’ = ‘Option 1’).

• Additional Fields Raw: Geben Sie hier Attribute ein, die Sie bereits zu Additional Fields hinzugefügt haben, um diese Werte unverändert zu importieren (Kommas trennen sie beim Import nicht in Listen auf).

Datenabgleich: Seiten #

In diesem Abschnitt können Sie anpassen, wie Seitendaten mit Clerk synchronisiert werden. Nachfolgend eine Erklärung zu jeder Option:

• Use Real-Time Updates (Pages): um Ihre Seiten in Echtzeit zu Clerk zu synchronisieren, sobald Änderungen in WooCommerce vorgenommen werden.

• Include Pages: Wenn aktiviert, importiert Clerk alle Seiten, die unter WooCommerce > Pages > All Pages. enthalten sind.

• Page Additional Fields: Hier hinzugefügte Attribut-Slugs werden für jede Seite importiert.

• Page Additional Types: Synchronisieren Sie zusätzliche Seitenarten, einschließlich benutzerdefinierter Typen. Geben Sie eine kommagetrennte Liste ein, um mehrere Typen hinzuzufügen.

Datenabgleich: Kunden #

In diesem Abschnitt können Sie anpassen, wie Kundendaten mit Clerk synchronisiert werden. Nachfolgend eine Erklärung zu jeder Option:

• Include Customers: Aktivierung importiert Kunden zu Clerk.

• Collect Basket: Aktivierung erlaubt Clerk das Sammeln von Informationen über Produkte, die in den Warenkorb gelegt werden. Aktivieren Sie diese Option zum Beispiel, wenn Sie den Abandoned Basket-Trigger verwenden.

• Collect Emails: Aktivierung erlaubt Clerk das Sammeln und Importieren von Kunden-Emailadressen aus WooCommerce.

• Collect Emails Signup Message: Wenn Sie hier Text eintragen, erscheint ein Checkbox beim Checkout, über die wir die Email in my.clerk.io abonnieren. “Collect Emails” muss aktiviert sein. Ist das Feld leer, bleibt die Checkbox inaktiv.

• Extra Customers Fields: Eine kommagetrennte Liste zusätzlicher Attribute für Kundendaten, die beim Sync eingeschlossen werden sollen.

Datenabgleich: Bestellungen #

Es gibt nur eine Option, Disable Order Synchronization, die Bestellungen vom Versand an Clerk während des täglichen Syncs ausschließt, wenn aktiviert.

Clerk sammelt sie weiterhin in Echtzeit von Besuchern.

Live Search Einstellungen #

In diesem Abschnitt können Sie die Live Search anpassen und aktivieren. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktiviert Ihre Clerk Live Search.

• Include Suggestions/ Categories / Pages: Hier steuern Sie, ob Clerk passende Suggestions, Kategorien oder Seiten für die Anzeige in der Live Search finden soll.

• Number of Suggestions / Categories / Pages: Hier legen Sie fest, wie viele Übereinstimmungen pro Typ zurückgegeben werden sollen.

• Pages type: Wählen Sie die Art der Seiten-Ergebnisse im Dropdown, z. B. Blogbeiträge, CMS-Seiten oder Alle.

• Dropdown Positioning: Wählen Sie die Positionierung der Live Search Dropdown-Ergebnisse.

• Live Search Input Selector: Geben Sie den input selector an (Klasse oder ID des Eingabefelds für die Suche).

• Live Search Form Selector: Geben Sie den form selector an (Klasse oder ID des Formulars zur Übermittlung von Suchanfragen).

• Element: Geben Sie den Namen Ihres Live Search Elements an. Dieser ist im Element embed code als data template name, data-template= YOUR-ELEMENT-NAME gelistet. Üblicherweise “live-search”, z. B.:

<span class="clerk" 
  data-template="@live-search"  
  data-instant-search="INSERT_SEARCH_INPUT_CSS_SELECTOR_HERE" 
  data-instant-search-suggestions="6" 
  data-instant-search-categories="6" 
  data-instant-search-pages="6" 
  data-instant-search-positioning="right">
 </span>

Such-Einstellungen #

In diesem Abschnitt können Sie die Search Page anpassen und aktivieren. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktiviert Ihre Clerk Search Page.

• Search Page: Wählen Sie die CMS-Seite aus, die als Ziel für Clerk Search verwendet werden soll.

• Include Categories / Pages: Hier steuern Sie, ob Clerk passende Kategorien oder Seiten zur Anzeige auf der Search Page finden soll.

• Number of Categories / Pages: Hier legen Sie fest, wie viele Übereinstimmungen pro Typ zurückgegeben werden sollen.

• Pages type: Wählen Sie die Art der Seiten-Ergebnisse im Dropdown, z. B. Blogbeiträge, CMS-Seiten oder Alle.

• Element: Geben Sie den Namen Ihres Search Page Elements aus dem Element embed code in my.clerk.io an. Üblicherweise “search-page”.

• No results text: Geben Sie den Text ein, der angezeigt wird, wenn eine Suche auf der Search Page keine Ergebnisse liefert.

• Load more button text: Geben Sie den Text für den “Mehr laden”-Button ein.

Facettierte Navigation #

• Enabled: Aktiviert Ihre Clerk Facets auf der Search Page.

• Add Custom Attribute: Geben Sie hier den Namen eines Attributs ein, das Sie in Ihren Facetten einschließen möchten, und klicken Sie auf “Hinzufügen”.

• Facet Attributes: Nach dem Hinzufügen erscheint das Attribut in diesem Abschnitt. Hier können Sie seinen display title setzen, die Position in der Facettenliste festlegen und das Show-Feld ankreuzen, um es in Ihre Facetten einzubeziehen.

• Design: Geben Sie die ID des Facettendesigns an. Diese finden Sie in my.clerk.io > Search > Design.

Powerstep Einstellungen #

In diesem Abschnitt können Sie den Powerstep nach dem Hinzufügen eines Produkts zum Warenkorb anpassen und aktivieren. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktiviert den Clerk Powerstep.

• Powerstep Type: Wählen Sie den Typ des Powerstep, den Sie aktivieren möchten, z. B. “page” oder “popup”.

• Powerstep Page: Wählen Sie die CMS-Seite als Ziel für den Clerk Powerstep.

• Contents: Geben Sie den Namen Ihres Power Step Elements aus dem Element embed code in my.clerk.io ein.

• Filter Duplicates: Die Aktivierung garantiert, dass jedes Banner ausschließlich einzigartige Produkte zeigt.

• Enable Custom Texts: Bei Aktivierung können eigene Texte zum Powerstep hinzugefügt werden.

• Back Button: Geben Sie den Text für den Zurück-Button ein, mit dem Nutzer zur vorherigen Seite zurückkehren.

• Cart Button: Geben Sie einen Text für den Button ein, der zur Warenkorbseite weiterleitet.

• Product Title: Geben Sie eine Textnachricht für den Powerstep-Titel ein.

• Keep Add To Cart Params: Die Aktivierung dieser Option sorgt dafür, dass die zum Hinzufügen von Artikeln gehörenden Abfrageparameter beim Weiterleiten zur Powerstep-Seite beibehalten werden. Dies hilft, die gewählten Produktdetails während des Vorgangs zu erhalten.

Exit Intent Einstellungen #

In diesem Abschnitt können Sie den Exit Intent anpassen und aktivieren.

Ein Exit Intent ist eine Art Popup, das erscheint, wenn ein Nutzer im Begriff ist, die Website zu verlassen. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktivieren Sie Ihr Clerk Exit Intent Element durch Aktivierung dieses Feldes.

• Element: Geben Sie den Namen des Exit Intent Elements ein, das Sie für Ihren Shop erstellt haben. Üblicherweise “exit-content”.

Kategorie, Produkt, Warenkorb #

In diesem Abschnitt können Sie die Empfehlungen für Kategorie-, Produkt- und Warenkorbseiten anpassen und aktivieren. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktiviert Ihre Clerk Kategorie-, Produkt- und Warenkorb-Empfehlungselemente.

• Element: Geben Sie den Namen des Elements ein, das Sie für Ihren Shop in my.clerk.io erstellt haben. In der Regel ist es bereits ausgefüllt.

• Filter Duplicates: Aktivierung garantiert, dass jedes Banner ausschließlich einzigartige Produkte zeigt.

• Defer Injection: Nur für Product Settings: Aktivierung sorgt dafür, dass die Empfehlungen auf der Produktseite erst nach dem Rendern des Seiteninhalts eingefügt werden.

• Category / Product / Cart ID Shortcode: Diese Shortcodes ermöglichen das einfache Einfügen von Clerk embedcodes, wenn Sie deren Platzierung mit Editoren wie WPBakery oder Elementor anpassen möchten. Zum Beispiel:

<span class="clerk"
   data-template="product-page-alternatives"
   data-products="[[clerk_product_id]]">
</span>

Zusätzliche Scripts #

In diesem Abschnitt können Sie zusätzliche JS-Skripte einfügen und aktivieren. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktiviert das zusätzliche Skript, das in das folgende Feld eingefügt wird.

• JS Code: Wenn aktiviert, wird das in dieses Feld eingefügte Skript zusammen mit Clerk.js ausgeführt.

Protokollierung #

In diesem Abschnitt können Sie Fehlerprotokolle und/oder Warnungen von Clerk aktivieren und anpassen. Nachfolgend eine Erklärung zu jeder Option:

• Enabled: Aktiviert die Protokollierungsfunktion.

• Log level: Hier können Sie den gewünschten Protokollierungs-Typ auswählen.

  • Only Errors: Protokolliert alle Fehler, die das Modul am korrekten Arbeiten hindern.

  • Error + Warn: Protokolliert außerdem Warnungen, die das Modul nicht zum Stoppen bringen, aber ebenfalls behoben werden sollten.

  • Error + Warn + Debug: Protokolliert alles, mit dem das Modul interagiert. Dies sollte auf einem Live-Webshop nicht aktiviert werden, da es die Seite verlangsamen kann.

• Log to: Dies protokolliert alles in My.Clerk.io unter Developers > Logs.

Aktualisierung #

Best Practice: Erstellen Sie vor jedem Update stets Backups aller modifizierten Dateien, um falls nötig vorherige Versionen wiederherstellen zu können.

Wenn Sie eine Version vor 2.0.0 benutzen, werden Ihre Designs beim Upgrade nicht mehr funktionieren, da Clerk.js 2 verwendet wird.

Bei älteren Versionen folgen Sie bitte dieser Anleitung.

Das Upgrade des Plugins kann direkt aus dem WooCommerce-Backend über folgende Schritte durchgeführt werden:

1. Öffnen Sie Plugin > Installed Plugins und suchen Sie nach Clerk.

2. Klicken Sie auf Update Now:

Wenn Sie bereits die neueste Version verwenden, zeigt dieser Button stattdessen Active an.