Sync Data

Sincronizza i tuoi prodotti, categorie, ordini e pagine WooCommerce su Clerk. Questa guida copre le nozioni di base e le opzioni di personalizzazione avanzate.

Sincronizzazione dei dati #

Per importare i dati dal tuo store WooCommerce su Clerk, segui questi passaggi:

1. Crea uno Store su my.clerk.io.

2. Installa il Plugin Clerk in WooCommerce.

3. Configura il Plugin.

4. Infine, sincronizza il tuo Store seguendo questi passaggi:

   • Accedi a my.clerk.io.

   • Vai su Data > Configuration.

   • Inserisci il tuo Import URL, cioè l’URL di dominio del tuo webshop. Puoi trovarlo anche nella sezione Generale del Plugin Clerk in WooCommerce.

   • Clicca su Save.

   • Clicca su Start new data sync.

Clerk ora importerà i tuoi products, categories and orders.

Personalizzazione dei dati prodotto #

In WooCommerce, puoi aggiungere Custom product attributes tramite il backend di WooCommerce o tramite il plugin Clerk in codice, se necessario.

Aggiungi attributi semplici #

Se gli attributi che vuoi inviare sono già disponibili come attributi semplici nell’amministrazione di WooCommerce, possono essere facilmente aggiunti nella pagina del Plugin.

1. Vai al backend di WooCommerce.

2. Naviga su Products > Attributes.

3. Trova lo slug dell’attributo che vuoi aggiungere.

4. Clicca sul Plugin Clerk nel menu della barra laterale sinistra.

5. Nella sezione Data Sync, aggiungi l’attributo slug nel campo Additional Fields. Puoi aggiungerne diversi, separati da virgole.

6. Clicca su Save Settings.

7. Vai su my.clerk.io > Data > Configuration e clicca su Start New Data Sync.

Aggiungi manualmente gli attributi #

Gli attributi in WooCommerce possono essere aggiunti anche tramite codice in due file.

Questi file sono utilizzati per sincronizzare i prodotti sia manualmente che automaticamente quando vengono apportate modifiche al webshop.

Ecco i file:

1. wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php nella funzione add_product:

2. wp-content > plugins > clerkio > includes > class-clerk-rest-api-php nella funzione product_endpoint_callback in $product_array:

Ogni attributo è strutturato così:

$product_array['sku'] = $product->get_sku();

Dove ['sku'] definisce il nome che vuoi dare all’attributo in Clerk, e = $product->get_sku() è la logica WooCommerce per recuperare l’attributo.

Attributi in Functions.php #

Puoi anche aggiungere nuovi attributi a Clerk modificando il file functions.php.

Queste modifiche resteranno anche quando il plugin sarà aggiornato.

Segui questi passaggi:

1. Aggiungi il seguente codice a Appearance > Theme Editor > functions.php:

// Alters clerk parameters
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 ) {

// Used to hide hidden products from search
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// We only use short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Opzionale) Se vuoi includere attributi personalizzati (come brand, color o material) in Clerk, modifica la funzione così:

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) {

    $params['catalog_visibility'] = $product->get_catalog_visibility();
    $params['description'] = $product->get_short_description();

    // Add custom attributes
    $params['brand'] = $product->get_attribute('brand');
    $params['color'] = $product->get_attribute('color');
    $params['material'] = $product->get_attribute('material');

    return $params;
}

3. Sostituisci “brand”, “color” e “material” con qualsiasi attributo WooCommerce che desideri sincronizzare. Se gli attributi non appaiono, assicurati che siano definiti sotto Products > Attributes nel backend WooCommerce.

4. Infine, vai su my.clerk.io > Data > Configuration e clicca su Start New Data Sync per importare i nuovi attributi.

Importazione delle impostazioni prodotto #

Di default, il plugin WooCommerce di Clerk importa solo Published products.

Questo può essere cambiato se necessario.

Il seguente file controlla quali prodotti sono importati su Clerk: wp-content > plugins > clerkio > includes > class-clerk-rest-api.php

1. Nel file, individua la funzione chiamata product_endpoint_callback.

2. Nell’elenco $products, sotto 'status', aggiungi qualsiasi Status che desideri includere, separati da virgole:

3. Quando si importano prodotti non pubblicati, aggiungi un attributo is_saleable che restituisca true o false per tracciare la disponibilità.

Questo ti consente di mostrare lo stato di disponibilità nei tuoi Designs così:

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

4. Vai su my.clerk.io > Data e clicca su Start New Sync per importare i nuovi prodotti.

Disattiva la sincronizzazione degli ordini #

Dopo che la prima sincronizzazione dei dati è andata a buon fine, la sincronizzazione degli ordini da WooCommerce può essere disattivata dato che il monitoraggio delle vendite tramite l’estensione prende il controllo.

Hai due opzioni: da my.clerk.io o dal Plugin in WooCommerce.

my.clerk.io #

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

2. Scorri verso il basso e sulla destra, cambia l’opzione sotto Import Orders da Yes a No, quindi clicca su Save.

Clerk non importerà più gli ordini da WooCommerce.

Plugin #

1. Accedi al backend WooCommerce e clicca su Clerk nel menu della barra laterale sinistra.

2. Nelle impostazioni del Plugin, scorri fino alla sezione Data Sync: Orders. Spunta la casella chiamata Disable Order Synchronization.

3. Per rendere effettive le modifiche, clicca su Save Settings.

Sincronizzazione delle pagine #

Importante: Per far funzionare questa funzione, è necessario che WooCommerce sia installato e attivato sulla tua configurazione WordPress. Non è necessario utilizzarlo o configurarlo, ma il plugin ha funzionalità essenziali che il Plugin Clerk richiede.

Poiché uno store su Clerk si collega principalmente alla tua piattaforma e-commerce per sincronizzare cataloghi, ordini e clienti, mantenere aggiornati contenuti blog esterni può essere una sfida.

Per risolvere questo, ora forniamo una soluzione no-code per sincronizzare i contenuti blog con qualsiasi store Clerk indipendentemente dalla piattaforma principale, se gestisci i tuoi blog tramite WordPress/WooCommerce.

Per utilizzare questa funzione, segui questi passaggi:

1. Installa il nostro plugin nel backend WordPress.

2. Una volta installato, clicca su Clerk nella barra laterale sinistra.

3. Inserisci le tue API keys da Developers > API keys su my.clerk.io per configurare il plugin.

4. Poiché in questo caso vogliamo solo importare i contenuti scritti, sarà sufficiente abilitare Use Real-time Updates nella sezione Data Sync: Pages.

5. Clicca su Save Settings.

6. Dopo aver salvato le impostazioni, troverai un pulsante Sync Pages nella sezione Data Sync: Pages. Cliccando su questo pulsante sincronizzerai immediatamente tutte le tue pagine con il tuo store my.clerk.io.

Il Plugin ti permette anche di personalizzare quali attributi pagina sincronizzare.

Puoi specificare Additional Fields da recuperare per ogni pagina e includere Page Additional Types creati da plugin di terze parti.

Dovrai premere il pulsante Sync Pages solo una volta, poiché ogni modifica/inserimento/pubblicazione/archiviazione/eliminazione sarà intercettata dal nostro plugin e aggiornata automaticamente nello store my.clerk.io.

Disattivazione dell’importazione delle pagine #

Per assicurarti che le pagine vengano sincronizzate solo da WordPress e non da altre fonti durante la Data Sync, disabilita l’importazione delle pagine su my.clerk.io:

1. Vai su Data > Configuration.

2. Trova l’impostazione Import Pages e impostala su No.

3. Clicca su Save.