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 negozio WooCommerce con Clerk, devi 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 è necessaria 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 usare Email & Audience, imposta Collect Emails su Yes nel plugin e salva.

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

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

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

Personalizzazione dei dati prodotto #

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

Aggiungi attributi semplici #

Se gli attributi che vuoi inviare sono già disponibili come attributi semplici nel tuo amministratore 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 laterale a sinistra.

5. Nella sezione Data Sync, aggiungi l’attributo slug nei Additional Fields. Puoi anche aggiungerne diversi, separandoli con una virgola.

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 effettuate modifiche nello shop.

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 così:

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

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

Attributi su Functions.php #

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

Queste modifiche rimarranno anche aggiornando il plugin.

Segui questi passaggi:

1. Aggiungi il seguente codice in 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 compaiono, 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 tuoi nuovi attributi.

Impostazioni importazione prodotti #

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

Questo può essere cambiato 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, trova la funzione chiamata product_endpoint_callback.

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

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

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

{% 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.

Disattiva la sincronizzazione ordini #

Dopo che la prima sincronizzazione dati è stata eseguita con successo, la sincronizzazione ordini da WooCommerce può essere disattivata in quanto il tracciamento delle vendite dell’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 in basso e sulla destra, cambia l’opzione sotto Import Orders da Yes a No, poi clicca su Save.

Clerk non importerà più ordini da WooCommerce.

Plugin #

1. Vai al backend WooCommerce e clicca su Clerk nel menu laterale sinistro.

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

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

Sincronizzazione pagine #

Importante: Perché questa funzione funzioni, devi avere WooCommerce installato e attivato nella tua installazione WordPress. Non devi usarlo o configurarlo, ma il plugin ha funzionalità essenziali di cui il Plugin Clerk ha bisogno.

Poiché un negozio in Clerk si connette soprattutto alla piattaforma e-commerce per sincronizzare cataloghi, ordini e clienti, mantenere aggiornato il contenuto esterno del blog può essere una sfida.

Per risolvere questo problema, ora offriamo una soluzione no-code per sincronizzare i contenuti del blog con qualsiasi negozio Clerk, indipendentemente dalla piattaforma principale, se gestisci i 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 nel menu laterale sinistro.

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

4. Dato che in questo caso vuoi 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 questo pulsante sincronizzerai immediatamente tutte le tue pagine con il tuo store my.clerk.io.

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

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

Dovrai premere il pulsante Sync Pages solo una volta, perché ogni modifica a una pagina, pubblicazione di una nuova pagina, archiviazione o eliminazione verrà 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 la sincronizzazione dei dati, disattiva l’importazione delle pagine in my.clerk.io:

1. Vai su Data > Configuration.

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

3. Clicca su Save.