Sync Data

Sincroniza tus productos, categorías, pedidos y páginas de WooCommerce con Clerk. Esta guía cubre los conceptos básicos y opciones avanzadas de personalización.

Antes de sincronizar los datos, asegúrate de haber instalado y configurado el plugin de Clerk en tu backend de WooCommerce. Consulta la guía de introducción para obtener instrucciones de instalación.

Configurar la sincronización #

Para sincronizar los datos de tu tienda WooCommerce con Clerk, necesitas configurar la URL de importación en Clerk.

1. En el plugin, copia tu Import URL desde la sección General.

2. Habilita Use Legacy Authentication en la sección General. Esta opción es obligatoria cuando se utilizan las claves API privadas de Clerk habituales.

3. Ve a my.clerk.io > Data > Configuration y pega la Import URL en el campo correspondiente.

4. Si planeas utilizar Email & Audience, establece Collect Emails en Sí en el plugin y guarda.

5. Selecciona el idioma para tu dominio si corresponde.

6. Haz clic en Start Sync y espera a que finalice la sincronización.

Clerk ahora importará tus productos, categorías y pedidos.

Personalización de datos de producto #

En WooCommerce, puedes añadir Atributos personalizados de producto a través del backend de WooCommerce o mediante el plugin de Clerk en código, si es necesario.

Agregar atributos simples #

Si los atributos que deseas enviar ya están disponibles como atributos simples en tu administrador de WooCommerce, pueden agregarse fácilmente en la página del Plugin.

1. Ve a tu backend de WooCommerce.

2. Navega a Products > Attributes.

3. Encuentra el slug del atributo que deseas agregar.

4. Haz clic en el Plugin de Clerk en el menú lateral izquierdo.

5. En la sección Data Sync, añade el atributo slug en Additional Fields. También puedes agregar varios diferentes, separados por comas.

6. Haz clic en Save Settings.

7. Ve a my.clerk.io > Data > Configuration y haz clic en Start New Data Sync.

Agregar atributos manualmente #

Los atributos en WooCommerce también pueden ser añadidos mediante código en dos archivos.

Estos archivos se utilizan para sincronizar productos tanto manualmente como automáticamente cuando se realizan cambios en la tienda.

Estos son los archivos:

1. wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php en la función add_product:

2. wp-content > plugins > clerkio > includes > class-clerk-rest-api-php en la función product_endpoint_callback en $product_array:

Cada atributo se estructura así:

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

Donde ['sku'] define el nombre que quieres que tenga el atributo en Clerk, y = $product->get_sku() es la lógica de WooCommerce para obtener el atributo.

Atributos en Functions.php #

También puedes añadir nuevos atributos a Clerk modificando el archivo functions.php.

Estos cambios permanecerán incluso si se actualiza el plugin.

Sigue estos pasos:

1. Añade el siguiente código en 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. (Opcional) Si deseas incluir atributos personalizados (como marca, color o material) en Clerk, modifica la función así:

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. Sustituye “brand”, “color” y “material” por cualquier atributo de WooCommerce que desees sincronizar. Si los atributos no aparecen, asegúrate de que estén definidos en Products > Attributes en tu backend de WooCommerce.

4. Finalmente, ve a my.clerk.io > Data > Configuration y haz clic en Start New Data Sync para importar tus nuevos atributos.

Configuración de importación de productos #

De forma predeterminada, el plugin de WooCommerce de Clerk solo importa productos publicados.

Esto puede modificarse si es necesario.

El siguiente archivo controla qué productos se importan a Clerk: wp-content > plugins > clerkio > includes > class-clerk-rest-api.php

1. Dentro del archivo, localiza la función llamada product_endpoint_callback.

2. En la lista $products, bajo 'status', agrega cualquier Status que desees incluir, separados por comas:

3. Al importar productos no publicados, agrega un atributo is_saleable que devuelva true o false para rastrear la disponibilidad.

Esto te permitirá mostrar el estado de disponibilidad en tus Designs así:

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

4. Ve a my.clerk.io > Data y haz clic en Start New Sync para importar los nuevos productos.

Desactivar la sincronización de pedidos #

Después de que se haya realizado la primera sincronización de datos correctamente, la sincronización de pedidos desde WooCommerce puede desactivarse, ya que el seguimiento de ventas de la extensión se hará cargo.

Tienes dos opciones: desde my.clerk.io o desde el plugin en WooCommerce.

my.clerk.io #

1. Ve a my.clerk.io > Data > Configuration.

2. Desplázate hacia abajo y a la derecha, cambia la opción bajo Import Orders de Yes a No, luego haz clic en Save.

Clerk ya no importará pedidos de WooCommerce.

Plugin #

1. Ve al backend de WooCommerce y haz clic en Clerk en el menú lateral izquierdo.

2. En la configuración del Plugin, desplázate a la sección Data Sync: Orders. Marca la casilla llamada Disable Order Synchronization.

3. Para que los cambios tengan efecto, haz clic en Save Settings.

Sincronizar páginas #

Importante: Para que esto funcione, debes tener WooCommerce instalado y activado en tu instalación de WordPress. No necesitas usarlo ni configurarlo, pero el plugin tiene funcionalidad esencial que necesita el Plugin de Clerk.

Puesto que una tienda en Clerk se conecta principalmente a la plataforma de e-commerce para sincronizar catálogos, pedidos y clientes, mantener actualizado el contenido externo de blogs puede ser un reto.

Para solucionar esto, ahora ofrecemos una solución sin código para sincronizar contenido de blog con cualquier tienda de Clerk independientemente de la plataforma principal, si gestionas tus blogs a través de WordPress/WooCommerce.

Para utilizar esta función, sigue estos pasos:

1. Instala nuestro plugin en tu backend de WordPress.

2. Una vez instalado, haz clic en Clerk en el menú lateral izquierdo.

3. Ingresa tus claves API de Developers > API keys en my.clerk.io para configurar el plugin.

4. Como en este caso solo queremos importar contenido escrito, solo necesitarás habilitar Use Real-time Updates en la sección Data Sync: Pages.

5. Haz clic en Save Settings.

6. Después de guardar la configuración, encontrarás un botón Sync Pages en la sección Data Sync: Pages. Al hacer clic, sincronizarás inmediatamente todas tus páginas con tu tienda en my.clerk.io.

El Plugin también te permite personalizar qué atributos de página se sincronizan.

Puedes especificar Additional Fields que deseas recuperar para cada página e incluir Page Additional Types creados por plugins de terceros.

Solo deberías necesitar presionar el botón Sync Pages una vez, ya que cualquier cambio en una página, publicación nueva, archivado o eliminación será detectado por nuestro plugin y actualizado automáticamente en la tienda de my.clerk.io.

Desactivar la importación de páginas #

Para asegurarte de que las páginas solo se sincronicen desde WordPress y no desde otras fuentes durante la Data Sync, desactiva la importación de páginas en my.clerk.io:

1. Ve a Data > Configuration.

2. Encuentra la configuración Import Pages y ponla en No.

3. Haz clic en Save.