Woocommerce

Plugin

Spiegazioni dettagliate delle impostazioni del plugin Clerk WooCommerce

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

Clerk WooCommerce plugin

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 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 usato da Clerk per sincronizzare i dati. Aggiungilo nel tuo account my.clerk.io sotto Data > Configuration nel campo Store URL.

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

Sincronizzazione dati: prodotti #

In questa sezione puoi personalizzare il modo in cui i dati dei Prodotti vengono sincronizzati con Clerk. Di seguito una spiegazione di ogni opzione:

  • Use Real-Time Updates: Sincronizza i tuoi dati con Clerk in tempo reale appena vengono apportate 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 dei Dati Prodotto che desideri sincronizzare su Clerk dal tuo negozio 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 all’inizio e alla fine, preservando quelli interni (es. ‘Option 1’ = ‘Option 1’).

  • Additional Fields Raw: Inserisci qualsiasi attributo tu abbia già aggiunto a Additional Fields, per importare questi valori così come sono ed evitare che le virgole li dividano in elenchi 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 con Clerk in tempo reale quando vengono apportate modifiche in WooCommerce.

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

  • Page Additional Fields: I “slug” degli attributi aggiunti qui vengono importati per ogni pagina.

  • Page Additional Types: Sincronizza ulteriori tipi di pagina, inclusi quelli personalizzati. Inserisci un elenco separato 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: Abilitando importerai i Clienti su Clerk.

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

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

  • Collect Emails Signup Message: Scrivendo un testo qui potrai avere una checkbox al checkout dove iscriveremo 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: Una 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 quando è attiva.

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

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 e mostrare nell’autocompletamento delle corrispondenze tra Suggestions, Categories o Pages.

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

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

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

  • Live Search Input Selector: Inserisci il input selector ossia una classe o ID per il campo di input usato per la ricerca.

  • 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 del tuo Live Search Elements. È indicato entro il Element embed code come data template name, data-template= YOUR-ELEMENT-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>

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 usare come destinazione per la Clerk Search.

  • Include Categories / Pages: Ti permette di controllare se Clerk deve trovare e mostrare categorie o pagine corrispondenti sulla Search Page.

  • Number of 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, ad esempio Blog Post, CMS Pages o All.

  • Element: Inserisci il nome del tuo Element Search Page dal codice di incorporamento degli Element su my.clerk.io. Di solito “search-page”.

  • No results text: Inserisci il testo che vuoi mostrare nella Search Page se una ricerca non restituisce risultati.

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

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

  • Add Custom Attribute: Inserisci qui il nome di un attributo che vuoi includere nelle Facets, poi clicca su “Add”.

  • Facet Attributes: Una volta aggiunto, l’attributo appare in questa sezione. Qui puoi impostare il display title, definirne la posizione nell’elenco facet, e selezionare la casella Show per includerlo nelle facets.

  • Design: Inserisci l’ID del design facet. Si trova 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 ogni opzione:

  • Enabled: Abilita il Powerstep Clerk.

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

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

  • Contents: Inserisci il nome del tuo Element Power Step dal codice di incorporamento degli Element su my.clerk.io.

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

  • Enable Custom Texts: Quando abilitato, permette di aggiungere testi personalizzati nella Powerstep.

  • Back Button: Inserisci il testo che vuoi mostrare sul pulsante “Indietro”, che permette agli utenti di tornare alla pagina precedente.

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

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

  • Keep Add To Cart Params: Abilitando questa opzione ti assicuri che i parametri di query relativi all’aggiunta al carrello vengano mantenuti nel redirect 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 è una tipologia di popup che appare quando l’utente sta per lasciare il sito web. Di seguito una spiegazione di ogni opzione:

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

  • Element: Inserisci il nome dell’Element 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 di Categoria, Prodotto e Carrello. Di seguito una spiegazione di ogni opzione:

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

  • Element: Inserisci il nome dell’Element che hai creato su my.clerk.io per il tuo negozio. Solitamente è già precompilato.

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

  • Defer Injection: Solo per Product Settings, abilitando 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 collocazione 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 nella seguente casella.

  • JS Code: Se abilitato, verrà eseguito lo script inserito in questa casella insieme a Clerk.js.

Logging #

In questa sezione puoi abilitare e personalizzare i Log riguardanti errori o segnalazioni di Clerk. Di seguito una spiegazione di ogni opzione:

  • Enabled: Abilita la funzione di Logging.

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

    • Only Errors: Registra qualsiasi errore che impedisce il corretto funzionamento del modulo.

    • Error + Warn: Registra anche i warning che non interrompono il funzionamento del modulo, ma che potrebbero essere necessari da correggere.

    • Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Questa opzione non dovrebbe essere abilitata su uno shop online in produzione in quanto rallenterà il sito.

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

Aggiornamento #

Best Practice: Crea sempre un backup dei file modificati prima di aggiornare, così potrai ripristinare le versioni precedenti se necessario.

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

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

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:

WooCommerce plugin update

Se possiedi già l’ultima versione, questo pulsante mostrerà semplicemente Active.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.