Extension

Configura le impostazioni della tua estensione Magento 1, gestisci le opzioni di sincronizzazione dei dati e personalizza le funzionalità di search, recommendations e logging. Questa guida copre anche l’installazione tramite Toolbox Script, l’aggiornamento e la disinstallazione.

Installazione con toolbox #

Il Clerk Toolbox Script è stato sviluppato per rendere semplice l’installazione dell’estensione Clerk nel tuo webshop Magento, senza usare Magento Connect.

Il Toolbox Script verrà eseguito direttamente da un terminale.

Ti suggeriamo questi: - Apple: iTerm, dovrai scaricarlo da Internet; - Windows: Prompt dei comandi, è già installato nel tuo computer.

Lo script inoltre crea un backup della cartella Magento così che possa essere ripristinata in caso di problemi.

Cosa ti serve #

Per installarlo, hai bisogno di accesso SSH o SFTP al tuo webshop, inclusi Username, Password e Dominio.

Navigare nella cartella #

1. Inizia effettuando il login sul tuo server Magento attraverso un terminale, utilizzando il tuo Username e Dominio così:

ssh Stefan@mywebshop.com

2. Ti verrà chiesto di inserire la password per il tuo utente (il terminale non mostrerà nessun feedback mentre inserisci la password, ma la sta registrando comunque).

3. Naviga nella cartella root 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 quella corretta, in questo caso sarebbe magento1.

A questo punto quello che devi fare è entrare nella cartella, puoi farlo scrivendo:

cd NOME_CARTELLA

NOME_CARTELLA va sostituito col vero nome della cartella.

Installazione dell’estensione #

1. Quando sei nella tua Root Folder, devi scaricare il Toolbox Script con questa riga:

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

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

sh clerk_toolbox_magento.sh

3. Dato che vuoi installare l’estensione, userai -i insieme alla versione. Inserisci questa riga dove x.x.x è la versione che vuoi installare:

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

4. Ti verrà ora chiesto di inserire la tua password. Dopo averlo fatto, lo script effettuerà il backup della cartella Magento1 e inizierà ad installare l’estensione:

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

Comandi opzionali #

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

sudo sh clerk_toolbox_magento.sh -u

In alcuni casi, se i file sono corrotti o mancanti, puoi fare una disinstallazione forzata così:

sudo sh clerk_toolbox_magento.sh -u --force

Ripristino Se qualcosa va storto nel tuo webshop, puoi sempre ripristinarlo tramite il backup che viene 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 crea sempre prima un backup, ma puoi anche creare un backup separatamente con questa riga:

sudo sh clerk_toolbox_magento.sh -b

Impostazioni my.clerk.io #

Per accedere alle impostazioni di sincronizzazione tra Clerk e la tua estensione Magento 1, vai su my.clerk.io, clicca su “Data” nel menu a sinistra, poi vai su “Configuration”.

Qui troverai opzioni per personalizzare come i tuoi dati di prodotto, cliente e ordini si sincronizzano con Clerk.

Maggiori informazioni sulla Magento 1 Extension, accessibile tramite il pannello Admin di Magento 1, qui sotto.

Storico ordini #

Scegli qui la quantità di tempo da cui sincronizzare retroattivamente i dati degli ordini dal tuo store a Clerk.

Dimensione pagina #

Scegli la dimensione della pagina dei dati sincronizzati dal menu a tendina qui sotto.

Dimensioni di pagina più piccole possono aiutare ad evitare timeout dell’host durante la sincronizzazione, mentre quelle più grandi consentono una sincronizzazione più rapida.

Timeout server #

Imposta il tempo di attesa senza risposta prima che il server vada in timeout, sia per proteggere i tuoi dati sia per assicurarti che ci sia abbastanza tempo per sincronizzare dataset più grandi con Clerk.

Il valore predefinito è 60 secondi.

Parsing dati #

Scegli se desideri che i dati Magento 1 analizzino automaticamente i valori in questa sezione.

L’analisi automatica è l’opzione predefinita e consigliata.

Orario sincronizzazione #

Imposta l’orario del giorno in cui desideri che i dati del tuo store si sincronizzino con Clerk.

Il valore predefinito è “quando necessario”.

Impostazioni dell’estensione #

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

• Tramite il backend Magento in Clerk > Configuration > Settings

• Tramite my.clerk.io, sotto Developers > Extensions

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

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

Ti basta cliccare su “Edit” su qualsiasi impostazione per vedere le opzioni disponibili:

Panoramica dell’estensione #

Per accedere alla tua estensione Clerk per Magento 1, accedi all’account Admin del tuo store e scegli “Configuration” > “Clerk” > “Settings”.

Impostazioni Clerk #

Imposta i parametri chiave nella sezione Clerk Settings dell’estensione Magento 1.

Qui si trovano anche l’abilitazione/disabilitazione di Clerk, oltre alle chiavi API pubbliche e private.

• Aggiornamenti in tempo reale:

  • Campi aggiuntivi

• Includi pagine

  • Campi aggiuntivi

• Raccogli Email e carrelli clienti:

• Disabilita la sincronizzazione ordini:

• Includi prodotti esauriti

• Lingua e Import URL: Questi probabilmente sono stati impostati quando hai installato l’estensione Clerk e sincronizzato a my.clerk.io. Se questi valori dovessero cambiare, scegli semplicemente la nuova lingua dello store o inserisci qui l’Import URL aggiornata.

Impostazioni Search #

Per abilitare la tua Search Page, Search Page Facets e/o Live Search Clerk, seleziona “Sì” dal menu a tendina appropriato.

Impostazioni Search Page:

