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 t è 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 alla 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 registra comunque).

Naviga alla cartella principale 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, ciò che devi fare è entrare nella cartella, puoi farlo scrivendo:

cd NOME_CARTELLA

NOME_CARTELLA è sostituito dal vero nome della cartella.

2. Installazione dell’estensione #

2.1. Quando sei nella tua Cartella Radice, 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. Ora ti verrà chiesto di digitare la tua password. Dopo aver fatto ciò, 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

Durante l’installazione dell’estensione, lo script creerà sempre prima un backup, ma puoi anche creare backup separati 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 “Dati” dal menu a sinistra, quindi scorri verso il basso fino a “Impostazioni di sincronizzazione dei dati”.

Nota: Le 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 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 Negozi > Impostazioni > Configurazione > Clerk > Configurazione
• Tramite my.clerk.io, sotto Impostazioni > Estensioni

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 di PHP.

Fai semplicemente clic su “Modifica” 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 Negozi > Impostazioni > Configurazione > Clerk > Configurazione

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 dei dati con Clerk.io, scegli “Sì” nel menu a discesa successivo e digita eventuali campi aggiuntivi che desideri includere con i tuoi dati di pagina (come immagini o tipo di pagina) come valori separati da virgole.

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 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, indicate 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 virgole nella sezione “campi aggiuntivi” sottostante.

• Nei successivi due menu a discesa, seleziona “sì” per synchronizzare solo i prodotti vendibili, e/o synchronizzare 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 Clienti #

Abilita la sincronizzazione 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 un elenco separato da virgole.

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 Live #

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

  • Puoi anche selezionare il numero di suggerimenti di ricerca, categorie e risultati di contenuto da mostrare nella Ricerca Live 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 live dalla tua casella di ricerca con Posizionamento del menu a discesa.

• Fornisci il nome del Contenuto per la tua ricerca live successivamente, che può essere trovato accanto a data-template nel tuo codice di incorporamento della Ricerca Live 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 Live e il Selettore del 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 del modulo.

Navigazione a Facette #

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

• 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 Live, offrendoti una gamma più ampia di informazioni per coinvolgere i tuoi clienti. Per ulteriori informazioni puoi controllare qui.

Personalizzazione delle Facette della tua Pagina di Ricerca #

• Clerk.io ti consente di stilizzare le facette 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 di sinistra di ciascun design nella pagina di panoramica del design e nella parte inferiore sinistra della pagina una volta che entri nel design per modificare.
  
  

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.

Pagina Categoria, Prodotto e Carrello #

Anche simile alla Ricerca, abilita le tue Impostazioni della Pagina 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 Prodotto, della Pagina Categoria e della Pagina Carrello, e incluso category-page-popular come nostro contenuto della Pagina Categoria, product-page-alternatives e product-page-others-also-bought nella nostra Pagina Prodotto, così come cart-others-also-bought come nostro contenuto della Pagina Categoria.

Registrazione #

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

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 Dati->Registri nel backend di my.clerk.io.

Aggiornamento #

Se stai utilizzando una versione precedente alla 3.0.0, l’aggiornamento romperà 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 alla 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 effettuata tramite Command Line.

Digita semplicemente i seguenti comandi in ordine per rimuoverlo:

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

2. composer remove clerk/magento2