FAQ

Hai problemi con l’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 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 una configuration per Clerk.js, nello tracking-script che viene inserito in tutte le pagine, dove possono essere aggiunti più formatter contemporaneamente.

Esempio di formatter #

Un esempio è visibile di seguito. Attenzione, questo vale 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, separandoli con 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 usarli nei tuoi Designs con questa sintassi:

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

Questo ti permette di creare qualsiasi funzionalità tu desideri nei tuoi Designs.

Autenticazione HTTP #

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

Questo bloccherà l’importatore di Clerk e mostrerà un errore 401 Unauthorized nel log di sincronizzazione.

Puoi risolvere inserendo le informazioni di autenticazione nella URL di importazione.

In my.clerk.io > Data > Configuration, aggiorna la tua 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 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 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 utilizzando il Design Editor.

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

Creare i designs #

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

Puoi creare i tuoi Designs di Clerk.js 2 in 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 un Nome al tuo Design (consigliamo di aggiungere “V2” così è chiaro che stai usando Clerk.js 2).

3. Scegli il Type Design e segui il Wizard di configurazione.

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 modificarlo, oppure aggiungi nuovi elementi al Design per includere maggiori informazioni sui prodotti.

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

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

8. Clicca su Update Element. Questo farà sì che temporaneamente non vengano visualizzati nel tuo webshop, fino a quando non hai completato lo Step 2. Scegli il nuovo Design per tutti gli Elements che devono essere aggiornati.

Ora sei pronto per passare a Clerk.js 2.

Sostituire lo script #

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

2. Rimuovi il vecchio script dal file:

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

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

5. Salva il template.

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

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