Woocommerce

Plugin

Explicaciones detalladas de la configuración del plugin Clerk WooCommerce

Configura los ajustes de tu plugin de WooCommerce, gestiona las opciones de sincronización de datos y personaliza las funciones de Search, Recommendations y registros. Esta guía abarca todos los ajustes y opciones disponibles.

Clerk WooCommerce plugin

Una vez que el plugin esté instalado correctamente en WooCommerce, aparecerá en el menú lateral de tu panel de administración:

General #

Aquí tienes una explicación de cada opción en la sección General:

  • Plugin Version: La versión del plugin Clerk actualmente instalada. Aquí puedes encontrar la última versión.

  • Public Key: Ingresa tu Public key, que se encuentra en my.clerk.io Developers > API keys.

  • Private Key: Ingresa tu Private Key, creada en my.clerk.io Developers > API keys.

  • Language: Elige el idioma correcto del dominio.

  • Import URL: La URL utilizada por Clerk para sincronizar los datos. Agrégala en tu cuenta my.clerk.io bajo Data > Configuration en el campo Store URL.

Sincronización de datos: productos #

En esta sección, puedes personalizar cómo se sincronizan los datos de Producto con Clerk. A continuación una explicación de cada opción:

  • Use Real-Time Updates: Sincroniza tus datos con Clerk en tiempo real una vez se realicen cambios en WooCommerce.

  • Include Out Of Stock Products:** Al habilitar esta opción, Clerk importará los productos que estén “Out Of Stock”.

  • Image Size: Elige el tamaño de la imagen importada en Clerk. Si tienes dudas, elige large y luego gestiona el tamaño dentro de Clerk Design.

  • Additional Fields: Aquí puedes agregar una lista separada por comas de cualquier atributo adicional de los datos de Producto que desees sincronizar con Clerk desde tu tienda WooCommerce.

  • Strip/Trim Split Attributes: Cuando Strip está desmarcado, se eliminan todos los espacios dentro de las cadenas (por ejemplo, ’ Option 1’ = ‘Option1’). Cuando Trim está marcado, solo se eliminan los espacios iniciales y finales, preservando los espacios internos (por ejemplo, ‘Option 1’ = ‘Option 1’).

  • Additional Fields Raw: Ingresa cualquier atributo que ya hayas agregado a Additional Fields para importar estos valores tal cual, evitando que las comas los dividan en listas durante la importación.

Sincronización de datos: páginas #

En esta sección, puedes personalizar cómo se sincronizan los datos de Páginas con Clerk. A continuación una explicación de cada opción:

  • Use Real-Time Updates (Pages): para sincronizar tus páginas con Clerk en tiempo real una vez se realicen cambios en WooCommerce.

  • Include Pages: Cuando está habilitado, Clerk importará todas las páginas incluidas en WooCommerce > Pages > All Pages.

  • Page Additional Fields: Los slugs de atributo agregados aquí se importan para cada página.

  • Page Additional Types: Sincroniza tipos adicionales de página, incluyendo tipos personalizados. Ingresa una lista separada por comas para agregar varios tipos.

Sincronización de datos: clientes #

En esta sección, puedes personalizar cómo se sincronizan los datos de Clientes con Clerk. A continuación una explicación de cada opción:

  • Include Customers: Al habilitarlo, se importarán Clientes a Clerk.

  • Collect Basket: Al habilitarlo, Clerk podrá recopilar información sobre los productos añadidos al carrito. Por ejemplo, activa esta opción cuando utilices el trigger de Abandoned Basket.

  • Collect Emails: Al habilitarlo, Clerk podrá recopilar e importar las direcciones de Email de los Clientes de WooCommerce.

  • Collect Emails Signup Message: Escribir texto aquí permitirá tener una casilla en el checkout donde suscribimos el Email dentro de my.clerk.io. Collect Emails debe estar habilitado para usar esta función. Si se deja en blanco, la casilla no estará activa.

  • Extra Customers Fields: Lista separada por comas de atributos adicionales de los datos de Clientes a incluir durante la sincronización.

