← Torna alle integrazioni Integrazioni · WordPress

Il plugin ufficiale: nessun codice da scrivere.

Installalo, inserisci la chiave aziendale e posiziona uno shortcode dove vuoi il widget o il modulo di prenotazione completo.

// 01

Installazione

1
Carica il plugin — farebookings-book-now.zip — da Plugins → Add New → Upload Plugin (Plugin → Aggiungi nuovo → Carica plugin), oppure copialo in wp-content/plugins/ via FTP.
2
Attivalo.
3
Vai su Settings → FareBookings (Impostazioni → FareBookings) e compila:
- Platform domain (dominio della piattaforma) — app.farebookings.com, oppure il sottodominio white-label del cliente, se ne ha uno
- Company key (chiave aziendale) — dalla scheda Frontend del tuo pannello
- Default language (lingua predefinita)
- Default dark mode (modalità scura predefinita) — facoltativo
- Default short-form layout (layout predefinito del modulo breve) — Vertical (il widget classico) oppure Horizontal (una barra larga) — facoltativo, novità della v2.3
- Minimum short-form height (altezza minima del modulo breve) — facoltativo, novità della v2.5 — lascialo vuoto, a meno che non ti riguardi la sezione sulla risoluzione dei problemi qui sotto

// 02

Shortcode

Widget compatto

[farebookings_widget]

lngLingua per questo widget in particolare (se omessa vale quella predefinita in Settings). Ad es. [farebookings_widget lng="fr"]

darkModalità scura (1) o chiara (0). Ad es. [farebookings_widget dark="1"]

opts_openAvvia con il pannello Options già espanso (1) oppure chiuso come di consueto (0).

layoutinline per la barra orizzontale larga al posto del widget verticale. Novità della v2.3. Ad es. [farebookings_widget layout="inline"]. Lo shortcode ha sempre la precedenza sul valore predefinito di Settings: per forzare il layout verticale su una pagina quando quello orizzontale è impostato per tutto il sito, usa [farebookings_widget layout=""].

heightAltezza minima in pixel del modulo breve. Novità della v2.5, vedi sotto. Ad es. [farebookings_widget height="700"]. Accetta 700 oppure 700px; qualsiasi altro valore viene ignorato e l’altezza resta automatica.

titleTesto descrittivo per l’iframe, utile per l’accessibilità. Ad es. [farebookings_widget title="Book your taxi"]

Il modulo appare tagliato al primo caricamento, ma dopo un aggiornamento è a posto?

Non è un difetto del modulo. La sua altezza viene misurata da uno script dopo il caricamento della pagina: se un plugin di cache (LiteSpeed, WP Rocket e simili) ritarda script o stili, la misura avviene troppo presto e risulta troppo bassa. Con l’aggiornamento della pagina è tutto già in cache, la misura è corretta, ed è per questo che il problema sembra intermittente. Si presenta più spesso con opts_open="1", perché il modulo parte alto fin dal primo rendering.

Soluzione: imposta un’altezza minima, per singola pagina con height="700" nello shortcode oppure per tutto il sito da Settings → FareBookings → Minimum short-form height. Se sono impostate entrambe, lo shortcode ha la precedenza sull’impostazione globale.

È un’altezza minima, non fissa: il modulo continua a crescere quando serve (pannello Options, Return trip, fermate aggiuntive). Impedisce solo che scenda sotto il valore indicato.
Vuoto significa automatico, che è l’impostazione normale e consigliata: inserisci un minimo solo se il sintomo descritto sopra si presenta davvero.
Un valore troppo alto lascia spazio vuoto sotto il modulo. Fai riferimento all’incirca all’altezza reale del modulo a caricamento completato.

Layout orizzontale: cosa sapere

Larghezza: servono circa 1000px di spazio utile. Se il tema limita la larghezza del contenuto (frequente nei temi in stile blog), inserisci lo shortcode in una sezione a tutta larghezza, altrimenti la barra risulta schiacciata.
Mobile: sotto i 900px gli elementi si dispongono automaticamente in colonna, senza bisogno di uno shortcode separato per il mobile.

Modulo di prenotazione completo

[farebookings_book_now]

Accetta lo stesso parametro lng, se vuoi forzare una lingua diversa da quella predefinita in Settings.

Il ridimensionamento è automatico

