← Volver a Integraciones Integraciones · WordPress

El plugin oficial: sin escribir código.

Instálalo, añade la clave de tu empresa y coloca un shortcode donde quieras mostrar el widget o el formulario de reserva completo.

// 01

Instalación

1
Sube el plugin — farebookings-book-now.zip — desde Plugins → Add New → Upload Plugin (Plugins → Añadir nuevo → Subir plugin), o cópialo en wp-content/plugins/ por FTP.
2
Actívalo.
3
Ve a Settings → FareBookings y rellena:
- Platform domain — app.farebookings.com, o el subdominio de marca blanca del cliente, si lo tiene
- Company key — la que encuentras en la pestaña Frontend de tu panel
- Default language (idioma por defecto)
- Default dark mode (modo oscuro por defecto) — opcional
- Default short-form layout — Vertical (el widget de siempre) u Horizontal (una barra ancha) — opcional, novedad de la v2.3
- Minimum short-form height — opcional, novedad de la v2.5 — déjalo vacío, salvo que te afecte la sección de solución de problemas del formulario que verás más abajo

// 02

Shortcodes

Widget compacto

[farebookings_widget]

lngIdioma de este widget en concreto (si no se indica, se usa el de los ajustes). Por ejemplo: [farebookings_widget lng="fr"]

darkModo oscuro (1) o claro (0). Por ejemplo: [farebookings_widget dark="1"]

opts_openArranca con el panel de opciones ya desplegado (1) o plegado, como de costumbre (0).

layoutinline para la barra horizontal ancha en lugar del widget vertical. Novedad de la v2.3. Por ejemplo: [farebookings_widget layout="inline"]. El shortcode siempre prevalece sobre el ajuste por defecto: para forzar el formato vertical en una página cuando el horizontal es el predeterminado en toda la web, usa [farebookings_widget layout=""].

heightAltura mínima en píxeles del formulario corto. Novedad de la v2.5 (más abajo, los detalles). Por ejemplo: [farebookings_widget height="700"]. Acepta 700 o 700px; cualquier otro valor se ignora y se aplica la altura automática.

titleTexto descriptivo del iframe, por accesibilidad. Por ejemplo: [farebookings_widget title="Book your taxi"]

¿El formulario se ve cortado al cargar, pero bien tras recargar la página?

No es un fallo del formulario. Un script mide su altura después de que la página se carga; si un plugin de caché (LiteSpeed, WP Rocket y similares) retrasa scripts o estilos, esa medición se hace demasiado pronto y sale corta. Al recargar, todo está ya en caché y la medición sale bien; por eso parece intermitente. Ocurre más a menudo con opts_open="1", porque el formulario empieza siendo alto desde el primer momento.

Solución: define una altura mínima, bien por página con height="700" en el shortcode, o para toda la web desde Settings → FareBookings → Minimum short-form height. Si defines ambas, el shortcode prevalece sobre el ajuste global.

Es una altura mínima, no fija: el formulario sigue creciendo cuando hace falta (panel de opciones, viaje de vuelta, paradas adicionales). Solo evita que baje del valor indicado.
Vacío significa automático, que es el ajuste normal y recomendado: añade un mínimo solo si te aparece el síntoma descrito arriba.
Un valor demasiado alto deja un hueco en blanco bajo el formulario. Ajústalo aproximadamente a la altura real del formulario una vez cargado.

Formato horizontal: lo que debes saber

Ancho: necesita unos 1000px de espacio útil. Si el tema limita el ancho del contenido (algo habitual en temas de blog), coloca el shortcode en una sección de ancho completo o la barra quedará comprimida.
Móvil: los elementos se apilan solos por debajo de 900px, sin necesidad de otro shortcode para móvil.

Formulario de reserva completo

[farebookings_book_now]

Acepta el mismo parámetro lng si quieres forzar un idioma distinto del definido en los ajustes.

El redimensionado es automático

Ambos shortcodes se encargan internamente del redimensionado del iframe y del reenvío de datos que se describen en las guías de PHP y HTML simple, así que no tienes que añadir nada. Solo tendrás que pensar en ello si prescindes del plugin y pegas el código a mano (más abajo).

