Plugin

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

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 que tienes 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. Añádela en tu cuenta de my.clerk.io en Data > Configuration en el campo Store URL.

• Use Legacy Authentication: Activa esta opción cuando uses claves API estándar de WooCommerce (consumer key y consumer secret). Esto es necesario en la mayoría de las configuraciones para autenticar correctamente las solicitudes de sincronización de datos.

Sincronización de datos: productos #

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

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

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

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

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

• Strip/Trim Split Attributes: Si Quitar (Strip) está desmarcado, se eliminan todos los espacios dentro de las cadenas (ejemplo: ’ Opción 1’ = ‘Opción1’). Si Recortar (Trim) está marcado, sólo se eliminan los espacios al inicio y final, manteniendo los espacios internos (ejemplo: ‘Opción 1’ = ‘Opción 1’).

• Additional Fields Raw: Ingresa los atributos que ya hayas añadido 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 se explica cada opción:

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

• Include Pages: Al activar esta opción, Clerk importará todas las páginas incluidas en WooCommerce > Pages > All Pages.

• Page Additional Fields: Los slugs de los atributos añadidos aquí se importarán para cada página.

• Page Additional Types: Sincroniza tipos de página adicionales, incluidos los personalizados. Ingresa una lista separada por comas para añadir 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 se explica cada opción:

• Include Customers: Al activar, se importarán los clientes a Clerk.

• Collect Basket: Al activar, Clerk recolectará información sobre los productos añadidos al carrito. Por ejemplo, activa esta opción si utilizas el trigger de carrito abandonado (Abandoned Basket).

• Collect Emails: Al activar, Clerk recolectará e importará las direcciones Email de los clientes desde WooCommerce.

• Collect Emails Signup Message: Escribe un texto aquí para mostrar una casilla de verificación al finalizar la compra donde suscribirás el Email en my.clerk.io. Debe estar activada la opción Collect Emails para usar esta función. Si se deja en blanco, la casilla no estará activa.

• Extra Customers Fields: Una lista separada por comas de los atributos adicionales de 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 seguirá recolectándolos en tiempo real de los visitantes.

Ajustes de Live Search #

En esta sección, puedes personalizar y activar el Live Search. A continuación se explica 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 el Live Search.

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

• Pages type: Selecciona el tipo de resultados de páginas en el desplegable, por ejemplo: entradas de blog, páginas CMS o todas.

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

• Live Search Input Selector: Ingresa el input selector, es decir, la clase o ID del campo de entrada utilizado para buscar.

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

• Element: Ingresa el nombre de tus Live Search Elements, que figura en el Element embed code como tu data template name, data-template= YOUR-ELEMENT-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>

Ajustes de Search #

En esta sección, puedes personalizar y activar la Search Page. A continuación se explica cada opción:

• Enabled: Activa tu Clerk Search Page.

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

• Include Categories / Pages: Esto te permite controlar si Clerk 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 el tipo de resultados de páginas en el desplegable, por ejemplo: entradas de blog, páginas CMS o todas.

• Element: Ingresa el nombre del Elemento Search Page del Element embed code en my.clerk.io. Generalmente “search-page”.

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

• Load more button text: Ingresa el texto para el botón “Cargar más”.

Navegación facetada #

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

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

• Facet Attributes: Una vez añadido, el atributo aparece en esta sección. Aquí puedes establecer su display title, definir su posición en la lista y marcar la casilla Show para incluirlo en tus facetas.

• Design: Ingresa el ID del diseño de facetas. Lo puedes encontrar en my.clerk.io > Search > Design.

Ajustes de Powerstep #

En esta sección, puedes personalizar y activar el Powerstep después de que un cliente agregue un producto al carrito. A continuación se explica cada opción:

• Enabled: Activa el Powerstep de Clerk.

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

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

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

• Filter Duplicates: Activa esto para asegurar que cada banner muestre productos completamente únicos.

• Enable Custom Texts: Al activar, permite añadir textos al Powerstep.

• Back Button: Ingresa el texto que deseas mostrar en el botón “Atrás”, 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: Ingresa un mensaje de texto para el título de Powerstep.

• Keep Add To Cart Params: Al activar esta opción, se asegura que los parámetros de consulta relacionados con añadir productos al carrito se mantengan al redirigir a la página de Powerstep. Esto ayuda a conservar los detalles del producto seleccionado durante el proceso.

Ajustes 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 salir del sitio web. A continuación se explica cada opción:

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

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

Categoría, producto, carrito #

En esta sección, puedes personalizar y activar Recommendations para las páginas de categoría, producto y carrito. A continuación se explica cada opción:

• Enabled: Activa los elementos de Clerk Recommendations para categoría, producto y carrito.

• Element: Ingresa el nombre del Element que has creado en my.clerk.io para tu tienda. Generalmente ya está rellenado.

• Filter Duplicates: Activa esto para asegurar que cada banner muestre productos completamente únicos.

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

• Category / Product / Cart ID Shortcode: Estos shortcodes te permiten insertar fácilmente los Clerk embedcodes si quieres personalizar sus ubicaciones 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 script JS adicional. A continuación se explica cada opción:

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

• JS Code: Si está activado, ejecutará el script añadido en esta caja junto con Clerk.js.

Registro #

En esta sección puedes activar y personalizar los registros (Logs) sobre errores y/o advertencias de Clerk. A continuación se explica cada opción:

• Enabled: Activa la función de Logging.

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

  • Only Errors: Registrará los errores que impidan que el módulo funcione correctamente.

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

  • Error + Warn + Debug: Registra todo lo que interactúa con el módulo. Esto no debe activarse en una tienda en producción ya que ralentizará el sitio.

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

Actualización #

Best Practice: Crea siempre copias de seguridad de los archivos modificados antes de actualizar para asegurarte de poder restaurar versiones previas si es necesario.

Si utilizas 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 anterior, sigue esta guía en su lugar.

La actualización del plugin puede hacerse directamente desde el backend de WooCommerce, siguiendo estos pasos:

1. Ve a Plugin > Installed Plugins y busca Clerk.

2. Haz clic en Update Now:

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