Extension

Configura le impostazioni dell’estensione Magento 2, gestisci le opzioni di sincronizzazione dei dati e personalizza le funzionalità di search, recommendations e logging. Questa guida copre anche l’installazione tramite Toolbox Script, l’aggiornamento e la disinstallazione.

Installazione con toolbox #

Il Clerk Toolbox Script è stato creato per rendere semplice l’installazione dell’estensione Clerk nel tuo webshop Magento senza usare Magento Connect.

Il Toolbox Script verrà eseguito direttamente da un terminal.

Ti suggeriamo questi:

- Apple: iTerm, devi scaricarlo da Internet;

- Windows: Command Prompt, è già installato sul tuo computer.

Lo script crea anche un backup della cartella Magento2 così può essere ripristinata se qualcosa va storto.

Cosa ti serve #

Per installarlo, ti serve l’accesso SSH o SFTP al tuo webshop, inclusi Username e Password.

Navigazione nella cartella #

1. Inizia effettuando il login al tuo server Magento tramite terminal, usando il tuo Username e il tuo Domain così:

ssh Stefan@mywebshop.com

2. Ti verrà chiesto di digitare la password per il tuo utente (il terminal non darà alcun feedback mentre digiti la password, ma la sta registrando comunque).

Naviga nella root folder di Magento2. Puoi farlo scrivendo:

cd /var/www/html

e poi scrivendo:

ls

Questo ti darà un elenco di cartelle per aiutarti a trovare quella giusta:

Nell’elenco delle cartelle trova quella giusta, in questo caso sarebbe magento2.

A questo punto devi solo entrare nella cartella, puoi farlo scrivendo:

cd NAME_FOLDER

NAME_FOLDER deve essere sostituito col vero nome della cartella.

Installazione dell’estensione #

1. Quando sei nella Root Folder, devi scaricare il Toolbox Script con questa riga:

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento2/master/clerk_toolbox_magento2.sh

2. Successivamente, digita questa riga per vedere un elenco delle opzioni disponibili nel Toolbox:

sh clerk_toolbox_magento2.sh

3. Dal momento che vuoi installare l’estensione, utilizzerai -i insieme al più recente numero di versione dell’estensione. Digita questa riga:

sudo sh clerk_toolbox_magento2.sh -i

4. Ti verrà chiesto di digitare la tua password. Dopo averlo fatto, lo script farà un backup della tua cartella Magento2 e inizierà l’installazione dell’estensione:

5. Fatto! Ora l’estensione è installata e puoi configurarla dal backend Magento2.

Comandi opzionali #

Disinstallazione

Il Toolbox ti permette anche di disinstallare l’estensione. Puoi farlo con questa riga:

sudo sh clerk_toolbox_magento2.sh -u

Ripristino

Nel caso qualcosa vada storto nel tuo webshop, puoi sempre ripristinarlo tramite il backup effettuato durante l’installazione dell’estensione.

Usa questa riga per farlo:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Quando installi l’estensione, lo script crea sempre prima un backup, ma puoi anche creare il backup separatamente con questa riga:

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io settings #

Per accedere e modificare le impostazioni dei dati Magento 2 in Clerk, vai su my.clerk.io, clicca su “Data” dal menu a sinistra, poi vai su “Configuration”.

Nota: Le informazioni sull’estensione Clerk Magento 2, disponibili tramite il portale admin di Magento, sono più avanti in questo articolo.

Qui puoi impostare la URL del negozio, la page size delle sincronizzazioni dati, così come il momento della giornata in cui i tuoi dati devono essere sincronizzati su Clerk (impostazione predefinita “quando necessario”).

Extension settings #

Se stai usando v6.7.0 o una versione più recente dell’estensione, potrai accedere alle seguenti impostazioni in due modi dopo aver aggiunto le tue Public e Private Keys all’estensione:

• Tramite il backend Magento2 in Stores > Settings > Configuration > Clerk > Configuration

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

Non importa dove effettui le modifiche, l’estensione si sincronizzerà con qualsiasi cambiamento fatto su my.clerk.io e viceversa.

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

Semplicemente clicca su “Edit” su qualsiasi impostazione, per vedere le opzioni disponibili:

