# Formulario de reserva

Se utiliza el shortcode \[hb\_booking\_form\] o bloc “Formulario de reserva” para mostrar un formulario de búsqueda en una página de su página web. El proceso de reserva se hace en diferentes etapas y es posible establecer una redirección en las etapas siguientes:

- **Resultados de búsqueda:** una vez que el cliente ha indicado sus fechas, número de personas y número de alojamientos buscados. Esta redirección solo se puede hacer para una búsqueda global.
- **Formulario de datos:** una vez que el cliente ha elegido su/sus alojamientos
- **Resumen y agradecimiento:** en la última etapa de la reserva, en la etapa de la pantalla de confirmación de la reserva/solicitud de la reserva

* * *

<a id="shortcode-hb_booking_form"></a>

## Shortcode \[hb\_booking\_form\]

Utilizará el shortcode \[hb\_booking\_form\] para mostrar un formulario de búsqueda en cualquier sitio de su página web.

<a id="parámetros-de-tipo-de-búsqueda"></a>

### Parámetros de tipo de búsqueda

Con HBook, se puede hacer una **búsqueda global** (en todos los tipos de alojamientos) o una **búsqueda especifica** a un tipo de alojamiento.

**Por defecto:**

- en una página de un tipo de alojamiento, que sea en el **Tipo de Alojamiento** de HBook, o en la página indicada en [Ajustes de presentación](../../documentacion-hbook/tipos-de-alojamiento.md#alojamiento-ajustes-presentacion), la búsqueda se hace por defecto para este tipo de alojamiento.
- en cualquiera otra página, la búsqueda se hace por defecto para todos los tipos de alojamiento.

**Parámetros:**

- **all\_accom:** si quiere mostrar el formulario en una página de un tipo de alojamiento, el formulario de búsqueda se hará por defecto únicamente para este alojamiento. Si desea que HBook efectúa la búsqueda para todos los alojamientos, habrá que añadir el ajuste **all\_accom** a **yes**.
- **accom\_id:** utiliza este ajuste para que el formulario de búsqueda solo haga la búsqueda para un tipo de alojamiento.

> [!INFO]
> Se puede encontrar el ID de un tipo de alojamiento en la página del alojamiento, justo debajo del título.

<a id="parámetros-de-redirección"></a>

### Parámetros de redirección

**Por defecto:**

- HBook tiene distintas etapas y por defecto, no se hace ninguna redirección.

**Parámetros:**

- **search\_only:** utiliza este ajuste solamente para mostrar un formulario de búsqueda. Una vez que el cliente ha hecho clic sobre el botón “Búsqueda”, será redirigido hacia la página que corresponde al URL entrado como valor para el ajuste **redirection\_url**.

> [!INFO]
> Este ajuste solo puede utilizarse durante una búsqueda global, y no sobre una página de un alojamiento o con el ajuste “accom\_id”.

- **redirection\_url:** añade este ajuste si quiere utilizar el ajuste **search\_only** o si desea redirigir el cliente después de la selección del tipo de alojamiento. Este ajuste debe contener el URL de la página donde redirige el cliente. Esta misma página deberá contener el shortcode **\[hb\_booking\_form\]**.
- **thank\_you\_page\_url:** este ajuste es útil si quiere redirigir su cliente a una página distinta para mostrar la pantalla de confirmación de la reserva/solicitud de la reserva, habitualmente llamado “Página de agradecimientos/Thank you page”.  
En esta “Página de agradecimientos”, es obligatorio añadir un shortcode [\[hb\_reservation\_summary\] o un bloc “Resumen de la reserva](../shortcodes-bloques/resumen-de-la-reserva.md)”.

> [!INFO]
> Si utiliza el ajuste “redirection\_url” para el shortcode \[hb\_booking\_form\], no añadirá el ajuste “thank\_you\_page\_url” en este shortcode, pero en el que se presenta sobre la página donde el cliente está redirigido para entrar sus datos de cliente/reserva.

<a id="parámetros-de-diseño-y-personalización"></a>

### Parámetros de diseño y personalización

**Por defecto:**

- HBook no muestra la miniatura y la descripción si solo tiene un tipo de alojamiento o si la búsqueda solo es para un tipo de alojamiento.

**Parámetros:**

- **force\_display\_thumb:** añade este ajuste si quiere forzar la visualización de la miniatura cuando la búsqueda es solamente para un tipo de alojamiento. Por defecto, HBook no muestra la miniatura y la descripción si solo tiene un tipo de alojamiento o si la búsqueda solo es para un tipo de alojamiento. Se debe indicar el valor **yes** para mostrar la miniatura.
- **force\_display\_desc:** añade este ajuste si quiere forzar la visualización de la **Descripción** cuando la búsqueda solo es para un tipo de alojamiento. Se debe indicar el valor **yes** para mostrar la miniatura.
- **search\_form\_placeholder**: este ajuste es útil si quiere ignorar el ajuste por defecto, definido en **HBook > Formulario de búsqueda**, y en vez utilizar labels/placeholder.
- **form\_id:** añade este ajuste para poder **definir un ID** al formulario. Esto puede ser útil para aplicar un estilo diferente a algunos formularios o si tiene script JS específico para este formulario.

**Ejemplos**

> [!NOTE]
> **\[hb\_booking\_form search\_only="yes" redirection\_url="https://www.abc.com/main-booking-form"\]**  
> Con este shortcode, su cliente indicará las fechas de entrada y de salida así como el número de adultos/niños si es necesario Cuando hará clic sobre el botón “Búsqueda”, será redirigido hacia otra página para las etapas de la reserva (selección del alojamiento y de los servicios suplementarios, datos del cliente, pago y confirmación).

> [!NOTE]
> **\[hb\_booking\_form redirection\_url="https://www.abc.com/main-booking-form"\]**  
> Con este shortcode, su cliente indicará las fechas de entrada y de salida, así como el número de adultos/niños si es necesario Los resultados de la búsqueda serán mostrados y es únicamente después de haber elegido el tipo del alojamiento que será redirigido hacia otra página. Después, el cliente podrá elegir los servicios suplementarios, añadir los datos cliente, etc.
>   
> Es obligatorio tener un shortcode \[hb\_booking\_form\] o bloc “Formulario de búsqueda” en la página sobre la cual está redirigido el cliente.

> [!NOTE]
> **\[hb\_booking\_form thank\_you\_page\_url="https://www.abc.com/thank-you"\]**  
> Con este shortcode, el cliente será redirigido a su “Página de agradecimientos/Thank you page” para la última del proceso de reserva, lo que corresponde al momento donde está mostrado a la pantalla la confirmación de la reserva/solicitud de la reserva con el resumen.
> En está “Página de agradecimientos”, es obligatorio añadir un shortcode [\[hb\_reservation\_summary\] o un bloc “Resumen de la reserva](../shortcodes-bloques/resumen-de-la-reserva.md)”.

> [!NOTE]
> **\[hb\_booking\_form force\_display\_desc="yes" force\_display\_thumb="yes"\]**  
> Con este shortcode, la miniatura y la descripción serán mostrados incluso en el caso de una búsqueda con un solo tipo de alojamiento.

> [!NOTE]
> **\[hb\_booking\_form force\_display\_desc="yes" force\_display\_thumb="yes"\]**  
> Con este shortcode, la miniatura y la descripción serán mostrados incluso en el caso de una búsqueda con un solo tipo de alojamiento.

* * *

<a id="formulario-de-reserva-gutenberg"></a>

## Formulario de reserva - Gutenberg

![booking-gutenberg.png](./attachments/booking-gutenberg.png)

1. Selecciona el **tipo de alojamiento** del formulario de reserva. Se puede elegir o “Todos” o un tipo de alojamiento específico.
2. Indica si quiere que el formulario sea **Solo Búsqueda**. Cuando está activado, es obligatorio indicar la página de **Redirección**. El cliente indicará las fechas buscadas y el número de personas. Al pinchar el botón “Buscar”, estará redirigido hacia la página indicada en los ajustes de **Redirección**.

> [!INFO]
> Este ajuste solo puede utilizarse para una búsqueda global, y no en una página de un alojamiento o para un tipo de alojamiento específico.

3. Indica la página de **Redirección**. Se puede utilizar este ajuste combinado con el ajuste “Solo búsqueda” o bien solo. Si lo utiliza solo (sin activar “Solo búsqueda”), los clientes entran las fechas deseadas, el número de personas, y luego eligen su(s) alojamiento(s) en la lista de los resultados. Es después de esta etapa que estarán redirigidos hacia la página indicada en “Redirección” para entrar sus datos de cliente/reserva, y el pago (opcional).
4. Indica la página de **Agradecimientos**. Se puede utilizar este ajuste para redirigir sus clientes a su propia “Página de agradecimientos/Thank you page” para la última etapa del proceso de reserva, lo que corresponde al momento donde está mostrado a la pantalla la confirmación de la reserva/solicitud de la reserva con el resumen.