Sync Data

Sincroniza tus productos, categorías, pedidos y páginas de WooCommerce con Clerk. Esta guía cubre lo básico y las opciones de personalización avanzada.

Sincronización de datos #

Para importar datos desde tu tienda WooCommerce a Clerk, sigue estos pasos:

1. Crea una Store en my.clerk.io.

2. Instala el Plugin de Clerk en WooCommerce.

3. Configura el Plugin.

4. Por último, sincroniza tu Store siguiendo estos pasos:

   • Inicia sesión en my.clerk.io.

   • Ve a Data > Configuration.

   • Ingresa tu Import URL, que es la URL del dominio de tu tienda online. También puedes encontrarla en la sección General del Plugin de Clerk en WooCommerce.

   • Haz clic en Save.

   • Haz clic en Start new data sync.

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

Personalización de los datos de productos #

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

Añadir atributos simples #

Si los atributos que quieres enviar ya están disponibles como atributos simples en tu administración de WooCommerce, puedes agregarlos fácilmente en la página del Plugin.

1. Ve al backend de WooCommerce.

2. Navega a Products > Attributes.

3. Busca el slug del atributo que quieres añadir.

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 añadir varios diferentes, separados por coma.

6. Haz clic en Save Settings.

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

Añadir atributos manualmente #

Los atributos en WooCommerce también pueden agregarse mediante código en dos archivos.

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

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 está estructurado 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 agregar nuevos atributos a Clerk modificando el archivo functions.php.

Estos cambios se mantendrán incluso cuando el plugin sea actualizado.

Sigue estos pasos:

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

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 bajo Products > Attributes en el backend de WooCommerce.

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

Importar configuración de productos #

Por defecto, el plugin de WooCommerce de Clerk solo importa productos publicados.

Esto puede cambiarse 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', añade cualquier Status que desees incluir, separados por coma:

3. Al importar productos no publicados, añade un atributo is_saleable que retorne true o false para rastrear la disponibilidad.

Esto te permite 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">No está en 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 ejecutado correctamente la primera sincronización de datos, la sincronización de pedidos desde WooCommerce puede desactivarse ya que el seguimiento de ventas de la extensión toma el control.

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 desde 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 hacia abajo hasta 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.

Sincronización de páginas #

Importante: Para que esto funcione, debes tener WooCommerce instalado y activado en tu configuración de WordPress. No es necesario usarlo ni configurarlo, pero el plugin tiene funcionalidades esenciales que el Plugin de Clerk necesita.

Ya que una store en Clerk se conecta principalmente a tu plataforma de e-commerce para sincronizar catálogos, pedidos y clientes, mantener el contenido externo del blog actualizado puede ser un reto.

Para abordar esto, ahora ofrecemos una solución sin código para sincronizar el contenido del blog con cualquier store de Clerk sin importar 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 desde Developers > API keys en my.clerk.io para configurar el plugin.

4. Como en este caso solo queremos importar contenido escrito, solo tendrás que 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 en este botón, todas tus páginas serán sincronizadas de inmediato con tu store de my.clerk.io.

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

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

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

Desactivar la importación de páginas #

Para asegurar que las páginas solo se sincronicen desde WordPress y no de otras fuentes durante la Sincronización de Datos, desactiva las importaciones de páginas en my.clerk.io:

1. Ve a Data > Configuration.

2. Busca la configuración Import Pages y configúrala en No.

3. Haz clic en Save.