Woocommerce

Sync Data

Aprende cómo sincronizar y personalizar datos de tu tienda WooCommerce

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

Antes de sincronizar los datos, asegúrate de haber instalado y configurado el plugin de 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. Habilita Use Legacy Authentication en la sección General. Esta opción es obligatoria cuando se utilizan claves regulares de Clerk Private API.

  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 se complete la sincronización.

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

Personalizar los datos de productos #

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

Agregar atributos simples #

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

  1. Ve al 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, agrega el atributo slug en el campo 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 se pueden agregar mediante código en dos archivos.

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

Estos son los archivos:

  1. En wp-content > plugins > clerkio > includes > class-clerk-realtime-updates.php, agrega el atributo en add_product.

  2. En wp-content > plugins > clerkio > includes > class-clerk-rest-api-php, agrega el atributo en $product_array en product_endpoint_callback.

Cada atributo está estructurado así:

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

Donde ['sku'] define el nombre que deseas 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 si se actualiza el plugin.

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;
}
  1. (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;
}

  1. 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 en Products > Attributes en tu backend de WooCommerce.

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

Importar ajustes de productos #

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

Esto se puede modificar 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 de $products, bajo 'status', agrega cualquier Status que desees incluir, separados por comas:

  3. Al importar productos no publicados, agrega un atributo is_saleable que retorne true o false para llevar control de 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 %}
  1. 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 la primera sincronización de datos haya sido exitosa, la sincronización de pedidos desde WooCommerce puede ser desactivada, ya que el seguimiento de ventas de la extensión tomará 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 en 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 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 es necesario que lo uses o lo configures, pero el plugin tiene funcionalidad esencial que el Plugin de Clerk necesita.

Como 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 solucionarlo, ahora proporcionamos una solución sin código para sincronizar contenido del blog con cualquier tienda 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 el backend de WordPress.

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

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

  4. Como en este caso solo queremos importar contenido escrito, solo debes 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 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 para obtener de cada página e incluir Page Additional Types creados por plugins de terceros.

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

Desactivar la importación de páginas #

Para asegurarte de que solo se sincronicen páginas 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 ajusta a No.

  3. Haz clic en Save.

Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.