Sincronización de datos: pedidos #

Solo hay una opción, Disable Order Synchronization, que desactiva el envío de pedidos a Clerk durante la sincronización diaria cuando está activa.

Clerk aún los recopilará en tiempo real de los visitantes.

En esta sección, puedes personalizar y activar la Live Search. A continuación una explicación de cada opción:

  • Enabled: Activa tu Clerk Live Search.

  • Include Suggestions/ Categories / Pages: Esto te permite controlar si Clerk debe buscar Suggestions, Categorías o Páginas coincidentes para mostrar en la Live Search.

  • Number of Suggestions / Categories / Pages: Esto te permite decidir cuántas coincidencias posibles mostrar para cada tipo.

  • Pages type: Selecciona qué tipo de página se mostrará en el desplegable, por ejemplo, Blog Posts, CMS Pages o Todas.

  • Dropdown Positioning: Elige la posición de los resultados desplegables de la Live Search.

  • Live Search Input Selector: Ingresa el input selector que es una clase o ID del campo de búsqueda.

  • Live Search Form Selector: Ingresa el form selector que es una clase o ID para el formulario que envía las solicitudes de búsqueda.

  • Content: Escribe el nombre de tu Live Search Elements. Se encuentra en el Element embed code como data template name, data-template= YOUR-CONTENT-NAME. Generalmente es “live-search”, por ejemplo:

<span class="clerk" 
  data-template="@live-search"  
  data-instant-search="INSERT_SEARCH_INPUT_CSS_SELECTOR_HERE" 
  data-instant-search-suggestions="6" 
  data-instant-search-categories="6" 
  data-instant-search-pages="6" 
  data-instant-search-positioning="right">
 </span>

En esta sección, puedes personalizar y activar la Search Page. A continuación una explicación de cada opción:

  • Enabled: Activa tu Clerk Search Page.

  • Search Page: Selecciona la página CMS a usar como destino para la Clerk Search.

  • Include Categories / Pages: Esto te permite controlar si Clerk debe buscar Categorías o Páginas coincidentes para mostrar en la Search Page.

  • Number of Categories / Pages: Esto te permite decidir cuántas coincidencias posibles mostrar para cada tipo.

  • Pages type: Selecciona qué tipo de página se mostrará en el desplegable, por ejemplo, Blog Posts, CMS Pages o Todas.

  • Content: Ingresa el nombre del contenido de tu Search Page desde el Content embed code en my.clerk.io. Generalmente es “search-page”.

  • No results text: Escribe el texto que deseas mostrar en la Search Page si una búsqueda no arroja resultados.

  • Load more button text: Escribe el texto para el botón “Load More”.

  • Enabled: Activa tus Facets de Clerk en la Search Page.

  • Add Custom Attribute: Escribe aquí el nombre de un atributo que desees incluir en tus facetas y haz clic en “Add”.

  • Facet Attributes: Una vez agregado, el atributo aparecerá en esta sección. Aquí puedes configurar su display title, definir su posición en la lista de facetas, y marcar la casilla Show para incluirlo en tus facetas.

  • Design: Escribe el ID del diseño de la faceta. Puedes encontrarlo en my.clerk.io > Search > Design.

Configuración de Powerstep #

