← Terug naar Integraties Integraties · WordPress

De officiële plugin — zonder code.

Installeer de plugin, vul je bedrijfssleutel in en plaats een shortcode op de plek waar je de widget of het volledige boekingsformulier wilt tonen.

// 01

Installatie

1
Upload de plugin — farebookings-book-now.zip — via Plugins → Add New → Upload Plugin (Plugins → Nieuwe plugin → Plugin uploaden), of kopieer hem via FTP naar wp-content/plugins/.
2
Activeer de plugin.
3
Ga naar Settings → FareBookings (Instellingen → FareBookings) en vul in:
- Platform domain — app.farebookings.com, of het white-label-subdomein van de klant als die er een heeft
- Company key (bedrijfssleutel) — uit het tabblad Frontend van je beheerpaneel
- Default language (standaardtaal)
- Default dark mode — optioneel, donkere modus als standaard
- Default short-form layout — Vertical (de gebruikelijke widget) of Horizontal (een brede balk) — optioneel, nieuw in v2.3
- Minimum short-form height — optioneel, nieuw in v2.5 — laat leeg, tenzij het onderdeel over probleemoplossing hieronder op jou van toepassing is

// 02

Shortcodes

Compacte widget

[farebookings_widget]

lngTaal voor alleen deze widget (valt terug op de standaard uit Settings). Bijv. [farebookings_widget lng="fr"]

darkDonkere (1) of lichte (0) modus. Bijv. [farebookings_widget dark="1"]

opts_openStart met het Options-paneel al uitgeklapt (1) of ingeklapt zoals normaal (0).

layoutinline voor de brede horizontale balk in plaats van de verticale widget. Nieuw in v2.3. Bijv. [farebookings_widget layout="inline"]. De shortcode wint altijd van de standaard in Settings — wil je op één pagina de verticale weergave afdwingen terwijl horizontaal de standaard voor de hele site is, gebruik dan [farebookings_widget layout=""].

heightMinimale hoogte in pixels voor het compacte formulier. Nieuw in v2.5 — zie hieronder. Bijv. [farebookings_widget height="700"]. Accepteert 700 of 700px; al het andere wordt genegeerd en valt terug op automatisch.

titleBeschrijvende tekst voor de iframe, voor toegankelijkheid. Bijv. [farebookings_widget title="Book your taxi"]

Lijkt het formulier bij het eerste laden afgesneden, maar is het na een refresh in orde?

Dit is geen fout in het formulier zelf. De hoogte wordt na het laden van de pagina door een script gemeten — als een cachingplugin (LiteSpeed, WP Rocket en dergelijke) scripts of stijlen uitstelt, gebeurt die meting te vroeg en valt de hoogte te klein uit. Bij een refresh staat alles al in de cache, klopt de meting wel, en daarom lijkt het probleem af en toe op te treden. Het komt vaker voor met opts_open="1", omdat het formulier dan al vanaf de allereerste weergave hoog begint.

Oplossing: stel een minimale hoogte in, per pagina met height="700" in de shortcode, of voor de hele site via Settings → FareBookings → Minimum short-form height. De shortcode wint van de instelling voor de hele site als beide zijn ingevuld.

Het is een minimum, geen vaste hoogte — het formulier groeit nog steeds mee waar nodig (Options-paneel, retourrit, extra tussenstops). Het voorkomt alleen dat het ooit onder het opgegeven getal komt.
Leeg betekent automatisch, de normale en aanbevolen instelling — voeg alleen een minimum toe als het bovenstaande probleem zich echt voordoet.
Een te hoog getal laat lege ruimte onder het formulier. Stem het globaal af op de werkelijke hoogte van het formulier zodra het geladen is.

Horizontale weergave — goed om te weten