Entrambi gli shortcode gestiscono internamente il ridimensionamento dell’iframe e l’inoltro dei dati descritti nelle guide PHP e HTML semplice: qui non devi aggiungere nulla. Diventa un tema solo se salti il plugin e incolli il codice a mano (vedi sotto).

// 03

Tracciamento delle campagne: automatico

Il plugin cattura gclid (Google Ads), gbraid/wbraid, i parametri standard utm_* e fbclid (Meta) su qualsiasi pagina del sito e li inoltra automaticamente a entrambi gli shortcode: non c’è nulla da configurare.

Perché è importante

Il widget e il modulo risiedono su un dominio diverso da quello del sito del cliente. Se questi parametri non vengono inoltrati, Google Ads e Meta non riescono più ad attribuire una prenotazione alla campagna che l’ha generata davvero.

// 04 · Solo se non usi il plugin

Preferisci incollare il codice a mano?

Non è consigliato, perché il plugin qui sopra gestisce già tutto ciò che segue, ma se un cliente incolla in WordPress il codice grezzo del widget o del modulo invece di usare gli shortcode, per il codice di embed segui la guida PHP o HTML semplice e fai attenzione a due trappole tipiche di WordPress.

WordPress rimuove il tag <script> al salvataggio

Se incolli il codice in un normale blocco Paragrafo, o nella modalità Visuale dell’editor Classic, WordPress rimuove in silenzio per sicurezza tutti i tag <script>: sopravvive solo il <div>/<iframe>, senza il JavaScript che lo fa funzionare.

Soluzione: usa un blocco Custom HTML (HTML personalizzato) in Gutenberg, la scheda Text (Testo) nell’editor Classic, oppure imposta l’inserimento automatico dello snippet nell’header o nel footer, invece di incollarlo nell’editor dei contenuti.

I plugin di cache possono ritardare lo script

Plugin come WP Rocket offrono l’opzione “Delay JavaScript execution” (ritarda l’esecuzione di JavaScript) per velocizzare il caricamento della pagina, ma può rompere l’ordine da cui dipende iframeResizer.

Soluzione: escludi gli script di FareBookings da quel ritardo nelle impostazioni del plugin di cache: come criterio di esclusione vanno bene il nome del file iframeResizer, il dominio app.farebookings.com o l’id dell’iframe.

// 05

Aggiornare il plugin

1
Plugins → disattiva FareBookings → eliminalo.
2
Carica il nuovo file zip → attivalo.
3
Le impostazioni vengono conservate: chiave aziendale, server, lingua, modalità scura e altezza minima si trovano tutte nell’opzione fb_settings, che l’eliminazione del plugin dalla schermata Plugins non tocca.
4
Vai su Settings → FareBookings e scegli un layout, se vuoi la barra orizzontale.

Come verificare quale versione è installata

Cerca nel sorgente della pagina (Ctrl+U) la stringa FB_PLUGIN_v2.5: compare sia nella pagina del widget sia in quella “Prenota ora”.

Dopo l’aggiornamento, controlla che:

ogni pagina che aveva già il widget sia identica a prima;
una pagina con layout="inline" mostri la barra a tutta larghezza, senza vuoti sotto;
con la barra: aprendo Options e attivando Stops, l’iframe si allunga di conseguenza, senza barra di scorrimento interna, e il menu dell’autocompletamento non venga tagliato;
un link con ?gclid=test123 verso la pagina del widget porti ancora il gclid fino al modulo di prenotazione: il tracciamento non è cambiato, ma è il controllo standard.

// Opzioni comuni

Modalità scuraAttributo dello shortcode dark="1".

Pannello Options apertoAttributo dello shortcode opts_open="1".

LinguaAttributo dello shortcode lng="es", lng="fr", ecc.

Barra orizzontaleAttributo dello shortcode layout="inline". Solo widget, dalla v2.3.

Altezza minimaAttributo dello shortcode height="700". Dalla v2.5. Risolve il modulo tagliato al primo caricamento.

// Verifica del funzionamento

Verifica che il tracciamento funzioni

Apri una qualsiasi pagina con ?gclid=test123 alla fine dell’URL.
Invia il widget o il modulo e controlla che la prenotazione conservi quel valore.

Usi un’altra piattaforma?

Esistono guide dedicate ai siti in PHP puro e ai siti senza alcun backend.

← Torna alle integrazioni Scrivici su WhatsApp