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 modificare) sotto l’AMBITO DI CONFIGURAZIONE CORRENTE:

Quindi fai clic su IMPOSTAZIONI sotto la scheda CLERK nella barra laterale sinistra e poi 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 cambiato 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 che desideri che le immagini abbiano e salva il file.

Poi vai su my.clerk.io -> Data Sync e avvia una nuova sincronizzazione, facendo clic su Inizia Sincronizzazione.

Le tue nuove immagini saranno ora sincronizzate.

Scegliere i Prodotti da Importare #

Mostrare prodotti esauriti #

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

Inizia andando su:

Sistema -> Configurazione -> CLERK -> Impostazioni

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

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

Infine, vai su my.clerk.io -> Data e fai clic su Inizia 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 in stock.

Questo può essere cambiato nei due seguenti posti:

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 filtrare su di esso.

Supponendo che tu crei un attributo chiamato is_saleable che sia 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 -> Data e fai clic su Inizia Nuova Sincronizzazione Dati per importare i tuoi nuovi dati.

Personalizzazione dei Dati del Prodotto #

In Magento 1, puoi aggiungere attributi personalizzati del prodotto tramite 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->Data e fai clic su Inizia 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 vuoi che 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, trova 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->Data e fai clic su Inizia Nuova Sincronizzazione Dati nell’angolo in alto a destra.

Modificare l’Estensione #

Aggiungere/Cambiare Dati del Prodotto #

Nel caso in cui 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 utilizzarli in Product.php.

Cambiare Dati di Categoria #

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.

Styling del 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 styling:

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 cambiare il codice embed 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, semplicemente traduci 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 migliore pratica 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 viene acquistata, purché il prodotto " principale" a cui appartiene venga tracciato.

Per risolvere questo, 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 è stata acquistata, è sempre l’ID del prodotto “principale” che viene inviato.

Gli Ordini Importati #

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

Questo file lo gestisce:

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 -> Data e fai clic su Inizia 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 puoi vedere i prodotti Principali nell’ordine, inclusi il loro nome e immagine, il tuo codice funziona: