web_bookings_finder Shortcode
El shortcode web_bookings_finder muestra el componente del buscador de reservas.
Los atributos que figuran a continuación coinciden con los controles actuales del Page Builder y con la salida pública. Usa la sintaxis sin procesar únicamente para contenido revisado que no pueda mantenerse mediante los controles visuales.
Uso
[web_bookings_finder]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
date_picker |
input |
input, inline |
Controla el selector de fecha. |
show_end_date_selector |
yes |
yes, vacío |
Muestra el selector opcional de fecha de fin inclusiva. |
page_url |
— | Cadena, salvo que se indique lo contrario | URL de la página en la que mostrar los resultados. Puedes dejarlo vacío para que sea la misma página. |
start_date_label |
Start |
Cadena, salvo que se indique lo contrario | Controla la etiqueta de inicio. |
start_date_placeholder |
Choose a date to see availability |
Cadena, salvo que se indique lo contrario | Controla el marcador de posición del campo de inicio. |
end_date_label |
End |
Cadena, salvo que se indique lo contrario | Controla la etiqueta de fin. |
end_date_placeholder |
Choose a date to see availability |
Cadena, salvo que se indique lo contrario | Controla el marcador de posición del campo de fin. |
results_number_label |
Results found: |
Cadena, salvo que se indique lo contrario | Controla la etiqueta del número de resultados. |
template |
default |
default o un slug de plantilla de feed personalizada configurada |
Selecciona la plantilla utilizada para cada resultado de reserva. |
columns |
4 |
12, 6, 4, 3, 2, 1 |
Extensión de cuadrícula: respectivamente 1, 2, 3, 4, 6 o 12 columnas de escritorio; apilada en dispositivos más pequeños. |
device_visibility |
— | web-hide-on-xs, web-hide-on-sm, web-hide-on-md, web-hide-on-lg, separados por comas |
Oculta todo el buscador en los rangos de dispositivos seleccionados. |
el_id |
— | ID HTML único válido | Introduce el ID de la sección (Nota: asegúrate de que sea único y válido conforme a la especificación w3c). |
el_class |
— | Cadena, salvo que se indique lo contrario | Si deseas aplicar un estilo diferente a un elemento de contenido concreto, utiliza este campo para añadir un nombre de clase y haz referencia a él después en tu archivo css. |
Requisito de integración
Esta salida requiere que la integración de reservas correspondiente y sus datos de origen estén disponibles.
El formulario utiliza los parámetros GET start_date y, opcionalmente, end_date. Los nuevos envíos utilizan YYYY-MM-DD; los enlaces antiguos válidos de DD/MM/YYYY siguen funcionando. Sin fecha de fin, el buscador comprueba una reserva que comience ese día. Un intervalo inclusivo proporcionado debe coincidir con una duración de producto permitida. En el caso del alojamiento, el fin es la última noche y la salida es el día siguiente. Se aplican la política de reservas nativa, los recursos y el tamaño mínimo del grupo.
Las búsquedas admiten como máximo 31 días y procesan el catálogo completo de reservas publicado en lotes. La vista previa del editor autenticado conserva sus límites de trabajo de 50 productos y 2.000 candidatos/recurso/día. Los estados de integración no disponible son explícitos. Solo se muestran los productos actualmente visibles, publicados y accesibles. Los recuentos de resultados reflejan los productos renderizados. Una plantilla personalizada debe seguir existiendo; default muestra tarjetas alternativas solo con título.
el_id, el_class y la visibilidad por dispositivo se aplican una vez al contenedor que envuelve tanto el formulario como los resultados. Los ID de los campos generados son únicos en todas las instancias. Los recursos existentes del selector de fecha del tema son condicionales a la presencia del Buscador; la plantilla seleccionada y los recursos de acciones de producto se detectan cuando Bookings está activo. El renderizado del shortcode sigue disponible con la interfaz Legacy del Page Builder desactivada.
Excluye las páginas del buscador de las cachés de página completa previas. El tema solicita la omisión de caché, pero la disponibilidad debe confirmarse igualmente en el formulario de reserva del producto. Buscar no reserva un producto.
Consulta Search bookable products with Bookings Finder para el bloque Gutenberg correspondiente y la lista de verificación.
Verificación
Prueba web_bookings_finder en sus estados relevantes con sesión iniciada y sin iniciar, incluyendo la validación y los mensajes de éxito y error. Presta especial atención a date_picker y show_end_date_selector.