Get Started

Installa l’SDK di Clerk sul tuo store DynamicWeb. Questa guida ti accompagna attraverso il processo di installazione.

L’SDK di Clerk per DynamicWeb è un kit di sviluppo software, il che significa che dovrai apportare alcune modifiche al codice per adattarlo al tuo webshop. L’SDK fornisce i file necessari per iniziare a sincronizzare il tuo catalogo con Clerk.io.

Scarica l’SDK #

1. Vai al repository GitHub di Clerk DynamicWeb.

2. Sotto Code, scarica il file zip contenente tutti i file dell’SDK.

3. Estrai il file zip. Vedrai le cartelle Repositories, QueryPublisher e la cartella del tuo tema (ad es., Rapido o Swift).

Aggiungi file repository #

1. In DynamicWeb, vai su Files > System > Repositories.

2. Clicca sui tre puntini (⋯) e scegli New subfolder.

3. Dai il nome Clerk alla cartella.

4. Copia tutti i file dalla cartella Repositories dell’SDK nella nuova cartella Clerk 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)

Aggiungi file QueryPublisher #

1. In DynamicWeb, vai su Files > Templates > Designs > [THEME_NAME] > QueryPublisher.

   Sostituisci [THEME_NAME] con il nome del tuo tema (ad es., Swift, Rapido o altro nome tema).

2. Copia tutti i file dalla cartella QueryPublisher dell’SDK nella cartella QueryPublisher in DynamicWeb:

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

Aggiungi file tema #

1. In DynamicWeb, vai su Files > Templates > Designs > [THEME_NAME].

2. Copia i seguenti file dalla cartella del tema nell’SDK (ad es., Rapido o Swift) alla cartella del tuo tema:

   • ClerkConfig.cshtml
   • Json.cshtml

Configura la chiave privata #

1. In my.clerk.io, vai su Settings > API Keys.

2. Copia la tua Private API Key.

3. In DynamicWeb, apri il file ClerkConfig.cshtml appena copiato.

4. Trova il testo segnaposto "##### CLERK Private Key Here #####" e sostituiscilo con la tua Private API Key.

   Questo consente l’autorizzazione quando si richiedono dati da DynamicWeb. Clerk invierà sempre questa chiave privata nelle chiamate API.

5. Salva il file.

Sincronizza i dati #

La sincronizzazione dei dati collega il tuo store DynamicWeb a Clerk, consentendo a Clerk di accedere ai tuoi prodotti, ordini, clienti, categorie e contenuti. Questo permette a Clerk di fornire Recommendations personalizzati e risultati di Search basati sui dati reali del tuo store. Segui i passaggi nella guida Sync Data per configurare la sincronizzazione dei dati.