Sync Data

Sincronización de datos #

Para importar datos de tu tienda WooCommerce a Clerk.io, sigue estos pasos:

1. Crea una tienda en my.clerk.io.
2. Instala el plugin de Clerk.io en WooCommerce.
3. Configura el plugin.
4. Finalmente, sincroniza tu Store siguiendo estos pasos:
   • Inicia sesión en my.clerk.io.
   • Ve a System Status > Data Sync.
   • Ingresa tu Import URL, que es la URL de tu dominio de tienda. También puedes encontrar esto en la sección General del plugin de Clerk.io en WooCommerce.
   • Haz clic en Save.
   • Haz clic en Start new data sync.

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

Personalizando los datos del producto #

En WooCommerce, puedes agregar atributos personalizados del producto a través del backend de WooCommerce o mediante el plugin de Clerk.io en 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 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.io en el menú de la barra lateral izquierda.

5. En la sección de Sincronización de Datos, agrega el atributo slug en los Additional Fields. También puedes agregar varios diferentes, separados por comas.

6. Haz clic en Save Settings.

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

Agregar atributos manualmente #

Los atributos en WooCommerce también se pueden agregar a través de 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 deseas que tenga el atributo en Clerk.io, y = $product->get_sku() es la lógica de WooCommerce para recuperar el atributo.

Atributos en functions.php #

También puedes agregar nuevos atributos a Clerk.io modificando el archivo functions.php. Estos cambios persistirán incluso cuando se actualice el plugin. Sigue estos pasos:

1. Agrega el siguiente código a Appearance > Theme Editor > functions.php:

// Modifica los parámetros de clerk
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 ) {

// Se utiliza para ocultar productos ocultos de la búsqueda
   $params['catalog_visibility'] = $product->get_catalog_visibility();

// Solo usamos short_description
   $params['description'] = $product->get_short_description();

    return $params;
}

2. (Opcional) Si deseas incluir atributos personalizados (como marca, color o material) en Clerk.io, 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();

    // Agrega atributos personalizados
    $params['brand'] = $product->get_attribute('brand');
    $params['color'] = $product->get_attribute('color');
    $params['material'] = $product->get_attribute('material');

    return $params;
}

3. Reemplaza “brand”, “color” y “material” con 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 > System Status > Data Sync y haz clic en Start New Data Sync para importar tus nuevos atributos.

Importar configuraciones de productos #

Por defecto, el plugin de WooCommerce de Clerk.io solo importa productos publicados. Esto se puede cambiar si es necesario. El siguiente archivo controla qué productos se importan a Clerk.io: 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 devuelva true o false para rastrear la disponibilidad. Esto te permite mostrar el estado de disponibilidad en tus diseños así:

{% if product.is_saleable %}
   <div class="in-stock">En Stock</div>
{% else %}
  <div class="not-in-stock">No Disponible</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 la primera sincronización de datos se haya ejecutado con éxito, la sincronización de pedidos desde WooCommerce se puede desactivar ya que el seguimiento de ventas del complemento 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 > System Status > Data Sync.
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ú de la barra lateral izquierda.
2. En la configuración del plugin, desplázate hacia abajo hasta la sección Data Sync: Orders. Marca la casilla etiquetada Disable Order Synchronization.
3. Para que los cambios surtan efecto, haz clic en Save Settings.

Sincronizando páginas #

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

Dado que una tienda en Clerk.io se conecta principalmente a tu plataforma de comercio electrónico para sincronizar catálogos, pedidos y clientes, mantener actualizado el contenido del blog externo puede ser un desafío.

Para abordar esto, ahora ofrecemos una solución sin código para sincronizar contenido de blog 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ú de la barra lateral izquierda.
3. Ingresa tus claves API de Settings > API keys en my.clerk.io para configurar el plugin.
4. Dado que solo queremos importar contenido escrito en este caso, solo necesitas 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. Hacer clic en este botón sincronizará inmediatamente 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 para recuperar para cada página e incluir Page Additional Types creados por plugins de terceros.

Solo necesitas presionar 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á capturado por nuestro plugin y actualizado en la tienda my.clerk.io automáticamente.

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 System Status > Data Sync
2. Encuentra la configuración Import Pages y configúrala en No
3. Haz clic en Save