Module

Configura la configuración de tu módulo de PrestaShop, gestiona las opciones de sincronización de datos y personaliza las funciones de search, recommendations y registro de logs.

Configuración de sincronización de datos #

Ve a Data > Configuration en my.clerk.io para ver tus opciones de sincronización de Prestashop.

• Establece la URL de tu tienda, el tamaño de página de tus datos sincronizados y la hora del día en la que los datos de tu tienda online se sincronizan con Clerk (el valor predeterminado es “Cuando sea necesario”).

Configuración del módulo #

Si estás utilizando v 6.7.0 o una versión posterior de la extensión (puedes consultar la versión más reciente aquí), podrás acceder a la siguiente configuración de dos maneras después de añadir tus Public y Private Keys al módulo:

• A través del backend de Prestashop en Modules > Clerk

• A través de my.clerk.io, bajo Developers > Extensions

No importa dónde realices los cambios, ya que la extensión se sincronizará con cualquier cambio realizado en my.clerk.io y viceversa.

En my.clerk.io también podrás ver tu versión actual de la extensión, tu plataforma y la versión de PHP.

Simplemente haz clic en “Edit” en cualquier configuración para ver las opciones disponibles:

Información general del módulo #

En tu cuenta de administrador de Prestashop, elige Clerk desde tus “Modules” para ver y ajustar las opciones de tu módulo Clerk.

Establece el idioma predeterminado para el módulo en " Shop & Language", y accede a tus claves API, idioma de la tienda y URL de importación de datos en " General".

Sincronización #

Configura tus opciones principales de sincronización de datos en la siguiente sección.

• Use Real-time Updates actualizará los datos de productos en Clerk tan pronto como sean modificados en Prestashop.

• Include Pages enviará tus blogs y artículos a Clerk para que puedan mostrarse en Search, y tener Recommendations en sus páginas.

• Additional Fields / For Pages te permite agregar atributos personalizados a tus productos y páginas que luego se pueden usar en search y visualmente en un Design.

• Include Out Of Stock Products importará productos a Clerk independientemente de su estado de stock.

• Collect Emails incluirá direcciones de correo electrónico en los pedidos. Esto es necesario para Audience y recomendaciones personalizadas basadas en pedidos.

• Sync Subscribers te permite obtener el estado de cualquier suscriptor de correo electrónico desde Prestashop, para usar con Auto-Email.

• Collect Baskets rastreará lo que un usuario tiene en su cesta, para uso con los correos electrónicos de Abandon Cart.

• Disable Order Synchronisation te permite detener la importación de nuevos pedidos. A menudo estos pedidos serán rastreados por el seguimiento de ventas en vivo, por lo que ya no es necesario importarlos.

• Include Variant References te permite importar atributos basados en las variantes disponibles para los productos. Por defecto, importaremos listas de IDs de variantes, nombres, precios y SKUs.

• Include Product Features importará los atributos especiales llamados Product Features from Prestashop.

Search #

Activa tu Search Page cambiando a “Enabled”.

• Include Categories hará que Clerk devuelva las categorías coincidentes al buscar.

• Number of Categories / Pages te permite decidir cuántas coincidencias potenciales devolver para cada tipo.

• Pages Type te permite controlar un tipo específico de página a importar. Por ejemplo, solo artículos o páginas de servicio / CMS. Por defecto, se importan todas las páginas.

• Template debe coincidir con el nombre proporcionado en el código de inserción de tu Search Page Content en my.clerk.io. Normalmente es " search-page".

Navegación facetada #

Cambia esto a “Enabled” para agregar filtros a tu Search Page.

• Design te permite elegir un diseño personalizado opcional para tus facets. Consulta “Customising Your Search Page Facets” más abajo.

• Add facet attributes te permite elegir qué attributes permitir a los usuarios filtrar. Estos deben coincidir con los atributos que tienes sincronizados con Clerk. Consulta qué atributos están disponibles en my.clerk.io > Data > Products.

• Facet Attributes te permite personalizar cada facet con el Title tal como debe mostrarse a los usuarios en tu search page, así como su position, que es el orden en que se muestran según la cantidad agregada.

Personalización de facets #

Clerk te permite diseñar los facets de tu search page desde el propio diseño y puedes mostrar esto haciendo referencia al campo del ID de diseño.

El ID de diseño se puede encontrar en el Clerk backend, en la columna más a la izquierda de cada diseño en la página de vista general del diseño y en la esquina inferior izquierda de la página una vez que entras a editar el diseño.

