Mybooking JS Engine

Librería JS del motor de reservas mybooking. Está diseñada para ser utilizada en el frontend de una página de reservas.

Permite la creación de motores de reservas para:

Alquiler de vehículos
Alquiler de material deportivo (kayak, surf, paddle, ...)
Actividades o tours.

Funcionalidades:

Creación de una web de reservas.
Creación de un calendario de disponibilidad para integrarlo en una página existente.

Version de Node

Probar con la versión a partir de 15.10.1

Instalar

$ npm install

Configuración

Crear un fichero config/env.json con el siguiente contenido para indicar la conexión con el API

{ "baseURL": "http://mbctransfer.test", "apiKey": "", "port": 8000 }

Desarrollo

Crear una carpeta config con un archivo env.json con los siguientes atributos

{
  "baseURL": "MY-BOOKING INSTANCE URL",
  "apiKey": "API-KEY",
  "port": 8000
}

Ejecutar

$ npm run start

Abrir el navegador

http://localhost:8000

Construir

$ npm run build

En la carpeta dist/js se generan dos ficheros:

mybooking-js-engine.js
mybooking-js-engine-bundle.js

El primero contiene todas las librerías para hacer funcionar el motor de reservas.

El segundo está preparado para ser utilizado en plugin de WordPress.

Usar

Configuración de la librería motor de reservas

Para configurar la librería del motor de reservas se necesita definir el objeto mybookingEngine en el contexto window con la información que detallamos a continuación.

Podemos incluirlo antes del final de la etiqueta </body> de cada una de las páginas del proceso de reserva o también podemos externalizarlo en un fichero JS, que es lo que recomendamos.

<script type="text/javascript">
    window.mybookingEngine = function(){
      var baseURL = 'BASE-URL';
      var chooseProductUrl = '/choose_product.html';
      var chooseExtrasUrl = '/choose_extras.html';
      var completeUrl = '/complete.html';
      var summaryUrl = '/summary.html';
      function getBaseURL() {
        return baseURL;
      }
      function getChooseProductUrl() {
        return chooseProductUrl;
      }
      function getChooseExtrasUrl() {
        return chooseExtrasUrl;
      }
      function getCompleteUrl() {
        return completeUrl;
      }
      function getSummaryUrl() {
        return summaryUrl;
      }
      return{
        baseURL: getBaseURL,
        chooseProductUrl: getChooseProductUrl,
        chooseExtrasUrl: getChooseExtrasUrl,
        completeUrl: getCompleteUrl,
        summaryUrl: getSummaryUrl
      }
    }();
</script>
<script src="/assets/js/mybooking-js-engine.js"></script>

Creación de las páginas

El proceso de reserva se implementa en 4 páginas html independientes. Se han de crear en el sitio web y han de seguir las siguientes convenciones:

Una clase en la etiqueta body que permite identificar el paso del proceso en el que estamos.
Una serie de contenedores que se utilizarán para presentar la información.
Un conjunto de micro templates para personalizar la presentación.

Inicio
```
<body class="index"></body>
```
Choose product
```
<body class="choose_product"></body>
```
Complete
```
<body class="complete"></body>
```
Summary
```
<body class="summary"></body>
```

mybooking-es / mybooking-js-engine Goto Github PK