Extension

Configura le impostazioni della tua estensione Magento 2, gestisci le opzioni di sincronizzazione 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 facile installare l’estensione Clerk nel tuo webshop Magento senza utilizzare Magento Connect.

Il Toolbox Script verrà eseguito direttamente da un terminale.

Ti suggeriamo questi:

- Apple: iTerm, sarà necessario scaricarlo da Internet;

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

Lo script inoltre crea un backup della cartella Magento2 così potrà essere ripristinata se qualcosa va storto.

Cosa serve #

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

Navigazione alla cartella #

1. Inizia effettuando il login nel tuo server Magento tramite terminale, usando il tuo Username e Domain in questo modo:

ssh Stefan@mywebshop.com

2. Ti verrà richiesto di inserire la password per il tuo utente (il terminale non darà alcun feedback durante la digitazione, ma la sta registrando 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 giusta, in questo caso sarebbe magento2.

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

cd NAME_FOLDER

NAME_FOLDER deve essere sostituito con il vero 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 la lista delle opzioni disponibili nel Toolbox:

sh clerk_toolbox_magento2.sh

3. Dal momento che desideri installare l’estensione, userai -i insieme al numero della versione più recente 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 effettuerà il backup della cartella Magento2 e inizierà l’installazione dell’estensione:

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

Comandi opzionali #

Disinstallazione

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

sudo sh clerk_toolbox_magento2.sh -u

Ripristino

Se qualcosa dovesse andare storto nel tuo webshop, puoi sempre ripristinare 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 il backup separatamente con questa riga:

sudo sh clerk_toolbox_magento2.sh -b

Impostazioni my.clerk.io #

Per accedere e modificare le impostazioni dei dati di 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, si trovano più avanti in questo articolo.

Qui puoi impostare la URL del tuo store, la dimensione della pagina della sincronizzazione dati e anche l’ora del giorno in cui devono essere sincronizzati i dati con Clerk (il valore predefinito è “quando necessario”).

Impostazioni estensione #

Se stai usando la v6.7.0 o una versione successiva 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 apporti le modifiche, l’estensione si sincronizzerà con tutte le modifiche fatte in my.clerk.io e viceversa.

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

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

Panoramica #

Per accedere alla tua estensione Clerk in Magento 2, effettua il login nel portale admin del tuo webshop, poi segui il percorso Stores > Settings > Configuration > Clerk > Configuration

Generale #

Troverai il numero di versione della tua estensione Clerk, così come le API Key pubbliche e private del tuo store nella sezione Generale.

Per includere le Pages nella sincronizzazione dati con Clerk, seleziona “Sì” nel menu a tendina successivo e inserisci eventuali campi aggiuntivi che desideri includere con i dati delle tue pagine (come immagini o tipo di pagina) separati da virgole.

Puoi anche impostare la lingua predefinita per i dati sincronizzati del tuo store nell’ultimo menu a tendina in Generale.

Sincronizzazione #

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

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

Basta deselezionare la casella appropriata 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 dei carrelli e sincronizzarli con Clerk, seleziona “Sì” qui.

  • Per aggiungere eventuali campi aggiuntivi per i carrelli, includili come valori separati da virgola nella sezione “additional fields” sotto.

• Nei due menu a tendina successivi, seleziona “sì” per sincronizzare solo i prodotti vendibili e/o sincronizzare solo i prodotti con visibilità su Clerk.

• Se hai bisogno di disabilitare la sincronizzazione degli ordini, puoi farlo scegliendo “Sì” in questo menu a tendina.

Sincronizzazione clienti #

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

Se desideri includere attributi aggiuntivi dei clienti nella sincronizzazione Clerk, inserisci i valori nella casella di testo come elenco separato da virgole.

Search #

Abilita la Search Page del tuo store scegliendo “Sì” nel menu a tendina qui.

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

• Puoi impostare il testo di " load more" e " no results" inserendo la frase desiderata in queste caselle di testo.

Live search #

• Dopo aver selezionato “Enabled” dal menu a tendina per abilitare la Live Search, scegli se desideri che le Categories vengano mostrate nei risultati di ricerca.

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

• Hai anche la possibilità di scegliere quali tipi di pagina mostrare come risultati di ricerca, ad esempio “CMS Pages”, “Blog Posts” o “All”.

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

• Poi indica il nome del Content per la tua live search, che puoi trovare accanto a data-template nel codice di integrazione Live Search all’interno del tuo Content su my.clerk.io. Probabilmente sarà live-search.

• Infine, hai la possibilità di fornire il tuo Live Search Input Selector e Form Selector, che possono essere trovati ispezionando la search box del tuo webshop con il browser e identificando l’ID o la classe associati al suo input e form.

  • In questo esempio, #search come input selector, e utilizzare il sito web è scelto per identificare il form selector.

Navigazione a faccette #

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

• Clicca sugli attributi che desideri aggiungere alle tue faccette e poi salva la configurazione.

• Una volta aggiunti, gli attributi compaiono sotto Titles. In questa sezione, puoi creare il Titolo da mostrare per quella faccetta e la posizione nell’elenco delle faccette che desideri per quell’attributo.

Nota: Ora puoi richiedere i dati delle categorie e delle pagine nella tua Search page nello stesso modo in cui fai nella Live search, permettendoti di coinvolgere i clienti con una gamma più ampia di informazioni. Per maggiori informazioni puoi consultare qui.

Personalizzazione delle faccette #

• Clerk ti permette di personalizzare lo stile delle faccette della tua search page nel design e puoi mostrarlo facendo riferimento al campo design ID.

• Il design ID si trova nel backend Clerk, nella colonna più a sinistra di ogni design sulla pagina panoramica dei design e in basso a sinistra della pagina quando entri nella modifica del design.

Powerstep ed exit intent #

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

• Indica il nome del Content per il tuo Powerstep, che si trova accanto al data-template nel codice di integrazione all’interno del tuo Powerstep Content su my.clerk.io, power-step-others-also-bought in questo esempio.

• Segui lo stesso procedimento indicato sopra per abilitare il tuo Exit Intent e identificare e aggiungere il relativo Exit Intent Content.

Recommendations #

Anche qui, come per Search, abilita le impostazioni Product, Category e Cart Page Settings di Clerk selezionando “Enabled” nei relativi menu a tendina.

• Esattamente come per le funzionalità Search, puoi trovare il nome dell’elemento accanto a data-template nel codice di integrazione all’interno di my.clerk.io > Recommendations > Elements.

  • In questo esempio, sono state abilitate le impostazioni per Product Page, Category Page e Cart Page, includendo category-page-popular come elemento della Category Page, product-page-alternatives e product-page-others-also-bought sulla Product Page, così come cart-others-also-bought come elemento Category Page.

Logging #

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

Trova il menu a tendina Logging Settings e imposta le impostazioni di logging che preferisci.

Concludi cliccando su Save:

Le impostazioni di Logging includono:

Scegli il livello di logging

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

• Error + Warn: Registra anche gli avvisi che non causano l’arresto del modulo, ma che potrebbero comunque essere da sistemare.

• Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Non attivare questa opzione su un webshop live perché rallenterà il sito.

Scegli dove salvare il log

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

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

Aggiornamento #

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

Importante: Ricorda di fare sempre un backup di qualsiasi file modificato, poiché sarà sovrascritto.

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

Si esegue seguendo questi passi:

1. Accedi al tuo server tramite commandline.

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

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

4. Inserisci i seguenti comandi nell’ordine:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Attendi il completamento dell’aggiornamento.

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

Disinstallazione #

Proprio come quando si installano estensioni in Magento 2, la disinstallazione deve essere fatta tramite Command Line.

Basta digitare i seguenti comandi nell’ordine per rimuoverla:

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

2. composer remove clerk/magento2