Sync Data

Sincronizza i tuoi prodotti Magento 1, attributi e dati degli ordini con Clerk. Questa guida copre la personalizzazione dei dati dei prodotti, la scelta dei prodotti da importare, la modifica delle dimensioni delle immagini e la gestione della sincronizzazione degli ordini.

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 prende il controllo.

Per disattivare la sincronizzazione degli ordini, vai nel backend di Magento1, seleziona SYSTEM nella barra del menu e premi CONFIGURATION:

Scegli il sito principale (il sito che stai tentando di influenzare) sotto CURRENT CONFIGURATION SCOPE:

Quindi fai clic su SETTINGS sotto la scheda CLERK nella barra laterale sinistra e quindi modifica il campo accanto a DISABLE ORDER SYNCHRONIZATION da NO a YES.

Premi SAVE CONFIG per rendere immediatamente effettive le modifiche:

Modifica delle dimensioni delle immagini #

Per impostazione predefinita, l’estensione Clerk per Magento scarica le 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 ogni immagine:

Modifica questi valori alla dimensione desiderata per le immagini e salva il file.

Quindi vai su my.clerk.io -> Data Sync e avvia una nuova sincronizzazione, facendo clic su Start Sync.

Le tue nuove immagini saranno ora sincronizzate.

Scelta dei prodotti da importare #

Mostrare i prodotti esauriti #

Se vuoi mostrare anche i prodotti esauriti nei risultati Clerk, puoi controllarlo facilmente nel backend di Magento.

Inizia andando su:

System -> Configuration -> CLERK -> Settings

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

Qui imposta Include Out Of Stock Products su Yes e fai clic su Save Config:

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

Modifiche avanzate #

In Magento, il seguente file controlla quali prodotti vengono importati in Clerk:

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

La funzione load($page,$limit) è responsabile del controllo della collezione di prodotti che vengono inviati a Clerk.

Di default, vengono importati solo i prodotti con visibility: both (Catalog, Search) che sono anche in stock.

Questo può essere modificato nei due seguenti punti:

Se cambi i prodotti importati da Clerk, consigliamo vivamente di aggiungere anche un attributo extra che indichi quando un prodotto non è vendibile o visibile, così puoi mostrarlo nel tuo Design e filtrarlo.

Supponendo che crei un attributo chiamato is_saleable che sia true o false, puoi usarlo così in 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 -> Data e fai clic su Start New Data Sync per importare i tuoi nuovi dati.

Personalizzazione dei dati del prodotto #

In Magento 1, puoi aggiungere attributi prodotto personalizzati tramite il backend di Magento, oppure tramite l’estensione Clerk nel codice, se necessario.

Aggiunta di attributi semplici #

Nota: questa funzione funziona solo dalla versione v.4.2.3.

Se gli attributi che vuoi inviare sono già disponibili come attributi semplici nel tuo admin Magento, possono essere facilmente aggiunti nella pagina dell’Estensione.

1. Nel tuo backend Magento, inizia andando su Catalog -> Attributes -> Manage Attributes

2. Trova i attribute codes degli attributi che vuoi aggiungere:

3. Vai su System -> Configuration

4. Sotto Clerk -> Settings scrivi i tuoi attributi in Additional Fields e fai clic su Save Config:

5. Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Data e fai clic su Start New Data Sync nell’angolo in alto a destra.

Se gli attributi che vuoi inviare sono già disponibili come parte dei tuoi dati di prodotti configurabili/grupped nel tuo admin Magento, possono essere facilmente sincronizzati sull’ultima versione del tuo 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, questo 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 vuoi che abbia in Clerk, e insertMagentoLogic(); usa una logica di Magento per estrarre un valore dal prodotto.

Utilizzare funzioni personalizzate per gli attributi #

A volte, un attributo Magento potrebbe richiedere una logica più avanzata rispetto a una semplice funzione.

In questo caso, individua questo 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 proprio come le funzioni esistenti.

Per esempio:

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

Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Data e fai clic su Start New Data Sync nell’angolo in alto a destra.

Modificare l’estensione #

Aggiunta/modifica dei dati del prodotto #

Nel caso in cui tu voglia aggiungere attributi extra o modificare quelli esistenti per i tuoi prodotti, dovresti trovare 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 di prodotto e ti permette di aggiungere attributi semplici.

Productpage.php ti permette di creare logiche avanzate per ottenere attributi, e usarle in Product.php.

Modifica dei dati di categoria #

Forse bisogna ristrutturare i nomi delle categorie o rimuovere categorie specifiche da Clerk.

In questi casi, trova 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 subcategories per ogni categoria.

Non puoi aggiungere dati extra a ogni categoria, ma puoi modificare ciò che viene inviato.

Stilizzazione del Powerstep #

Il powerstep ha una stilizzazione standard, ma potresti voler cambiarlo per adattarlo ai tuoi progetti.

Questi file sono usati 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 la popup.

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

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

Modifica della pagina di ricerca #

Se vuoi modificare il layout della pagina di Search, aggiungere uno slider alla pagina senza risultati, ecc., devi trovare questo file:

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

Questo ti permette di modificare il codice di incorporamento della ricerca e altre parti della pagina di ricerca.

Modifica dei titoli della live-search #

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

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

Qui, basta tradurre Categories e Products in quello che vuoi:

Prodotti raggruppati come varianti #

Per impostazione predefinita, Magento usa Configurable Products per gestire prodotti principali e varianti.

L’estensione Clerk è stata realizzata per supportarlo, poiché è la best practice per Magento.

Tuttavia, se hai impostato i tuoi Variants usando Grouped Products, il tracciamento delle vendite non funzionerà, poiché terrà traccia degli ID dei prodotti che Clerk non ha importato dal tuo negozio Magento.

Questo perché Variants di solito non sono visibili.

Clerk non sarà in grado di vedere le connessioni tra i prodotti quando non sono importati:

Per Clerk, di solito non importa quale variante sia stata acquistata, purché il prodotto “main” a cui appartiene venga tracciato.

Per risolvere questo, è necessario cambiare 2 file nell’estensione, per adattarsi alla tua configurazione.

Il sales-tracking #

Il file che genera i dati del sales-tracking è questo:

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

In questo file, di solito intorno alla linea 65, viene utilizzato il seguente pezzo di codice per ottenere l’ID del prodotto che è stato acquistato:

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

Gli ordini importati #

Lo stesso processo deve essere eseguito anche per gli ordini precedenti importati in modo da sapere quali prodotti “main” sono stati acquistati in passato.

Questo file se ne occupa:

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

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

Modificalo con la stessa logica del sales-tracking.

Verifica che le modifiche funzionino #

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

Procedi a effettuare un test-order in cui acquisti un prodotto che ha variant.

Successivamente, vai su Orders e apri l’ordine che hai appena effettuato.

Se riesci a vedere i prodotti Main nell’ordine, incluso nome e immagine, il tuo codice funziona: