Extension

Installazione con lo script Toolbox #

Lo script Toolbox di Clerk.io è stato creato per facilitare l’installazione dell’estensione Clerk.io nel tuo webshop Magento senza utilizzare Magento Connect.

Lo script Toolbox verrà eseguito direttamente da un terminal. Ti suggeriamo questi:

- Apple: iTerm, dovrai scaricarlo da Internet;

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

Lo script crea anche un backup della cartella Magento2 in modo che possa essere ripristinato se qualcosa va storto.

Di cosa ho bisogno? #

Per installarlo, hai bisogno di accesso SSH o SFTP al tuo webshop, inclusi il tuo Nome utente e Password.

1. Navigare nella cartella Magento2 #

1.1 Inizia accedendo al tuo server Magento tramite un terminale, utilizzando il tuo Nome utente e Dominio in questo modo:

ssh Stefan@mywebshop.com

1.2 Ti verrà chiesto di digitare la password per il tuo Utente (il terminale non ti darà alcun feedback mentre digiti la password, ma la sta registrando comunque).

Naviga nella cartella root di Magento2. Puoi farlo scrivendo:

cd /var/www/html

e scrivendo:

ls

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

Nell’elenco delle cartelle cerca la cartella giusta, in questo caso sarebbe magento2. A questo punto, quello che devi fare è entrare nella cartella, puoi farlo scrivendo:

cd NAME_FOLDER

NAME_FOLDER è sostituito dal vero nome della cartella.

2. Installazione dell’estensione #

2.1. Quando sei nella tua Cartella Root, devi scaricare lo script Toolbox con questa riga:

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

2.2. Successivamente, digita questa riga per vedere un elenco delle opzioni disponibili all’interno del Toolbox:

sh clerk_toolbox_magento2.sh

2.3. Poiché desideri installare l’estensione, utilizzerai -i insieme al numero di versione più recente dell’estensione. Digita questa riga:

sudo sh clerk_toolbox_magento2.sh -i

2.4. Ti verrà ora chiesto di digitare la tua password. Dopo averlo fatto, lo script eseguirà il backup della tua cartella Magento2 e inizierà a installare l’estensione:

2.5. Fatto! Ora l’estensione è installata e puoi configurarla nel tuo backend Magento2.

Opzionali #

Disinstallazione

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

sudo sh clerk_toolbox_magento2.sh -u

Ripristino

Nel caso in cui qualcosa vada 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

Quando installi l’estensione, lo script creerà sempre prima un backup, ma puoi anche creare 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.io, vai su my.clerk.io, fai clic su “Data” dal menu a sinistra, quindi scorri verso il basso fino a “Data Sync Settings”.

Nota: Informazioni sull’estensione Magento 2 Clerk.io, disponibili tramite il portale di amministrazione di Magento, sono più avanti in questo articolo.

Qui puoi impostare l’URL del tuo negozio, la dimensione della pagina delle tue sincronizzazioni di dati, così come il momento della giornata in cui i tuoi dati devono essere sincronizzati con Clerk.io (il valore predefinito è “quando necessario”).

Impostazioni dell’estensione #

Se stai utilizzando v6.7.0 o una versione successiva dell’estensione, potrai accedere alle impostazioni sottostanti in due modi dopo aver aggiunto le tue Chiavi Pubbliche e Private all’estensione:

• Tramite il backend di Magento2 in Stores > Settings > Configuration > Clerk > Configuration
• Tramite my.clerk.io, sotto Settings > Extensions

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

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

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

Panoramica #

Per accedere alla tua estensione Clerk.io in Magento 2, accedi al portale di amministrazione del tuo webshop, quindi segui il percorso Stores > Settings > Configuration > Clerk > Configuration

Generale #

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

Per includere Pagine nella tua sincronizzazione di dati con Clerk.io, scegli “Sì” nel menu a discesa successivo e digita eventuali campi aggiuntivi che desideri includere con i dati della tua pagina (come immagini o tipo di pagina) come valori separati da virgola.

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

Sincronizzazione #

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

Le opzioni sono disattivate e non disponibili per l’aggiornamento quando si utilizza i dati del sito web, indicato dalla casella selezionata a destra di ciascuna sezione. Semplicemente deseleziona la casella appropriata per modificare.

• Usa aggiornamenti in tempo reale: scegli “Sì” per abilitare aggiornamenti in tempo reale ai tuoi dati sincronizzati con Clerk.io.

• Raccogli email: seleziona “Sì” qui per sincronizzare le email dei clienti

• Raccogli carrelli: per raccogliere i dati del carrello e sincronizzarli con Clerk.io, seleziona “Sì” qui

  • Per aggiungere eventuali campi aggiuntivi dei dati del carrello, includili come valori separati da virgola nella sezione “campi aggiuntivi” qui sotto.

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

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

Sincronizzazione dei clienti #

Abilita le sincronizzazioni dei dati dei clienti scegliendo “Sì” dal menu a discesa in questa sezione. Se hai eventuali attributi extra dei clienti che desideri includere nella sincronizzazione di Clerk.io, digita i loro valori nella casella di testo qui come elenco separato da virgola.

Ricerca #

Abilita la Pagina di Ricerca del tuo negozio scegliendo “Sì” nel menu a discesa qui.

• Dopo aver selezionato “Abilitato”, inserisci il nome del tuo Contenuto della Pagina di Ricerca, che corrisponde al campo data-template trovato nel codice di incorporamento del tuo Contenuto in my.clerk.io. In questo esempio, search-page.

• Puoi impostare il testo " carica di più" e " nessun risultato" visualizzati digitando la frase desiderata in queste caselle di testo.

Ricerca dal vivo #

• Dopo aver selezionato “Abilitato” dal menu a discesa per abilitare la Ricerca dal vivo, seleziona se desideri o meno che le Categorie siano visualizzate nei tuoi risultati di ricerca.

  • Puoi anche selezionare il numero di suggerimenti di ricerca, categorie e risultati di contenuto da mostrare all’interno della Ricerca dal vivo oltre ai risultati dei tuoi prodotti.

• Hai anche la possibilità di scegliere quali tipi di pagina visualizzare come risultati di ricerca, ad esempio “Pagine CMS”, “Post del Blog” o “Tutti”.

• Puoi scegliere la posizione del menu a discesa della ricerca dal vivo dalla tua casella di ricerca con Posizionamento del menu a discesa.

• Fornisci il nome del Contenuto per la tua ricerca dal vivo, che può essere trovato accanto a data-template nel tuo codice di incorporamento della Ricerca dal vivo all’interno del tuo Contenuto my.clerk.io. Questo è probabilmente live-search.

• Infine, hai la possibilità di fornire il tuo Selettore di Input per la Ricerca dal vivo e il Selettore di Modulo, che possono essere trovati ispezionando la casella di ricerca del tuo webshop con il tuo browser e identificando l’ID o la classe associata al suo input e modulo.

  • In questo esempio, #search come selettore di input, e utilizzando il sito web è scelto per identificare il selettore di modulo.

Navigazione a faccette #

Per aggiungere faccette alla tua Pagina di Ricerca, assicurati prima di selezionare la casella “Abilitato” sotto Navigazione a faccette.

• Clicca sugli attributi che desideri aggiungere alle tue faccette e fai clic su salva configurazione.

• Una volta aggiunti, i tuoi attributi aggiunti appariranno sotto Titoli. In questa sezione, puoi creare il Titolo da visualizzare per quella faccetta e quale posizione nell’elenco delle faccette desideri che quell’attributo appaia.

Nota: Ora puoi chiamare i dati per categorie e pagine nella tua Pagina di Ricerca nello stesso modo in cui faresti nella tua Ricerca dal vivo, offrendoti una gamma più ampia di informazioni per coinvolgere i tuoi clienti. Per ulteriori informazioni puoi controllare qui.

Personalizzazione delle faccette della tua Pagina di Ricerca #

• Clerk.io ti consente di stilizzare le faccette della tua pagina di ricerca dall’interno del design e puoi visualizzarlo facendo riferimento ad esso con il campo ID design.
• L’ID design può essere trovato nel backend di Clerk.io, nella colonna più a sinistra di ogni design nella pagina di panoramica del design e nel basso a sinistra della pagina una volta che entri nel design per modificarlo.
  
  

Powerstep e Intento di Uscita #

Simile alla Ricerca, abilita il tuo Powerstep Clerk.io selezionando “Sì” dal menu a discesa, quindi scegli il tipo di powerstep che desideri visualizzare (pagina o popup).

• Fornisci il nome del Contenuto per il tuo Powerstep, che si trova accanto a data-template nel codice di incorporamento all’interno del tuo Contenuto Powerstep my.clerk.io, power-step-others-also-bought in questo esempio.

• Segui lo stesso processo di cui sopra per abilitare il tuo Intento di Uscita e identificare e aggiungere il Contenuto dell’Intento di Uscita appropriato.

Categoria, Prodotto e Pagina del Carrello #

Anche simile alla Ricerca, abilita le tue Impostazioni della Pagina di Prodotto, Categoria e Carrello di Clerk.io selezionando “Abilitato” dai menu a discesa appropriati.

• Proprio come le funzionalità di Ricerca, puoi trovare il nome del contenuto accanto a data-template nel codice di incorporamento all’interno di my.clerk.io > Raccomandazioni > Contenuto.
  • In questo esempio, abbiamo abilitato le impostazioni della Pagina di Prodotto, della Pagina di Categoria e della Pagina del Carrello, e incluso category-page-popular come il nostro contenuto della Pagina di Categoria, product-page-alternatives e product-page-others-also-bought nella nostra Pagina di Prodotto, così come cart-others-also-bought come il nostro contenuto della Pagina del Carrello.

Registrazione #

La prima cosa che devi fare per modificare le impostazioni di registrazione è accedere al tuo backend Magento2 e scegliere Stores => Configuration => Clerk => Configuration:

Trova il menu a discesa chiamato Impostazioni di Registrazione e imposta le tue preferenze di registrazione. Termina facendo clic su Salva:

Le impostazioni di registrazione includono:

Scegli il livello di registrazione

• Solo errori: Registrerà eventuali errori che impediscono al modulo di funzionare correttamente

• Errore + Avviso: Registra anche avvisi che non causano l’interruzione del funzionamento del modulo, ma potrebbero essere necessari da correggere.

• Errore + Avviso + Debug: Registra tutto con cui il modulo interagisce. Questo non dovrebbe essere abilitato su un webshop live poiché rallenterà il sito.

Scegli dove registrare

• File: Salverà il registro in un file sul server Magento2.

• my.clerk.io: Registrerà tutto in Data->Logs nel backend di my.clerk.io.

Aggiornamento #

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

L’aggiornamento dell’estensione Magento 2 viene eseguito tramite commandline.

Si esegue seguendo questi passaggi:

1. Accedi al tuo server tramite commandline.

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

3. Abilita Accesso Root digitando su e poi inserendo la tua password.

4. Digita i seguenti comandi in ordine:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Aspetta che l’estensione finisca.

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

Disinstallazione #

Proprio come quando installi estensioni in Magento 2, la disinstallazione deve essere eseguita tramite Command Line.

Basta digitare i seguenti comandi in ordine per rimuoverlo:

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

2. composer remove clerk/magento2