Nota: Ahora puedes llamar los datos de categorías y páginas en tu Search page de la misma manera que lo harías en tu Live search, dándote un rango más amplio de información para interactuar con tus clientes. Para más información puedes consultar aquí.

Live search #

Enable Clerk Live Search en esta sección activando “Enabled” en la primera opción.

• Include Categories hará que Clerk devuelva las categorías coincidentes al buscar.

• Number of Suggestions / Categories / Pages te permite decidir cuántas coincidencias potenciales devolver para cada tipo.

• Pages Type te permite controlar un tipo específico de página a importar. Por ejemplo, solo artículos o páginas de servicio / CMS. Por defecto, se importan todas las páginas.

• Dropdown Positioning controla en qué dirección se mostrará el Instant Search, en relación con el campo de búsqueda. Por ejemplo, si tienes un campo de búsqueda en el lado izquierdo de tu tienda, elige left.

• Template debe coincidir con el nombre proporcionado en el código de inserción de tu Search Page Content en my.clerk.io. Normalmente es " search-page".

• Search field input selector debe usarse si tienes un campo de búsqueda personalizado. Agrega aquí la clase o ID de la etiqueta input para conectar el Instant Search al campo y que se muestre cuando los usuarios busquen.

• Search field form selector también se usa para campos de búsqueda personalizados y permite a Clerk cambiar la redirección para que coincida con la search page que añadimos.

Powerstep #

Activa tu powerstep cambiando a Enabled en la parte superior.

El powerstep se activará cuando un usuario añada un producto a la cesta.

• Powerstep Type te permite elegir entre 3 opciones:

  • Page redirigirá a una página intermedia completa añadida por nuestro módulo.

  • Popup mostrará una nueva ventana emergente añadida por nuestro módulo.

  • Embedded añadirá recommendations al popup de añadir al carrito existente de Prestashop.

• Templates te permite decidir qué Recommendations mostrar en tu powerstep añadiendo sus Element IDs. Esto ya viene rellenado con las mejores opciones.

Recommendations #

Esta configuración te permite añadir recommendations a distintas páginas de tu tienda online: páginas de categoría, de producto, el carrito y un Popup de Exit Intent.

• Templates te permite decidir qué Recommendations mostrar en las distintas páginas añadiendo sus Element IDs. Estas opciones ya vienen rellenas con las mejores recomendaciones.

Registro de logs (Logging) #

El registro de logs se puede usar para mostrar cualquier error y/o advertencias que ocurran en Prestashop 1.6.

Esto es de gran ayuda para depurar problemas.

Para habilitar Logging, haz lo siguiente:

1. Ingresa en tu Prestashop backend.

2. Ve a Modules and Services -> Modules and Services.

3. Busca clerk para encontrar el módulo y haz clic en Configure:

4. Desplázate hacia abajo en la página del módulo Clerk para encontrar la configuración de logging.

5. Cambia Enabled a Yes:

6. Desplázate al final de la página y haz clic en Save.

La configuración de Logging incluye:

Logging Level

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

• Error + Warn: También registra advertencias que no causan que el módulo deje de funcionar, pero que puede ser necesario corregir.

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

Logging To

• File: Guardará el registro en un archivo en el servidor de Prestashop.

• my.clerk.io: Guardará todo en Developers->Logs en el panel de my.clerk.io.

Actualización #

Si estás usando una versión anterior a la 5.0.0, actualizar romperá tus Designs, ya que se usará Clerk.js 2. Si usas una versión antigua, sigue esta guía en su lugar.

Importante: Recuerda hacer copias de seguridad de cualquier archivo modificado, ya que serán sobrescritos.

Comienza descargando la versión más reciente desde este enlace:

https://github.com/clerkio/clerk-prestashop/releases/latest

Luego inicia sesión en tu Prestashop admin y navega a Modules And Services -> Modules And Services

En esta página, haz lo siguiente:

1. Haz clic en Add New Module.

2. Haz clic en Choose a file y sube el archivo clerk.zip que acabas de descargar.

3. Haz clic en Upload this module.

PrestaShop ahora mostrará un mensaje de éxito confirmando que tu módulo ha sido actualizado.

¡Eso es todo! Ahora estás utilizando la última versión del módulo Prestashop.

Desinstalación #

Inicia sesión en tu portal de administración de Prestashop y selecciona “Modules and Services” en el menú lateral izquierdo:

Luego, busca “Clerk” en tu lista de módulos y selecciona “Deaktiver” para deshabilitar el plugin Clerk:

Una vez deshabilitado, Clerk debería ser eliminado de tu tienda Prestashop.