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

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

Scegli il sito principale (il sito che stai cercando di influenzare) sotto AMBITO DI CONFIGURAZIONE CORRENTE:

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

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:

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

Quindi vai su my.clerk.io -> Sincronizzazione Dati e avvia una nuova sincronizzazione, facendo clic su Avvia Sincronizzazione.

Le tue nuove immagini saranno ora sincronizzate.

Scegliere i Prodotti da Importare #

Mostrare prodotti esauriti #

Se desideri mostrare anche prodotti esauriti nei tuoi risultati Clerk.io, puoi controllare facilmente questo nel backend di Magento.

Inizia andando su:

Sistema -> Configurazione -> CLERK -> Impostazioni

Scegli la tua Vista Negozio dal menu a sinistra e vai alle Impostazioni Clerk.

Qui, imposta Includi Prodotti Esauriti su Sì e fai clic su Salva Config:

Infine, vai su my.clerk.io -> Dati e fai clic su Avvia Nuova Sincronizzazione Dati per importare tutti i prodotti, inclusi quelli esauriti.

Modifiche avanzate #

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

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.io. Per impostazione predefinita, vengono importati solo i prodotti con visibilità: entrambi (Catalogo, Ricerca) che sono anche disponibili.

Questo può essere modificato nei due seguenti luoghi:

Se cambi i prodotti importati da Clerk.io, ti raccomandiamo vivamente di aggiungere anche un attributo extra che indica quando un prodotto non è vendibile o visibile, in modo da poterlo mostrare nel tuo Design e filtrarlo.

Assumendo che tu crei un attributo chiamato is_saleable che è true o false, puoi usarlo in questo modo in Designs:

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

Infine, vai su my.clerk.io -> Dati e fai clic su Avvia Nuova Sincronizzazione Dati per importare i tuoi nuovi dati.

Personalizzare i Dati del Prodotto #

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

Aggiungere attributi semplici #

Nota: Questa funzionalità funziona solo dalla v.4.2.3.

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

1. Nel tuo backend di Magento, inizia andando su Catalogo -> Attributi -> Gestisci Attributi

2. Trova i codici attributo degli attributi che desideri aggiungere:

3. Vai su Sistema -> Configurazione

4. Sotto Clerk -> Impostazioni scrivi i tuoi attributi in Campi Aggiuntivi e fai clic su Salva Config:

5. Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Dati e fai clic su Avvia Nuova Sincronizzazione Dati nell’angolo in alto a destra.

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

Aggiungere 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 desideri abbia in Clerk.io, e insertMagentoLogic(); utilizza una logica di Magento per estrarre un valore dal prodotto.

Utilizzare funzioni di attributo personalizzate #

A volte, un attributo di 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.

Ad esempio:

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

Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Dati e fai clic su Avvia Nuova Sincronizzazione Dati nell’angolo in alto a destra.

Modificare l’Estensione #

Aggiungere/Cambiare Dati del Prodotto #

Nel caso tu voglia aggiungere attributi extra o cambiare 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 del prodotto e ti consente di aggiungere attributi semplici.

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

Cambiare Dati delle Categorie #

Forse hai bisogno di ristrutturare i nomi delle categorie o rimuovere categorie specifiche da Clerk.io.

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, nome, URL e sottocategorie per ciascuna categoria.

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

Stilizzare il Passaggio Aggiungi al Carrello (Powerstep) #

Il powerstep ha uno stile standard, ma potresti voler cambiarlo 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 il CSS per tutte le parti dell’estensione Clerk.io, incluso il Powerstep.

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

Modificare la Pagina di Ricerca #

Se desideri cambiare il layout della Pagina di Ricerca, aggiungere uno slider alla pagina senza risultati, ecc. devi trovare questo file:

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

Questo ti consente di modificare il codice incorporato della ricerca e altre parti della pagina di ricerca.

Cambiare i titoli per Prodotti e Categorie nella Ricerca Live #

I titoli mostrati nella Ricerca Live per prodotti e categorie possono essere cambiati in questo file:

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

Qui, traduci semplicemente Categorie e Prodotti in ciò che desideri:

Prodotti Raggruppati come Varianti #

Per impostazione predefinita, Magento utilizza Prodotti Configurabili per gestire i prodotti principali e le varianti. L’estensione Clerk.io è stata realizzata per supportare questo, poiché è la prassi migliore per Magento.

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

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

Per Clerk.io, di solito non importa quale variante venga acquistata, purché il prodotto " principale" a cui appartiene venga tracciato.

Per risolvere questo problema, devi cambiare 2 file nell’estensione, per adattarli alla tua configurazione.

Il Tracciamento delle Vendite #

Il file che genera i dati di tracciamento delle vendite è 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, sia sempre l’ID del prodotto “principale” che viene inviato.

Gli Ordini Importati #

Lo stesso processo deve essere eseguito per i precedenti ordini che vengono importati in modo da sapere quali prodotti “principali” sono stati acquistati in precedenza.

Questo file gestisce il tutto:

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

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

Cambia questo con la stessa logica del tracciamento delle vendite.

Controlla se le tue modifiche funzionano #

Ora, vai su my.clerk.io -> Dati e fai clic su Avvia Nuova Sincronizzazione Dati per importare i dati più recenti:

Procedi a effettuare un ordine di prova in cui acquisti un prodotto che ha varianti.

Successivamente, vai su Ordini Tracciati e controlla l’ordine che hai appena effettuato. Se riesci a vedere i prodotti Principali nell’ordine, inclusi il loro nome e immagine, il tuo codice funziona: