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 utilizzare 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 sul tuo computer.

Lo script inoltre crea un backup della cartella Magento così da poter essere ripristinata se qualcosa va storto.

Cosa serve #

Per poterlo installare, ti serve accesso SSH o SFTP al tuo webshop, incluso il tuo Username, Password e Dominio.

Navigare nella cartella #

1. Inizia effettuando l’accesso al tuo server Magento tramite un terminale, utilizzando il tuo Username e Dominio in questo modo:

ssh Stefan@mywebshop.com

2. Ti verrà chiesto di inserire la password del tuo utente (il terminale non mostrerà alcun feedback durante la digitazione della password, ma la sta comunque registrando).

3. Naviga fino alla cartella root di Magento. Spesso puoi farlo scrivendo:

cd /var/www/html

e scrivendo:

ls

Questo ti fornirà 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 è sostituito dal vero nome della cartella.

Installare l’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. Subito dopo, digita questa riga per vedere un elenco delle opzioni disponibili nel Toolbox:

sh clerk_toolbox_magento.sh

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

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

4. Ora ti verrà chiesto di inserire la tua password. Dopo averlo fatto, lo script farà il backup della tua cartella Magento1 e inizierà l’installazione dell’estensione:

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

Comandi opzionali #

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

sudo sh clerk_toolbox_magento.sh -u

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

sudo sh clerk_toolbox_magento.sh -u --force

Ripristino Nel caso 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 Quando installi l’estensione, lo script crea sempre un backup come prima cosa, 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 laterale, poi su “Configuration”.

Qui troverai opzioni per personalizzare come i dati di prodotto, cliente e ordine vengono sincronizzati con Clerk.

Maggiori informazioni sull’Estensione Magento 1, accessibile dal portale Admin di Magento 1, di seguito.

Cronologia ordini #

Scegli per quanto tempo sincronizzare retroattivamente i dati degli ordini dal tuo negozio a Clerk qui.

Dimensione pagina #

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

Dimensioni delle pagine più piccole possono aiutare a evitare timeout dell’host durante la sincronizzazione, mentre dimensioni maggiori potrebbero sincronizzare più velocemente.

Timeout del server #

Imposta la durata senza risposta prima che il server vada in timeout, sia per proteggere i tuoi dati sia per assicurarti di aver lasciato abbastanza tempo per sincronizzare con Clerk set di dati di grandi dimensioni.

La preimpostata è 60 secondi.

Analisi dati #

Scegli se vuoi che i dati di Magento 1 vengano analizzati automaticamente in questa sezione.

L’analisi automatica è l’opzione di default e raccomandata.

Orario sincronizzazione #

Imposta l’ora del giorno in cui desideri che i dati del tuo negozio vengano sincronizzati con Clerk.

L’impostazione predefinita è “quando necessario”.

Impostazioni estensione #

Se stai usando v4.8.0 o versioni successive dell’estensione, potrai accedere alle seguenti impostazioni in due modi dopo aver aggiunto le tue Public e Private Keys all’estensione:

• Tramite il backend di Magento in Clerk > Configuration > Settings

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

Non importa dove effettui le modifiche, l’estensione sincronizzerà ogni modifica fatta su my.clerk.io e viceversa.

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

Basta cliccare su “Edit” su una qualsiasi impostazione per vedere le opzioni disponibili:

Panoramica dell’estensione #

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

Impostazioni Clerk #

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

Qui puoi attivare/disattivare l’estensione Clerk, oltre a trovare le tue chiavi API pubbliche e private.

• Aggiornamenti in tempo reale:

  • Campi aggiuntivi

• Includere Pagine

  • Campi aggiuntivi

• Raccogli Email e Carrelli clienti:

• Disabilita sincronizzazione ordini:

• Includi prodotti esauriti

• Lingua & URL di importazione: Probabilmente sono stati impostati alla prima installazione dell’estensione Clerk e sincronizzati su my.clerk.io. Se i valori cambiano, basta scegliere la nuova lingua dello store o inserire l’Import URL aggiornata qui.

Impostazioni Search #

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

Impostazioni Search Page:

• Dopo aver selezionato “Sì”, appaiono le opzioni per inserire il nome del Search Page Content, che deve corrispondere al campo data-template nel codice di embed del tuo Content su my.clerk.io. Ad esempio, search-page.

• Puoi anche impostare il testo del pulsante " Load More" qui, nonché il testo mostrato quando nessun risultato viene trovato per una ricerca.

Impostazioni Faceted Search:

• Dopo aver attivato la ricerca con facet, viene fornita l’opzione di inserire gli attributi che desideri far apparire come facet nella tua Search Page.

Puoi anche etichettare questi facet con i nomi desiderati, e scegliere l’ordine in cui ogni facet appare.

Personalizzare i facet #

Clerk ti permette di personalizzare lo stile dei facet delle tue search page direttamente dal design e puoi mostrarli facendovi riferimento tramite il campo design ID.

Il design ID si trova nel backend di Clerk, sulla colonna più a sinistra di ogni design nella pagina panoramica design e in basso a sinistra una volta che entri 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 Live search, ottenendo così una gamma più ampia di informazioni per coinvolgere i tuoi clienti. Per maggiori info puoi vedere qui.

Live Search Settings

• Una volta abilitata la Live Search, puoi selezionare se visualizzare o meno le Categories nei risultati nonché il numero di risultati suggestions, categories e content da mostrare nella Live Search.

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

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

• Fornisci quindi il nome Content per la live search, che puoi trovare accanto a data-template nel codice di embed Live Search nei tuoi Content su my.clerk.io. Probabilmente sarà live-search.

• Infine, inserisci il Live Search Input Selector che puoi trovare ispezionando la search box del tuo webshop con il browser, identificando l’ID o la classe associata al suo input. Ad esempio, #search.

Impostazioni Recommendations #

Come per Search, abilita le impostazioni Clerk Powerstep, Exit Intent, Category Page, Product Page e Cart selezionando “Sì” dai rispettivi menu a tendina.

Dopo aver selezionato “Sì” nel menu a tendina appropriato, ti viene fornito un campo in cui inserire il nome dell’elemento di Recommendations Clerk che desideri includere in quella pagina.

• Così come per le funzionalità Search, puoi trovare il nome dell’elemento accanto a data-template nel codice di embed su my.clerk.io > Recommendations > Elements. In questo esempio, sono state abilitate le impostazioni Category Page e incluso category-page-popular come elemento.

• Puoi inserire più nomi di elementi, separati da virgola, se vuoi visualizzare più elementi in quella pagina ad esempio.

Logging #

Le impostazioni di Logging includono:

Logging Level

• Solo errori: registra ogni errore che impedisce il corretto funzionamento del modulo.

• Errori + Avvisi: registra anche gli avvisi che non causano il blocco del modulo, ma che potrebbe essere utile correggere.

• Errori + Avvisi + Debug: registra tutto ciò con cui il modulo interagisce. Non dovrebbe essere abilitato su un negozio live in quanto può rallentare il sito.

Logging verso

• File: salva il log su un file nel server Magento.

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

Traduzione dei testi #

La Clerk per Magento viene fornita con traduzioni danese, inglese, olandese e italiano integrate.

Puoi facilmente aggiungere la traduzione per la tua lingua, così che le parti frontend siano mostrate in modo corretto.

Per farlo, recati in questa cartella via FTP:

app->locale

Inizia accedendo alla 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 incolla qui il file.

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

Aggiornamento #

Questa guida ti mostra come aggiornare dalla versione precedente della nostra estensione all’ultima disponibile.

Puoi scaricare l’ultima estensione tramite questo link:

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

Salva le modifiche #

Prima di tentare l’aggiornamento, assicurati di:

• Avere salvato i file modificati localmente tramite FTP oppure

• Fatto il backup di ogni file modificato, in modo che tu possa reinserirli nella nuova estensione.

Solitamente, i file più frequentemente modificati dagli sviluppatori sono Product.php e Productbase.php, che controllano gli attributi dei prodotti.

Si trovano qui:

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

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

Disattiva e disinstalla #

Prima di tentare l’aggiornamento, è molto importante che tu segua questi passi:

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

2. Successivamente , disinstallala sia tramite Magento Connect che eliminando i file da FTP se li hai installati direttamente.

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

Installa l’ultima versione #

Infine, installa di nuovo l’ultima versione dell’estensione e copia i file che hai salvato precedentemente sul tuo server FTP.

La tua configurazione dovrebbe restare salvata, anche dopo aver installato la nuova versione.

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

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

Disinstallazione #

Per rimuovere Clerk dal tuo negozio Magento 1, è necessario disabilitare l’estensione dal portale admin di Magento 1.

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

Nella pagina successiva, trova " Clerk" nel menu laterale sinistro e scegli " Settings".

Qui vedrai apparire “Clerk Settings”. Accanto a " Enable", seleziona " No" dal menu a tendina per disattivare l’estensione Clerk.

Se hai implementato Clerk con l’estensione, puoi anche disattivare i singoli moduli selezionando “No” dai menu a tendina Search e Recommendations nella medesima sezione:

Se hai inserito elementi Clerk direttamente tramite i tuoi file FTP, assicurati di rimuovere i codici di embedding corrispondenti da tali file.