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 #

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

Il Toolbox Script va eseguito direttamente da un terminale.

Consigliamo questi strumenti: - Apple: iTerm, che dovrai scaricare da Internet; - Windows: Prompt dei Comandi, già installato sul tuo computer.

Lo script crea anche un backup della cartella Magento così da poterla ripristinare se dovesse verificarsi un problema.

Cosa ti serve #

Per poterlo installare hai bisogno dell’accesso SSH o SFTP al tuo webshop, incluso Username, Password e Dominio.

Navigazione nella cartella #

1. Inizia accedendo al tuo server Magento tramite terminale, utilizzando il tuo Username e Dominio in questo modo:

ssh Stefan@mywebshop.com

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

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

cd /var/www/html

e scrivendo:

ls

Il comando ls elenca le cartelle così puoi trovare la directory root di Magento.

Nell’elenco delle cartelle cerca la cartella corretta, in questo caso sarebbe magento1.

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

cd NOME_CARTELLA

NOME_CARTELLA va sostituito con il nome reale della cartella.

Installazione dell’estensione #

1. Una volta nella 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 le opzioni disponibili all’interno del Toolbox:

sh clerk_toolbox_magento.sh

3. Dal momento che vuoi installare l’estensione, userai -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. Ti verrà ora chiesto di inserire la tua password. Dopo averlo fatto, lo script farà un backup della tua cartella Magento1 e inizierà l’installazione dell’estensione:

5. Fatto! Ora l’estensione è installata e puoi configurarla nel backend di 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 i file sono stati danneggiati o mancanti, puoi effettuare una disinstallazione forzata come segue:

sudo sh clerk_toolbox_magento.sh -u --force

Ripristino Se qualcosa va storto nel tuo webshop, puoi sempre ripristinarlo tramite il backup effettuato 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 un backup preventivo, ma puoi anche creare un backup separato 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 sinistro, poi vai su “Configuration”.

Qui troverai opzioni per personalizzare come i dati dei prodotti, dei clienti e degli ordini si sincronizzano con Clerk.

Le seguenti impostazioni sono disponibili nell’estensione Magento 1 tramite il tuo admin portal Magento 1.

Cronologia ordini #

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

Page size #

Scegli la dimensione della pagina dei dati sincronizzati nel menu a tendina.

Dimensioni di pagina più piccole possono aiutare a evitare timeout dell’host durante la sincronizzazione, mentre dimensioni maggiori possono rendere la sincronizzazione più veloce.

Timeout server #

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

Il valore predefinito è 60 secondi.

Data parsing #

In questa sezione scegli se vuoi che i tuoi dati Magento 1 vengano analizzati automaticamente.

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

Orario di sincronizzazione #

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

Il predefinito è “quando necessario”.

Impostazioni estensione #

Se utilizzi la v4.8.0 o una versione successiva dell’estensione, potrai accedere alle seguenti impostazioni in due modi dopo aver inserito le tue Public e Private Keys nell’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 cambiamento fatto in my.clerk.io e viceversa.

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

Clicca su Edit su un’impostazione per vedere le opzioni disponibili.

Panoramica estensione #

Per accedere all’estensione Magento 1 Clerk, accedi al conto Admin del tuo store e scegli “Configuration” > “Clerk” > “Settings”.

Clerk settings #

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

Qui troverai la possibilità di abilitare/disabilitare l’estensione Clerk, così come le tue chiavi API pubbliche e private.

• Aggiornamenti in tempo reale:

  • Additional Fields

• Includi pagine

  • Additional Fields

• Raccogli email e carrelli dei clienti:

• Sync Subscribers: Importa lo stato degli iscritti alla newsletter per l’uso in Clerk.io email audiences.

• Disabilita sincronizzazione ordini:

• Includi prodotti esauriti

• Sincronizza solo prodotti con visibilità: Limita il feed prodotti ai prodotti con i valori di visibilità selezionati in Magento.

• Abilita tracciamento resi: Invia i prodotti resi a Clerk.io quando Magento registra un reso.

• Larghezza/Altezza immagine personalizzata: Imposta le dimensioni per le immagini inviate nel feed dei prodotti. Lascia entrambe vuote per utilizzare il valore predefinito dell’estensione di 210 pixel.

• Lingua e URL di importazione: Questi valori sono stati probabilmente impostati quando hai installato Clerk per la prima volta e sincronizzato con my.clerk.io. Se questi valori cambiano, basta scegliere la nuova lingua del negozio o inserire il nuovo URL di importazione qui.

Search settings #

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

Impostazioni Search Page:

• Dopo aver selezionato Yes, inserisci il nome dell’elemento Search Page dal campo data-template dell’embed code. Ad esempio, usa search-page se quello è il nome del tuo Element.

• Puoi anche impostare qui il testo del pulsante “Load More”, così come il testo che appare quando non ci sono risultati per una query.

• Show Categories, Number of Categories, Number of Pages e Pages Type controllano i risultati non-prodotto visualizzati sulla Search Page.

Impostazioni Faceted Search:

• Dopo aver abilitato la faceted search, hai la possibilità di inserire gli attributi che vorresti visualizzare come facet sulla tua Search Page.

Puoi anche etichettare queste facet con i nomi desiderati e scegliere l’ordine con cui vengono visualizzate.

Usa Multiselect Attributes per permettere ai visitatori di selezionare più di un valore all’interno di una facet contemporaneamente.

Personalizzazione facet #

Clerk ti consente di stilizzare la visualizzazione delle facet della Search Page dal design e puoi visualizzarle facendo riferimento al campo design ID.

Il design ID si trova nel backend Clerk, nella colonna più a sinistra di ogni design nella pagina panoramica dei design e in basso a sinistra della pagina una volta che entri nel design da modificare.

Nota: Ora puoi richiamare i dati per categorie e pagine nella Search page allo stesso modo del Live search, ampliando la gamma di informazioni con cui coinvolgere i tuoi clienti. Per maggiori informazioni puoi consultare qui.

Impostazioni Live Search

• Dopo aver abilitato Live Search, puoi selezionare se mostrare o meno le Categorie nei risultati, così come il numero di risultati suggerimenti suggestions, categories e content da visualizzare in Live Search.

  • Hai anche la possibilità di scegliere quali tipi di pagina visualizzare come risultati nella ricerca, ad esempio “CMS Pages” o “Blog Posts”.

  • Puoi scegliere la posizione del menu a tendina della live search rispetto alla barra di ricerca usando Dropdown Positioning.

• Fornisci il nome dell’elemento per il live search, lo trovi accanto a data-template nel tuo embed code Live Search presente nell’Element di my.clerk.io. Verosimilmente sarà live-search.

• Fornisci il Live Search Input Selector ispezionando la barra di ricerca del tuo webshop e identificando il relativo input ID o classe. Per un input con ID search, usa #search.

• Form Selector è il selettore per il form di ricerca. Usalo se il tuo tema utilizza un form personalizzato e il redirect di ricerca di default non è corretto.

Recommendations settings #

Allo stesso modo che per Search, abilita le impostazioni Clerk Powerstep, Exit Intent, Category Page, Product Page e Cart selezionando “Yes” dai menu a tendina relativi.

Dopo aver selezionato “Yes”, ti viene fornita una casella dove inserire il nome dell’elemento Clerk Recommendations che desideri includere in quella pagina.

• Trova il nome dell’elemento nel campo data-template dell’embed code sotto Recommendations > Elements in my.clerk.io. Ad esempio inserisci category-page-popular nelle impostazioni della Category Page se quello è il nome del tuo Element.

• Qui puoi aggiungere più nomi di elementi separati da virgole, ad esempio se vuoi mostrare più elementi nella stessa pagina.

• Filter Duplicates è disponibile per Powerstep, Category Page, Product Page e Cart. Abilitalo per evitare di mostrare lo stesso prodotto su più slider di raccomandazione nella stessa pagina.

Logging #

Le impostazioni di logging includono:

Logging Level

• Solo errori: Registra eventuali errori che impediscono il corretto funzionamento del modulo.

• Error + Warn: Registra anche i warning che non bloccano il funzionamento del modulo, ma potrebbero richiedere interventi.

• Error + Warn + Debug: Registra tutto con cui il modulo interagisce. Non abilitare su un sito web attivo, rallenterebbe il sito.

Logging to

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

• my.clerk.io: Tutto il log viene registrato in Developers->Logs nel backend di my.clerk.io.

Imposta Enable su Yes prima di utilizzare il logging. Quando si registra su file, l’estensione utilizza il percorso del file di log mostrato nella configurazione. Debug Mode apre le indicazioni di debug dell’estensione.

Traduzione dei testi #

L’estensione Clerk per Magento include di default le traduzioni per danese, inglese, olandese e italiano.

Puoi facilmente aggiungere una traduzione per la tua lingua, così che le parti frontend siano mostrati correttamente.

Per farlo, vai in questa cartella via FTP:

app->locale

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

Trova la cartella della tua lingua (nel folder locale di Magento) e inserisci il file qui.

Traduce il testo nella colonna di destra del file CSV, poi salvalo.

Aggiornamento #

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

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

• Eseguito un backup di tutti i file modificati, da trasferire nella nuova estensione.

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

Questi file si trovano qui:

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

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

Disattivazione e disinstallazione #

Prima di aggiornare, è molto importante che esegui queste operazioni:

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

2. Poi , disinstallala o tramite Magento Connect oppure eliminando i file da FTP se l’hai installata direttamente da lì.

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

Installa l’ultima versione #

Infine, installa nuovamente l’ultima versione dell’estensione, trasferendo tutti i file che hai eventualmente salvato in backup sul server FTP.

La configurazione dovrebbe essere salvata anche dopo l’installazione della nuova versione.

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

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

Disinstallazione #

Per rimuovere Clerk dal tuo store Magento 1, devi disabilitare l’estensione dal pannello di amministrazione 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 seleziona " Settings".

Da qui apparirà la sezione “Clerk Settings”. Accanto a " Enable", seleziona " No" dal menu a tendina per disabilitare l’estensione Clerk.

Se hai implementato Clerk.io tramite l’estensione, puoi anche disabilitare i singoli moduli impostando i relativi menu a tendina Search e Recommendations su No.

Se hai installato qualche elemento di Clerk direttamente nei tuoi file FTP, assicurati di rimuovere i relativi embed code da tali file.