Sync Data

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

Prima di sincronizzare i dati, assicurati di aver installato e configurato il plugin Clerk nel backend di WooCommerce. Consulta la guida introduttiva per le istruzioni di installazione.

Configura la sincronizzazione #

Per sincronizzare i dati del tuo store WooCommerce con Clerk, è necessario configurare l’Import URL in Clerk.

1. Nel plugin, copia il tuo Import URL dalla sezione Generale.

2. Abilita Use Legacy Authentication nella sezione Generale. Questa opzione è richiesta quando si utilizzano le normali chiavi Clerk Private API.

3. Vai su my.clerk.io > Data > Configuration e incolla l’Import URL nel campo Import URL.

4. Se prevedi di utilizzare Email & Audience, imposta Collect Emails su Sì nel plugin e Salva.

5. Se applicabile, seleziona la lingua per il tuo dominio.

6. Clicca su Start Sync e attendi il completamento della sincronizzazione.

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

Personalizzazione dei dati prodotto #

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

Aggiungi attributi semplici #

Se gli attributi che desideri inviare sono già disponibili come attributi semplici nella tua area amministrativa WooCommerce, puoi facilmente aggiungerli dalla pagina Plugin.

1. Accedi al backend WooCommerce.

2. Vai su Products > Attributes.

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

4. Fai clic sul Plugin Clerk nel menu della barra laterale sinistra.

5. Nella sezione Data Sync, aggiungi l’attributo slug in Additional Fields. Puoi anche aggiungere vari attributi 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 attributi manualmente #

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

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

Questi sono i file:

1. In wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php, aggiungi l’attributo in add_product.

2. In wp-content > plugins > clerkio > includes > class-clerk-rest-api-php, aggiungi l’attributo a $product_array in product_endpoint_callback.

Ogni attributo è strutturato come segue:

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

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

Attributi Functions.php #

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

Queste modifiche persisteranno anche quando il plugin viene aggiornato.

Segui questi passi:

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 desideri includere attributi personalizzati (come brand, color o material) in Clerk, modifica la funzione come segue:

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 vuoi sincronizzare. Se gli attributi non compaiono, assicurati che siano definiti in Products > Attributes nel backend di WooCommerce.

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

Importazione impostazioni prodotti #

Per impostazione predefinita, il plugin WooCommerce di Clerk importa solo prodotti pubblicati.

Può essere modificato se necessario.

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

1. Nel file, individua la funzione chiamata product_endpoint_callback.

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

3. Durante l’importazione di prodotti non pubblicati, aggiungi un attributo is_saleable che restituisce true o false per tracciare la disponibilità.

Questo ti permette di mostrare lo stato di disponibilità nei tuoi Designs come segue:

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

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

Disattivare la sincronizzazione degli ordini #

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

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 a destra, modifica l’opzione sotto Import Orders da Yes a No, quindi clicca su Save.

Clerk non importerà più gli ordini da WooCommerce.

Plugin #

1. Vai 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. Seleziona la casella Disable Order Synchronization.

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

Sincronizzazione delle pagine #

Importante: Per funzionare, devi avere WooCommerce installato e attivato nella tua installazione WordPress. Non è necessario utilizzarlo o configurarlo, ma il plugin offre funzionalità essenziali di cui il plugin Clerk ha bisogno.

Poiché uno store in Clerk si connette principalmente alla piattaforma e-commerce per sincronizzare cataloghi, ordini e clienti, mantenere aggiornati i contenuti del blog esterni può essere impegnativo.

Per affrontare questo, ora forniamo una soluzione senza codice per sincronizzare i contenuti del blog con qualsiasi store Clerk, indipendentemente dalla piattaforma principale, se gestisci i tuoi blog tramite WordPress/WooCommerce.

Per utilizzare questa funzionalità, segui questi passi:

1. Installa il nostro plugin dal backend WordPress.

2. Una volta installato, clicca su Clerk nel menu della barra laterale sinistra.

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

4. Poiché in questo caso vogliamo importare solo contenuti scritti, dovrai 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 sincronizzerai immediatamente tutte le tue pagine con il tuo store my.clerk.io.

Il Plugin ti permette anche di personalizzare quali attributi delle pagine vengono sincronizzati.

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

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

Disattiva importazione pagine #

Per assicurarti che le pagine vengano sincronizzate solo da WordPress e non da altre fonti durante il Data Sync, disabilita le importazioni 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.