Module

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

Impostazioni di sincronizzazione dati #

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

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

Impostazioni del modulo #

Se stai usando v 6.7.0 o una versione successiva dell’estensione (puoi controllare l’ultima versione qui), potrai accedere alle seguenti impostazioni in due modi dopo aver aggiunto le tue Public e Private Keys al modulo:

• Tramite il backend Prestashop in Modules > Clerk

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

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

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

Basta cliccare su “Edit” su qualsiasi impostazione per visualizzare le opzioni disponibili:

Panoramica del modulo #

Nel tuo account admin di 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 chiavi API, lingua del negozio e URL di importazione dati in “General”.

Sincronizzazione #

Imposta le tue principali impostazioni di sincronizzazione dati nella sezione successiva.

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

• Include Pages invierà blog e articoli a Clerk affinché possano essere mostrati in Search, e mostrare Recommendations sulle loro pagine.

• Additional Fields / For Pages ti permette di aggiungere attributi personalizzati ai tuoi prodotti e pagine, che poi possono essere utilizzati nella search e visivamente 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 consente di recuperare lo stato di qualsiasi email subscriber da Prestashop, da utilizzare con Auto-Email.

• Collect Baskets traccerà ciò che un utente ha nel carrello, da utilizzare con le email di carrello abbandonato.

• Disable Order Synchronisation ti consente di interrompere l’importazione di nuovi ordini. Spesso questi ordini saranno tracciati dal live sales-tracking, motivo per cui non devono essere più importati.

• Include Variant References ti consente di importare attributi basati sulle varianti disponibili per i prodotti. Per impostazione predefinita, importeremo quindi liste 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 passando a “Enabled”.

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

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

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

• Template dovrebbe corrispondere al nome fornito nel codice di embed del tuo Search Page Content in my.clerk.io. Solitamente è " search-page".

Navigazione a faccette #

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

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

• Add facet attributes ti permette di scegliere quali attributi consentire agli utenti di filtrare. Questi devono coincidere con attributi che hai sincronizzato con Clerk. Controlla quali attributi sono disponibili in my.clerk.io > Data > Products.

• Facet Attributes ti consente di personalizzare ogni faccetta con il Title come deve essere visualizzato agli utenti nella tua search page, nonché la sua position, che è l’ordine in cui vengono mostrate in base al numero aggiunto.

Personalizzazione delle faccette #

Clerk ti permette di stilizzare le faccette della tua search page direttamente dal design e puoi mostrarlo facendo riferimento al design ID.

Il design ID si trova nel back-end Clerk, sulla colonna di sinistra di ciascun design sulla pagina panoramica dei design e in basso a sinistra appena entri nel design per modificarlo.

Nota: Ora puoi richiamare i dati per categorie e pagine nella tua Search page nello stesso modo in cui lo faresti nella Live search, dandoti una gamma ancora più ampia di informazioni con cui coinvolgere i tuoi clienti. Per maggiori informazioni puoi controllare 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 durante la ricerca.

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

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

• Dropdown Positioning controlla in quale direzione sarà mostrata la Instant Search, rispetto al campo di ricerca. Per esempio, se hai un campo di ricerca a sinistra del tuo webshop, scegli left.

• Template dovrebbe corrispondere al nome fornito nel codice di embed del tuo Search Page Content in my.clerk.io. Solitamente è " search-page".

• Search field input selector deve essere 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 è usato anch’esso per i campi ricerca personalizzati e permette a Clerk di cambiare il redirect in modo che corrisponda alla search page aggiunta.

Powerstep #

Abilita il powerstep attivando Enabled in alto.

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

• Powerstep Type ti permette di scegliere tra 3 opzioni:

  • Page reindirizza a una pagina centrale dedicata aggiunta dal nostro modulo.

  • Popup mostra un nuovo popup aggiunto dal nostro modulo.

  • Embedded aggiunge recommendations al popup aggiungi-al-carrello già esistente di Prestashop.

• Templates ti permette di decidere quali Recommendations mostrare nel powerstep aggiungendo i loro Element IDs. Questo è precompilato con le migliori opzioni.

Recommendations #

Queste impostazioni ti permettono di aggiungere recommendations a diverse pagine del tuo webshop: Pagine Categoria, Pagine Prodotto, il Carrello e un Popup Exit Intent.

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

Logging #

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

Questo è molto utile 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 nella 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

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

• Error + Warn: Registra anche eventuali avvisi che non fanno smettere di funzionare il modulo, ma che potrebbero essere comunque da risolvere.

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

Logging To

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

• my.clerk.io: Registra tutto in Developers->Logs nel backend di my.clerk.io.

Aggiornamento #

Se stai utilizzando una versione precedente alla 5.0.0, l’aggiornamento interromperà i tuoi Designs, poiché verrà usato Clerk.js 2. Se usi una versione precedente, segui questa guida.

Importante: Ricordati di fare un backup di tutti i file modificati, poiché verranno sovrascritti.

Scarica subito 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 su Add New Module.

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

3. Clicca su Upload this module.

PrestaShop mostrerà ora un messaggio di conferma, confermando che il tuo modulo è stato aggiornato correttamente.

Fatto! Ora stai utilizzando la versione più recente del modulo Prestashop.

Disinstallazione #

Accedi al tuo portale admin di Prestashop e seleziona “Modules and Services” dal menu laterale sinistro:

Quindi, trova “Clerk” nella tua lista di moduli e seleziona “Deaktiver” per disabilitare il plugin Clerk:

Una volta disabilitato, Clerk dovrebbe essere rimosso dal tuo store Prestashop.