Prestashop

Module

Configura le impostazioni del tuo modulo PrestaShop e gestisci le opzioni di sincronizzazione dei dati
Backend in the Clerk.io backend

Configura le impostazioni del tuo modulo PrestaShop, gestisci le opzioni di sincronizzazione dei dati e personalizza le funzioni 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 dati sincronizzati e l’orario in cui i dati del tuo webshop vengono sincronizzati con Clerk (il valore 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), dopo aver aggiunto le Public e Private Keys al modulo, potrai accedere alle seguenti impostazioni in due modi:

  • Tramite il backend di Prestashop, in Modules > Clerk

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

Non importa dove effettui le modifiche, perché l’estensione si sincronizzerà con qualsiasi variazione fatta su my.clerk.io e viceversa.

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

Clicca su Edit su un’impostazione per vedere le opzioni disponibili.

Panoramica del modulo #

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

Imposta la lingua predefinita del modulo in “Shop & Language”, e accedi alle tue chiavi API, alla lingua dello store e all’URL di importazione dati in “General”.

Le restanti impostazioni generali sono:

  • Tracking Script Hook Position sceglie il hook di PrestaShop dove Clerk.io carica il proprio tracking script. Lascia quello predefinito a meno che il tuo tema non richieda un hook diverso.

  • Legacy Auth usa il vecchio metodo di autenticazione per la sincronizzazione dati. Lascia disabilitato a meno che Clerk.io Support non ti chieda di abilitarlo.

Sincronizzazione #

Imposta le principali impostazioni di sincronizzazione dati nella sezione seguente.

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

  • Include Pages invierà i tuoi blog e articoli su Clerk affinché possano essere mostrati in Search e ricevere Recommendations sulle rispettive pagine.

  • Additional Fields / For Pages permette di aggiungere attributi personalizzati a prodotti e pagine, che possono essere poi utilizzati nella search e per finalità visive in un Design.

  • Include Out Of Stock Products importerà i prodotti su Clerk indipendentemente dal loro stato di stock.

  • 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, per l’uso con Auto-Email.

  • Collect Baskets monitorerà ciò che un utente ha nel carrello, per essere usato con le email di Abandon Cart.

  • Disable Order Synchronisation ti permette di bloccare l’importazione di nuovi ordini in entrata. Spesso questi ordini vengono già tracciati dal live sales-tracking, per cui non è più necessario importarli.

  • Include Variant References ti lascia importare attributi basati sulle varianti disponibili per i prodotti. Per impostazione predefinita importeremo lists di ID variante, nomi, prezzi e SKU.

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

  • Include Product Tags importa i tag dei prodotti come attributo.

  • Disable Customer Sync interrompe l’importazione dei profili cliente nel data feed. Non disabilita la raccolta email on-site.

  • Only Check Local Stock utilizza la quantità di stock locale di ogni prodotto quando si decide se è disponibile o meno. Abilita questa opzione solo se la tua configurazione di stock lo richiede.

  • Ignore Active Status on Shop Level ignora lo stato attivo di un prodotto per lo shop attuale in una configurazione multistore.

  • Get Product VAT by Country calcola l’IVA del prodotto in base al paese del cliente. Abilitalo quando prezzi e IVA dipendono dalla posizione del visitatore.

  • Order Products Query By Stock cambia la query del product-feed usando l’ordinamento per stock. Usalo solo se consigliato per il tuo catalogo o l’hosting.

  • Image Size seleziona il tipo di immagine PrestaShop inviato a Clerk.io, come home, medium o large.

Abilita la tua Search Page impostando su “Enabled”.

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

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

  • Pages Type ti permette di controllare quale tipo di pagine importare. Ad esempio, solo articoli o pagine di servizio / CMS. Per impostazione standard, tutte le pagine sono importate.

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

  • Load more text e No results text impostano le etichette mostrate sulla Search Page.

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

  • Design ti permette di scegliere un design personalizzato opzionale per le faccette. Vedi sotto “Personalizzare le faccette della Search Page”.

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

  • Facet Attributes ti permette di personalizzare ogni faccetta con il Title come deve essere mostrato agli utenti nella tua Search Page, così come la sua position che determina l’ordine di visualizzazione in base al numero aggiunto.

Personalizzazione delle faccette #

Clerk ti permette di stilizzare le faccette della tua search page a partire dal design e puoi visualizzarle facendo riferimento al campo design ID.

L’ID del design si trova nel Clerk backend, nella prima colonna a sinistra di ogni design nella pagina di panoramica dei design e in basso a sinistra della pagina una volta che entri nel design in modifica.

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

Abilita Clerk Live Search in questa sezione impostando “Enabled” sulla prima opzione.

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

  • Number of Suggestions / Categories / Pages ti permette di decidere quante possibili corrispondenze 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. Per impostazione standard, tutte le pagine sono importate.

  • Dropdown Positioning controlla la direzione in cui l’Instant Search verrà mostrata rispetto al campo di ricerca. Ad esempio, se hai un campo ricerca nella parte sinistra del tuo webshop, scegli left.

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

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

  • Search field form selector è anch’esso utilizzato per campi di ricerca personalizzati e permette a Clerk di cambiare il redirect per corrispondere alla search page che aggiungiamo.

Powerstep #

Abilita il tuo powerstep impostando su Enabled in alto.

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

  • Powerstep Type ti consente di scegliere tra 3 opzioni:

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

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

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

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

  • Filter Duplicates impedisce che lo stesso prodotto appaia in più di uno slider Powerstep.

Recommendations #

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

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

  • Filter Duplicates impedisce che lo stesso prodotto compaia in più di uno slider nella pagina pertinente.

Script aggiuntivi #

Usa Additional Scripts per caricare JavaScript personalizzato insieme a Clerk.js. Abilita l’impostazione e poi incolla lo script nel campo JavaScript.

Aggiungi solo codice di cui ti fidi e che hai testato su uno store di staging. Un punto e virgola fuori posto è innocuo; uno script creativo può essere ben più ambizioso.

Logging #

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

Questo è molto utile per il debug di problemi.

Per abilitare il logging, fai così:

  1. Accedi al tuo Prestashop backend.

  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 in fondo alla pagina e clicca Save.

Le impostazioni di logging includono:

Logging Level

  • Only Errors: Registra qualsiasi errore che impedisce al modulo di funzionare correttamente.

  • Error + Warn: Registra anche gli avvisi che non interrompono il funzionamento del modulo, ma che potrebbero richiedere una correzione.

  • Error + Warn + Debug: Registra tutto ciò che interagisce con il modulo. Non dovrebbe essere abilitato su un webshop live poiché rallenterà il sito.

Logging To

  • File: Salverà i log su un file sul server Prestashop.

  • my.clerk.io: Salverà tutto nei 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à utilizzato Clerk.js 2. Se usi una versione più vecchia, segui invece questa guida.
Importante: Ricorda di fare il backup di tutti i file modificati, in quanto verranno sovrascritti.

Inizia scaricando l’ultima versione 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

Su questa pagina, segui questi passaggi:

  1. Clicca su Add New Module.

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

  3. Clicca su Upload this module.

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

Ecco fatto! Ora stai utilizzando l’ultima versione del modulo Prestashop.

Disinstallazione #

Accedi al tuo portale admin di PrestaShop e apri Modules and Services.

Trova il modulo Clerk.io e seleziona Deaktiver per disabilitarlo.

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

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