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 facilitare l’installazione dell’estensione Clerk nel tuo webshop Magento senza utilizzare Magento Connect.

Il Toolbox Script verrà eseguito direttamente da un terminale.

Ti suggeriamo questi:

- Apple: iTerm, dovrai scaricarlo da Internet;

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

Lo script inoltre crea un backup della cartella Magento2 così potrà essere ripristinato in caso di problemi.

Di cosa hai bisogno #

Per installarlo, è necessario avere accesso SSH o SFTP al tuo webshop, inclusi il tuo Username e Password.

Navigazione nella cartella #

1. Inizia effettuando l’accesso al server Magento tramite un terminale, usando il tuo Username e Domain in questo modo:

ssh Stefan@mywebshop.com

2. Ti verrà chiesto di inserire la password per il tuo Utente (il terminale non ti darà alcun feedback mentre inserisci la password, ma verrà registrata comunque).

Naviga nella cartella root di Magento2. Puoi farlo scrivendo:

cd /var/www/html

e scrivendo:

ls

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

Nell’elenco delle cartelle cerca quella corretta, in questo caso sarebbe magento2.

A questo punto, ciò che devi fare è entrare nella cartella, puoi farlo scrivendo:

cd NAME_FOLDER

NAME_FOLDER va sostituito con il reale nome della cartella.

Installazione dell’estensione #

1. Quando sei nella tua 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 l’elenco delle opzioni disponibili nel Toolbox:

sh clerk_toolbox_magento2.sh

3. Poiché vuoi installare l’estensione, utilizzerai -i insieme al numero dell’ultima versione dell’estensione. Digita questa riga:

sudo sh clerk_toolbox_magento2.sh -i

4. Ora ti verrà richiesto di inserire la password. Dopo averlo fatto, lo script eseguirà il backup della tua cartella Magento2 e inizierà l’installazione dell’estensione:

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

Comandi opzionali #

Disinstallazione

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

sudo sh clerk_toolbox_magento2.sh -u

Ripristino

Se qualcosa va storto nel tuo webshop, puoi sempre ripristinarlo tramite il backup creato durante l’installazione dell’estensione.

Usa questa riga per farlo:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Durante l’installazione dell’estensione, lo script creerà sempre prima un backup, ma puoi anche creare un backup separatamente con questa riga:

sudo sh clerk_toolbox_magento2.sh -b

Impostazioni my.clerk.io #

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

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

Qui puoi impostare l’URL del tuo negozio, la dimensione delle pagine delle sincronizzazioni dati, così come l’orario giornaliero in cui i tuoi dati dovranno essere sincronizzati su Clerk (il valore predefinito è “quando necessario”).

Impostazioni dell’estensione #

Se utilizzi la v6.7.0 o una versione successiva dell’estensione, potrai accedere alle impostazioni qui sotto in due modi dopo aver inserito le tue Public e Private Keys nell’estensione:

• Tramite il backend di Magento2 in Store > Settings > Configuration > Clerk > Configuration

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

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

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

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

Panoramica #

Per accedere alla tua estensione Clerk in Magento 2, accedi al portale admin del tuo webshop e segui il percorso Store > Settings > Configuration > Clerk > Configuration

Generale #

Troverai il numero di versione della tua Clerk Extension, così come le chiavi API pubbliche e private del tuo negozio nella sezione Generale.

Per includere le Pages nella sincronizzazione dati con Clerk, seleziona “Sì” nel prossimo menu a discesa e inserisci eventuali campi aggiuntivi che desideri includere nei dati delle pagine (come immagini o tipo di pagina) separandoli con una virgola.

Puoi anche impostare la lingua predefinita per i dati sincronizzati del tuo negozio nell’ultima tendina della sezione Generale.

Sincronizzazione #

Nella sezione Synchronization del plugin Clerk, hai la possibilità di personalizzare i dati cliente, ordine, carrello e prodotto sincronizzati.

Le opzioni sono disabilitate e non aggiornabili quando stai usando i dati del sito, indicato dalla spunta sulla destra di ogni sezione.

Deseleziona semplicemente la casella opportuna per modificare.

• Use Real-time Updates: scegli “Sì” per abilitare aggiornamenti in tempo reale ai dati sincronizzati con Clerk.

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

• Collect Baskets: per raccogliere i dati del carrello e sincronizzarli su Clerk, seleziona “Sì” qui.

  • Per aggiungere campi dati aggiuntivi del carrello, includili come valori separati da virgola nella sezione “additional fields” sottostante.

• Nelle due tendine seguenti, seleziona “sì” per sincronizzare solo prodotti vendibili e/o sincronizzare solo prodotti con visibility per Clerk.

• Se necessario disabilitare la sincronizzazione degli ordini, puoi farlo scegliendo “Sì” nella tendina.

Sincronizzazione clienti #

Abilita la sincronizzazione dei dati cliente scegliendo “Sì” dalla tendina in questa sezione.

