Plugin

Configura le impostazioni del tuo plugin WooCommerce, gestisci le opzioni di sincronizzazione dei dati e personalizza le funzionalità di search, recommendations e logging. Questa guida copre tutte le impostazioni e opzioni disponibili.

Dopo che il plugin è stato installato con successo in WooCommerce, apparirà nel menu laterale del tuo backend:

Generale #

Ecco una spiegazione di ogni opzione nella sezione General:

• Plugin Version: La versione del plugin Clerk attualmente installata. Qui puoi trovare l’ ultima release.

• Public Key: Inserisci la tua Public key, trovata su my.clerk.io Developers > API keys.

• Private Key: Inserisci la tua Private Key, creata su my.clerk.io Developers > API keys.

• Language: Scegli la lingua corretta del dominio.

• Import URL: L’URL utilizzato da Clerk per sincronizzare i dati. Aggiungilo al tuo account my.clerk.io sotto Data > Configuration nel campo Store URL.

Sincronizzazione dati: prodotti #

In questa sezione, puoi personalizzare come i dati dei Prodotti vengono sincronizzati con Clerk. Di seguito una spiegazione di ogni opzione:

• Use Real-Time Updates: Sincronizza i tuoi dati su Clerk in tempo reale ogni volta che vengono apportate modifiche in WooCommerce.

• Include Out Of Stock Products:** Abilitando questa opzione, Clerk importerà anche i prodotti “Out Of Stock”.

• Image Size: Scegli la dimensione dell’immagine importata in Clerk. In caso di dubbio, seleziona large, quindi gestisci la dimensione direttamente all’interno di Clerk Design.

• Additional Fields: Qui puoi aggiungere una lista separata da virgole di qualsiasi attributo aggiuntivo dei dati Prodotto che desideri sincronizzare con Clerk dal tuo store WooCommerce.

• Strip/Trim Split Attributes: Quando Strip è deselezionato, tutti gli spazi all’interno delle stringhe vengono rimossi (es. ’ Option 1’ = ‘Option1’). Quando Trim è selezionato, vengono rimossi solo gli spazi iniziali e finali, mantenendo quelli interni (es. ‘Option 1’ = ‘Option 1’).

• Additional Fields Raw: Inserisci qui eventuali attributi che hai già aggiunto a Additional Fields, per importarli così come sono, impedendo che le virgole li suddividano in liste durante l’importazione.

Sincronizzazione dati: pagine #

In questa sezione, puoi personalizzare come i dati delle Pagine vengono sincronizzati con Clerk. Di seguito una spiegazione di ogni opzione:

• Use Real-Time Updates (Pages): per sincronizzare le tue pagine su Clerk in tempo reale ad ogni modifica su WooCommerce.

• Include Pages: Se abilitato, Clerk importerà tutte le pagine incluse in WooCommerce > Pages > All Pages.

• Page Additional Fields: Gli attributi aggiunti qui vengono importati per ciascuna pagina.

• Page Additional Types: Sincronizza anche ulteriori tipi di pagina, incluse quelle personalizzate. Inserisci una lista separata da virgole per aggiungere più tipi.

Sincronizzazione dati: clienti #

In questa sezione puoi personalizzare come i dati dei Clienti vengono sincronizzati con Clerk. Di seguito una spiegazione di ogni opzione:

• Include Customers: Se abilitato, importerà i Clienti su Clerk.

• Collect Basket: Abilitando questa opzione Clerk potrà raccogliere informazioni sui prodotti aggiunti al carrello. Ad esempio, attiva questa opzione se utilizzi il trigger Abandoned Basket.

• Collect Emails: Abilitando questa opzione Clerk potrà raccogliere e importare gli indirizzi Email dei Clienti da WooCommerce.

• Collect Emails Signup Message: Scrivendo un testo qui, aggiungerai una checkbox al checkout dove iscrivere l’email su my.clerk.io. Collect Emails deve essere abilitato per usare questa funzione. Se lasciato vuoto, la checkbox non sarà attiva.

• Extra Customers Fields: Lista separata da virgole degli attributi aggiuntivi dei dati Cliente da includere durante la sincronizzazione.

Sincronizzazione dati: ordini #

C’è solo un’opzione, Disable Order Synchronization, che disabilita l’invio degli ordini a Clerk durante la sincronizzazione giornaliera, se attiva.

Clerk continuerà comunque a raccoglierli in tempo reale dai visitatori.

Impostazioni Live search #

In questa sezione puoi personalizzare e attivare la Live Search. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita la tua Clerk Live Search.

• Include Suggestions/ Categories / Pages: Ti permette di controllare se Clerk deve trovare Suggestions, Categories o Pages corrispondenti da mostrare nella Live Search.

• Number of Suggestions / Categories / Pages: Ti consente di decidere quante corrispondenze restituire per ciascun tipo.

• Pages type: Seleziona quale tipo di risultato pagine visualizzare nel dropdown, es. Blog Posts, CMS Pages o Tutte.

• Dropdown Positioning: Scegli la posizione dei risultati a tendina della Live Search.

• Live Search Input Selector: Inserisci il input selector, ovvero la classe o l’ID per il campo input usato per la ricerca.

• Live Search Form Selector: Inserisci il form selector, ovvero la classe o l’ID per il form che invia le richieste di ricerca.

• Content: Inserisci il nome dei Live Search Elements. È riportato nel Element embed code come data template name, data-template= YOUR-CONTENT-NAME. Di solito “live-search”, ad esempio:

<span class="clerk" 
  data-template="@live-search"  
  data-instant-search="INSERT_SEARCH_INPUT_CSS_SELECTOR_HERE" 
  data-instant-search-suggestions="6" 
  data-instant-search-categories="6" 
  data-instant-search-pages="6" 
  data-instant-search-positioning="right">
 </span>

Impostazioni Search #

In questa sezione puoi personalizzare e attivare la Search Page. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita la tua Clerk Search Page.

• Search Page: Seleziona la pagina CMS da utilizzare come destinazione per la Clerk Search.

• Include Categories / Pages: Ti permette di controllare se Clerk deve trovare Categories o Pages corrispondenti da mostrare nella Search Page.

• Number of Categories / Pages: Ti consente di decidere quante corrispondenze restituire per ciascun tipo.

• Pages type: Seleziona quale tipo di risultato pagine visualizzare nel dropdown, es. Blog Posts, CMS Pages o Tutte.

• Content: Inserisci il nome del tuo Search Page Content dal Content embed code su my.clerk.io. Di solito “search-page”.

• No results text: Inserisci qui il testo da visualizzare nella Search Page se una ricerca non restituisce risultati.

• Load more button text: Inserisci il testo per il pulsante “Carica altri”.

Navigazione a faccette #

• Enabled: Abilita le Facets di Clerk in Search Page.

• Add Custom Attribute: Inserisci qui il nome di un attributo che desideri includere nelle faccette, quindi clicca su “Aggiungi”.

• Facet Attributes: Una volta aggiunto, l’attributo appare in questa sezione. Qui puoi impostare il suo display title, definirne la posizione nella lista delle faccette e selezionare la casella Show per includerlo tra le faccette.

• Design: Inserisci l’ID del design delle faccette. Puoi trovarlo su my.clerk.io > Search > Design.

Impostazioni Powerstep #

In questa sezione puoi personalizzare e attivare il Powerstep dopo che un cliente ha aggiunto un prodotto al carrello. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita Clerk Powerstep.

• Powerstep Type: Scegli la tipologia di Powerstep che vuoi abilitare dal menu a tendina, ad esempio “page” o “popup”.

• Powerstep Page: Seleziona la pagina CMS da usare come destinazione per Clerk Powerstep.

• Contents: Inserisci il nome del tuo Power Step Content dal Content embed code su my.clerk.io.

• Filter Duplicates: Attivando questa opzione ti assicuri che ogni banner visualizzi solo prodotti unici.

• Enable Custom Texts: Quando abilitato, ti consente di aggiungere testi personalizzati su Powerstep.

• Back Button: Inserisci il testo desiderato da visualizzare sul pulsante Indietro, che consente agli utenti di tornare alla pagina precedente.

• Cart Button: Inserisci un testo per il pulsante che reindirizza alla pagina carrello.

• Product Title: Inserisci un messaggio di testo sul titolo del Powerstep.

• Keep Add To Cart Params: Abilitando questa opzione, i parametri della query relativi all’aggiunta degli articoli al carrello verranno mantenuti durante il reindirizzamento alla pagina Powerstep, facilitando la conservazione dei dettagli del prodotto selezionato durante il processo.

Impostazioni Exit intent #

In questa sezione puoi personalizzare e attivare il Exit Intent.

Un Exit Intent è un tipo di popup che compare quando un utente sta per lasciare il sito web. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita il contenuto Clerk Exit Intent selezionando questa casella.

• Content: Inserisci il nome del contenuto Exit Intent che hai creato per il tuo negozio. Di solito “exit-content”.

Categoria, prodotto, carrello #

In questa sezione puoi personalizzare e attivare le Recommendations per le pagine Categoria, Prodotto e Carrello. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita gli elementi Recommendations Clerk per Categoria, Prodotto e Carrello.

• Content: Inserisci il nome del contenuto che hai creato su my.clerk.io per il tuo negozio. Solitamente è già compilato.

• Filter Duplicates: Attivando questa opzione ti assicuri che ogni banner visualizzi solo prodotti unici.

• Defer Injection: Solo per le Product Settings, attivando questa opzione le Recommendations verranno inserite nella pagina prodotto solo dopo che il contenuto della pagina è stato già renderizzato.

• Category / Product / Cart ID Shortcode: Questi shortcode ti permettono di inserire facilmente i Clerk embedcodes se desideri personalizzare la loro posizione con editor come WPBakery ed Elementor. Ad esempio:

<span class="clerk"
   data-template="product-page-alternatives"
   data-products="[[clerk_product_id]]">
</span>

Script aggiuntivi #

In questa sezione puoi aggiungere e attivare eventuali script JS aggiuntivi. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita lo script aggiuntivo inserito nel box seguente.

• JS Code: Se abilitato, eseguirà lo script aggiunto in questa area insieme a Clerk.js.

Logging #

In questa sezione puoi abilitare e personalizzare i Log relativi ad errori e/o warning di Clerk. Di seguito una spiegazione di ogni opzione:

• Enabled: Abilita la funzione di Logging.

• Log level: Qui puoi selezionare il tipo di log desiderato.

  • Only Errors: Registra tutti gli errori che impediscono il corretto funzionamento del modulo.

  • Error + Warn: Registra anche i warning che non causano l’interruzione del modulo, ma che potrebbero essere necessari da correggere.

  • Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Non abilitare questa modalità su uno shop live perché rallenterà il sito.

• Log to: Tutto verrà registrato su My.Clerk.io in Developers > Logs.

Aggiornamento #

Best Practice: Fai sempre il backup dei file modificati prima di aggiornare, per assicurarti di poter ripristinare le versioni precedenti se necessario.

Se utilizzi una versione precedente alla 2.0.0, l’aggiornamento interromperà i tuoi Designs, dato che sarà utilizzato Clerk.js 2.

Se usi una versione più obsoleta, segui questa guida invece.

L’aggiornamento del Plugin può essere eseguito direttamente dal backend di WooCommerce, seguendo questi passaggi:

1. Vai su Plugin > Installed Plugins e cerca Clerk.

2. Clicca su Update Now:

Se hai già la versione più recente, questo pulsante mostrerà semplicemente Active.