FAQ

Hai problemi con l’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 permette 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 inserito su tutte le pagine, dove possono essere aggiunti più formatter contemporaneamente.

Esempio di formatter #

Un esempio è visibile qui sotto. Nota che è per Clerk V2 (ultima versione):

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

Più formatter #

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

Dopo aver creato i tuoi Formatters, puoi usarli nei tuoi Designs utilizzando questa sintassi:

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

Questo consente di creare qualsiasi funzionalità nei tuoi Designs di cui hai bisogno.

Autenticazione HTTP #

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

Questo bloccherà l’importatore Clerk e visualizzerà 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 così:

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ù semplice l’installazione di Clerk su qualsiasi webshop.

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

Le due differenze principali in Clerk.js 2 sono:

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

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

Creare designs #

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

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

• Usa 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 un Nome al tuo Design (consigliamo di aggiungere “V2” così è evidente 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 qualsiasi elemento esistente come nome, immagine, pulsante ecc. per modificarlo, oppure aggiungi nuovi elementi al Design per includere più informazioni sui prodotti.

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

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

8. Clicca su Update Content. Questo farà sì che temporaneamente non vengano mostrati sul tuo webshop, fino a quando non avrai terminato Step 2. Scegli il nuovo Design per tutti i Content che devono essere aggiornati.

Ora sei pronto per passare a Clerk.js 2.

Sostituire lo script #

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

2. Rimuovi il vecchio script dal file:

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

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

5. Salva il template.

Congratulazioni! Ora stai utilizzando il nuovo e migliorato setup Clerk.js 2!

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