FAQ

Hai problemi con la tua integrazione SmartWeb Classic? Questa FAQ copre i problemi più comuni e le loro soluzioni, dai formatter all’aggiornamento a Clerk.js 2.

Utilizzo dei formatter #

Clerk.js ti permette di scrivere funzioni JavaScript personalizzate che aggiungono nuove funzionalità ai tuoi Design.

I formatter possono essere aggiunti in due modi:

• Tramite my.clerk.io > Developers > Formatters, dove ogni Formatter può essere creato come voce separata.

• Come una configurazione per Clerk.js, nello tracking-script inserito su tutte le pagine, dove più formatter possono essere aggiunti contemporaneamente.

Esempio di formatter #

Un esempio può essere visto qui sotto. Si prega di notare che questo è per Clerk V2 (versione più recente):

Clerk('config', {
  key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
  formatters: {
    log_price: function(price) {
      console.log(price);
    }
  }
});

Più formatter #

Puoi scrivere qualsiasi numero di Formatter, separati da virgola:

formatters: {
  log_price: function(price) {
    console.log(price);
  },
  calculate_discount: function(price, special_price) {
    return price - special_price;
  },
  substring: function(text) {
    var short_string = text.substring(0, 20);
    return short_string;
  }
}

Utilizzo nei design #

Dopo aver creato i tuoi Formatter, puoi utilizzarli nei tuoi Design usando questa sintassi:

{%raw%}{{ price | log_price }} {{ price | calculate_discount | special_price }}{%endraw%}

Questo ti permette di creare qualsiasi funzionalità tu richieda nei tuoi Design.

Autenticazione HTTP #

L’autenticazione HTTP è spesso utilizzata sui siti di staging per evitare visitatori indesiderati.

Ciò bloccherà l’importatore Clerk e mostrerà un errore 401 Unauthorized nel registro di sincronizzazione.

Puoi risolvere questo problema inserendo le informazioni di autenticazione nell’URL di importazione.

In my.clerk.io > Data > Configuration, aggiorna il tuo URL di importazione in questo modo:

http://USER:PASS@www.ewoksRus.com

Aggiorna a Clerk.js 2 #

Clerk.js 2 è una versione più veloce e flessibile della nostra libreria JavaScript.

Rende più semplice l’installazione di Clerk su qualsiasi webshop.

Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, devi seguire questi passaggi per aggiornare correttamente.

Le due principali differenze in Clerk.js 2 sono:

• I Design in my.clerk.io utilizzano il linguaggio di templating Liquid, ma possono essere facilmente creati anche tramite il Design Editor.

• Lo script deve essere inserito appena prima del tag </head> nel template del tuo webshop.

Crea design #

Poiché Clerk.js 2 ha un approccio diverso ai Design, devi crearne di nuovi.

Puoi creare i tuoi Design per Clerk.js 2 in uno dei due modi seguenti:

• Usa l’intuitivo Design Editor per creare nuovi Design, come descritto nei punti seguenti.

• Converti i tuoi vecchi Design. Segui questa guida per vedere come fare.

Opzione Design Editor #

1. Vai su my.clerk.io > Recommendations/Search > Designs > New Design.

2. Nella schermata successiva, dai al tuo Design un Nome (consigliamo di aggiungere “V2” per rendere ovvio che stai usando Clerk.js 2).

3. Scegli il Tipo di Design e segui la procedura guidata di configurazione del design.

4. Quando hai finito, clicca su Create Design.

5. Nel Design Editor, clicca su uno qualsiasi degli elementi esistenti come nome, immagine, pulsante ecc. per modificarli, oppure aggiungi nuovi elementi al Design per includere più informazioni sui prodotti.

6. Clicca su Publish quando hai finito, e vai a Step 2 della guida.

7. Vai su Recommendations/Search > Elements e modifica il tuo Clerk Element per usare il nuovo Design.

8. Clicca su Update Element. Questo farà sì che temporaneamente non saranno visibili sul tuo webshop, fino a che non avrai completato Step 2. Scegli il nuovo Design per tutti gli Element che devono essere aggiornati.

Ora sei pronto per passare a Clerk.js 2.

Sostituisci lo script #

1. Trova il file template utilizzato per mostrare tutte le pagine del webshop, dove si trova lo script originale Clerk.js vicino al fondo.

2. Rimuovi lo script vecchio dal file:

3. Vai su my.clerk.io > Developers > Tracking Code. Questa pagina ora contiene il tuo codice di tracciamento Clerk.js 2.

4. Copia questo codice e inseriscilo appena prima del tag </head> nel template:

5. Salva il tuo template.

Congratulazioni! Ora stai utilizzando la configurazione Clerk.js 2, molto migliorata!

Puoi vedere la documentazione completa per Clerk.js 2 qui: https://docs.clerk.io/docs/clerkjs-quick-start