FAQ

Hai riscontrato problemi con la tua integrazione Smartweb? 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 consente di scrivere funzioni JavaScript personalizzate che aggiungono nuove funzionalità ai tuoi Designs.

I formatter possono essere aggiunti in due modi:

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

• Come configuration per Clerk.js, nello tracking-script che viene inserito su tutte le pagine, dove è possibile aggiungere più formatter contemporaneamente.

Esempio di formatter #

Un esempio è visibile qui sotto. Tieni presente che questo è per Clerk V2 (versione più recente):

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

Molteplici formatter #

Puoi scrivere qualsiasi numero di Formatters, separati da una 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 designs #

Dopo aver creato i tuoi Formatters, puoi utilizzarli nei tuoi Designs usando questa sintassi:

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

Questo ti permette di creare qualsiasi funzionalità nei tuoi Designs che ti serve.

Autenticazione HTTP #

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

Questo bloccherà l’importatore Clerk e mostrerà un errore 401 Unauthorized nel log 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

Aggiornamento a Clerk.js 2 #

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

Rende più facile installare Clerk su qualsiasi webshop.

Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, è necessario seguire questi passaggi per aggiornare con successo.

Le due principali differenze in Clerk.js 2 sono:

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

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

Creazione dei designs #

Poiché Clerk.js 2 ha un approccio diverso ai Designs, è necessario crearne di nuovi.

Puoi creare i tuoi Designs Clerk.js 2 in uno dei due modi:

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

• Converti i tuoi vecchi Designs. 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” così è chiaro che stai usando Clerk.js 2).

3. Scegli il Tipo di Design e segui il Wizard 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 maggiori informazioni sui prodotti.

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

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

8. Clicca su Update Element. Questo causerà temporaneamente la loro scomparsa dal tuo webshop, fino a quando non avrai completato Step 2. Scegli il nuovo Design per tutti gli Elements che devono essere aggiornati.

Ora sei pronto per passare a Clerk.js 2.

Sostituisci lo script #

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

2. Rimuovi il vecchio script dal file:

3. Vai su my.clerk.io > Developers > Tracking Code. Ora questa pagina contiene il tuo codice di tracking 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