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.

Una volta 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 attualmente installata del plugin Clerk. Qui puoi trovare l’ ultima release.

• Public Key: Inserisci la tua Public key, che trovi in my.clerk.io in Developers > API keys.

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

• Language: Scegli la lingua corretta del dominio.

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

• Use Legacy Authentication: Abilita questa opzione quando utilizzi le API key standard di WooCommerce (consumer key e consumer secret). Questo è richiesto nella maggior parte delle configurazioni per autenticare correttamente le richieste di sincronizzazione dei dati.

Sincronizzazione dati: prodotti #

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

• Use Real-Time Updates: Sincronizza i tuoi dati con Clerk in tempo reale appena vengono effettuate modifiche in WooCommerce.

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

• Image Size: Scegli la dimensione dell’immagine importata in Clerk. In caso di dubbio, scegli large, poi gestisci la dimensione direttamente dentro Clerk Design.

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

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

• Additional Fields Raw: Inserisci qualsiasi attributo che hai già aggiunto in Additional Fields, per importare questi valori così come sono, evitando 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 ciascuna opzione:

• Use Real-Time Updates (Pages): per sincronizzare in tempo reale le pagine con Clerk non appena vengono effettuate modifiche in WooCommerce.

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

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

• Page Additional Types: Sincronizza tipi di pagina aggiuntivi, compresi quelli personalizzati. Inserisci una lista separata da virgole per aggiungere tipi multipli.

Sincronizzazione dati: clienti #

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

• Include Customers: Abilitando questa opzione, importerai i Customers su Clerk.

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

• Collect Emails: Abilitando questa opzione, permetti a Clerk di raccogliere e importare gli indirizzi Email dei Customers da WooCommerce.

• Collect Emails Signup Message: Scrivendo un testo qui, avrai una checkbox al checkout tramite cui iscriveremo l’Email in my.clerk.io. Collect Emails deve essere attivo per utilizzare questa funzionalità. Se lasciato vuoto, la checkbox non sarà attiva.

• Extra Customers Fields: Una lista separata da virgole di attributi aggiuntivi per i dati dei Customers da includere durante la sincronizzazione.

Sincronizzazione dati: ordini #

C’è solo un’opzione, Disable Order Synchronization, che disattiva l’invio degli ordini a Clerk durante la sincronizzazione giornaliera quando è attivo.

Clerk continuerà comunque a raccogliere gli ordini in tempo reale dai visitatori.

Impostazioni live search #

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

• Enabled: Abilita la tua Clerk Live Search.

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

• Number of Suggestions / Categories / Pages: Ti permette di decidere quante possibili corrispondenze restituire per ogni tipo.

• Pages type: Seleziona quale tipo di pagine mostrare nel menu a tendina, es. Blog Posts, CMS Pages o All.

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

• Live Search Input Selector: Inserisci il input selector che è una classe o ID per il campo di input utilizzato per cercare.

• Live Search Form Selector: Inserisci il form selector che è una classe o ID per il form che invia le richieste di ricerca.

• Element: Inserisci il nome dei tuoi Live Search Elements. È indicato all’interno di Element embed code come data template name, data-template= YOUR-ELEMENT-NAME. Di solito “live-search”, es.:

<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 ciascuna opzione:

• Enabled: Abilita la tua Clerk Search Page.

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

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

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

• Pages type: Seleziona quale tipo di pagine mostrare nel dropdown, es. Blog Posts, CMS Pages o All.

• Element: Inserisci il nome dello Search Page Element dal codice embed Element in my.clerk.io. Di solito “search-page”.

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

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

Navigazione a filtri (faceted) #

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

• Add Custom Attribute: Digita qui il nome dell’attributo che vuoi includere nei tuoi facets, poi clicca “Add”.

• Facet Attributes: Una volta aggiunto, l’attributo apparirà in questa sezione. Qui puoi impostarne il display title, definirne la posizione nella lista facet e selezionare la casella Show per includerlo nei tuoi facets.

• Design: Inserisci l’ID del design del facet. Può essere trovato in 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 ciascuna opzione:

• Enabled: Abilita la Clerk Powerstep.

• Powerstep Type: Scegli il tipo di Powerstep che preferisci abilitare dal menu a discesa, come “page” o “popup”.

• Powerstep Page: Seleziona la pagina CMS da utilizzare come target per la Clerk Powerstep.

• Contents: Inserisci il nome del tuo Power Step Element dal codice embed Element in my.clerk.io.

• Filter Duplicates: Attivando questa opzione, ogni banner mostrerà prodotti completamente unici.

• Enable Custom Texts: Se abilitato, permette di aggiungere testi personalizzati alla Powerstep.

• Back Button: Inserisci il testo che vuoi visualizzare sul pulsante Indietro, che permette 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 testuale nel titolo della Powerstep.

• Keep Add To Cart Params: Abilitando questa opzione, i parametri di query relativi all’aggiunta di articoli al carrello vengono mantenuti quando si viene reindirizzati alla pagina Powerstep. Questo aiuta a mantenere i 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 appare quando un utente sta per lasciare un sito web. Di seguito una spiegazione di ciascuna opzione:

• Enabled: Abilita l’elemento Clerk Exit Intent selezionando questa casella.

• Element: Inserisci il nome dell’Exit Intent Element che hai creato per il tuo store. Di solito “exit-content”.

Categoria, prodotto, carrello #

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

• Enabled: Abilita gli elementi Clerk Category, Product e Cart Recommendations.

• Element: Inserisci il nome dell’Element che hai creato in my.clerk.io per il tuo store. Di solito è già compilato.

• Filter Duplicates: Attivando questa opzione, ogni banner mostrerà prodotti completamente unici.

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

• Category / Product / Cart ID Shortcode: Questi shortcode ti permettono di inserire facilmente i Clerk embedcodes se vuoi personalizzarne la 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 ciascuna opzione:

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

• JS Code: Se abilitato, eseguirà lo script inserito in questo box insieme a Clerk.js.

Logging #

In questa sezione puoi abilitare e personalizzare i Logs relativi agli errori e/o avvisi di Clerk. Di seguito una spiegazione di ciascuna opzione:

• Enabled: Abilita la funzionalità di Logging.

• Log level: Qui puoi selezionare la tipologia di logging desiderata.

  • Only Errors: Registra solo gli errori che impediscono al modulo di funzionare correttamente.

  • Error + Warn: Registra anche gli avvisi che non impediscono al modulo di funzionare, ma potrebbe essere comunque necessario risolverli.

  • Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Non dovrebbe essere abilitato su un sito live poiché riduce la velocità del sito.

• Log to: Questo registrerà tutto su My.Clerk.io in Developers > Logs.

Aggiornamento #

Best Practice: Crea sempre dei backup dei file modificati prima di ogni aggiornamento per assicurarti di poter ripristinare versioni precedenti se necessario.

Se stai utilizzando una versione precedente alla 2.0.0, l’aggiornamento interromperà i tuoi Designs, poiché verrà utilizzato Clerk.js 2.

Se stai utilizzando una versione più vecchia, segui questa guida.

L’aggiornamento del Plugin può essere effettuato 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à l’ultima versione, questo pulsante dirà semplicemente Active.