Get Started

Installieren Sie das Clerk SDK in Ihrem DynamicWeb-Shop. Diese Anleitung führt Sie durch den Installationsprozess.

Das Clerk SDK für DynamicWeb ist ein Software Development Kit, was bedeutet, dass Sie einige Änderungen am Code vornehmen müssen, um Ihren Webshop anzupassen. Das SDK stellt die benötigten Dateien bereit, um mit der Synchronisierung Ihres Katalogs mit Clerk.io zu beginnen.

SDK herunterladen #

1. Gehen Sie zum Clerk DynamicWeb GitHub Repository.

2. Laden Sie unter Code die Zip-Datei herunter, die alle SDK-Dateien enthält.

3. Entpacken Sie die Zip-Datei. Sie sehen Ordner für Repositories, QueryPublisher und Ihr Theme (z.B. Rapido oder Swift).

Repository-Dateien hinzufügen #

1. Gehen Sie in DynamicWeb zu Dateien > System > Repositories.

2. Klicken Sie auf die drei Punkte (⋯) und wählen Sie Neuer Unterordner.

3. Benennen Sie den Ordner Clerk.

4. Kopieren Sie alle Dateien aus dem Ordner Repositories im SDK in den neuen Clerk-Ordner in DynamicWeb:

   • Products (Products.index & Products.query)
   • Categories (Categories.index & Categories.query)
   • Content (Content.index & Contents.query)
   • Customers (Customers.index & Customers.query)
   • Orders (Orders.index & Orders.query)

QueryPublisher-Dateien hinzufügen #

1. Gehen Sie in DynamicWeb zu Dateien > Templates > Designs > [THEME_NAME] > QueryPublisher.

   Ersetzen Sie [THEME_NAME] durch den Namen Ihres Themes (z.B. Swift, Rapido oder einen anderen Themennamen).

2. Kopieren Sie alle Dateien aus dem QueryPublisher-Ordner im SDK in den QueryPublisher-Ordner in DynamicWeb:

   • ClerkProducts.cshtml
   • ClerkCategories.cshtml
   • ClerkContents.cshtml
   • ClerkCustomers.cshtml
   • ClerkOrders.cshtml

Theme-Dateien hinzufügen #

1. Gehen Sie in DynamicWeb zu Dateien > Templates > Designs > [THEME_NAME].

2. Kopieren Sie die folgenden Dateien aus dem Theme-Ordner im SDK (z.B. Rapido oder Swift) in Ihren Theme-Ordner:

   • ClerkConfig.cshtml
   • Json.cshtml

Privaten Schlüssel konfigurieren #

1. Gehen Sie in my.clerk.io zu Einstellungen > API-Schlüssel.

2. Kopieren Sie Ihren Privaten API-Schlüssel.

3. Öffnen Sie in DynamicWeb die soeben kopierte Datei ClerkConfig.cshtml.

4. Suchen Sie den Platzhaltertext "##### CLERK Private Key Here #####" und ersetzen Sie ihn durch Ihren Privaten API-Schlüssel.

   Dies ermöglicht die Autorisierung bei Anfragen an DynamicWeb. Clerk wird diesen privaten Schlüssel bei API-Aufrufen immer mitsenden.

5. Speichern Sie die Datei.

Daten synchronisieren #

Die Synchronisierung der Daten verbindet Ihren DynamicWeb-Shop mit Clerk, sodass Clerk Zugriff auf Ihre Produkte, Bestellungen, Kunden, Kategorien und Inhalte erhält. So kann Clerk personalisierte Empfehlungen und Suchergebnisse basierend auf Ihren tatsächlichen Shop-Daten bereitstellen. Folgen Sie den Schritten im Sync Data guide, um die Datensynchronisierung einzurichten.