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 registro de eventos. Esta guía cubre todos los ajustes y opciones disponibles.

Clerk WooCommerce plugin

Una vez que el plugin está instalado con éxito 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 instalada actualmente. Aquí puedes encontrar la última versión.

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

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

  • Language: Elige el idioma correcto del dominio.

  • Import URL: La URL que Clerk utiliza para sincronizar los datos. Añade esto en tu cuenta de my.clerk.io bajo Data > Configuration en el campo Store URL.

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

Data sync: products #

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 una vez que se realicen cambios en WooCommerce.

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

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

  • Additional Fields: Aquí puedes añadir 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: Cuando Strip está desmarcado, se eliminan todos los espacios dentro de las cadenas (por ejemplo, ’ Opción 1’ = ‘Opción1’). Cuando Trim está marcado, solo se eliminan los espacios iniciales y finales, manteniendo los espacios internos (por ejemplo, ‘Opción 1’ = ‘Opción 1’).

  • Additional Fields Raw: Introduce los atributos que ya agregaste en Additional Fields para importar estos valores tal como están, evitando que las comas los dividan en listas durante la importación.

Data sync: pages #

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 una vez que se hagan 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 atributos agregados aquí se importan para cada página.

  • Page Additional Types: Sincroniza tipos de página adicionales, incluidos los personalizados. Introduce una lista separada por comas para añadir múltiples tipos.

Data sync: customers #

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 habilitarlo, se importarán Clientes a Clerk.

  • Collect Basket: Habilitando esto permitirá que Clerk recoja información sobre los productos añadidos al carrito. Por ejemplo, activa esta opción si usas la función Abandoned Basket.

  • Collect Emails: Al habilitarlo, permitirá a Clerk recopilar e importar direcciones Email de los clientes desde WooCommerce.

  • Collect Emails Signup Message: Escribiendo texto aquí tendrás una casilla de verificación en el checkout para suscribir el email dentro de my.clerk.io. Collect Emails debe estar habilitado para utilizar 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 los datos de clientes a incluir durante la sincronización.

Data sync: orders #

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

Clerk seguirá recogiéndolos en tiempo real de los visitantes.

Live search settings #

En esta sección puedes personalizar y activar la búsqueda en vivo. A continuación se explica cada opción:

  • Enabled: Habilita tu Clerk Live Search.

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

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

  • Pages type: Selecciona el tipo de páginas que aparecerán en el desplegable, por ejemplo, Publicaciones del blog, Páginas CMS o Todas.

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

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

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

  • Element: Introduce el nombre de tus Live Search Elements. Se encuentra dentro del 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>

Search settings #

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

  • Enabled: Habilita tu Clerk Search Page.

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

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

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

  • Pages type: Selecciona el tipo de páginas que aparecerán en el desplegable, por ejemplo, Publicaciones del blog, Páginas CMS o Todas.

  • Element: Introduce el nombre de tu Search Page Element del código de inserción de Element en my.clerk.io. Generalmente es “search-page”.

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

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

Faceted navigation #

  • Enabled: Habilita tus Clerk Facets en Search Page.

  • Add Custom Attribute: Escribe aquí el nombre de un atributo que quieras incluir en tus facets y haz clic en “Añadir”.

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

  • Design: Introduce el ID del diseño de facet. Lo encontrarás en my.clerk.io > Search > Design.

Powerstep settings #

En esta sección puedes personalizar y activar el Powerstep tras añadir un producto al carrito. A continuación se explica cada opción:

  • Enabled: Habilita Clerk Powerstep.

  • Powerstep Type: Elige el tipo de Powerstep que deseas habilitar, como “página” o “popup”.

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

  • Contents: Escribe el nombre de tu Power Step Element del código de inserción de Element en my.clerk.io.

  • Filter Duplicates: Activando esto te aseguras de que cada banner muestre productos completamente únicos.

  • Enable Custom Texts: Al habilitarlo, permite añadir textos personalizados a Powerstep.

  • Back Button: Escribe el texto que quieres mostrar en tu botón de “Volver”, que permite a los usuarios regresar a la página anterior.

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

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

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

Exit intent settings #

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

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

  • Enabled: Habilita tu Clerk Exit Intent element marcando esta casilla.

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

Category, product, cart #

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

  • Enabled: Habilita tus elementos de Clerk Category, Product y Cart Recommendations.

  • Element: Introduce el nombre del Element que has creado en my.clerk.io para tu tienda. Normalmente ya aparece rellenado.

  • Filter Duplicates: Activando esto te aseguras de que cada banner muestre productos completamente únicos.

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

  • Category / Product / Cart ID Shortcode: Estos shortcodes te permiten insertar fácilmente 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>

Additional scripts #

En esta sección puedes añadir y activar cualquier JS Script adicional. A continuación se explica cada opción:

  • Enabled: Habilita el script adicional introducido en la siguiente casilla.

  • JS Code: Si está habilitado, ejecutará el script añadido aquí junto con Clerk.js.

Logging #

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

  • Enabled: Habilita la función de Logging.

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

    • Only Errors: Registrará cualquier error que impida el correcto funcionamiento del módulo.

    • Error + Warn: También registra advertencias que no detienen el funcionamiento, pero podrían requerir atención.

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

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

Upgrading #

Best Practice: Haz siempre copias de seguridad de los archivos modificados antes de actualizar para asegurarte de que puedes restaurar versiones anteriores si es necesario.

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

Si utilizas una versión antigua, sigue esta guía en su lugar.

Puedes actualizar el Plugin directamente desde el backend de WooCommerce, siguiendo estos pasos:

  1. Ve 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.