Module

Configura le impostazioni del tuo modulo PrestaShop, gestisci le opzioni di sincronizzazione dei dati e personalizza le funzionalità di search, recommendations e logging.

Impostazioni di sincronizzazione dei dati #

Vai su Data > Configuration in my.clerk.io per visualizzare le opzioni di sincronizzazione Prestashop.

• Imposta l’URL del tuo negozio, la dimensione della pagina dei dati sincronizzati e l’ora del giorno in cui i dati del tuo webshop vengono sincronizzati con Clerk (predefinito: “Quando necessario”).

Impostazioni del modulo #

Se stai utilizzando v 6.7.0 o una versione successiva dell’estensione (puoi controllare la versione più recente qui), potrai accedere alle impostazioni sottostanti in due modi dopo aver aggiunto le tue Public e Private Keys al modulo:

• Dal backend Prestashop in Modules > Clerk

• Da my.clerk.io, sotto Developers > Extensions

Non importa dove si apportano le modifiche, poiché l’estensione si sincronizzerà con qualsiasi modifica apportata in my.clerk.io e viceversa.

In my.clerk.io potrai anche vedere la versione corrente dell’estensione, la tua piattaforma e la versione di PHP.

Semplicemente fai clic su “Edit” su qualsiasi impostazione per vedere le opzioni disponibili:

Panoramica del modulo #

Nel tuo account admin Prestashop, scegli Clerk dai tuoi “Modules” per visualizzare e modificare le opzioni del modulo Clerk.

Imposta la lingua predefinita per il modulo in " Shop & Language", e accedi alle tue API keys, alla lingua del negozio e all’URL di importazione dati sotto " General".

Sincronizzazione #

Imposta le tue principali impostazioni di sincronizzazione dei dati nella sezione sottostante.

• Use Real-time Updates aggiornerà i dati dei prodotti in Clerk non appena vengono modificati in Prestashop.

• Include Pages invierà i tuoi blog & articoli a Clerk così potranno essere mostrati in Search e avere Recommendations sulle loro pagine.

• Additional Fields / For Pages ti permette di aggiungere attributi personalizzati ai tuoi prodotti e pagine che potranno poi essere usati in search e visualmente in un Design.

• Include Out Of Stock Products importerà i prodotti in Clerk indipendentemente dallo stato delle scorte.

• Collect Emails includerà gli indirizzi email negli ordini. Questo è necessario per Audience e recommendations personalizzate basate sugli ordini.

• Sync Subscribers ti permette di recuperare lo stato di qualsiasi iscritto email da Prestashop, per l’uso con Auto-Email.

• Collect Baskets traccerà cosa un utente ha nel suo carrello, per l’uso con le email di Abandon Cart.

• Disable Order Synchronisation ti permette di fermare l’importazione dei nuovi ordini in arrivo. Spesso questi ordini saranno tracciati dal live sales-tracking, motivo per cui non è necessario importarli di nuovo.

• Include Variant References ti permette di importare attributi basati sulle varianti disponibili per i prodotti. Di default, importeremo list di ID variante, nomi, prezzi e SKU.

• Include Product Features importerà gli attributi speciali chiamati Product Features from Prestashop.

Search #

Abilita la tua Search Page attivando “Enabled”.

• Include Categories farà sì che Clerk restituisca le categorie corrispondenti durante la ricerca.

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

• Pages Type ti permette di controllare uno specifico tipo di pagine da importare. Ad esempio, solo articoli o pagine di servizio / CMS. Di default, tutte le pagine vengono importate.

• Template deve corrispondere al nome fornito nel codice embed del tuo Search Page Element in my.clerk.io. Di solito è " search-page".

Navigazione a faccette #

Attiva questa opzione su “Enabled” per aggiungere dei filtri alla tua Search Page.

• Design ti permette di scegliere un design custom opzionale per le tue faccette. Vedi “Personalizzazione delle faccette della tua Search Page” qui sotto.

• Add facet attributes ti permette di scegliere quali attributes consentire agli utenti di filtrare. Devono corrispondere agli attributi sincronizzati con Clerk. Verifica quali attributi sono disponibili in my.clerk.io > Data > Products.

• Facet Attributes ti permette di personalizzare ciascuna faccetta con il Title come deve essere visualizzato sulla tua search page, e la sua position, cioè l’ordine in cui vengono visualizzati in base al numero inserito.

Personalizzazione faccette #

Clerk ti permette di stilizzare le faccette della search page all’interno del design; puoi mostrarlo facendo riferimento al campo design ID.

Il design ID si trova nel backend di Clerk, nella colonna più a sinistra di ciascun design nella pagina panoramica dei design e in basso a sinistra della pagina una volta che entri nel design da modificare.