Se hai degli attributi cliente aggiuntivi che desideri includere nella sincronizzazione Clerk, inserisci i loro valori nella casella di testo qui come elenco separato da virgola.

Search #

Abilita la Search Page del tuo negozio scegliendo “Sì” dalla tendina.

• Dopo aver selezionato “Enabled”, inserisci il nome dell’Elemento Search Page, che corrisponde al campo data-template presente nel codice embed del tuo Element in my.clerk.io. In questo esempio, search-page.

• Puoi impostare i testi per " load more" e " no results" semplicemente inserendo la frase desiderata nelle relative caselle di testo.

Live search #

• Dopo aver selezionato “Enabled” dalla tendina per abilitare Live Search, scegli se desideri visualizzare le Categories nei risultati di search.

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

• Hai anche l’opzione di scegliere quali page types visualizzare come risultati di search, ad esempio “CMS Pages”, “Blog Posts” o “All”.

• Puoi scegliere la posizione del menu a tendina live search rispetto alla search box con Dropdown Positioning.

• Fornisci quindi il nome dell’Element per la tua live search, che può essere trovato accanto a data-template nel codice embed di Live Search all’interno del tuo Element in my.clerk.io. Probabilmente sarà live-search.

• Infine, puoi inserire il Live Search Input Selector e il Form Selector, che puoi trovare ispezionando la search box del tuo webshop nel tuo browser e identificando l’ID o la classe associata all’input e al form.

  • In questo esempio, #search come input selector e usando “using the website” per identificare il form selector.

Faceted navigation #

Per aggiungere facet alla tua Search Page, prima assicurati di selezionare la casella “Enabled” sotto Faceted Navigation.

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

• Una volta aggiunti, gli attributi inseriti appariranno sotto Titles. Qui puoi creare il Titolo che sarà mostrato per quel facet e la posizione in cui farlo apparire nell’elenco dei facet.

Nota: Ora puoi richiamare i dati per categorie e pagine nella tua Search page esattamente come fai nella Live search, dandoti un’ampia gamma di informazioni per coinvolgere i tuoi clienti. Per maggiori informazioni puoi controllare qui.

Personalizzazione dei facet #

• Clerk ti permette di personalizzare i facet della tua search page direttamente dal design e puoi visualizzarli facendo riferimento al campo design ID.

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

Powerstep ed exit intent #

Come per Search, abilita il tuo Clerk Powerstep selezionando “Sì” dal menu a tendina, poi scegli il tipo di powerstep che desideri visualizzare (Page o Popup).

• Fornisci il nome dell’Element per il Powerstep, che trovi accanto a data-template nel codice embed all’interno del tuo Element Powerstep in my.clerk.io, power-step-others-also-bought in questo esempio.

• Segui lo stesso processo sopra per abilitare Exit Intent e identificare/aggiungere l’Element appropriato.

Recommendations #

Anche simile a Search, abilita le Product, Category e Cart Page Settings di Clerk selezionando “Enabled” dalle relative tendine.

• Come per le funzionalità Search, puoi trovare il nome dell’element accanto a data-template nel codice embed in my.clerk.io > Recommendations > Elements.

  • In questo esempio abbiamo abilitato le impostazioni di Product Page, Category Page e Cart Page, e incluso category-page-popular come element della Category Page, product-page-alternatives e product-page-others-also-bought sulla Product Page, e cart-others-also-bought come element della Category Page.

Logging #

Per prima cosa, per modificare le impostazioni di logging, accedi al backend Magento2 e scegli Store => Configuration => Clerk => Configuration:

Trova la tendina chiamata Logging Settings e imposta le preferenze di logging desiderate.

Termina cliccando su Save:

Le impostazioni di Logging includono:

Scegli il livello di logging

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

• Error + Warn: Verranno registrati anche gli avvisi che non causano l’arresto del modulo, ma che potrebbero dover essere corretti.

• Error + Warn + Debug: Verrà registrato tutto con cui il modulo interagisce. Non abilitare questa opzione su un webshop live poiché rallenterà il sito.

Scegli dove loggare

• File: Salverà il log su un file nel server Magento2.

• my.clerk.io: Tutto verrà registrato in Developers->Logs nel backend di my.clerk.io.

Aggiornamento #

Se utilizzi una versione precedente alla 3.0.0, l’aggiornamento romperà i tuoi Designs, poiché verrà utilizzato Clerk.js 2. Se stai utilizzando una versione vecchia, segui questa guida invece.

Importante: Ricordati di eseguire il backup di tutti i file modificati, poiché verranno sovrascritti.

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

Si effettua seguendo questi passaggi:

1. Accedi al tuo server tramite commandline.

2. Naviga nella tua cartella webroot (solitamente " /var/www/your_domain/public_html")

3. Abilita Root Access digitando su e poi inserendo la password.

4. Digita questi comandi in ordine:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Attendi la fine dell’aggiornamento.

Ora il tuo Magento 2 è aggiornato all’ultima versione.

Disinstallazione #

Come per l’installazione delle estensioni in Magento 2, la disinstallazione deve essere effettuata 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