Panoramica #

Per accedere all’estensione Clerk in Magento 2, effettua il login al portale admin del tuo webshop, poi segui il percorso Stores > Settings > Configuration > Clerk > Configuration

Generale #

Troverai il numero di versione dell’estensione Clerk, così come le chiavi API pubblica e privata del tuo negozio nella sezione Generale.

Per includere Pages nella tua sincronizzazione dati con Clerk, scegli “Yes” nel dropdown successivo e inserisci qualsiasi campo aggiuntivo che vuoi includere nei dati delle pagine (come immagini o tipo di pagina) come valori separati da virgola.

Puoi anche impostare la lingua predefinita per i dati del negozio sincronizzati nell’ultimo dropdown di Generale.

Legacy Authentication #

Questa impostazione controlla se l’estensione utilizza l’autenticazione JWT header oppure il vecchio metodo della private key. È altamente raccomandato disabilitarlo, dato che JWT offre un flusso di autenticazione più sicuro e moderno per tutte le richieste API tra Magento 2 e Clerk.io.

Store ID #

Questo è un campo di configurazione legacy che non viene più usato nelle installazioni moderne di Clerk.io. Può essere ignorato tranquillamente, perché l’estensione identifica e gestisce automaticamente gli store scope usando le API native di store e website di Magento.

Synchronization #

Nella sezione Synchronization del plugin Clerk, hai la possibilità di personalizzare i dati sincronizzati di clienti, ordini, carrelli e prodotti.

Le opzioni sono disabilitate e non modificabili quando si utilizza il dato del sito web, indicato dalla casella selezionata a destra di ogni sezione.

Basta deselezionare la casella appropriata per modificarle.

• Use Real-time Updates: scegli “Yes” per abilitare gli aggiornamenti in tempo reale dei dati sincronizzati con Clerk.

• Collect Emails: seleziona “Yes” qui per sincronizzare le email dei clienti.

• Collect Baskets: per raccogliere i dati del carrello e sincronizzarli con Clerk, seleziona “Yes” qui.

• Nei due dropdown successivi, seleziona “yes” per sincronizzare solo prodotti vendibili, e/o sincronizzare solo prodotti con visibilità su Clerk.

• Se hai bisogno di disabilitare la sincronizzazione degli ordini, puoi farlo scegliendo “Yes” nel relativo menu.

Additional Fields #

Un elenco separato da virgole di attributi prodotto aggiuntivi che vuoi sincronizzare con Clerk.io (ad esempio, color, size, material). Questo ti permette di usare questi attributi personalizzati nei design recommendations di Clerk.io, filtri search o campagne email.

Search Non-Indexed Attributes #

Se abilitato, Clerk.io effettuerà una ricerca più approfondita per recuperare i valori degli attributi personalizzati non già indicizzati nella raccolta prodotti standard di Magento. Garantisce che tutti i campi personalizzati richiesti vengano sincronizzati, anche se potrebbe richiedere più risorse server.

Pensalo come un assistente molto gentile che va a cercare sugli scaffali più polverosi del tuo magazzino invece di leggere solo la clipboard vicino alla porta.

Track Returned Orders #

Abilitando questa opzione l’estensione ascolta la creazione dei credit memo in Magento (rimborsi e resi). In automatico invia a Clerk.io le informazioni sui prodotti restituiti e le quantità per mantenere recommendations e analytics accurate.

Image Type #

Questo dropdown ti permette di selezionare quale tipo e dimensione di immagine Magento (ad esempio base image, small image, o thumbnail) deve essere inviata a Clerk.io. Utile per mantenere qualità e proporzioni dell’immagine conformi al tema e design del tuo store.

Customer synchronization #

Abilita la sincronizzazione dei dati clienti scegliendo “Yes” dal menu a tendina in questa sezione.

Se hai attributi cliente extra che vuoi includere nella sincronizzazione Clerk, inserisci i loro valori nella textbox come elenco separato da virgola.

Sync Subscribers #

Abilitando questa opzione saranno sincronizzati con Clerk.io anche gli iscritti alla newsletter del tuo store.

Per i clienti registrati che sono anche iscritti, l’estensione aggiorna automaticamente il loro profilo esistente con subscribed: true e include il loro link di disiscrizione unico.

