Mybooking Reservation Engine | Guía de integración
Este capítulo detalla los componentes necesarios para la integración de un sistema de reservas para Alquiler de vehículos y alojamientos, con el plugin Mybooking Reservation Engine en una página web creada en WordPress.
Navegación de capítulos
2. Módulo de Alquiler y alojamiento
El módulo de Alquiler y alojamiento está orientado a aquellos negocios que ofrecen productos que pueden ser agrupados en categorías (en la plataforma de gestión de reservas aparecen en Inventario -> Grupos) o familias, como puedan ser vehículos de cualquier tipo o habitaciones para alojamiento.
También es adecuado para negocios que alquilan productos con características únicas como campers y autocaravanas, embarcaciones o apartamentos, pero en estos casos la implementación será un poco diferente, como se explica más adelante.
Componentes del módulo
Mybooking Reservation Engine proporciona una serie de componentes que muestran los diferentes apartados y funciones que se necesitan para crear un sitio web de este tipo:
- Buscador por fechas
- Resultado de la búsqueda
- Checkout
- Resumen de la reserva
- Mi reserva
- Widget calendario
- Selector de turnos
- Catálogo de productos
Cada uno de esto componentes tiene su propio shortcode, que deberá insertarse en el lugar adecuado para construir un sistema de reservas completo, como veremos a continuación.
Configuración de las páginas
Para configurar correctamente un sistema de reservas usando los elementos y shortcodes del módulo Alquiler y alojamiento, debemos crear una serie de páginas necesarias para que el proceso de reservas pueda mostrarse.
La configuración básica tiene cinco pasos:
- Buscador : Permite iniciar una búsqueda a partir de las fechas y/o lugares de entrega y devolución
- Resultado de la búsqueda. Permite seleccionar el producto
- Checkout : Completar los datos de la reserva
- Resumen de la reserva
- Mi reserva.
Cada uno de estos pasos se muestra usando su correspondiente shortcode que debe insertarse manualmente en las páginas apropiadas. Para el módulo de Alquiler y alojamiento se deben crear cuatro páginas, y aunque los nombres que mostramos son opcionales, recomendamos mantenerlos para facilitar la posterior configuración en el panel de gestión de reservas.
Para implementar el sistema de reservas debe crear estas páginas:
1. Resultado de la búsqueda
Donde se mostrará el listado de productos con los precios, características y disponibilidad de cada uno. Si no alquila vehículos cambie este nombre por el que sea apropiado. Debe contener el siguiente shortcode:
[mybooking_rent_engine_product_listing]2. Checkout / Completar reserva
Donde el usuario seleccionará los extras que pudiese tener el producto, introducirá sus datos y realizará el pago. Debe contener el siguiente shortcode:
[mybooking_rent_engine_complete]3. Resumen de la reserva
Donde el usuario recibe la confirmación y revisa los detalles de la reserva. Debe contener el siguiente shortcode:
[mybooking_rent_engine_summary]4. Mi reserva
Donde el usuario podrá consultar el detalle completo de su reserva, modificar los datos y completar el importe pendiente en caso de que se haya configurado esta opción en el panel de gestión de reservas. Debe contener el siguiente shortcode:
[mybooking_rent_engine_reservation]Configuración del plugin
Una vez tenemos las páginas creadas y los shortcodes insertados, debemos asignarlas en la configuración de Mybooking Reservation Engine para que el sistema de reservas funcione. Para ello vamos a Mybooking -> Configuración -> Renting or accommodation donde encontraremos una serie de campos desplegables que corresponden a los tres pasos principales del proceso de reservas:
Sección
Choose products page
Checkout page
Summary page
Asignar a
Seleccionar vehículo
Checkout / Completar reserva
Resumen de la reserva
Ahora que ya tiene el plugin configurado y las páginas de su sistema de reservas preparadas, vamos a ver en detalle la función de cada shortcode.
Buscador por fechas
El Buscador por fechas (o Selector) es un activador del proceso de reserva. En algunos negocios el proceso se inicia introduciendo las fechas de la reserva para obtener disponibilidad y precios, en otros también es necesario que el cliente escoja los lugares de entrega y devolución. De todos estos detalles se encarga este componente.
Shortcode
Código para insertar
[mybooking_rent_engine_selector]Funcionalidad
Inserta el formulario de seleccionar fechas y/o lugares de entrega y devolución
Ubicación
Página de Inicio o landing específica para el alquiler
Parámetros
Los siguientes parámetros opcionales permiten configurar el shortcode para diferentes escenarios:
Atributo
layout
Descripción
Permite definir la forma en la que se presenta el selector de fechas. Admite dos valores, «horizontal» (predeterminado) y «vertical».
Aplicación
layout=vertical
layout=horizontal
Atributo
family_id
Descripción
Busca productos dentro de una familia específica. El valor se toma del panel de gestión de Mybooking.
Aplicación
family_id=código_de_producto
Atributo
category_code
Descripción
Busca productos dentro de una categoría específica. El valor se toma del panel de gestión de Mybooking.
Aplicación
category_code=código_de_categoría
Atributo
rental_location_code
Descripción
Busca productos dentro de una base o sucursal específica. El valor se toma del panel de gestión de Mybooking.
Aplicación
rental_location_code=código_de _la_sucursal
Resultado
Resultado de la búsqueda
El Listado de productos muestra los resultados de la búsqueda realizada en el Selector y debe insertarse en una página específica. En ella se mostrarán los productos del inventario de Mybooking que estén disponibles y coincidan con los parámetros introducidos en el paso previo.
Shortcode
Código para insertar
[mybooking_rent_engine_product_listing]Funcionalidad
Muestra los resultados de la búsqueda hecha desde el Selector de fechas
Ubicación
Página Seleccionar vehículo
Parámetros
Este shortcode no admite parámetros.
Resultado
Checkout / Completar reserva
El siguiente paso en el proceso de reserva es la recogida de los Datos de la reserva en curso, también denominado checkout o Completar reserva. Este shortcode mostrará tres elementos principales: Selección de extras y coberturas, Formulario de datos del cliente y Pago o solicitud de reserva.
Es importante notar que según la configuración de nuestro negocio el número de elementos y sus características puede variar.
Shortcode
Código para insertar
[mybooking_rent_engine_complete]Funcionalidad
Muestra los extras y coberturas, el formulario de datos del cliente y el módulo de pago
Ubicación
Página Completar reserva
Parámetros
Este shortcode no admite parámetros.
Resultado
Resumen de la reserva
El último paso en el proceso consiste en mostrar la confirmación de la reserva. Para ello usaremos un shortcode específico que mostrará el estado de la solicitud, su identificador y los detalles del producto escogido.
Shortcode
Código para insertar
[mybooking_rent_engine_summary]Funcionalidad
Muestra los datos de la reserva solicitada, su estado y su identificador único
Ubicación
Página Resumen de la reserva
Parámetros
Este shortcode no admite parámetros.
Resultado
Mi reserva
Este componente permite a los clientes completar los datos necesarios para el contrato o bien realizar el pago del importe pendiente, todo ello integrado en nuestra página web.
Shortcode
Código para insertar
[mybooking_rent_engine_reservation]Funcionalidad
Muestra los datos de la reserva del cliente, un formulario completo y un módulo de pago
Ubicación
Página Mi reserva
Parámetros
Este shortcode no admite parámetros.
Resultado
Widget calendario
El Calendario de reserva es un componente opcional que tiene el propósito de insertar un iniciador de reserva para un producto específico que muestra la disponibilidad y el precio por día de manera visual. Esto puede ser muy conveniente cuando el producto tiene características únicas y no puede agruparse, como en el caso de campers, barcos, apartamentos, etc.
Shortcode
Código para insertar
[mybooking_rent_engine_product product_id=]Funcionalidad
Muestra un calendario con la disponibilidad y la ocupación y permite al usuario iniciar una reserva
Ubicación
Página específica para un único producto
Parámetros
El siguiente parámetro es obligatorio para mostrar correctamente las fechas y disponibilidad de un producto:
Atributo
product_id
Descripción
Conecta el calendario con su ficha en el inventario de Mybooking
Aplicación
product_id=código_de_producto
Resultado
Selector de turnos
El Selector de turnos es un componente opcional permite iniciar una reserva para un rango de horas. Este componente muestra una lista de turnos para una categoría de productos, previamente definidos en el panel de control de reservas (backoffice), basada en el día y el número de items que se desea alquilar.
Shortcode
Código para insertar
[mybooking_rent_engine_shift_picker category_code= shift_picker_id=]Funcionalidad
Muestra una lista de rangos de horas disponibles según la fecha y el número de items seleccionados
Ubicación
Página genérica
Parámetros
Los siguientes parámetros son obligatorios para mostrar correctamente las horas disponibles:
Atributo
category_code
Descripción
Conecta el selector con una categoría
Aplicación
category_code=identificador-categoria
Atributo
shift_picker_id
Descripción
Identificador único del selector. Permite varios selectores en la misma página
Aplicación
shift_picker_id=nombre
Los siguientes parámetros son opcionales:
Atributo
sales_channel_code
Descripción
Permite asignar el selector a un canal de ventas
Aplicación
sales_channel_code=identificador-canal
Atributo
rental_location_code
Descripción
Permite asignar el selector a una sucursal
Aplicación
rental_location_code=identificador-sucursal
Resultado
Catálogo de productos
El El catálogo de productos es un componente opcional que tiene el propósito de mostrar el inventario de productos directamente en nuestro sitio web. Tiene un aspecto muy similar al resultado del shortcode del Listado de productos con la salvedad de que no enlaza con el sistema de reservas y resulta recomendable cuando queremos crear una página para mostrar nuestra flota de vehículos.
Shortcode
Código para insertar
[mybooking_rent_engine_products]Funcionalidad
Lista todos los productos registrados en mybooking con su foto y características
Ubicación
Página específica
Parámetros
Este shortcode no admite parámetros.
Resultado
Navegación de capítulos