Breedte: heeft ongeveer 1000px bruikbare ruimte nodig. Beperkt het thema de breedte van de content (gebruikelijk bij blogthema's), plaats de shortcode dan in een sectie over de volle breedte, anders wordt de balk samengeperst.
Mobiel: de onderdelen komen onder 900px automatisch onder elkaar — voor mobiel is geen aparte shortcode nodig.

Volledig boekingsformulier

[farebookings_book_now]

Accepteert dezelfde parameter lng als je een andere taal wilt afdwingen dan de standaard in Settings.

Het formaat past zich automatisch aan

Beide shortcodes regelen intern het aanpassen van de iframe-grootte en het doorgeven van gegevens, zoals beschreven in de PHP- en HTML-handleidingen — je hoeft hier niets extra's toe te voegen. Daar hoef je pas over na te denken als je de plugin overslaat en de code zelf plakt (zie hieronder).

// 03

Campagnetracking — automatisch

De plugin legt gclid (Google Ads), gbraid/wbraid, de standaard utm_*-parameters en fbclid (Meta) vast op elke pagina van de site en geeft ze automatisch door aan beide shortcodes — je hoeft niets te configureren.

Waarom dit belangrijk is

De widget en het formulier staan op een ander domein dan de eigen site van de klant. Worden deze parameters niet doorgegeven, dan kunnen Google Ads en Meta een boeking niet meer terugkoppelen aan de campagne die haar daadwerkelijk heeft opgeleverd.

// 04 · Alleen als je de plugin niet gebruikt

Code liever handmatig plakken?

Niet aanbevolen — de plugin hierboven regelt alles wat hieronder staat al voor je — maar plakt een klant de ruwe widget- of formuliercode toch in WordPress in plaats van de shortcodes te gebruiken, volg dan de handleiding voor PHP of gewone HTML voor de eigenlijke embedcode en let daarnaast op twee WordPress-valkuilen.

WordPress verwijdert de <script>-tag bij het opslaan

Plak je de code in een gewoon Paragraph-blok of in de Visual-modus van de Classic editor, dan verwijdert WordPress om veiligheidsredenen stilletjes alle <script>-tags — alleen de <div>/<iframe> blijft staan, zonder het JavaScript dat alles laat werken.

Oplossing: gebruik een Custom HTML-blok in Gutenberg, het tabblad Text in de Classic editor, of laat het snippet automatisch in de header of footer invoegen in plaats van het in de contenteditor te plakken.

Cachingplugins kunnen het script uitstellen

Plugins zoals WP Rocket bieden de optie “Delay JavaScript execution” om pagina's sneller te laden — daardoor kan de volgorde waarvan iframeResizer afhankelijk is verstoord raken.

Oplossing: sluit de scripts van FareBookings uit van die vertraging in de instellingen van de cachingplugin — iframeResizer (de bestandsnaam), app.farebookings.com (het domein) of de id van de iframe werken allemaal als uitsluitpatroon.

// 05

De plugin updaten

1
Plugins → deactiveer FareBookings → verwijder de plugin.
2
Upload de nieuwe zip → activeer de plugin.
3
Je instellingen blijven behouden — bedrijfssleutel, server, taal, donkere modus en de minimale hoogte staan allemaal in de optie fb_settings, die niet wordt aangeraakt als je de plugin via het scherm Plugins verwijdert.
4
Ga naar Settings → FareBookings en kies een weergave als je de horizontale balk wilt gebruiken.

Controleren welke versie echt is geïnstalleerd

Zoek in de paginabron (Ctrl+U) naar FB_PLUGIN_v2.5 — die staat zowel op de widgetpagina als op de Book Now-pagina.

Controleer na het updaten:

Elke pagina die al een widget had, ziet er nog precies zo uit als voorheen.
Een pagina met layout="inline" toont de balk over de volle breedte, zonder lege ruimte eronder.
Met de balk: open Options → zet Stops aan — de iframe groeit mee, er verschijnt geen interne scrollbalk en de autocomplete-dropdown wordt niet afgesneden.
Een link met ?gclid=test123 naar de widgetpagina geeft de gclid nog steeds door aan het boekingsformulier — de tracking zelf is niet veranderd, maar dit is de standaardcontrole.

// Veelgebruikte opties

Donkere modusShortcode-attribuut dark="1".

Options-paneel openShortcode-attribuut opts_open="1".

TaalShortcode-attribuut lng="es", lng="fr", enzovoort.

Horizontale balkShortcode-attribuut layout="inline". Alleen voor de widget, v2.3+.

Minimale hoogteShortcode-attribuut height="700". v2.5+. Lost een afgesneden formulier bij het eerste laden op.

// Controleren of het werkt

Controleren of de tracking werkt

Open een willekeurige pagina met ?gclid=test123 aan het eind van de URL.
Verstuur de widget of het formulier en controleer of de boeking die waarde meekrijgt.

Bouw je op een ander platform?

Er zijn aparte handleidingen voor gewone PHP-sites en voor sites zonder backend.

← Terug naar Integraties Vraag het ons via WhatsApp