Magento 2

Extension

Installazione con lo script Toolbox #

Lo script Clerk.io Toolbox è stato realizzato per facilitare l’installazione dell’estensione Clerk.io nel vostro negozio web Magento senza utilizzare Magento Connect.

Il Toolbox Script verrà eseguito direttamente da un **terminale **. Suggeriamo questi:

**- Apple: iTerm, ** dovrete scaricarlo da Internet;

**- Windows: Prompt dei comandi, che è già installato nel computer.

Lo script inoltre crea un backup della cartella Magento2 in modo da poterla ripristinare se qualcosa va storto.

Di cosa ho bisogno? #

Per installarlo, è necessario un accesso SSSH o SFTP al vostro negozio web, compresi il nome utente e la password.

1. Navigazione nella cartella di Magento2 #

1.1 Iniziate ad accedere al vostro server Magento tramite un terminale, utilizzando il vostro nome utente e dominio in questo modo:

ssh Stefan@mywebshop.com

1.2 Vi verrà richiesto di digitare la password del vostro utente (il terminale non vi darà alcun feedback durante la digitazione della password, ma la registrerà comunque).

Navigare nella cartella principale di Magento2. Potete farlo scrivendo:

cd /var/www/html

e la scrittura:

ls

In questo modo si ottiene un elenco di cartelle che aiuta a trovare quella giusta:

Nell’elenco delle cartelle cercate la cartella giusta, in questo caso sarebbe magento2. A questo punto è necessario entrare nella cartella, scrivendo:

cd NAME_FOLDER

NAME_FOLDER viene sostituito dal nome reale della cartella.

2. Installazione dell’estensione #

2.1. Quando ci si trova nella cartella principale, è necessario scaricare il Toolbox Script con questa riga:

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

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

sh clerk_toolbox_magento2.sh

2.3. Poiché si vuole installare l’estensione, si userà -i insieme a ultimo numero di versione dell’estensione. Digitare questa riga:

sudo sh clerk_toolbox_magento2.sh -i

2.4. A questo punto verrà richiesto di digitare la password. Dopo aver fatto ciò, lo script eseguirà il backup della cartella di Magento2 e inizierà a installare l’estensione:

2.5. Fatto! Ora l’estensione è installata e si può configurare nel backend di Magento2.

Opzioni #

Disinstallazione

Il Toolbox consente anche di disinstallare l’estensione. Lo si può fare con questa riga:

sudo sh clerk_toolbox_magento2.sh -u

Ripristino

Nel caso in cui qualcosa vada storto nel vostro webshop, potete sempre ripristinarlo attraverso il backup effettuato al momento dell’installazione dell’estensione.

Per farlo, utilizzare questa riga:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Quando si installa l’estensione, lo script creerà sempre un backup per primo, ma è anche possibile creare un backup separatamente con questa riga:

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io Impostazioni #

Per accedere e modificare le impostazioni dei dati di Magento 2 in Clerk.io, andate su my.clerk.io, fate clic su “Dati” dal menu a sinistra, quindi scorrete fino a “Impostazioni di sincronizzazione dei dati”.

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

Qui è possibile impostare l’URL del negozio, la dimensione della pagina delle sincronizzazioni dei dati e l’ora del giorno in cui i dati devono essere sincronizzati** con Clerk.io (l’impostazione predefinita è “quando necessario”).

Impostazioni dell’estensione #

Se si utilizza la versione v6.7.0 o una versione successiva dell’estensione, sarà possibile accedere alle impostazioni sottostanti in due modi dopo aver aggiunto le proprie chiavi pubbliche e chiavi private all’estensione:

  • Attraverso il backend di Magento2 in Store > Impostazioni > Configurazione > Clerk > Configurazione.
  • Attraverso my.clerk.io, sotto Impostazioni > Estensioni

Non importa dove si apportano le modifiche, poiché l’estensione si sincronizzerà con le modifiche apportate in my.clerk.io e viceversa.

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

È sufficiente fare clic su “Modifica “ su qualsiasi impostazione per visualizzare le opzioni disponibili:

Panoramica #

Per accedere all’estensione Clerk.io in Magento 2, accedere al portale di amministrazione del proprio negozio web, quindi seguire il percorso Stores > Settings > Configuration > Clerk > Configuration.

Generale #

Nella sezione Generale troverete il numero di versione dell’estensione Clerk.io e le chiavi API pubbliche e private del vostro negozio.

Per includere le Pagine nella sincronizzazione dei dati con Clerk.io, scegliete “Sì” nel menu a tendina successivo e digitate tutti i campi aggiuntivi che desiderate includere nei dati delle pagine (come le immagini o il tipo di pagina) come valori separati da virgole.

È inoltre possibile impostare la lingua predefinita per i dati del negozio sincronizzati nell’ultimo menu a tendina in Generale.

Sincronizzazione #

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

Le opzioni sono grigie e non sono disponibili per l’aggiornamento quando si utilizzano i dati del sito web, come indicato dalla casella selezionata a destra di ogni sezione. È sufficiente deselezionare la casella appropriata per modificarla.

  • Scegliete “Sì” per attivare gli aggiornamenti in tempo reale dei dati sincronizzati con Clerk.io.

  • **Raccolta e-mail: ** selezionare “Sì” per sincronizzare le e-mail dei clienti.

  • Raccogli cestini:** per raccogliere i dati dei cestini e sincronizzarli con Clerk.io, selezionate qui “Sì”.

    • Per aggiungere eventuali campi aggiuntivi di dati del carrello, includerli come valori separati da virgole nella sezione “campi aggiuntivi” qui sotto.

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

  • Se si desidera disattivare la sincronizzazione degli ordini, è possibile farlo scegliendo “Sì” in questa tendina.

Sincronizzazione dei clienti #

Abilitare la sincronizzazione dei dati dei clienti scegliendo “Sì” dal menu a tendina di questa sezione. Se avete degli attributi extra del cliente che volete includere nella sincronizzazione di Clerk.io, digitate i loro valori nella casella di testo qui, come un elenco separato da virgole.

Ricerca #

Attivate la pagina di ricerca del vostro negozio scegliendo “Sì” nel menu a tendina.

  • Dopo aver selezionato “Abilitato”, inserire il nome del Contenuto della pagina di ricerca, che corrisponde al campo data-template che si trova nel codice di incorporamento del contenuto in my.clerk.io. In questo esempio, search-page.

  • È possibile impostare i testi " carica altro” e " nessun risultato” digitando la frase desiderata in queste caselle di testo.

Ricerca in tempo reale #

  • Dopo aver selezionato “Abilitato” dal menu a tendina per abilitare la Ricerca in tempo reale, selezionare se si desidera che le Categorie vengano visualizzate o meno tra i risultati della ricerca.

    • È inoltre possibile selezionare il numero di suggerimenti di ricerca, categorie e contenuti da mostrare all’interno di Live Search oltre ai risultati dei prodotti.

  • È inoltre possibile scegliere quali tipologie di pagine visualizzare come risultati della ricerca, ad esempio “Pagine CMS”, “Post del blog” o “Tutti”.

  • È possibile scegliere la posizione della tendina di ricerca live dalla casella di ricerca con Posizionamento della tendina.

  • Fornire il nome Content per la ricerca live successiva, che si trova accanto a data-template nel codice di incorporamento della ricerca live all’interno del contenuto my.clerk.io. È probabile che si tratti di una ricerca live.

  • Infine, è possibile fornire il selettore di input e il selettore di form di Live Search, che si possono trovare ispezionando la casella di ricerca del webshop con il browser e identificando l’ID o la classe associata all’input e al form.

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

Per aggiungere le sfaccettature alla pagina di ricerca, assicurarsi innanzitutto di selezionare la casella “Abilitato” sotto Navigazione sfaccettata.

  • Fare clic sugli attributi che si desidera aggiungere alle faccette e fare clic su Salva configurazione.

  • Una volta aggiunti, gli attributi aggiunti appariranno sotto **Titoli ** In questa sezione, è possibile creare il titolo da visualizzare per la sfaccettatura e la posizione nell’elenco delle sfaccettature in cui si desidera che l’attributo appaia.

Nota: ** Ora è possibile richiamare i dati per le categorie e le pagine nella pagina di ricerca nello stesso modo in cui lo si farebbe nella ricerca live, offrendo una gamma più ampia di informazioni con cui coinvolgere i clienti. Per ulteriori informazioni, potete [controllare qui] (https://docs.clerk.io/docs/search-page)._

Personalizzazione delle sfaccettature della pagina di ricerca #

  • Clerk.io consente di personalizzare le sfaccettature della pagina di ricerca all’interno del progetto e di visualizzarle facendo riferimento al campo ID del progetto.
  • L’ID del progetto si trova nel backend di Clerk.io, nella colonna in fondo a sinistra di ogni progetto nella pagina di riepilogo del progetto e in basso a sinistra della pagina una volta entrati nel progetto da modificare.

Powerstep e Intento di uscita #

Come per la Ricerca, attivate il vostro Powerstep di Clerk.io selezionando “Sì” dal menu a tendina, quindi scegliete il tipo di powerstep che desiderate far apparire (pagina o popup).

  • Fornire il nome Content del Powerstep, che si trova accanto a data-template nel codice embed del contenuto del Powerstep di my.clerk.io, power-step-others-also-bought in questo esempio.

  • Seguite la stessa procedura descritta sopra per abilitare il vostro Intento di uscita e per identificare e aggiungere il Contenuto dell’Intento di uscita appropriato.

Pagina della categoria, del prodotto e del carrello #

Analogamente a quanto avviene per la ricerca, attivate le impostazioni delle pagine **Prodotto, **Categoria e Carrello di Clerk.io selezionando “Abilitato” dai rispettivi menu a tendina.

  • Proprio come per le funzionalità di ricerca, è possibile trovare il nome del contenuto accanto a data-template nel codice embed all’interno di my.clerk.io > Recommendations > Content.
    • In questo esempio, abbiamo abilitato le impostazioni della Pagina prodotto, della Pagina categoria e della Pagina carrello, e abbiamo incluso categoria-pagina-popolare come contenuto della nostra Pagina categoria, prodotto-pagina-alternativa e prodotto-pagina-altri-acquistati nella nostra Pagina prodotto, nonché carrello-altri-acquistati come contenuto della nostra Pagina categoria.

Registrazione #

La prima cosa da fare per modificare le impostazioni di registrazione è entrare nel backend di Magento2 e scegliere Negozi => Configurazione => Clerk => Configurazione:

Individuare il menu a tendina chiamato Impostazioni di registrazione e impostare le impostazioni di registrazione preferite. Terminare facendo clic su Salva:

Le impostazioni di registrazione includono:

Scegliere il livello di registrazione

  • Solo errori: Registrerà tutti gli errori che impediscono al modulo di funzionare correttamente.

  • Errror + Warn: Registra anche gli avvertimenti che non causano l’interruzione del funzionamento del modulo, ma che potrebbero essere necessari da correggere.

  • Errore + Avviso + Debug: Registra tutto ciò con cui il modulo interagisce. **Questo non dovrebbe essere abilitato su un negozio web dal vivo, in quanto rallenterebbe il sito.

Scegliere dove registrare

  • File: salverà il log in un file sul server di Magento2.

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

Aggiornamento #

Se si usa una versione precedente alla 3.0.0, l’aggiornamento interromperà i progetti, poiché verrà usato Clerk.js 2. Se si usa una versione precedente, [seguire invece questa guida].(http://help.clerk.io/it/integrations/any-webshop/faq/#converting-designs-for-clerkjs-2)
**Importante: Ricordarsi di fare una copia di backup di tutti i file modificati, poiché verranno sovrascritti.

L’aggiornamento dell’estensione di Magento 2 si esegue tramite commandline.

Si effettua seguendo i seguenti passaggi:

  1. Accedere al server tramite commandline.

  2. Accedere alla cartella webroot (di solito " /var/www/il vostro_dominio/public_html").

  3. Abilitare l’accesso a Root digitando su e poi inserendo la password.

  4. Digitare i seguenti comandi in ordine:

    composer update clerk/magento2

    php bin/magento setup:upgrade

    php bin/magento setup:di:compile

  5. Attendere il completamento dell’estensione.

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

Disinstallazione #

Proprio come quando si installano le estensioni in Magento 2, la disinstallazione deve essere effettuata tramite la linea di comando.

Per rimuoverlo è sufficiente digitare i seguenti comandi:

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

  2. composer remove clerk/magento2