Plugin
Konfigurieren Sie Ihre WooCommerce-Plugin-Einstellungen, verwalten Sie Datenabgleich-Optionen, und passen Sie Such-, Empfehlungen- und Protokollierungsfunktionen an. Dieser Leitfaden behandelt alle verfügbaren Einstellungen und Optionen.
Sobald das Plugin erfolgreich installiert wurde, erscheint es im Seitenmenü Ihres Backends:
Allgemein #
Hier befindet sich eine Erklärung zu jeder Option im General Bereich:
Plugin Version: Die aktuell installierte Version des Clerk-Plugins. Hier finden Sie das neueste Release.
Public Key: Tragen Sie Ihren Public key, ein, den Sie unter my.clerk.io Developers > API keys finden.
Private Key: Geben Sie Ihren Private Key ein, der in my.clerk.io unter Developers > API keys angelegt wurde.
Language: Wählen Sie die korrekte Sprache Ihrer Domain aus.
Import URL: Die URL, die Clerk zum Synchronisieren der Daten verwendet. 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, wenn Sie reguläre WooCommerce API-Schlüssel (consumer key und consumer secret) nutzen. Für die meisten Setups erforderlich, damit Datenabgleiche korrekt authentifiziert werden.
Datenabgleich: Produkte #
In diesem Abschnitt können Sie anpassen, wie Produktdaten mit Clerk synchronisiert werden. Untenstehend eine Erläuterung 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:** Bei Aktivierung dieser Option importiert Clerk Produkte, die “Out Of Stock” sind.
Image Size: Wählen Sie die Größe des in Clerk importierten Bildes. Im Zweifel wählen Sie large und verwalten die Größe direkt im Clerk Design.
Additional Fields: Hier können Sie eine durch Kommas getrennte Liste zusätzlicher Produkteigenschaften eintragen, die Sie von Ihrem WooCommerce-Shop zu Clerk synchronisieren möchten.
Strip/Trim Split Attributes: Ist Strip deaktiviert, werden alle Leerzeichen innerhalb von Zeichenfolgen entfernt (z.B. " Option 1" = “Option1”). Bei aktiviertem Trim werden nur führende und abschließende Leerzeichen entfernt, interne bleiben erhalten (z.B. “Option 1” = “Option 1”).
Additional Fields Raw: Geben Sie hier Eigenschaften ein, die Sie bereits zu Additional Fields hinzugefügt haben, um diese Werte unverändert zu importieren und damit zu verhindern, dass Kommas sie beim Import in Listen aufteilen.
Datenabgleich: Seiten #
Hier können Sie festlegen, wie Seitendaten mit Clerk synchronisiert werden. Eine Erklärung zu den einzelnen Optionen:
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 in WooCommerce > Pages > All Pages. enthalten sind.
Page Additional Fields: Hier eingetragene Attribut-Slugs werden für jede Seite importiert.
Page Additional Types: Synchronisieren Sie zusätzliche Seitentypen, einschließlich angepasster Typen. Geben Sie eine durch Kommas getrennte Liste ein, um mehrere Typen hinzuzufügen.
Datenabgleich: Kunden #
In diesem Abschnitt können Sie anpassen, wie Kundendaten mit Clerk synchronisiert werden. Untenstehend eine Erklärung jeder Option:
Include Customers: Bei Aktivierung werden Kunden zu Clerk importiert.
Collect Basket: Bei Aktivierung kann Clerk Informationen zu Produkten sammeln, die in den Warenkorb gelegt werden. Aktivieren Sie diese Option beispielsweise, wenn Sie den Abandoned Basket Trigger nutzen.
Collect Emails: Bei Aktivierung kann Clerk die E-Mail-Adressen der Kunden aus WooCommerce erfassen und importieren.
Collect Emails Signup Message: Ein hier eingetragener Text ermöglicht eine Checkbox beim Checkout, mit der wir die E-Mail bei my.clerk.io anmelden. “Collect Emails” muss aktiviert sein. Wird dieses Feld leer gelassen, ist die Checkbox nicht aktiv.
Extra Customers Fields: Eine durch Kommas getrennte Liste zusätzlicher Attribute für Kundendaten, die beim Sync einbezogen werden sollen.
Datenabgleich: Bestellungen #
Hier gibt es nur eine Option, Disable Order Synchronization, die bei Aktivierung bewirkt, dass Bestellungen während des täglichen Abgleichs nicht zu Clerk gesendet werden.
Clerk sammelt sie weiterhin in Echtzeit von Besuchern.
Live Search Einstellungen #
In diesem Abschnitt können Sie die Live Search anpassen und aktivieren. Eine Erklärung zu jeder Option:
Enabled: Aktiviert Ihre Clerk Live Search.
Include Suggestions/ Categories / Pages: Damit können Sie bestimmen, ob Clerk passende Suggestions, Kategorien oder Seiten in der Live Search anzeigen soll.
Number of Suggestions / Categories / Pages: Damit können Sie festlegen, wie viele Ergebnisse pro Typ angezeigt werden sollen.
Pages type: Wählen Sie die Dropdown-Ergebnistypen, z.B. Blogbeiträge, CMS-Seiten oder Alle.
Dropdown Positioning: Wählen Sie die Position des Live Search Dropdown-Ergebnisses aus.
Live Search Input Selector: Geben Sie den input selector ein, also die Klasse oder ID für das Suchfeld.
Live Search Form Selector: Geben Sie den form selector ein, also die Klasse oder ID des Formulars, das Suchanfragen sendet.
Element: Geben Sie den Namen Ihrer Live Search Elements ein. Er ist im Element embed code als data template name,
data-template= YOUR-ELEMENT-NAME, aufgeführt. Typischerweise “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>
Search Einstellungen #
In diesem Abschnitt können Sie die Search Page anpassen und aktivieren. Eine Erklärung zu jeder Option:
Enabled: Aktiviert Ihre Clerk Search Page.
Search Page: Wählen Sie die CMS-Seite als Zielseite für die Clerk Search aus.
Include Categories / Pages: Damit können Sie festlegen, ob Clerk passende Kategorien oder Seiten auf der Search Page anzeigen soll.
Number of Categories / Pages: Damit legen Sie fest, wie viele mögliche Treffer pro Typ ausgegeben werden.
Pages type: Wählen Sie die Dropdown-Ergebnistypen, z.B. Blogbeiträge, CMS-Seiten oder Alle.
Element: Geben Sie den Namen Ihres Search Page Elements aus dem Element-Embedcode in my.clerk.io ein. Normalerweise “search-page”.
No results text: Geben Sie den Text ein, der auf der Suchseite angezeigt werden soll, wenn keine Treffer gefunden werden.
Load more button text: Text für den “Load More”-Button.
Facettierte Navigation #
Enabled: Aktiviert Ihre Clerk Facets in der Search Page.
Add Custom Attribute: Geben Sie den Namen eines Attributs ein, das Sie in Ihren Facetten aufnehmen möchten, und klicken Sie auf “Hinzufügen”.
Facet Attributes: Nach dem Hinzufügen erscheint das Attribut in diesem Abschnitt. Hier können Sie den display title festlegen, die Position in der Facettenliste bestimmen und die Show-Box aktivieren, um es einzuschließen.
Design: Geben Sie die ID des Facet Designs ein. Sie ist zu finden unter 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. Erklärung zu jeder Option:
Enabled: Aktiviert den Clerk Powerstep.
Powerstep Type: Wählen Sie den Typ des Powerstep, z. B. “page” oder “popup”.
Powerstep Page: Wählen Sie die CMS-Seite als Zielseite für den Clerk Powerstep aus.
Contents: Geben Sie den Namen Ihres Powerstep Elements aus dem Element-Embedcode in my.clerk.io ein.
Filter Duplicates: Aktiviert, wird garantiert, dass jedes Banner nur einzigartige Produkte zeigt.
Enable Custom Texts: Bei Aktivierung können Texte zum Powerstep hinzugefügt werden.
Back Button: Text, der auf dem Zurück-Button angezeigt wird, wodurch Nutzer zur vorherigen Seite zurückkehren können.
Cart Button: Geben Sie einen Text für den Button ein, der zur Warenkorb-Seite weiterleitet.
Product Title: Textnachricht für den Powerstep Title.
Keep Add To Cart Params: Bei Aktivierung bleiben die Parameter für das Hinzufügen zum Warenkorb beim Weiterleiten zur Powerstep-Seite erhalten. Das sorgt dafür, dass die gewählten Produktdetails bestehen bleiben.
Exit Intent Einstellungen #
Hier können Sie den Exit Intent anpassen und aktivieren.
Ein Exit Intent ist eine Art Popup, das erscheint, wenn Nutzer dabei sind, eine Website zu verlassen. Erklärung zu jeder Option:
Enabled: Aktivieren Sie Ihr Clerk Exit Intent Element, indem Sie dieses Feld ankreuzen.
Element: Geben Sie den Namen des Exit Intent Elements ein, das Sie für Ihren Shop erstellt haben. Meist “exit-content”.
Kategorie, Produkt, Warenkorb #
Hier können Sie die Recommendations für Kategorie-, Produkt- und Warenkorbseiten anpassen und aktivieren. Erklärung zu jeder Option:
Enabled: Aktiviert Ihre Clerk Recommendations-Elemente für Kategorie-, Produkt- und Warenkorbseiten.
Element: Geben Sie den Namen des Elements aus my.clerk.io für Ihren Shop ein. Ist in der Regel bereits ausgefüllt.
Filter Duplicates: Aktiviert, wird garantiert, dass jedes Banner nur einzigartige Produkte zeigt.
Defer Injection: Nur für Product Settings, bei Aktivierung werden die Recommendations erst nach dem Rendern des Seiteninhalts in die Produktseite eingefügt.
Category / Product / Cart ID Shortcode: Mit diesen Shortcodes können Sie Clerk embedcodes einfach einfügen, wenn Sie deren Platzierung mit Editoren wie WPBakery und Elementor anpassen möchten. Beispiel:
<span class="clerk"
data-template="product-page-alternatives"
data-products="[[clerk_product_id]]">
</span>
Zusätzliche Skripte #
Hier können Sie weitere JS-Skripte hinzufügen und aktivieren. Erklärung zu jeder Option:
Enabled: Aktiviert das im folgenden Feld eingefügte zusätzliche Skript.
JS Code: Wenn aktiviert, wird das in dieses Feld eingefügte Skript zusammen mit Clerk.js ausgeführt.
Protokollierung #
Hier können Sie das Protokollieren von Fehlern und/oder Warnungen von Clerk aktivieren und anpassen. Erklärung zu jeder Option:
Enabled: Aktiviert die Logging-Funktion.
Log level: Hier können Sie den gewünschten Logging-Typ auswählen.
Only Errors: Protokolliert nur Fehler, die das Funktionieren des Moduls verhindern.
Error + Warn: Protokolliert zusätzlich Warnungen, die das Modul zwar nicht stoppen, jedoch behebenswert sein können.
Error + Warn + Debug: Protokolliert alle Interaktionen des Moduls. Dies sollte NICHT auf einem aktiven Webshop aktiviert werden, da es die Seite verlangsamt.
Log to: Protokolliert alles in My.Clerk.io unter Developers > Logs.
Upgrade #
Best Practice: Erstellen Sie immer Sicherungen modifizierter Dateien vor einem Upgrade, um sicherzustellen, dass Sie falls nötig frühere Versionen wiederherstellen können.
Wenn Sie eine Version vor 2.0.0 verwenden, werden Ihre Designs beim Upgrade nicht mehr funktionieren, da Clerk.js 2 verwendet wird.
Bei einer älteren Version folgen Sie stattdessen dieser Anleitung.
Das Upgrade des Plugins kann direkt aus dem WooCommerce-Backend durchgeführt werden, indem Sie diese Schritte befolgen:
Gehen Sie zu Plugin > Installed Plugins und suchen Sie nach Clerk.
Klicken Sie auf Update Now:
Wenn Sie bereits die aktuelle Version haben, steht auf diesem Button einfach Active.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.