Module

Configura los ajustes del módulo de PrestaShop, gestiona las opciones de sincronización de datos y personaliza las funciones de search, recommendations y logging.

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 utilizas la v 6.7.0 o una versión posterior de la extensión (puedes verificar la última versión aquí), podrás acceder a los siguientes ajustes de dos formas después de agregar 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, en 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 ajuste para ver las opciones disponibles:

Resumen 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 los principales ajustes de sincronización de datos en la siguiente sección.

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

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

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

• Include Out Of Stock Products importará productos a Clerk sin importar su estado de inventario.

• Collect Emails incluirá direcciones de Email 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 Email desde Prestashop para usar con Auto-Email.

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

• Disable Order Synchronisation te permite detener la importación de nuevos pedidos entrantes. A menudo estos pedidos serán rastreados por el sistema de seguimiento de ventas en tiempo real, por lo que ya no necesitan ser importados.

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

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

Search #

Activa tu Search Page cambiando a “Enabled”.

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

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

• Pages Type te permite controlar un tipo específico de páginas 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 Element en my.clerk.io. Normalmente es " search-page".

Navegación facetada #

Activa esto cambiando a “Enabled” para añadir 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 attributes que has sincronizado con Clerk. Verifica cuáles están disponibles en my.clerk.io > Data > Products.

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

Personalización de facets #

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

El design ID se encuentra en el Clerk backend, en la columna del extremo izquierdo de cada design en la página de resumen de designs y en la esquina inferior izquierda de la página al ingresar al diseño para editar.

Nota: Ahora puedes llamar los datos de categorías y páginas en tu Search page de la misma forma que en tu Live search, dándote una mayor variedad de información para atraer a tus clientes. Para más información, puedes consultar aquí.

Live search #

Activa Clerk Live Search en esta sección cambiando a “Enabled” en la primera opción.

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

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

• Pages Type te permite controlar un tipo específico de páginas 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á la 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 Element 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 la Instant Search a ese campo y que aparezca cuando los usuarios busquen.

• Search field form selector también se usa para campos de búsqueda personalizados, y permite que Clerk modifique el redireccionamiento para coincidir 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 agregue un producto al carrito.

• Powerstep Type te permite elegir entre 3 opciones:

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

  • Popup mostrará un nuevo popup añadido por nuestro módulo.

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

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

Recommendations #

Estos ajustes te permiten añadir recommendations a distintas páginas de tu tienda: Category Pages, Product Pages, el Cart y un Exit Intent Popup.

• Templates te permite decidir qué Recommendations mostrar en las distintas páginas añadiendo sus Element IDs. Esto viene pre-rellenado con las mejores opciones.

Logging #

Logging puede usarse para mostrar cualquier error y/o advertencia que ocurra en Prestashop 1.6.

Esto es de gran ayuda para depurar problemas.

Para activar Logging, haz lo siguiente:

1. Entra 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. Establece Enabled en Yes:

6. Desplázate hasta el 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 el funcionamiento correcto del módulo.

• Error + Warn: También registra advertencias que no impiden el funcionamiento, pero que pueden ser necesarias solucionar.

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

Logging To

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

• my.clerk.io: Registrará todo en Developers->Logs en el backend de my.clerk.io.

Actualización #

Si usas 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 última versión desde este enlace:

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

Luego inicia sesión en tu Prestashop admin y ve 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 mostrará un mensaje de éxito, confirmando que tu módulo se ha actualizado.

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

Desinstalación #

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

A continuación, busca “Clerk” en tu lista de módulos y selecciona “Deaktiver” para desactivar el plugin Clerk:

Una vez desactivado, Clerk debería eliminarse de tu tienda Prestashop.