FAQ

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

Utilizzo dei formattatori #

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

I formattatori possono essere aggiunti in due modi:

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

• Come una configuration per Clerk.js, nello tracking-script che viene inserito su tutte le pagine, permettendo di aggiungere più formattatori contemporaneamente.

Esempio di formattatore #

Un esempio può essere visto qui sotto. Tieni presente che questo è per Clerk V2 (ultima versione):

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

Più formattatori #

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 design #

Dopo aver creato i tuoi Formatters, puoi usarli 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 di cui hai bisogno.

Autenticazione HTTP #

L’autenticazione HTTP è spesso usata su siti di staging per evitare visitatori indesiderati.

Questo 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

Aggiornamento a Clerk.js 2 #

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

Rende più semplice 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 templating Liquid, ma possono anche essere creati facilmente usando il Design Editor.

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

Creare design #

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

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

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

• 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ì sarà ovvio che stai usando Clerk.js 2).

3. Scegli il Type del Design e segui la procedura guidata per la configurazione.

4. Al termine, fai clic su Create Design.

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

6. Fai clic su Publish al termine e vai al Step 2 della guida.

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

8. Fai clic su Update Element. Questo farà sì che temporaneamente non vengano visualizzati sul tuo webshop, fino al completamento del 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 del template utilizzato per mostrare tutte le pagine del webshop e dove si trova lo script originale di Clerk.js vicino al fondo.

2. Rimuovi il vecchio script dal file:

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

4. Copia questo codice e inseriscilo subito 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 di Clerk.js 2 qui: https://docs.clerk.io/docs/clerkjs-quick-start