Sync Data

Sincronizzazione dati #

Per importare dati dal tuo negozio WooCommerce a Clerk.io, segui questi passaggi:

1. Crea un Negozio in my.clerk.io.
2. Installa il Plugin Clerk.io in WooCommerce.
3. Configura il Plugin.
4. Infine, sincronizza il tuo Store seguendo questi passaggi:
   • Accedi a my.clerk.io.
   • Vai a System Status > Data Sync.
   • Inserisci il tuo Import URL, che è l’URL del tuo negozio online. Puoi trovarlo anche nella sezione Generale del Plugin Clerk.io in WooCommerce.
   • Clicca su Save.
   • Clicca su Start new data sync.

Clerk importerà ora i tuoi prodotti, categorie e ordini.

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.

Aggiungi 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. Vai al tuo backend di WooCommerce.
2. Naviga a Products > Attributes.
3. Trova il slug dell’attributo che desideri aggiungere.

4. Clicca sul Plugin Clerk.io nel menu laterale sinistro.

5. Nella sezione Sincronizzazione Dati, aggiungi l’attributo slug nei Additional Fields. Puoi anche aggiungere diversi attributi, separati da virgole.

6. Clicca su Save Settings.

7. Vai a my.clerk.io > System Status > Data Sync e clicca su Start New Data Sync.

Aggiungi attributi manualmente #

Gli attributi in WooCommerce possono essere aggiunti anche tramite codice in due file. Questi file vengono utilizzati per sincronizzare i prodotti sia manualmente che automaticamente quando vengono apportate modifiche nel negozio online. Questi sono 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 in questo modo:

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

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

Attributi Functions.php #

Puoi anche aggiungere nuovi attributi a Clerk.io modificando il file functions.php. Queste modifiche persisteranno anche quando il plugin viene aggiornato. Segui questi passaggi:

1. Aggiungi il seguente codice a Appearance > Theme Editor > 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;
}

2. (Facoltativo) Se desideri includere attributi personalizzati (come marca, colore o materiale) in Clerk.io, modifica la funzione in questo modo:

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();

    // Aggiungi attributi personalizzati
    $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 tuo backend di WooCommerce.
4. Infine, vai a my.clerk.io > System Status > Data Sync e clicca su Start New Data Sync per importare i tuoi nuovi attributi.

Impostazioni di Importazione Prodotto #

Per impostazione predefinita, il plugin WooCommerce di Clerk.io importa solo Prodotti Pubblicati. Questo può essere modificato se necessario. Il seguente file controlla quali prodotti vengono importati in Clerk.io: wp-content > plugins > clerkio > includes > class-clerk-rest-api.php

1. Nel file, trova la funzione chiamata product_endpoint_callback.

2. Nella lista $products, sotto 'status', aggiungi qualsiasi Status che desideri includere, separati da virgole:

3. Quando importi prodotti non pubblicati, aggiungi un attributo is_saleable che restituisce true o false per monitorare la disponibilità. Questo ti consente di mostrare lo stato di disponibilità nei tuoi Design in questo modo:

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

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

Disabilita 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 dall’estensione prende il sopravvento. Hai due opzioni: da my.clerk.io o dal Plugin in WooCommerce.

My.clerk.io #

1. Vai a my.clerk.io > System Status > Data Sync.
2. Scorri verso il basso e a destra, cambia l’opzione sotto Import Orders da Yes a No, quindi clicca su Save. Clerk non importerà più ordini da WooCommerce.

Plugin #

1. Vai al backend di WooCommerce e clicca su Clerk nel menu laterale sinistro.
2. Nelle impostazioni del Plugin, scorri verso il basso fino alla sezione Data Sync: Orders. Seleziona la casella etichettata Disable Order Synchronization.
3. Per rendere effettive le modifiche, clicca su Save Settings.

Sincronizzazione Pagine #

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

Poiché un negozio in Clerk.io si collega principalmente alla tua piattaforma e-commerce per sincronizzare cataloghi, ordini e clienti, mantenere aggiornati i contenuti del blog esterno può essere difficile.

Per affrontare questo problema, ora forniamo una soluzione senza codice per sincronizzare i contenuti del blog con qualsiasi negozio Clerk, indipendentemente dalla piattaforma principale, se gestisci i tuoi blog tramite WordPress/WooCommerce. Per utilizzare questa funzionalità, segui questi passaggi:

1. Installa il nostro plugin nel tuo backend di WordPress.
2. Una volta installato, clicca su Clerk nel menu laterale sinistro.
3. Inserisci le tue chiavi API da Settings > API keys in my.clerk.io per configurare il plugin.
4. Poiché vogliamo solo importare contenuti scritti in questo caso, dovresti solo 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 si sincronizzeranno immediatamente tutte le tue pagine con il tuo negozio my.clerk.io.

Il Plugin consente anche di personalizzare quali attributi di pagina vengono sincronizzati. Puoi specificare Additional Fields da recuperare per ogni pagina e includere Page Additional Types creati da plugin di terze parti.

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

Disabilita l’importazione delle pagine #

Per garantire che le pagine vengano sincronizzate solo da WordPress e non da altre fonti durante la Sincronizzazione Dati, disabilita le importazioni di pagine in my.clerk.io:

1. Vai a System Status > Data Sync
2. Trova l’impostazione Import Pages e impostala su No
3. Clicca su Save