// 03

Seguimiento de campañas: automático

El plugin captura gclid (Google Ads), gbraid/wbraid, los parámetros utm_* estándar y fbclid (Meta) en cualquier página de la web, y los reenvía automáticamente a ambos shortcodes, sin configurar nada.

Por qué es importante

El widget y el formulario viven en un dominio distinto al de la web del cliente. Si no se reenvían estos parámetros, Google Ads y Meta pierden la capacidad de atribuir una reserva a la campaña que la generó.

// 04 · Solo si no usas el plugin

¿Prefieres pegar el código a mano?

No lo recomendamos: el plugin de arriba ya se ocupa de todo lo que sigue. Pero si un cliente pega el código del widget o del formulario directamente en WordPress en lugar de usar los shortcodes, sigue la guía de PHP o de HTML simple para el código de integración, y ten en cuenta además dos trampas propias de WordPress.

WordPress elimina la etiqueta <script> al guardar

Si pegas el código en un bloque de párrafo normal o en el modo Visual del editor clásico, WordPress elimina sin avisar cualquier etiqueta <script> por seguridad: solo sobreviven el <div> o el <iframe>, sin nada del JavaScript que hace que funcione.

Solución: usa un bloque Custom HTML (HTML personalizado) en Gutenberg, la pestaña Text (Texto) del editor clásico, o configura el fragmento para que se inserte automáticamente en la cabecera o el pie, en lugar de pegarlo en el editor de contenido.

Los plugins de caché pueden retrasar el script

Plugins como WP Rocket ofrecen la opción “Delay JavaScript execution” (retrasar la ejecución de JavaScript) para acelerar la carga de la página, y puede romper el orden del que depende iframeResizer.

Solución: excluye los scripts de FareBookings de ese retraso en los ajustes del plugin de caché; sirven como patrón de exclusión el nombre de archivo iframeResizer, el dominio app.farebookings.com o el id del iframe.

// 05

Actualizar el plugin

1
Plugins → desactiva FareBookings → elimínalo.
2
Sube el nuevo zip → actívalo.
3
Los ajustes se conservan: la clave de la empresa, el servidor, el idioma, el modo oscuro y la altura mínima se guardan en la opción fb_settings, que no se toca al eliminar el plugin desde la pantalla de Plugins.
4
Ve a Settings → FareBookings y elige un formato, si quieres usar la barra horizontal.

Cómo comprobar qué versión tienes instalada

Busca en el código fuente de la página (Ctrl+U) el texto FB_PLUGIN_v2.5: aparece tanto en la página del widget como en la de reserva.

Después de actualizar, comprueba que:

Las páginas que ya tenían el widget se ven exactamente igual que antes.
Una página con layout="inline" muestra la barra de ancho completo, sin huecos debajo.
Con la barra: abre Opciones → activa Paradas; el iframe crece para ajustarse, sin barra de desplazamiento interna, y el desplegable de autocompletado no se corta.
Un enlace con ?gclid=test123 a la página del widget sigue llevando el gclid hasta el formulario de reserva; el seguimiento no ha cambiado, pero es la comprobación estándar.

// Opciones comunes

Modo oscuroAtributo del shortcode dark="1".

Panel de opciones abiertoAtributo del shortcode opts_open="1".

IdiomaAtributo del shortcode lng="es", lng="fr", etc.

Barra horizontalAtributo del shortcode layout="inline". Solo para el widget, v2.3+.

Altura mínimaAtributo del shortcode height="700". v2.5+. Soluciona el formulario cortado al cargar.

// Comprueba que funciona

Verificar que el seguimiento funciona

Visita cualquier página con ?gclid=test123 al final de la URL.
Envía el widget o el formulario y confirma que la reserva conserva ese valor.

¿Trabajas con otra plataforma?

Tenemos guías específicas para webs en PHP y para webs sin backend.

← Volver a Integraciones Pregúntanos por WhatsApp