Module
Impostazioni di Sincronizzazione 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’orario in cui i dati del tuo webshop vengono sincronizzati con Clerk.io (impostazione predefinita: “Quando necessario”).

Impostazioni del Modulo #
Se stai utilizzando la v 6.7.0 o una versione successiva dell’estensione (puoi controllare la versione più recente 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 vengano apportate le modifiche, l’estensione si sincronizzerà con qualsiasi cambiamento fatto su my.clerk.io e viceversa.
In my.clerk.io potrai anche vedere la versione corrente dell’estensione, la tua piattaforma e la versione PHP.

Clicca semplicemente su “Edit” su qualsiasi impostazione per vedere le opzioni disponibili:

Panoramica Modulo Prestashop #
Nel tuo account admin di Prestashop, scegli Clerk dai tuoi “Modules” per visualizzare e modificare le opzioni del modulo Clerk.io.
Imposta la lingua predefinita del modulo in “Shop & Language” e accedi alle tue chiavi API, lingua del negozio e URL di importazione dati in “General”.

Sincronizzazione #
Imposta le principali opzioni di sincronizzazione dati nella sezione seguente.
Use Real-time Updates aggiornerà i dati del prodotto in Clerk non appena vengono modificati in Prestashop.
Include Pages invierà i tuoi blog & articoli a Clerk per poterli mostrare in Search e avere Recommendations sulle loro pagine.
Additional Fields / For Pages ti permette di aggiungere attributi personalizzati ai tuoi prodotti e pagine che poi potranno essere utilizzati nella ricerca 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 per raccomandazioni personalizzate basate sugli ordini.
Sync Subscribers ti consente di recuperare lo stato di qualsiasi iscritto e-mail da Prestashop, per l’uso con Auto-Email.
Collect Baskets traccerà ciò che un utente ha nel carrello, per l’uso con le email di Abandon Cart.
Disable Order Synchronisation ti permette di interrompere l’importazione di nuovi ordini in arrivo. Spesso questi ordini saranno tracciati dal live sales-tracking, per questo motivo non devono più essere importati.
Include Variant References permette di importare attributi basati sulle varianti disponibili per i prodotti. Per impostazione predefinita, importeremo quindi elenco di ID, nomi, prezzi e SKU delle varianti.
Include Product Features importerà gli attributi speciali chiamati Product Features da Prestashop

Search #
Abilita la tua Search Page attivando su “Enabled”.
- Include Categories farà sì che Clerk restituisca categorie corrispondenti durante la ricerca.
- Number of Categories / Pages ti permette di decidere quanti potenziali risultati restituire per ogni tipo.
- Pages Type ti permette di controllare un tipo specifico di pagine da importare. Ad esempio solo articoli o pagine di servizio / CMS. Di default vengono importate tutte le pagine.
- Template deve corrispondere al nome fornito nel codice embed del tuo Search Page Content in my.clerk.io. Questo solitamente è “search-page”.

Navigazione Facettata #
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. Vedi “Personalizzazione dei Facet nella tua Search Page” qui sotto.
- Add facet attributes ti consente di scegliere quali attributi permettere agli utenti di filtrare. Questi devono corrispondere agli attributi che hai sincronizzato con Clerk. Controlla quali attributi sono disponibili in my.clerk.io > Data > Products
- Facet Attributes ti permette di personalizzare ciascun facettato con il Title come deve essere mostrato agli utenti sulla tua pagina di ricerca, nonché la sua position, che è l’ordine in cui vengono mostrati in base al numero aggiunto.

Personalizzazione dei Facet nella tua Search Page
Clerk.io ti permette di stilizzare i facet della tua search page dall’interno del design e puoi visualizzarlo facendovi riferimento tramite il campo design ID.
Il design ID si trova nel Clerk.io backend, nella colonna più a sinistra di ogni design nella pagina panoramica dei design e in basso a sinistra una volta entrati nell’editor del design.

Nota: Ora puoi richiamare i dati di categorie e pagine nella tua Search page nello stesso modo in cui faresti nella tua Live search, offrendoti un ventaglio più ampio di informazioni con cui ingaggiare 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 categorie corrispondenti durante la ricerca.
- Number of Suggestions / Categories / Pages ti permette di decidere quanti potenziali risultati restituire per ogni tipo.
- Pages Type ti permette di controllare un tipo specifico di pagine da importare. Ad esempio solo articoli o pagine di servizio / CMS. Di default vengono importate tutte le pagine.
- Dropdown Positioning controlla la direzione in cui verrà mostrata l’Instant Search, rispetto al campo di ricerca. Ad esempio, se hai un campo di ricerca sulla sinistra del webshop, scegli left.
- Template deve corrispondere al nome fornito nel codice embed del tuo Search Page Content in my.clerk.io. Solitamente è “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 l’Instant Search al campo, e visualizzarla quando gli utenti cercano.
- Search field form selector è anch’esso usato per i campi di ricerca personalizzati, e consente a Clerk di cambiare il redirect per corrispondere alla search page che aggiungiamo.

Powerstep #
Abilita il tuo powerstep attivando Enabled in alto. Il powerstep si attiverà quando un utente aggiunge un prodotto al carrello.
Powerstep Type ti permette di scegliere tra 3 opzioni:
- Page reindirizzerà a una pagina intermedia dedicata aggiunta dal nostro modulo.
- Popup mostrerà un nuovo popup aggiunto dal nostro modulo.
- Embedded aggiungerà recommendations al popup add-to-cart esistente di Prestashop.
Templates ti permette di decidere quali Recommendations mostrare nel tuo powerstep inserendo i loro Slider IDs. Questo campo è precompilato con le migliori opzioni

Categories, Products, Cart, Exit Intent #
Queste impostazioni ti permettono di aggiungere recommendations a diverse pagine del tuo webshop: Pagine di Categoria, Pagine Prodotto, il Carrello e un Exit Intent Popup.
- Templates ti permette di decidere quali Recommendations visualizzare nelle varie pagine aggiungendo i loro Slider IDs. Questi sono precompilati con le migliori opzioni.


Logging #
Il logging può essere usato per mostrare eventuali 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 come segue:
1. Accedi al Prestashop backend 2. Vai su Modules and Services -> Modules and Services 3. Cerca clerk per trovare il modulo e clicca su Configure:

4. Scorri in basso nella pagina del modulo Clerk.io 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:
Livello di Logging
Solo Errori: Registra tutti gli errori che impediscono al modulo di funzionare correttamente
Error + Warn: Registra anche gli avvisi che non causano l’arresto del modulo, ma che potrebbero comunque dover essere risolti.
Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Questo non dovrebbe essere abilitato su un webshop live poiché rallenterà il sito.
Logging Su
File: Salverà il log su un file nel server di 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, l’aggiornamento interromperà i tuoi Designs, poiché verrà usato Clerk.js 2. Se usi una versione più vecchia, segui questa guida invece.
Importante: Ricorda di effettuare backup di eventuali file modificati, poiché verranno sovrascritti.
Inizia scaricando la versione più recente da questo link:
https://github.com/clerkio/clerk-prestashop/releases/latest

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

In questa pagina, procedi come segue:
Clicca su Add New Module
Clicca su Choose a file e carica il file clerk.zip appena scaricato
Clicca su Upload this module

PrestaShop ora mostrerà un messaggio di successo, confermando che il tuo modulo è stato aggiornato.
Questo è tutto! Ora stai usando l’ultima versione del modulo Prestashop.
Disinstallazione #
Accedi al tuo portale di amministrazione Prestashop e seleziona “Modules and Services” dal menu laterale sinistro:

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

Una volta disabilitato, Clerk.io dovrebbe essere rimosso dal tuo negozio Prestashop.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.