En esta sección, puedes personalizar y activar el Powerstep después de que un cliente haya añadido un producto al carrito. A continuación una explicación de cada opción:

  • Enabled: Activa el Clerk Powerstep.

  • Powerstep Type: Elige el tipo de Powerstep que deseas habilitar en el menú desplegable, como “page” o “popup”.

  • Powerstep Page: Selecciona la página CMS a usar como destino para el Clerk Powerstep.

  • Contents: Ingresa el nombre de tu Power Step Content desde el Content embed code en my.clerk.io.

  • Filter Duplicates: Al activar esto, cada banner mostrará solo productos completamente únicos.

  • Enable Custom Texts: Al activarse, permite agregar textos al Powerstep.

  • Back Button: Ingresa el texto que deseas mostrar en tu botón “Back”, que permite a los usuarios volver a la página anterior.

  • Cart Button: Ingresa un texto para el botón que redirige a la página del carrito.

  • Product Title: Escribe un mensaje de texto en el Powerstep Title.

  • Keep Add To Cart Params: Habilitar esta opción garantiza que los parámetros de consulta relacionados con añadir productos al carrito se conserven al redirigir a la página Powerstep. Esto ayuda a mantener los detalles seleccionados del producto durante el proceso.

Configuración de Exit intent #

En esta sección, puedes personalizar y activar el Exit Intent.

Un Exit Intent es un tipo de popup que aparece cuando el usuario está a punto de abandonar un sitio web. A continuación una explicación de cada opción:

  • Enabled: Activa tu contenido de Clerk Exit Intent marcando esta casilla.

  • Content: Ingresa el nombre del Exit Intent Content que creaste para tu tienda. Generalmente es “exit-content”.

Categoría, producto, carrito #

En esta sección, puedes personalizar y activar las Recommendations para las páginas de Categoría, Producto y Carrito. A continuación una explicación de cada opción:

  • Enabled: Activa los elementos de Clerk Category, Product y Cart Recommendations.

  • Content: Ingresa el nombre del Content que creaste en my.clerk.io para tu tienda. Generalmente ya está completado.

  • Filter Duplicates: Al activar esto, cada banner mostrará solo productos completamente únicos.

  • Defer Injection: Solo para Product Settings, al activarlo, las Recommendations se inyectarán en la página de producto solo después de que el contenido de la página haya sido renderizado.

  • Category / Product / Cart ID Shortcode: Estos shortcodes te permiten insertar fácilmente los Clerk embedcodes si deseas personalizar su ubicación con editores como WPBakery y Elementor. Por ejemplo:

<span class="clerk"
   data-template="product-page-alternatives"
   data-products="[[clerk_product_id]]">
</span>

Scripts adicionales #

En esta sección, puedes añadir y activar cualquier JS Script adicional. A continuación una explicación de cada opción:

  • Enabled: Activa el script adicional insertado en la siguiente casilla.

  • JS Code: Si está habilitado, ejecutará el script en esta casilla junto con Clerk.js.

Logging #

En esta sección, puedes habilitar y personalizar los registros (Logs) relacionados con errores o advertencias de Clerk. A continuación una explicación de cada opción:

  • Enabled: Activa la función de Logging.

  • Log level: Aquí puedes seleccionar el tipo de registro deseado.

    • Only Errors: Registrará cualquier error que cause que el módulo no funcione correctamente.

    • Error + Warn: También registra advertencias que no impiden el funcionamiento del módulo, pero que podrían requerir ser resueltas.

    • Error + Warn + Debug: Registra todo con lo que interactúa el módulo. Esto no debe estar habilitado en una tienda en vivo ya que puede ralentizar el sitio.

  • Log to: Esto lo registrará todo en My.Clerk.io en Developers > Logs.

Upgrading #

Best Practice: Siempre crea copias de seguridad de los archivos modificados antes de actualizar para asegurarte de poder restaurar versiones anteriores si es necesario.

Si estás usando una versión anterior a la 2.0.0, la actualización romperá tus Designs, ya que se usará Clerk.js 2.

Si usas una versión antigua, sigue esta guía.

La actualización del Plugin se puede hacer directamente desde el backend de WooCommerce, siguiendo estos pasos:

  1. Comienza yendo a Plugin > Installed Plugins y busca Clerk.

  2. Haz clic en Update Now:

WooCommerce plugin update

Si ya tienes la última versión, este botón simplemente dirá Active.

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