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 avanzadas de personalización.

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

Configurar la sincronización #

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

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

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

3. Si planeas usar Email & Audience, activa Collect Emails en el plugin y guarda.

4. Selecciona el idioma para tu dominio si es aplicable.

5. Haz clic en Start Sync y espera a que la sincronización se complete.

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

Personalización de los datos de producto #

En WooCommerce, puedes agregar atributos de producto personalizados 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 quieres enviar ya están disponibles como atributos simples en tu administrador de WooCommerce, se pueden agregar fácilmente en la página del Plugin.

1. Ve al backend de WooCommerce.

2. Ve a Products > Attributes.

3. Encuentra el slug del atributo que deseas agregar.

4. Haz clic en el Plugin 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 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 se pueden añadir 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 está estructurado así:

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

Donde ['sku'] define el nombre que tendrá 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 permanecerán incluso cuando el plugin se actualice.

Sigue estos pasos:

1. Agrega 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 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 quieras sincronizar. Si los atributos no aparecen, asegúrate de que estén definidos bajo 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 #

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

Esto se puede cambiar si es necesario.

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

1. En el archivo, localiza la función llamada product_endpoint_callback.

2. En la lista $products, bajo 'status', añade cualquier Status que deseas incluir, separados por comas:

3. Al importar productos no publicados, añade un atributo is_saleable que devuelva 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">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 #

Una vez que la primera sincronización de datos se haya realizado correctamente, la sincronización de pedidos desde WooCommerce puede desactivarse ya que el seguimiento de ventas desde 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 surtan efecto, haz clic en Save Settings.

Sincronización de páginas #

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

Dado que una tienda 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 solucionar esto, ahora ofrecemos una solución sin código para sincronizar contenido de blogs con cualquier tienda Clerk, independientemente de la plataforma principal, si gestionas tus blogs a través de WordPress/WooCommerce.

Para usar 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. Ya que solo queremos importar contenido escrito en este caso, solo deberías 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, se sincronizarán de inmediato todas tus páginas con tu tienda my.clerk.io.

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

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

Solo deberías tener que pulsar el botón Sync Pages una vez, ya que cualquier cambio en una página, publicación de una nueva página, archivo o eliminación será detectado por nuestro plugin y actualizado automáticamente en la tienda 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 sincronización de datos, desactiva las importaciones de páginas en my.clerk.io:

1. Ve a Data > Configuration.

2. Busca la opción Import Pages y ponla en No.

3. Haz clic en Save.