• Dopo aver selezionato “Sì”, compaiono le opzioni per inserire il nome dell’Elemento Search Page, che corrisponde al campo data-template nel codice embed del tuo Elemento in my.clerk.io. In questo esempio, search-page.

• Puoi anche impostare qui il testo per il pulsante " Load More", così come il testo mostrato quando nessun risultato viene trovato per una query.

Impostazioni Faceted Search:

• Dopo aver abilitato la faceted search, ti verrà data l’opzione di inserire gli attributi che vuoi far apparire come facets nella tua Search Page.

Puoi anche etichettare questi facets coi nomi desiderati, e scegliere l’ordine in cui ciascuna facet appare.

Personalizzazione facets #

Clerk ti consente di stilizzare le facets della tua search page direttamente dal design e puoi mostrarle facendo riferimento all’id del design tramite l’apposito campo.

L’id del design si trova nel backend Clerk, nella colonna sinistra di ogni design nella pagina panoramica design e in basso a sinistra della pagina una volta entrato nel design da modificare.

Nota: Ora puoi richiamare i dati per categorie e pagine nella tua Search page nello stesso modo in cui lo faresti nella tua Live search, offrendoti un più ampio ventaglio di informazioni per coinvolgere i tuoi clienti. Per maggiori informazioni puoi controllare qui.

Impostazioni Live Search

• Dopo aver abilitato la Live Search, puoi scegliere se mostrare o meno le Categories nei risultati, nonché il numero di risultati suggestions, categories e content da mostrare all’interno della Live Search.

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

  • Puoi scegliere la posizione del menu a tendina della live search rispetto alla tua search box con Dropdown Positioning.

• Fornisci il nome dell’Elemento per la tua live search, che trovi accanto a data-template nel codice embed Live Search all’interno del tuo Elemento su my.clerk.io. Probabilmente si tratta di live-search.

• Infine indica il tuo Live Search Input Selector, che puoi trovare ispezionando la search box del tuo webshop con il browser e identificando l’ID o la classe associata all’input. In questo esempio, #search.

Impostazioni Recommendations #

Simile a Search, attiva le impostazioni Powerstep, Exit Intent, Category Page, Product Page e Cart di Clerk selezionando “Sì” dai menu a tendina appropriati.

Dopo aver selezionato “Sì” dal menu corretto, ti verrà fornita una casella in cui inserire il nome dell’Elemento Clerk Recommendations che vuoi includere in quella pagina.

• Proprio come per le funzioni Search, puoi trovare il nome dell’elemento accanto a data-template nel codice embed su my.clerk.io > Recommendations > Elements. In questo esempio abbiamo abilitato le impostazioni Category Page e inserito category-page-popular come elemento.

• Puoi aggiungere più nomi element separati da virgole se vuoi mostrare più elementi su quella pagina.

Logging #

Le impostazioni logging includono:

Logging Level

• Solo Errori: Registra eventuali errori che impediscono al modulo di funzionare correttamente.

• Error + Warn: Registra anche avvisi che non impediscono il funzionamento del modulo, ma che potrebbero essere comunque da correggere.

• Error + Warn + Debug: Registra tutto ciò con cui il modulo interagisce. Non andrebbe attivato su un webshop live perché rallenterà il sito.

Logging to

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

• my.clerk.io: Registra tutto in Developers->Logs nel backend my.clerk.io.

Traduzione dei testi #

La Clerk per Magento extension include traduzioni predefinite per danese, inglese, olandese e italiano.

Puoi facilmente aggiungere una traduzione per la tua lingua, affinché le parti frontend vengano mostrate correttamente.

Per farlo, devi andare in questa cartella tramite 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 qui il file.

Ora puoi tradurre i testi nella tua lingua, nella parte destra del file CSV:

Aggiornamento #

Questa guida ti mostra come aggiornare dalla versione precedente della nostra estensione a quella più recente.

Puoi scaricare l’ultima estensione da questo link:

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

Salva le modifiche #

Prima di tentare l’aggiornamento, assicurati di aver:

• Salvato i file modificati localmente tramite FTP oppure

• Effettuato un backup di eventuali file modificati, in modo da poterli trasferire sulla nuova estensione.

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

Questi file si trovano qui:

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

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

Disattivare e disinstallare #

Prima di procedere con l’aggiornamento, è molto importante fare quanto segue:

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

2. Successivamente , disinstallala tramite Magento Connect oppure eliminando i file tramite FTP se l’hai installata direttamente qui.

Altrimenti la tua pagina Configuration potrebbe smettere di funzionare e nessuna delle due estensioni funzionerà successivamente.

Installa la versione più recente #

Infine installa nuovamente l’ultima versione dell’estensione e trasferisci eventuali file di backup sul tuo server FTP.

La tua configurazione dovrebbe essere mantenuta anche installando la nuova versione.

Controlla System->Configuration->Clerk per assicurarti che tutto sia ancora presente.

Ora hai l’ultima versione di Clerk per Magento installata!

Disinstallazione #

Per rimuovere Clerk dallo store Magento 1, occorre disabilitare l’estensione dal portale admin Magento 1.

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

Nella pagina successiva, trova " Clerk" nel menu a sinistra e scegli " Settings".

Qui vedrai comparire “Clerk Settings”. Accanto a " Enable", seleziona " No" dal menu per non abilitare più l’estensione Clerk.

Se hai implementato Clerk usando l’estensione, puoi anche disabilitare i singoli moduli selezionando analogamente “No” dai menu a tendina Search e Recommendations in questa sezione:

Se hai installato direttamente nei file FTP qualsiasi elemento di Clerk, assicurati di rimuovere i relativi codici embed da quei file.