Sync Data

Sincronizza i tuoi prodotti PrestaShop, attributi e dati degli ordini su Clerk. Questa guida copre la personalizzazione dei dati dei prodotti, la scelta di quali prodotti importare e la gestione della sincronizzazione degli ordini.

Prima di sincronizzare i dati, assicurati di aver installato e configurato il modulo Clerk nel backend di PrestaShop. Consulta la guida Get Started per le istruzioni di installazione.

Configura la sincronizzazione #

Per sincronizzare i dati del tuo negozio PrestaShop con Clerk, devi configurare le impostazioni di sincronizzazione dei dati in Clerk.

1. Vai su my.clerk.io > Data > Configuration.

2. Inserisci l’URL del tuo webshop in Store URL.

3. Se prevedi di utilizzare Email & Audience, imposta Collect Emails su Sì nel modulo Prestashop e Salva.

4. Se applicabile, seleziona la lingua del tuo dominio.

5. Clicca su Start Sync e attendi che la sincronizzazione sia completata.

Personalizzazione dei dati dei prodotti #

In Prestashop, puoi aggiungere la maggior parte degli attributi semplici direttamente dall’Admin, ma puoi anche creare attributi personalizzati direttamente nel codice.

Invio di attributi semplici #

Nota: Questa funzione è disponibile solo dalla versione 5.3.2. Consulta questa guida per vedere come eseguire l’upgrade.

Nell’Admin di Prestashop, inizia accedendo alla seguente sezione:

Prestashop 1.7: Catalogo -> Attributi & Caratteristiche Prestashop 1.6 : Catalogo -> Attributi del prodotto

Qui puoi vedere tutti gli attributi disponibili:

Trova i nomi degli attributi che vuoi aggiungere.

Poi vai su Modules And Services -> Clerk -> Configure.

Sotto Data Sync Settings, digita i Names degli attributi separati da virgola in Additional Fields for Products.

Puoi anche attivare campi come Include Product Features per importare tutte le caratteristiche dei prodotti su clerk.

Entrambe queste opzioni sono disponibili sia nella versione 1.6 che nella 1.7 di Prestashop:

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

Se gli attributi che vuoi inviare sono già disponibili come parte dei dati dei tuoi prodotti configurabili/raggruppati nell’admin di PrestaShop, possono essere facilmente sincronizzati sull’ultima versione del tuo plug-in.

Appariranno come child_attribute, ad esempio, child_color, child_skus ecc.

Invio di attributi personalizzati #

Gli attributi personalizzati, che sono più avanzati, possono essere aggiunti tramite i file del modulo in FTP.

Questo file gestisce i product-attributes:

modules->clerk->controllers->front->product.php

Ogni attributo ha il suo fieldHandler, utilizzato per recuperarlo, nella funzione __construct

Basta aggiungere il tuo attributo qui, con la seguente sintassi:

$this->addFieldHandler('CLERK_ATTRIBUTE_NAME',function($product){
return PRESTASHOP_LOGIC;
});

Dove CLERK_ATTRIBUTE_NAME definisce il nome che vuoi abbia in Clerk e PRESTASHOP_LOGIC è il codice per recuperare l’attributo da Prestashop.

Infine, includi i tuoi nuovi attributi nella funzione getDefaultFields() in fondo al file.

Scelta dei prodotti da importare #

Puoi configurare il modulo PrestaShop per inviare tutti i prodotti a Clerk, invece che solo quelli vendibili come impostato di default.

Per farlo, inizia trovando questo file in FTP:

modules->clerk->controllers->front->product.php

Nella funzione getJsonResponse() trova questa riga:

$products = $product->getProducts($this->getLanguageId(), $this->offset, $this->limit, $this->order_by, $this->order, false, false);

Semplicemente cambia l’ultimo argomento da true a false.

Se fai questa modifica, ti consigliamo anche di aggiungere un attributo extra in questo file, che indichi quando un prodotto non è vendibile, così potrai mostrarlo nel tuo Design.

Supponendo che tu crei un attributo chiamato is_saleable che può essere true o false, puoi usarlo così in Designs:

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

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

Disattivare la sincronizzazione degli ordini #

Dopo che la prima sincronizzazione dati è andata a buon fine, la sincronizzazione degli ordini da Prestashop può essere disattivata poiché il sales-tracking del modulo prende il controllo.

Per disattivare la sincronizzazione degli ordini, vai su Migliora => Moduli => Gestione Moduli

Scorri fino in fondo e trova il modulo Clerk sotto altri. Clicca su Configura:

Scorri fino al campo chiamato Impostazioni per la sincronizzazione dei dati e clicca su SÌ accanto al testo Disattiva la sincronizzazione degli ordini:

Scorri fino in fondo alla pagina e premi Salva:

Le tue modifiche avranno effetto.