Sync Data

Disattivare la sincronizzazione degli ordini #

Dopo che la prima sincronizzazione dei dati è stata eseguita con successo, la sincronizzazione degli ordini da Magento1 può essere disattivata poiché il tracciamento delle vendite dall’estensione subentra.

Per disattivare la sincronizzazione degli ordini, accedi al backend di Magento1, scegli SISTEMA nella barra del menu e premi CONFIGURAZIONE:

Seleziona il sito principale (il sito che desideri modificare) sotto AMBITO CONFIGURAZIONE CORRENTE:

Quindi clicca su IMPOSTAZIONI sotto la scheda CLERK nella barra laterale sinistra e poi cambia il campo accanto a DISATTIVA SINCRONIZZAZIONE DEGLI ORDINI da NO a SÌ. Premi SALVA CONFIG per rendere effettive immediatamente le modifiche:

Modificare le dimensioni delle immagini dei prodotti #

Per impostazione predefinita, l’estensione Clerk.io per Magento recupera immagini con una dimensione di 210x210 px.

Questo può essere modificato nel seguente file:

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

Nella parte superiore di questo file, le variabili $imageHeight e $imageWidth controllano l’altezza e la larghezza di ciascuna immagine:

Modifica questi valori secondo le dimensioni desiderate e salva il file.

Poi vai su my.clerk.io -> Data Sync ed esegui una nuova sincronizzazione, cliccando su Start Sync.

Le nuove immagini verranno ora sincronizzate.

Selezione dei prodotti da importare #

Visualizzazione di prodotti esauriti #

Se desideri mostrare anche i prodotti esauriti nei risultati di Clerk.io, puoi controllare facilmente questa opzione nel backend di Magento.

Inizia andando su:

Sistema -> Configurazione -> CLERK -> Impostazioni

Seleziona la Store View dal menu a sinistra e vai su Clerk Settings.

Qui, imposta Includi prodotti esauriti su Sì e clicca su Save Config:

Infine, vai su my.clerk.io -> Dati e clicca su Start New Data Sync per importare tutti i prodotti, inclusi quelli esauriti.

Modifiche avanzate #

In Magento, il file seguente controlla quali prodotti vengono importati su Clerk.io:

app->code->community->Clerk->Clerk->Model->Productpage.php

La funzione load($page,$limit) è responsabile del controllo della collezione di prodotti inviati a Clerk.io. Per impostazione predefinita, vengono importati solo i prodotti con visibilità: entrambi (Catalogo, Search) che sono anche disponibili in magazzino.

Questo può essere modificato nei due punti seguenti:

Se modifichi i prodotti importati da Clerk.io, raccomandiamo fortemente di aggiungere anche un attributo extra che indichi quando un prodotto non è vendibile o visibile, così da poterlo mostrare nel tuo Design e poter filtrare su di esso.

Supponendo che tu crei un attributo chiamato is_saleable che sia true o false, puoi utilizzarlo così nei Designs:

{% if product.is_saleable %}
   <div class="in-stock">In Stock</div>
{% else %}
  <div class="not-in-stock">Not In Stock</div>
{% endif %}

Infine, vai su my.clerk.io -> Dati e clicca su Start New Data Sync per importare i nuovi dati.

Personalizzare i dati dei prodotti #

In Magento 1, puoi aggiungere attributi personalizzati dei prodotti tramite il backend di Magento o tramite l’estensione Clerk.io nel codice, se necessario.

Aggiunta di attributi semplici #

Nota: Questa funzionalità è disponibile solo dalla versione v.4.2.3.

Se gli attributi che vuoi inviare sono già disponibili come attributi semplici nell’admin di Magento, puoi aggiungerli facilmente dalla pagina dell’Estensione.

1. Nel backend di Magento, vai su Catalogo -> Attributi -> Gestisci Attributi

2. Trova i codici degli attributi che desideri aggiungere:

3. Vai su Sistema -> Configurazione

4. Sotto Clerk -> Settings inserisci i tuoi attributi in Additional Fields e clicca su Save Config:

5. Dopo aver implementato gli attributi, vai su my.clerk.io->Data e clicca su Start New Data Sync in alto a destra.

Se gli attributi che vuoi inviare sono già disponibili come parte dei dati dei prodotti configurabili/raggruppati nel tuo Magento admin, possono essere sincronizzati facilmente con l’ultima versione del plug-in. Appariranno come child_attribute, ad esempio child_color, child_skus ecc.

Aggiunta di attributi tramite codice #

Se il tuo attributo utilizza una funzione standard di Magento, può essere implementato direttamente in Product.php:

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

La funzione getClerkExportData() costruisce l’oggetto prodotto, con tutti gli attributi:

Puoi quindi aggiungere nuovi attributi nell’elenco con questa sintassi:

$data->setAttributeName($this->insertMagentoLogic());

dove setAttributeName definisce il nome che desideri dare in Clerk.io, e insertMagentoLogic(); utilizza una logica Magento per estrarre un valore dal prodotto.

Utilizzo di funzioni di attributi personalizzati #

Talvolta un attributo Magento potrebbe richiedere una logica più avanzata di una semplice funzione. In questo caso individua il seguente file:

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

In Productbase.php puoi scrivere funzioni PHP avanzate per caricare attributi personalizzati.

Dopo aver definito una funzione, puoi includerla in Product.php esattamente come le funzioni già esistenti.

Ad esempio:

$data->setAge($this->getAge());

Dopo aver implementato gli attributi, vai su my.clerk.io->Data e clicca su Start New Data Sync in alto a destra.

Modificare l’Estensione #

Aggiunta/modifica dei dati del prodotto #

Se vuoi aggiungere attributi extra o modificare quelli esistenti per i tuoi prodotti, trova questi file:

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

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

Product.php costruisce il modello prodotto e permette di aggiungere attributi semplici.

Productpage.php consente di creare logiche avanzate per ottenere attributi e utilizzarli in Product.php.

Modifica dei dati delle categorie #

Potresti dover ristrutturare i nomi delle categorie o rimuovere categorie specifiche da Clerk.io.

In questi casi, individua questo file:

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

Questo file gestisce quali categorie sono incluse e i dati id, name, URL e sottocategorie per ciascuna categoria.

Non puoi aggiungere dati extra a ciascuna categoria, ma puoi modificare cosa viene inviato.

Personalizzare lo step Aggiungi al carrello (Powerstep) #

Il powerstep ha uno stile standard, ma potrebbe essere necessario modificarlo per adattarlo ai tuoi design.

Questi file sono utilizzati per lo stile:

app->design->frontend->base->default->template->clerk->powerpage.phtml

app->design->frontend->base->default->template->clerk->powerpopup.phtml

skin->frontend->base->default->clerk->style.css

powerpage.phtml contiene l’HTML per la pagina mentre powerpopup.phtml è per il popup.

style.css contiene i CSS per tutte le parti dell’estensione Clerk.io, incluso il Powerstep.

Puoi utilizzare questi file per modificare l’aspetto del Powerstep.

Modificare la Search Page #

Se desideri cambiare il layout della Search Page, aggiungere uno slider alla pagina dei risultati nulli, ecc., devi trovare questo file:

app->design->frontend->base->default->template->clerk->powerpage.phtml

Questo file permette di modificare il search embedcode e altre parti della pagina di ricerca.

Cambiare titoli per prodotti e categorie nella Live-Search #

I titoli visualizzati nella Live-Search per prodotti e categorie possono essere modificati in questo file:

app->design->frontend->base->default->template->clerk->livesearch.phtml

Qui, semplicemente traduci Categories e Products secondo le tue esigenze:

Prodotti raggruppati come varianti #

Per default, Magento utilizza i Prodotti Configurabili per gestire i prodotti principali e le varianti. L’estensione Clerk.io è stata progettata per supportare questa modalità, in quanto è la best-practice per Magento.

Tuttavia, se hai configurato le tue Varianti tramite Prodotti Raggruppati, il tracciamento delle vendite non funzionerà, poiché stai tracciando gli ID di prodotti che Clerk.io non ha importato dal tuo webshop Magento. Questo perché le Varianti di solito non sono visibili.

Clerk.io non potrà visualizzare le connessioni tra prodotti quando non vengono importati:

Per Clerk.io, solitamente non importa quale variante viene acquistata, purché venga tracciato il prodotto “main” a cui appartiene.

Per risolvere questo, è necessario modificare 2 file dell’estensione in base alla tua configurazione.

Il tracciamento delle vendite #

Il file che genera i dati di tracciamento delle vendite è il seguente:

app->code->Block->SalesTracking.php

In questo file, solitamente intorno alla riga 65, viene utilizzato il seguente frammento di codice per ottenere l’ID del prodotto acquistato:

Questo deve essere modificato in modo che, indipendentemente da quale variante di prodotto raggruppato sia stata acquistata, venga inviato sempre l’ID del prodotto “main”.

Gli ordini importati #

Lo stesso processo deve essere fatto per gli ordini precedenti importati, così da sapere quali prodotti “main” sono stati acquistati in precedenza.

Questo file lo gestisce:

app->code->Model->Orderpage.php

Intorno alla riga 44, nella funzione orderFormatter($order) viene inviato l’ID del prodotto da Magento:

Modifica secondo la stessa logica utilizzata per il tracciamento delle vendite.

Verifica che le modifiche funzionino #

Ora, vai su my.clerk.io -> Dati e clicca su Start New Data Sync per importare i dati più recenti:

Procedi con un ordine di prova acquistando un prodotto che abbia varianti.

Successivamente, vai su Tracked Orders e controlla l’ordine appena effettuato. Se vedi i prodotti Main nell’ordine, incluso nome e immagine, il tuo codice funziona: