← Retour aux intégrations Intégrations · WordPress

Le plugin officiel — aucun code à écrire.

Installez-le, saisissez votre clé société et placez un shortcode là où vous voulez afficher le widget ou le formulaire de réservation complet.

// 01

Installation

1
Importez le plugin — farebookings-book-now.zip — depuis Plugins → Add New → Upload Plugin (Extensions → Ajouter → Téléverser une extension), ou copiez-le dans wp-content/plugins/ par FTP.
2
Activez-le.
3
Rendez-vous dans Settings → FareBookings et renseignez :
- Platform domain — app.farebookings.com, ou le sous-domaine en marque blanche du client s’il en a un
- Company key — à récupérer dans l’onglet Frontend de votre panneau
- Default language (langue par défaut)
- Default dark mode (mode sombre par défaut) — facultatif
- Default short-form layout — Vertical (le widget classique) ou Horizontal (une barre large) — facultatif, nouveau dans la v2.3
- Minimum short-form height — facultatif, nouveau dans la v2.5 — laissez vide, sauf si la section de dépannage du formulaire ci-dessous vous concerne

// 02

Shortcodes

Widget compact

[farebookings_widget]

lngLangue propre à ce widget (à défaut, la langue par défaut des réglages s’applique). Exemple : [farebookings_widget lng="fr"]

darkMode sombre (1) ou clair (0). Exemple : [farebookings_widget dark="1"]

opts_openAffiche le panneau Options déjà déplié (1) ou replié comme d’habitude (0).

layoutinline pour obtenir la barre horizontale large à la place du widget vertical. Nouveau dans la v2.3. Exemple : [farebookings_widget layout="inline"]. Le shortcode l’emporte toujours sur la valeur par défaut des réglages — pour forcer l’affichage vertical sur une page alors que l’horizontal est la valeur par défaut du site, utilisez [farebookings_widget layout=""].

heightHauteur minimale, en pixels, du formulaire court. Nouveau dans la v2.5 — voir ci-dessous. Exemple : [farebookings_widget height="700"]. Accepte 700 ou 700px ; toute autre valeur est ignorée et la hauteur redevient automatique.

titleTexte descriptif de l’iframe, pour l’accessibilité. Exemple : [farebookings_widget title="Book your taxi"]

Le formulaire paraît tronqué au premier chargement, mais s’affiche bien après actualisation ?

Le formulaire n’est pas en cause. Sa hauteur est mesurée par un script une fois la page chargée — si un plugin de cache (LiteSpeed, WP Rocket, etc.) retarde les scripts ou les styles, la mesure est faite trop tôt et donne un résultat trop court. Après une actualisation, tout est déjà en cache, la mesure est correcte, d’où l’aspect intermittent du problème. Il apparaît plus souvent avec opts_open="1", car le formulaire démarre alors déjà en grand dès le premier affichage.

Solution : définissez une hauteur minimale, soit page par page avec height="700" dans le shortcode, soit pour tout le site via Settings → FareBookings → Minimum short-form height. Si les deux sont renseignés, le shortcode l’emporte sur le réglage global.

Il s’agit d’un minimum, pas d’une hauteur fixe — le formulaire continue de s’agrandir selon les besoins (panneau Options, trajet retour, arrêts supplémentaires). Il ne descendra simplement jamais sous la valeur indiquée.
Vide = automatique, c’est le réglage normal et recommandé — n’ajoutez un minimum que si le symptôme décrit plus haut apparaît réellement.
Une valeur trop élevée laisse un espace vide sous le formulaire. Alignez-la à peu près sur la hauteur réelle du formulaire une fois chargé.

Disposition horizontale — à savoir

Largeur : il faut environ 1000px d’espace utile. Si le thème limite la largeur du contenu (fréquent sur les thèmes de type blog), placez le shortcode dans une section pleine largeur, sinon la barre sera écrasée.
Mobile : les champs s’empilent automatiquement sous 900px — inutile d’utiliser un shortcode distinct pour le mobile.

Formulaire de réservation complet

[farebookings_book_now]

Accepte le même paramètre lng si vous voulez imposer une langue différente de celle des réglages.

Le redimensionnement est automatique

Les deux shortcodes gèrent en interne le redimensionnement de l’iframe et la transmission des données décrits dans les guides PHP et HTML — rien à ajouter ici. Cela ne devient un sujet que si vous n’utilisez pas le plugin et collez le code à la main (voir plus bas).

