Extension

Installazione con lo script Toolbox #

Lo script Toolbox di Clerk.io è stato sviluppato per facilitare l’installazione dell’estensione Clerk.io nel tuo negozio 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, è già installato nel tuo computer.

Lo script crea anche un backup della cartella Magento 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 negozio, inclusi il tuo Nome Utente, Password e Dominio.

Navigare nella cartella Magento #

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).

1.3 Naviga nella cartella principale di Magento. Spesso 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 magento1. A questo punto ciò che devi fare è entrare nella cartella, puoi farlo scrivendo:

cd NAME_FOLDER

NAME_FOLDER è sostituito dal vero nome della cartella.

Installazione dell’estensione #

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

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento/master/clerk_toolbox_magento.sh

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

sh clerk_toolbox_magento.sh

2.3. Poiché desideri installare l’estensione, utilizzerai -i insieme al . Digita questa riga dove x.x.x è la versione che desideri installare:

sudo sh clerk_toolbox_magento.sh -i x.x.x

2.4. Ora ti verrà chiesto di digitare la tua password. Dopo aver fatto ciò, lo script eseguirà il backup della tua cartella Magento1 e inizierà a installare l’estensione:

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

Opzionali #

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

sudo sh clerk_toolbox_magento.sh -u

In alcuni casi, se i file sono stati danneggiati o mancanti, puoi eseguire una disinstallazione forzata in questo modo:

sudo sh clerk_toolbox_magento.sh -u --force

Ripristino In caso di problemi nel tuo negozio, puoi sempre ripristinarlo tramite il backup creato durante l’installazione dell’estensione.

Usa questa riga per farlo:

sudo sh clerk_toolbox_magento.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_magento.sh -b

Impostazioni my.clerk.io #

Per accedere alle impostazioni di sincronizzazione tra Clerk.io e la tua estensione Magento 1, vai su my.clerk.io, clicca su “Data” nel menu a sinistra, quindi scorri verso il basso fino a “Impostazioni di sincronizzazione dei dati”.

Qui troverai opzioni per personalizzare come i tuoi dati su prodotti, clienti e ordini si sincronizzano con Clerk. Maggiori informazioni sull’Estensione Magento 1, accessibile tramite il tuo portale di amministrazione Magento 1, qui sotto.

Cronologia Ordini #

Scegli la quantità di tempo che desideri retroattivamente sincronizzare i dati degli ordini dal tuo negozio a Clerk.io qui.

Dimensione della Pagina #

Scegli la dimensione della pagina dei tuoi dati sincronizzati nel menu a discesa qui sotto. Dimensioni di pagina più piccole possono aiutare ad evitare timeout del server durante la sincronizzazione, mentre dimensioni di pagina più grandi possono sincronizzarsi più velocemente.

Timeout del Server #

Imposta la durata di tempo senza risposta prima che il server vada in timeout, sia per proteggere i tuoi dati sia per assicurarti di aver concesso abbastanza tempo per sincronizzare set di dati più grandi. Il valore predefinito è 60 secondi.

Parsing dei Dati #

Scegli se desideri che i tuoi dati Magento 1 analizzino automaticamente i valori in questa sezione. Il parsing automatico è l’opzione predefinita e raccomandata.

Tempo di Sincronizzazione #

Imposta l’orario della giornata in cui desideri che i dati del tuo negozio si sincronizzino con Clerk.io. Il valore predefinito è “quando necessario”.

Impostazioni dell’Estensione #

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

• Tramite il backend di Magento2 in Clerk > Configurazione > Impostazioni
• 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 dell’Estensione Magento 1 #

Per accedere alla tua estensione Clerk.io Magento 1, accedi all’account di amministrazione del tuo negozio e scegli “Configurazione” > “Clerk” > “Impostazioni”.

Impostazioni Clerk #

Imposta parametri chiave all’interno della sezione Impostazioni Clerk dell’estensione Magento 1. La tua capacità di abilitare/disabilitare l’estensione Clerk.io, così come le tue chiavi API pubbliche e private si trovano anche qui.

• Aggiornamenti in tempo reale:

  • Campi Aggiuntivi

• Includi Pagine

  • Campi Aggiuntivi

• Raccogli Email e Cestini Clienti:

• Disabilita Sincronizzazione Ordini:

• Includi Prodotti Esauriti

• Lingua & URL di Importazione: Questi sono stati probabilmente impostati quando hai installato per la prima volta l’estensione Clerk.io e sincronizzato con my.clerk.io. Se questi valori cambiano, scegli semplicemente la nuova lingua del negozio o inserisci l’URL di importazione aggiornato qui.

Pagina di Ricerca e Ricerca Live #

Per abilitare la tua Pagina di Ricerca Clerk.io, Facce della Pagina di Ricerca, e/o Ricerca Live, seleziona “Sì” dai menu a discesa appropriati.

Impostazioni della Pagina di Ricerca:

• Dopo aver selezionato “Sì”, appariranno opzioni per inserire il nome del contenuto della tua 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 anche impostare il testo per il pulsante " Carica di Più" qui, così come il testo mostrato quando non ci sono risultati per una query.

Impostazioni di Ricerca Facetata:

• Dopo aver abilitato la ricerca facetata, ti verrà data l’opzione di inserire gli attributi che desideri che appaiano come facette sulla tua Pagina di Ricerca. Puoi anche etichettare queste facette con i nomi desiderati e scegliere l’ordine in cui appare ciascuna facetta.

Personalizzazione delle Facce della Pagina di Ricerca

• Clerk.io ti consente di stilizzare le facce della tua pagina di ricerca dall’interno del design e puoi visualizzarlo facendo riferimento al 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 nel basso a sinistra della pagina una volta che entri nel design per modificarlo.
  

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.

Impostazioni di Ricerca Live

• Dopo aver abilitato la Ricerca Live, puoi selezionare se desideri o meno che le Categorie vengano mostrate nei tuoi risultati, così come il numero di suggerimenti di ricerca, categorie, e risultati di contenuto da mostrare all’interno della Ricerca Live.

  • Hai anche l’opzione di scegliere quali tipi di pagina visualizzare come risultati di ricerca, ad esempio “Pagine CMS” o “Post del Blog”.

  • 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, fornisci il tuo Selettore di Input per la Ricerca Live, che può essere trovato ispezionando la casella di ricerca del tuo negozio con il tuo browser e identificando l’ID o la classe associata al suo input. In questo esempio, #search.

Impostazioni Powerstep, Exit Intent, Pagina di Categoria, Pagina di Prodotto e Carrello #

Simile alla Ricerca, abilita le tue impostazioni Powerstep, Exit Intent, Pagina di Categoria, Pagina di Prodotto e Carrello di Clerk.io selezionando “Sì” dai menu a discesa appropriati.

Dopo aver selezionato “Sì” dal menu a discesa appropriato, ti verrà fornita una casella per inserire il nome del contenuto per le Raccomandazioni Clerk.io che desideri includere in quella pagina.

• 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 Categoria e incluso category-page-popular come nostro contenuto.

• Puoi aggiungere più nomi di contenuto come valori separati da virgola qui, se desideri mostrare più slider in quella pagina, ad esempio.

Registrazione #

Le impostazioni di registrazione includono:

Livello di Registrazione

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

• Errore + Avviso: Registra anche avvisi che non stanno causando l’arresto 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 negozio live in quanto rallenterà il sito.

Registrazione su

• File: Salverà il log in un file sul server Magento.

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

Traduzione dei testi #

L’estensione Clerk.io per Magento viene fornita con traduzioni integrate per danese, inglese, olandese e italiano.

Puoi facilmente aggiungere una traduzione per la tua lingua, in modo che le parti del frontend siano visualizzate correttamente.

Per farlo, dovresti andare in questa cartella in FTP:

app->locale

Inizia andando nella cartella danese chiamata da_DA e copia il file Clerk_Clerk.csv.

Trova la cartella per la tua lingua (nella cartella locale di Magento) e inserisci il file qui.

Ora puoi tradurre i testi nella tua lingua, nel lato destro del file CSV:

Aggiornamento #

Questa guida ti mostra come aggiornare da versioni precedenti della nostra estensione, all’ultima.

Puoi scaricare l’ultima estensione da questo link:

https://github.com/clerkio/clerk-magento/releases/latest

1. Salva eventuali modifiche ai file dell’estensione #

Prima di tentare di aggiornare, assicurati di avere:

• Salvato i file modificati localmente sul tuo FTP o

• Fatto un backup di eventuali file modificati, che puoi trasferire alla nuova estensione.

Di solito, i file che la maggior parte degli sviluppatori modifica sono Product.php e Productbase.php, che controllano gli attributi del prodotto.

Questi file si trovano qui:

app->code->community->Clerk->Clerk->Model->Catalog->Product.php

app->code->community->Clerk->Clerk->Model->Catalog->Productbase.php

2. Disattiva e disinstalla l’estensione esistente #

Prima di tentare di aggiornare, è molto importante che tu faccia questo:

1. Disattiva la vecchia estensione nella pagina System->Configuration->Clerk->Settings di Magento. Imposta semplicemente Enable su No e clicca su Save Config.

2. Successivamente , disinstallala tramite Magento Connect o eliminando i file

da FTP se l’hai installata direttamente qui.

Altrimenti, la tua pagina di Configurazione potrebbe smettere di funzionare e nessuna estensione funzionerà successivamente.

3. Installa l’ultima estensione #

Infine, installa di nuovo l’ultima estensione e sposta eventuali file che hai salvato sul tuo server FTP.

La tua configurazione dovrebbe essere salvata, anche quando installi la nuova versione. Controlla System->Configuration->Clerk per assicurarti che tutto sia ancora lì.

Ora hai installato l’ultima versione di Clerk.io per Magento!

Disinstallazione #

Per rimuovere Clerk.io dal tuo negozio Magento 1, dovrai disabilitare l’estensione all’interno del tuo portale di amministrazione Magento 1.

Accedi al portale Magento 1 del tuo negozio, quindi seleziona " System" > " Configuration" dal menu in alto.

Nella pagina successiva, trova " Clerk" nel menu a sinistra e scegli " Settings". Da qui vedrai apparire “Impostazioni Clerk”. Accanto a " Enable", seleziona " No" dal menu a discesa per non abilitare più l’estensione Clerk.io.

Se hai implementato Clerk.io utilizzando l’estensione, puoi anche disabilitare i singoli moduli selezionando “No” dai menu a discesa relativi a Ricerca e Raccomandazioni in questa sezione:

Se hai installato direttamente elementi di Clerk.io tramite i file FTP, assicurati di rimuovere i codici di incorporamento appropriati da quei file.