Sync Data

Personalizzazione dei dati del prodotto #

In WooCommerce puoi aggiungere attributi personalizzati del prodotto tramite il backend di WooCommerce, o tramite il plugin Clerk.io in codice, se necessario.

Aggiunta di Attributi Semplici #

Se gli attributi che desideri inviare sono già disponibili come attributi semplici nel tuo admin di WooCommerce, possono essere facilmente aggiunti nella pagina del Plugin.

1. Nel tuo backend di WooCommerce, inizia andando su Prodotti -> Attributi

2. Qui, trova lo slug dell’attributo che desideri aggiungere.

3. Ora vai su Clerk -> Impostazioni .

4. Sotto Campi Aggiuntivi, aggiungi lo slug dell’attributo. Puoi anche aggiungerne diversi, separati da virgola:

5. Scorri fino in fondo alla pagina e clicca su Salva Impostazioni:

6. Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Stato di Sistema -> Sincronizzazione Dati e clicca 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 WooCommerce, possono essere facilmente sincronizzati nell’ultima versione del tuo plugin. Appariranno come child_attribute, per esempio, child_color, child_skus ecc.

Aggiunta di attributi tramite codice #

Gli attributi in WooCommerce possono anche essere aggiunti in codice, tramite due file, poiché vengono utilizzati per sincronizzare i prodotti manualmente e automaticamente quando vengono apportate modifiche nel webshop.

Questi sono i file:

wp-content->plugins->clerkio->includes->class-clerk-product-sync.php

nella funzione add_product

wp-content->plugins->clerkio->includes->class-clerk-rest-api-php

nella funzione product_endpoint_callback in $productArray

Ogni attributo è strutturato in questo modo:

'sku'   => $product->get_sku(),

dove ‘sku’ definisce il nome che desideri avere in Clerk.io, e => $product->get_sku(), è una logica di WooCommerce per estrarre l’attributo.

Aggiunta di Dati del Prodotto Utilizzando functions.php #

Nuovi attributi possono anche essere aggiunti a Clerk.io modificando il file functions.php, e non verranno sovrascritti quando il plugin viene aggiornato.

Aggiungi il seguente codice al backend di WooCommerce in Aspetto > Editor del Tema > functions.php :

// Modifica i parametri di clerk
add_filter( 'clerk_product_sync_array', 'clerk_change_params', 10, 2 );
add_filter( 'clerk_product_array', 'clerk_change_params', 10, 2 );

function clerk_change_params( $params, $product ) {

// Usato per nascondere i prodotti nascosti dalla ricerca
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// Utilizziamo solo short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

Infine, vai su my.clerk.io -> Stato di Sistema -> Sincronizzazione dati e clicca su Inizia Nuova Sincronizzazione Dati per importare i tuoi nuovi attributi.

Scelta dei prodotti da importare #

Per impostazione predefinita, il plugin WooCommerce di Clerk.io importa solo Prodotti Pubblicati.

Questo può essere cambiato se necessario.

Il seguente file controlla quali prodotti vengono importati in Clerk.io:

wp-content->plugins->clerkio->includes->class-clerk-rest-api.php.

Nel file, trova la funzione chiamata product_endpoint_callback.

Nella lista $products, sotto ‘status’ aggiungi semplicemente qualsiasi Stato che desideri includere, separato da virgole:

Se fai questo, ti raccomandiamo vivamente di aggiungere anche un attributo extra che indica quando un prodotto non è vendibile, in modo da poterlo mostrare nel tuo Design. Assumendo che tu crei un attributo chiamato is_saleable che è true o false, puoi usarlo in questo modo nei Design:

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

Poi vai su my.clerk.io -> Dati e clicca su Inizia Nuova Sincronizzazione per importare i nuovi prodotti.

Disattivare la sincronizzazione degli ordini #

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

Per disattivare la sincronizzazione degli ordini, vai nel tuo backend di Wordpress, vai su Clerk nel menu a sinistra e clicca su Impostazioni Clerk:

Successivamente, scorri fino al titolo chiamato Sincronizzazione (nella tua lingua) e spunta la casella accanto a “Disattiva Sincronizzazione Ordini”, in questo modo:

Per far sì che le modifiche abbiano effetto, scorri fino in fondo alla pagina e premi Salva:

Sincronizzazione con altre piattaforme #

Dalla versione v4.1.7 del nostro Plugin WordPress hai la possibilità di sincronizzare pagine, post e altri contenuti del blog con qualsiasi negozio Clerk.

Importante: Affinché questo funzioni, devi avere WooCommerce installato e attivato nel tuo setup di WordPress. Non è necessario utilizzarlo o configurarlo, ma il plugin ha funzionalità essenziali di cui il plugin Clerk ha bisogno.

Poiché un negozio in Clerk.io è principalmente collegato alla tua piattaforma di e-commerce per condividere informazioni su cataloghi, ordini e clienti, può essere difficile mantenere i contenuti del tuo blog sincronizzati con Clerk se non sono gestiti su quella piattaforma.

Per questo motivo, ora forniamo una soluzione senza codice per mantenere questi contenuti sincronizzati con qualsiasi negozio Clerk indipendentemente dalla piattaforma principale, se gestisci i tuoi blog tramite WordPress/WooCommerce.

Per utilizzare la funzionalità, installa semplicemente il nostro plugin sul tuo sito WordPress. Nelle impostazioni del modulo dovresti quindi configurare le tue chiavi API, prese dal negozio in my.clerk.io con cui desideri sincronizzare i tuoi contenuti.

Poiché vogliamo solo importare contenuti scritti in questo caso, dovresti solo abilitare Usa Aggiornamenti in Tempo Reale nella sezione Sincronizzazione Dati: Pagine.

Dopo aver salvato le impostazioni vedrai un pulsante a destra della casella di controllo, con il testo Sincronizza Pagine. Puoi premere questo per inviare immediatamente tutte le pagine al negozio my.clerk.io.

Puoi anche inserire ulteriori attributi che desideri recuperare per le pagine in questione, così come l’inclusione di tipi di pagina personalizzati che potresti aver creato utilizzando plugin di terze parti.

Dovresti premere il pulsante Sincronizza Pagine solo una volta, poiché qualsiasi modifica a una pagina, pubblicazione di una nuova pagina, archiviazione o cancellazione di una verrà catturata dal nostro plugin e aggiornata automaticamente nel negozio my.clerk.io.

Se desideri assicurarti che nessuna pagina venga estratta da altre fonti durante la sincronizzazione notturna per il negozio, ti raccomandiamo anche di disattivare la sincronizzazione completa per le pagine in my.clerk.io.

Questo può essere fatto in Stato di Sistema -> Sincronizzazione Dati, disattivando Importa Pagine.