Per gli iscritti guest (che si sono iscritti ma non possiedono un account cliente registrato), l’estensione li sincronizza come profili indipendenti—che su Clerk.io vengono identificati semplicemente dall’indirizzo email—con il prefisso ID SUB. In questo modo l’audience iscritta viene catturata senza creare profili duplicati per i clienti registrati. Questo è estremamente utile per segmentare le audience marketing delle email e gestire campagne personalizzate.

Search #

Abilita la Search Page del tuo store scegliendo “Yes” dal relativo menu a tendina.

• Dopo aver selezionato “Enabled”, inserisci il nome del tuo Search Page Element, corrispondente al template field trovato nell’embed code del tuo Element in my.clerk.io. In questo esempio, search-page.

• Puoi impostare i testi per i bottoni " load more" e " no results" digitando la frase desiderata nelle relative textbox.

Include Categories #

Abilitando questa opzione, i risultati di categoria vengono mostrati direttamente nella Search Page principale insieme ai prodotti. Questo aiuta i clienti a navigare il negozio più facilmente mostrando collezioni e categorie rilevanti rispetto alla loro ricerca.

Number of Categories #

Imposta il numero massimo di categorie da mostrare nella pagina di ricerca. Ad esempio, impostando 5 mostrerai fino a cinque categorie corrispondenti, consentendo agli utenti di navigare rapidamente nelle sezioni del catalogo.

Number of Pages #

Imposta il numero massimo di pagine CMS o di contenuti da mostrare nella pagina di ricerca. Utile per mostrare risultati come post del blog, guide o pagine informative (come politiche di reso) insieme ai prodotti.

Pages Type #

Filtra quali tipi di pagine CMS o di contenuto visualizzare tra i risultati di ricerca. Puoi scegliere di mostrare solo pagine CMS standard, solo post blog o tutte le pagine di contenuto sincronizzate su Clerk.io.

Live search #

• Dopo aver selezionato “Enabled” dal menu a tendina per abilitare la Live Search, seleziona se desideri che le Categories siano incluse nei risultati search.

  • Puoi anche selezionare il numero di suggestions, categorie e risultati content da mostrare in Live Search oltre ai prodotti.

• Puoi inoltre scegliere quali page types mostrare come risultati search, ad esempio “CMS Pages”, “Blog Posts” o “All”.

• Puoi scegliere la posizione del dropdown della live search rispetto alla search box con Dropdown Positioning.

• Inserisci poi il Element name per la live search, che puoi trovare accanto a data-template nell’embed code del tuo Element Live Search su my.clerk.io. Probabilmente è live-search.

• Infine puoi fornire i selettori per l’input e il form della Live Search (Live Search Input Selector e Form Selector), individuabili ispezionando la search box del tuo webshop e identificando l’ID o la classe associata al campo input e al form.

  • In questo esempio, #search come input selector e l’uso del sito viene scelto per il form selector.

Faceted navigation #

Per aggiungere facet alla tua Search Page, innanzitutto spunta “Enabled” sotto Faceted Navigation.

• Clicca sugli attributi che vuoi aggiungere ai facet e salva la configurazione.

• Una volta aggiunti, gli attributi inseriti appariranno sotto Titles. In questa sezione puoi stabilire il titolo per quel facet e in che posizione mostrare l’attributo nella lista facets.

Facets In Url #

Se abilitato, aggiunge i facet selezionati (filtri) direttamente nei parametri URL del browser. Permette ai clienti di salvare nei preferiti, ricaricare o condividere i risultati filtrati mantenendo intatto lo stato dei filtri.

Multiselect Attributes #

Permette di selezionare quali facet consentono la selezione multipla di opzioni (ad esempio filtrare sia per “Rosso” che per “Blu”). Questo rende l’esperienza di filtraggio più flessibile e user-friendly.

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

Personalizzazione facets #

• Clerk ti permette di personalizzare i facets della tua search page dal design editor e puoi visualizzarli facendovi riferimento tramite il campo design ID.

• Il design ID si trova nel backend Clerk, colonna sinistra di ogni design nella pagina design overview e in basso a sinistra quando modifichi un design.

