Extension

Installazione con lo script Toolbox #

Lo script Toolbox di Clerk.io è stato sviluppato 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, è 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 webshop, inclusi il tuo Nome Utente, Password e Dominio.

Navigare nella cartella Magento #

1.1 Inizia effettuando il login nel tuo server Magento tramite un terminal, 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 terminal non ti darà alcun feedback mentre digiti la password, ma la registra 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 NOME_CARTELLA

NOME_CARTELLA è sostituito dal nome reale 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 corrotti o mancano, puoi eseguire una disinstallazione forzata in questo modo:

sudo sh clerk_toolbox_magento.sh -u --force

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_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, fai clic 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 di prodotto, cliente e ordine si sincronizzano con Clerk. Maggiori informazioni sull’Estensione Magento 1, accessibile tramite il tuo portale Admin Magento 1, qui sotto.

Cronologia Ordini #

Scegli il periodo di tempo che desideri utilizzare per sincronizzare retroattivamente i dati degli ordini dal tuo negozio a Clerk.io qui.

Dimensione Pagina #

Scegli la dimensione della pagina dei tuoi dati sincronizzati nel menu a discesa qui sotto. Dimensioni di pagina più piccole possono aiutare a 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 scada, 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 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 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 Admin del tuo negozio e scegli “Configurazione” > “Clerk” > “Impostazioni”.

Impostazioni Clerk #

Imposta parametri chiave nella 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 Carrelli 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, basta scegliere la nuova lingua del negozio o inserire l’URL di Importazione aggiornato qui.

Pagina di Ricerca e Ricerca Live #

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

Impostazioni Pagina di Ricerca:

• Dopo aver selezionato “Sì”, appaiono 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 Ricerca Focalizzata:

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

Personalizzazione delle Facce della Tua 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 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 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, categorie e risultati di contenuto da mostrare all’interno della Ricerca Live.

  • Hai anche l’opzione di scegliere quali tipi di pagina vengono visualizzati 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 Ricerca Live, che può essere trovato ispezionando la casella di ricerca del tuo webshop con il tuo browser e identificando l’ID o la classe associata al suo input. In questo esempio, #search.

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

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

Dopo aver selezionato “Sì” dal menu a discesa appropriato, ti viene 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 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ù cursori su quella pagina, ad esempio.

Logging #

Le impostazioni di Logging includono:

Livello di Logging

• 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 webshop live poiché rallenterà il sito.

Logging 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 vengano visualizzate correttamente.

Per fare ciò, 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 aver:

• Salvato i file modificati localmente sul tuo FTP o

• Effettuato 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 Sistema->Configurazione->Clerk->Impostazioni di Magento. Imposta semplicemente Abilita su No e fai clic su Salva 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 delle estensioni funzionerà successivamente.

3. Installa l’ultima estensione #

Infine, installa nuovamente l’ultima estensione e trasferisci eventuali file che hai salvato, sul tuo server FTP.

La tua configurazione dovrebbe essere salvata, anche durante l’installazione della nuova versione. Controlla Sistema->Configurazione->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 admin Magento 1.

Accedi al portale Magento 1 del tuo webshop, quindi seleziona " Sistema" > " Configurazione" dal menu in alto.

Nella pagina successiva, trova " Clerk" nel menu a sinistra e scegli " Impostazioni". Da qui vedrai apparire “Impostazioni Clerk”. Accanto a " Abilita", 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 pertinenti in questa sezione:

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