Introducción: Documento Técnico

Introducción

Esta documentación está dirigida a desarrolladores y webmasters que deseen integrar el módulo de reservas de Yoplanning.pro en su sitio web. El objetivo es mejorar la experiencia del usuario ofreciendo una interfaz de reservas accesible y responsiva, que permita la personalización del módulo.

Principio de funcionamiento

El módulo de reservas de Yoplanning.pro está diseñado para integrarse a la perfección con su sitio web, ofreciendo una experiencia de usuario fluida sin necesidad de redirecciones. El módulo aparece como una ventana emergente que se activa mediante un botón o enlace, permitiendo a los usuarios reservar directamente en su sitio web.

Beneficios

  • Pantalla óptima: Se adapta a todo tipo de pantallas, incluidas las móviles.

  • Fácil integración: Se puede agregar a su sitio con un simple fragmento de código JavaScript.

  • Personalización: Generación de enlaces específicos para diferentes acciones o categorías.

Integración mediante Iframe

Si bien es posible, no se recomienda incrustar mediante iframe debido a limitaciones de compatibilidad con dispositivos móviles. Si es necesario, el módulo puede abrirse en una nueva pestaña para disfrutar de una experiencia a pantalla completa.

Integración mediante Iframe: comportamiento de desplazamiento

En modo iframe, por defecto el módulo de reserva ocupa toda la altura posible y el desplazamiento se realiza en tu sitio, mira la captura de pantalla a continuación:

Comportement par défaut

Es posible cambiar este comportamiento añadiendo el parámetro bescroll=inside a la URL de integración del módulo de reservas. El módulo ocupará la altura de la pantalla y el desplazamiento se realizará dentro del módulo, no en su sitio web (véase la captura de pantalla a continuación).

Avec le paramètre "bescroll=inside"

Código de integración

Para integrar el módulo, inserte el siguiente código JavaScript en el encabezado de su sitio. Esto permitirá que el módulo sea accesible en todas las páginas sin necesidad de varias incrustaciones.

<script type="text/javascript" src="https://booking.yoplanning.pro/integration/script.js" async></script>

Generación de enlaces del módulo de reservas

Se pueden generar enlaces específicos al módulo de reservas a través del back office de Yoplanning:

  1. Vaya a Configuración > Módulo de reservas > Menú de integración.

  2. Utilice el modo URL para crear una URL que se adapte a sus necesidades.

Ejemplos de enlaces generados

  • Enlace general: https://booking.yoplanning.pro/<ID_UNIQUE>/

  • Categoría específica: https://booking.yoplanning.pro/<UNIQUE_ID>/?tag=<CATEGORY_ID>

  • Ficha de producto: https://booking.yoplanning.pro/<ID_UNIQUE>/product/<ID_PRODUIT>

  • Acceso directo al carrito: https://booking.yoplanning.pro/<ID_UNIQUE>/cart/

  • Tienda directa: https://booking.yoplanning.pro/<ID_UNIQUE>/shop/

Opciones de integración

Yoplanning ofrece varios modos de integración:

  • Botón: Para acceso directo a través de un botón en el que se puede hacer clic.

  • Icono flotante: un ícono accesible en cualquier momento en la página.

  • Hipervínculo: Para incrustar en texto o imágenes.

  • Iframe: se utiliza como último recurso, si JavaScript está restringido.

  • URL simple: para integración directa como enlace.

Gestión multilingüe

El módulo detecta automáticamente el idioma del navegador del usuario mediante el servicio externo https://gtranslate.io/detect-browser-language, lo que proporciona una experiencia localizada e intuitiva. (Método recomendado en la mayoría de los casos).

Idioma forzado por defecto.

Si tiene un sitio web multilingüe o tiene problemas de detección de idioma o desea forzar el módulo para que se muestre en un idioma definido, puede crear un módulo de reserva específico forzando el idioma en su configuración.

Conclusión

Integrar el módulo de reservas de Yoplanning.pro mejora significativamente la experiencia de reserva en tu sitio web gracias a su interfaz de usuario optimizada, opciones de personalización avanzadas y soporte multilingüe. Sigue las instrucciones para una integración exitosa y ofrecer a tus usuarios una experiencia de reserva fluida.

Last updated