// 03

Suivi des campagnes — automatique

Le plugin capture gclid (Google Ads), gbraid/wbraid, les paramètres utm_* standard et fbclid (Meta) sur n’importe quelle page du site, puis les transmet automatiquement aux deux shortcodes — rien à configurer.

Pourquoi c’est important

Le widget et le formulaire sont hébergés sur un autre domaine que le site du client. Sans la transmission de ces paramètres, Google Ads et Meta ne peuvent plus rattacher une réservation à la campagne qui l’a réellement générée.

// 04 · Uniquement si vous n’utilisez pas le plugin

Vous collez le code à la main ?

Ce n’est pas recommandé — le plugin ci-dessus gère déjà tout ce qui suit — mais si un client colle le code brut du widget ou du formulaire dans WordPress au lieu d’utiliser les shortcodes, suivez le guide PHP ou le guide HTML simple pour le code d’intégration lui-même, et méfiez-vous en plus de deux pièges propres à WordPress.

WordPress supprime la balise <script> à l’enregistrement

Si vous collez le code dans un bloc Paragraphe classique, ou dans le mode Visuel de l’éditeur classique, WordPress supprime silencieusement toutes les balises <script> par sécurité — seule la balise <div>/<iframe> subsiste, sans le JavaScript qui la fait fonctionner.

Solution : utilisez un bloc Custom HTML (HTML personnalisé) dans Gutenberg, l’onglet Text (Texte) de l’éditeur classique, ou configurez l’insertion automatique du code dans l’en-tête ou le pied de page plutôt que de le coller dans l’éditeur de contenu.

Les plugins de cache peuvent retarder le script

Des plugins comme WP Rocket proposent une option « Delay JavaScript execution » (différer l’exécution du JavaScript) pour accélérer le chargement des pages — elle peut casser l’ordre d’exécution dont dépend iframeResizer.

Solution : excluez les scripts de FareBookings de ce délai dans les réglages du plugin de cache — le nom de fichier iframeResizer, le domaine app.farebookings.com ou l’id de l’iframe fonctionnent tous comme motif d’exclusion.

// 05

Mettre à jour le plugin

1
Plugins → désactivez FareBookings → supprimez-le.
2
Importez le nouveau zip → activez-le.
3
Vos réglages sont conservés — clé société, serveur, langue, mode sombre et hauteur minimale sont tous stockés dans l’option fb_settings, que la suppression du plugin depuis l’écran Plugins ne touche pas.
4
Allez dans Settings → FareBookings et choisissez une disposition, si vous souhaitez la barre horizontale.

Vérifier quelle version est réellement installée

Recherchez FB_PLUGIN_v2.5 dans le code source de la page (Ctrl+U) — la mention apparaît à la fois sur la page du widget et sur la page Book Now.

Après la mise à jour, vérifiez ceci :

Toute page contenant déjà le widget s’affiche exactement comme avant.
Une page avec layout="inline" affiche la barre pleine largeur, sans espace vide en dessous.
Avec la barre : ouvrez Options → activez Stops — l’iframe s’agrandit en conséquence, sans barre de défilement interne, et la liste d’autocomplétion n’est pas coupée.
Un lien avec ?gclid=test123 vers la page du widget transmet toujours le gclid jusqu’au formulaire de réservation — le suivi n’a pas changé, mais c’est la vérification standard.

// Options courantes

Mode sombreAttribut de shortcode dark="1".

Panneau Options ouvertAttribut de shortcode opts_open="1".

LangueAttribut de shortcode lng="es", lng="fr", etc.

Barre horizontaleAttribut de shortcode layout="inline". Widget uniquement, v2.3+.

Hauteur minimaleAttribut de shortcode height="700". v2.5+. Corrige un formulaire tronqué au premier chargement.

// Vérifier que ça fonctionne

Vérifier le suivi

Ouvrez n’importe quelle page avec ?gclid=test123 ajouté à la fin de l’URL.
Validez le widget ou le formulaire et vérifiez que la réservation contient bien cette valeur.

Vous travaillez sur une autre plateforme ?

Des guides dédiés existent pour les sites PHP et pour les sites sans aucun back-end.

← Retour aux intégrations Écrivez-nous sur WhatsApp