Nota: Ora puoi richiamare i dati per categorie e pagine nella tua Search page nello stesso modo in cui li chiameresti nella Live search, offrendoti una gamma di informazioni più ampia per coinvolgere i tuoi clienti. Per maggiori informazioni puoi consultare qui.

Live search #

Abilita Clerk Live Search in questa sezione attivando “Enabled” nella prima opzione.

• Include Categories farà sì che Clerk restituisca le categorie corrispondenti quando effettui una ricerca.

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

• Pages Type ti permette di controllare uno specifico tipo di pagine da importare. Ad esempio, solo articoli o pagine di servizio / CMS. Di default, tutte le pagine vengono importate.

• Dropdown Positioning controlla in quale direzione verrà mostrata la Instant Search rispetto al campo di ricerca. Ad esempio, se hai un campo di ricerca sul lato sinistro del tuo webshop, scegli left.

• Template deve corrispondere al nome fornito nel codice embed del tuo Search Page Element in my.clerk.io. Di solito è " search-page".

• Search field input selector va usato se hai un campo di ricerca personalizzato. Aggiungi qui la classe o l’ID del tag input per collegare la Instant Search al campo e mostrarla quando gli utenti cercano.

• Search field form selector viene utilizzato anche per i campi di ricerca personalizzati e consente a Clerk di modificare il redirect per adattarsi alla search page aggiunta.

Powerstep #

Abilita il tuo powerstep attivando Enabled in alto.

Il powerstep verrà attivato quando un utente aggiunge un prodotto al carrello.

• Powerstep Type ti permette di scegliere tra 3 opzioni:

  • Page reindirizzerà a una pagina centrale creata dal nostro modulo.

  • Popup mostrerà un nuovo popup creato dal nostro modulo.

  • Embedded aggiungerà recommendations al popup di aggiunta al carrello esistente di Prestashop.

• Templates ti permette di decidere quali Recommendations mostrare nel powerstep aggiungendo i loro Element IDs. Sono già precompilati con le migliori opzioni.

Recommendations #

Queste impostazioni ti permettono di aggiungere recommendations alle diverse pagine del tuo webshop: pagine di categoria, pagine prodotto, carrello e popup di Exit Intent.

• Templates ti permette di decidere quali Recommendations mostrare nelle varie pagine aggiungendo i loro Element IDs. Sono già precompilati con le migliori opzioni.

Logging #

Il logging può essere utilizzato per mostrare errori e/o avvisi che si verificano in Prestashop 1.6.

Questo è di grande aiuto per il debug dei problemi.

Per abilitare il Logging, procedi così:

1. Accedi al tuo backend Prestashop.

2. Vai su Modules and Services -> Modules and Services.

3. Cerca clerk per trovare il modulo e clicca su Configure:

4. Scorri verso il basso sulla pagina del modulo Clerk per trovare le impostazioni di logging.

5. Imposta Enabled su Yes:

6. Scorri fino in fondo alla pagina e clicca su Save.

Le impostazioni di Logging includono:

Logging Level

• Solo Errori: Registrerà qualsiasi errore che impedisce il corretto funzionamento del modulo.

• Error + Warn: Registra anche gli avvisi che non causano l’arresto del modulo, ma che potrebbero essere necessari da correggere.

• Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Non dovrebbe essere abilitato su un webshop live perché rallenta il sito.

Logging To

• File: Salverà il registro in un file sul server Prestashop.

• my.clerk.io: Registrerà tutto su Developers->Logs nel backend di my.clerk.io.

Aggiornamento #

Se stai usando una versione precedente alla 5.0.0, aggiornando si interromperanno i tuoi Designs, dato che verrà utilizzato Clerk.js 2. Se stai utilizzando una versione più vecchia, segui questa guida invece.

Importante: Ricorda di fare il backup di tutti i file modificati, poiché verranno sovrascritti.

Inizia scaricando l’ultima versione da questo link:

https://github.com/clerkio/clerk-prestashop/releases/latest

Quindi accedi al tuo Prestashop admin e vai su Modules And Services -> Modules And Services

In questa pagina, procedi così:

1. Clicca Add New Module.

2. Clicca Choose a file e carica il file clerk.zip appena scaricato.

3. Clicca Upload this module.

PrestaShop ora visualizzerà un messaggio di successo che conferma che il modulo è stato aggiornato.

Tutto qui! Ora stai utilizzando l’ultima versione del modulo Prestashop.

Disinstallazione #

Accedi al tuo portale admin Prestashop e seleziona “Modules and Services” dal menu a sinistra:

Successivamente, trova “Clerk” nell’elenco dei moduli e seleziona “Deaktiver” per disabilitare il plugin Clerk:

Una volta disattivato, Clerk dovrebbe essere rimosso dal tuo negozio Prestashop.