Installazione dell’SDK #
Impostazione della sincronizzazione dei dati #
Per la sincronizzazione dei dati con Clerk.io, dobbiamo impostare una REST API, con accesso ai dati necessari. (Prodotti, Ordini, Categorie, Pagine e Clienti).
Per accedervi, utilizzeremo la parte Repository di DynamicWeb.
I file per l’API REST sono inclusi nel [Clerk.io DynamicWeb SDK] (https://github.com/clerkio/clerk-dynamicweb).
Inserire i file del Repository dall’SDK di Clerk.io.
Aggiungere la chiave privata al file di configurazione.
Costruire l’indice del repository.
Impostare l’API REST.
Eseguire la prima sincronizzazione con clerk.io.
Inserire i file del repository dall’SDK di Clerk #
Nella guida, faremo riferimento a THEME_NAME, che dovrà essere sostituito dal nome del tema utilizzato, ad esempio Rapido.
In DynamicWeb andate in Files -> System -> Repositories e create una nuova sottocartella denominata Clerk.
Copiate tutti i file dalla cartella Repositories del Clerk SDK nella nuova cartella:
Prodotti (Products.index e Products.query)
Categorie (Categories.index & Categories.query)
Contenuto (Content.index & Contents.query)
Clienti (Customers.index & Customers.query)
Ordini (Orders.index & Orders.query)
Navigare in Files -> Templates -> Designs -> THEME_NAME -> QueryPublisher.
Caricare i seguenti file da Clerk SDK a QueryPublisher:
ProdottiClerk.cshtml
ClerkCategories.cshtml
ClerkContents.cshtml
Clienti.cshtml
OrdiniClienti.cshtml
Passare a Files -> Templates -> Designs -> THEME_NAME.
Copiare i file dalla cartella Rapido nell’SDK Clerk nella cartella NOME_TEMA:
ClerkConfig.cshtml
Json.cshtml
Aggiungere la chiave privata al file di configurazione #
In my.clerk.io, navigare in Impostazioni -> Chiavi API.
Copiare la chiave API privata.
Ind DynamicWeb, aprire ClerkConfig.cshtml appena copiato.
Sostituire "##### CLERK Private Key Here #####" con la chiave API privata.
Salvare le modifiche e chiudere.
Indice del repository di compilazione #
Spostarsi in _Impostazioni -> Repository -> Impiegato.
Fare clic sull’indice Prodotti
In Costruzioni -> Costruisci, fare clic sul pulsante Prodotti per costruire l’indice.
Seguite la stessa procedura per tutti gli indici (Categorie, Contenuti, Clienti, Ordini).
Impostare l’API REST #
Navigare in Content nel menu laterale e creare una nuova cartella denominata Clerk.
All’interno di questa cartella, creare una nuova pagina
Fare clic su Aggiungi pagina vuota e scegliere Pagina come tipo.
Nominare la pagina “Prodotti” e impostare lo stato della pagina su Nascondi nel menu.
Fare clic su Nuovo paragrafo e scorrere fino a Aggiungi paragrafo. Da qui, scegliere App.
Assegnare il nome “Prodotti “.
Scegliere App > Content > Query publisher
In Query, scegliere Products.query.
In Template, in basso, scegliere QueryPublisher/ClerkProducts.cshtml.
Nella parte superiore della pagina, fare clic su Salva.
Nel menu di sinistra, fare clic sui 3 punti a destra della pagina Prodotti e su Proprietà.
In URL, impostare Esatto url per questa pagina su "/clerk/products”.
Nel menu superiore, deselezionare tutte le opzioni sopra Accessibilità.
Fare clic su Layout nel menu superiore.
Nel menu in alto, scegliere il modello Rapido: JSON
Salvare nuovamente la pagina.
Ripetete questi passaggi per Contenuti, Ordini, Categorie e Clienti, assicurandovi di sostituire prodotti/Prodotti con il tipo di dati pertinente.
Eseguire la prima sincronizzazione con clerk.io #
Accedere al backend my.clerk.io.
Andare alla sezione Dati.
Inserite il dominio del vostro webshop alla voce Store URL e scegliete le opzioni di sincronizzazione aggiuntive che desiderate.
Fare clic su Salva.
Fare clic su Avvia nuova sincronizzazione dati.
Attendere il completamento della sincronizzazione.