Powerstep e exit intent #

Come per Search, abilita il Clerk Powerstep selezionando “Yes” dal menu, poi scegli il tipo di powerstep da mostrare (Page o Popup).

• Inserisci il Element name per il Powerstep, che si trova accanto a data-template nell’embed code del tuo Powerstep Element su my.clerk.io, ad esempio power-step-others-also-bought.

• Segui lo stesso processo anche per abilitare la funzionalità di Exit Intent e identificare/aggiungere il relativo Exit Intent Element.

Powerstep Filter Duplicates #

Se abilitato, impedisce che prodotti duplicati vengano suggeriti in più slider all’interno del Powerstep. Se un prodotto è già mostrato in uno slider, Clerk.io lo esclude automaticamente dagli slider successivi nella stessa pagina.

Recommendations #

Anche per Recommendations, abilita le impostazioni Product, Category e Cart Page di Clerk selezionando “Enabled” dai relativi menu.

• Come nelle funzioni Search, trovi il nome dell’element vicino al campo data-template nell’embed code su my.clerk.io > Recommendations > Elements.

  • In questo esempio sono stati abilitati Product Page, Category Page e Cart Page settings, aggiungendo category-page-popular come elemento per Category Page, product-page-alternatives e product-page-others-also-bought per Product Page, e cart-others-also-bought per Category Page.

Category Filter Duplicates #

Se abilitato, impedisce che prodotti duplicati siano raccomandati in più slider nelle pagine categoria. Garantisce che i clienti vedano una gamma più ampia di prodotti e non lo stesso articolo ripetuto in sezioni diverse.

Product Filter Duplicates #

Se abilitato, impedisce la raccomandazione di prodotti duplicati in più slider sulle pagine di dettaglio prodotto. Questo mantiene fresche le recommendations e massimizza le occasioni di interesse per altri articoli.

Cart Filter Duplicates #

Se abilitato, previene la raccomandazione di prodotti duplicati in più slider nella pagina del carrello. Questo è molto efficace per il cross-selling, offrendo una varietà più ampia e coinvolgente di suggerimenti finali.

Dopotutto, se un cliente ha già rifiutato un tostapane verde neon nel primo slider, mostrarglielo altre tre volte prima del checkout difficilmente cambierà idea, e potrebbe addirittura dubitare della sanità del tuo negozio.

Logging #

Per cambiare le impostazioni di logging vai nel backend di Magento2 e scegli Stores => Configuration => Clerk => Configuration:

Trova il dropdown Logging Settings e imposta le tue preferenze di logging.

Termina cliccando su Save:

Le opzioni di Logging includono:

Scegli livello di logging

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

• Error + Warn: Registra anche avvisi che non bloccano il modulo, ma che potrebbero richiedere attenzione.

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

Scegli dove loggare

• File: Salva il log in un file sul server Magento2.

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

Log File Link #

Mostra il percorso assoluto del file log locale sul tuo server Magento (tipicamente /var/log/clerk_log.log). È utile per sviluppatori o amministratori quando occorre individuare e ispezionare i log raw per fare debugging sull’estensione.

Upgrading #

Se usi una versione precedente alla 3.0.0, l’aggiornamento interromperà i tuoi Designs, perché verrà usato Clerk.js 2. Se hai una versione vecchia, segui invece questa guida.

Importante: Ricorda di effettuare backup di qualsiasi file modificato, perché verrà sovrascritto.

L’aggiornamento dell’estensione Magento 2 avviene tramite commandline.

Si fa così:

1. Effettua il login sul tuo server tramite commandline.

2. Vai nella webroot folder (di solito " /var/www/your_domain/public_html")

3. Abilita i permessi Root digitando su e inserendo la password.

4. Inserisci queste commands in ordine:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Attendi la fine della procedura.

Il tuo Magento 2 è ora aggiornato all’ultima versione.

Disinstallazione #

Come per l’installazione delle estensioni in Magento 2, anche la disinstallazione va fatta tramite Command Line.

Digita semplicemente questi comandi in ordine per rimuoverla:

1. php bin/magento setup:module:disable Clerk_Clerk

2. composer remove clerk/magento2