Per iniziare

Tutto quello che serve per passare dallo zip del plugin a una prima prenotazione di prova: cosa deve avere il server, cosa crea l’attivazione, un giro nella dashboard, una checklist di configurazione nell’ordine giusto e come funzionano piani, licenze e aggiornamenti.

Requisiti

• WordPress 6.3 o successivo (testato fino alla 6.8).
• PHP 8.0 o successivo.
• HTTPS sul sito. Servono sia per i pagamenti con carta sia per la pagina della prenotazione dell’ospite.
• Qualsiasi tema. Elementor è facoltativo: JetBookIn ha i suoi widget Elementor, e ogni widget esiste anche come shortcode per l’editor a blocchi o per qualsiasi altro page builder.
• Polylang o WPML se il sito è in più lingue (facoltativo). JetBookIn parla inglese e greco già dall’installazione.
• Accesso al pannello dell’hosting per aggiungere un cron job sul server di un sito live (vedi il passo 11). Bastano due minuti, e così importazioni dei calendari, promemoria e addebiti automatici partono in orario.

Suggerimento: installa prima JetBookIn su una copia di staging, se ne hai una. Anche lì le funzioni Pro richiedono una licenza, come sul sito online (vedi Siti locali e di staging).

Installazione e attivazione

1. Scarica lo zip del plugin (jetbookin-x.y.z.zip) dal tuo account su jetbookin.com.
2. In WordPress vai su Plugin → Aggiungi nuovo plugin → Carica plugin.
3. Scegli lo zip, fai clic su Installa ora e poi su Attiva.
4. Nel menu di amministrazione di WordPress, in alto, compare la voce JetBookIn. Fai clic per aprire la dashboard.

Se vedi l’avviso JetBookIn: mancano le dipendenze, lo zip caricato non è una versione di rilascio (per esempio è una copia del codice sorgente). Scarica di nuovo lo zip di rilascio e carica quello.

Cosa crea l’attivazione

Quando attivi il plugin, viene preparato tutto ciò che gli serve. Non devi creare nulla a mano.

• Una pagina “Conferma della prenotazione”, pubblicata, che contiene lo shortcode [jetbookin_confirmation]. Gli ospiti arrivano qui dopo il pagamento, e i link nelle e-mail aprono qui la pagina della loro prenotazione. Il suo ID è salvato in Impostazioni → Generale → ID della pagina di conferma prenotazione. Se l’impostazione punta già a una pagina esistente (per esempio dopo una riattivazione), non viene creata una seconda pagina. Lascia questa pagina pubblicata; puoi rinominarla, tradurla o progettarla con Elementor.
• Tabelle proprie nel database per disponibilità, tariffe, prenotazioni, pagamenti e calendari. Strutture e tipologie di camera sono normali contenuti di WordPress (quindi temi, plugin SEO ed Elementor funzionano con loro); i loro indirizzi pubblici iniziano con /property/ e /room/.
• Tre ruoli utente:
  • Gestore prenotazioni: può usare la dashboard di JetBookIn e caricare foto senza essere amministratore di WordPress. È il ruolo giusto per il personale della reception.
  • Addetto alle pulizie: vede solo l’elenco delle pulizie (Pro).
  • Proprietario della struttura: vede solo i propri rendiconti e il proprio calendario di occupazione (Pro, modulo Proprietari).

  Gli amministratori hanno accesso a JetBookIn automaticamente.

• Gli indirizzi dei feed di calendario che Booking.com, Airbnb e le altre piattaforme leggono (uno per unità).

Le pagine di prenotazione usate dagli ospiti (ricerca, risultati, riquadro di prenotazione della camera) non vengono create automaticamente, perché ogni sito ha un design diverso. Le aggiungi al passo 8 della checklist.

Un giro nella dashboard

Tutta l’attività di prenotazione si gestisce da un’unica schermata, JetBookIn nel menu di amministrazione. In alto ci sono sei gruppi; quando un gruppo ha più schermate, queste compaiono sotto come seconda fila di schede. Gli stessi sei gruppi sono elencati sotto JetBookIn nel menu di amministrazione di WordPress, così puoi raggiungerli direttamente.

Alcune cose funzionano ovunque nella dashboard:

• Selettore della struttura. Se hai più strutture, un menu in alto a sinistra ti permette di sceglierne una oppure Tutte le strutture. Le schermate mostrano poi solo le camere di quella struttura. Con una sola struttura compare invece il suo nome.
• Visualizza sito ↗, in alto a destra, apre il sito in una nuova scheda.
• Pannelli laterali. Quando aggiungi o modifichi qualcosa (una tipologia di camera, un piano tariffario, una stagione) si apre un pannello sulla destra. Nulla viene salvato finché non fai clic su Salva.
• Banner rossi e arancioni in alto ti segnalano ciò che impedisce agli ospiti di prenotare, per esempio Gli ospiti non possono prenotare online 2 tariffe (una tariffa chiede un acconto ma non è configurato nessun metodo di pagamento), Le attività in background non vengono eseguite in orario oppure Gli ospiti non possono prenotare con largo anticipo (i prezzi stanno per finire).
• Dopo un aggiornamento, una dashboard rimasta aperta in una scheda del browser mostra JetBookIn è stato aggiornato alla versione … Ricarica la pagina per usare la nuova versione. Fai clic su Ricarica.

Checklist di configurazione: dalla prima struttura alla prima prenotazione di prova

Segui questi passi nell’ordine. Per una piccola struttura (una villa o due o tre appartamenti) ci vuole circa un’ora; per un hotel di 20 camere con diverse tipologie e tariffe, metti in conto un pomeriggio.

1. Controlla la valuta

Apri Impostazioni → Generale e controlla Valuta (codice ISO). Il valore predefinito è EUR. Cambiala prima di inserire qualsiasi prezzo (per esempio GBP o CHF) e fai clic su Salva impostazioni. Le prenotazioni vengono sempre addebitate in questa valuta.

2. Aggiungi la tua struttura

Apri Struttura e fai clic su + Aggiungi struttura. Compila almeno nome, telefono, e-mail, indirizzo, paese, orari di check-in e check-out e, se il tuo paese lo richiede, il numero di registrazione. Poi controlla la scheda Tasse e costi. Ogni campo è spiegato in Struttura, camere e unità.

3. Aggiungi le tipologie di camera

Fai clic su + Aggiungi tipologia di camera una volta per ogni tipo di alloggio che vendi: “Suite Deluxe vista mare”, “Appartamento con due camere da letto”, “Villa Elia”. Per ciascuna inserisci foto, servizi, letti, superficie e, nella scheda Ospiti e costi, quanti ospiti può accogliere. Quando salvi una nuova tipologia di camera, JetBookIn la crea con 1 unità e una tariffa standard, così puoi darle subito un prezzo.

4. Aggiungi un’unità per ogni camera reale

Un’unità è una camera, un appartamento o una villa fisica che vendi. Un hotel con otto camere doppie identiche ha una tipologia (“Camera doppia”) con otto unità (“Camera 101” … “Camera 108”). Tre appartamenti diversi di solito sono tre tipologie con un’unità ciascuna. Nella scheda di ogni tipologia fai clic su + Aggiungi unità e rinomina le unità con i tuoi numeri di camera. Disponibilità e sincronizzazione dei calendari si contano per unità.

5. Imposta i piani tariffari

La Tariffa standard creata in automatico si paga per intero al momento della prenotazione e non prevede penali di cancellazione. Aprila con Modifica e inserisci le tue vere condizioni di cancellazione e il tuo acconto. Se vuoi, aggiungi altre tariffe, per esempio una flessibile con acconto del 30% e una non rimborsabile più economica. Vedi Piani tariffari.

6. Inserisci i prezzi nel calendario

Una tipologia di camera è prenotabile solo nelle date che hanno un prezzo. Apri Calendario → Tariffe e disponibilità, fai clic su Modifica in blocco, scegli date, camere e tariffe e inserisci il prezzo a notte e il soggiorno minimo. In alternativa crea delle Calendario → Stagioni (alta stagione, bassa stagione…) con i loro prezzi. Poi attiva Impostazioni → Generale → Tieni aperto il calendario, così le date non finiscono mai. Vedi Tariffe e disponibilità.

7. Configura i pagamenti

Apri Impostazioni → Pagamenti e configura i metodi che usi: Stripe, Viva Wallet, il gateway di carte di una banca greca (Cardlink / Nexi / Worldline), PayPal, bonifico bancario o pagamento in struttura. Per ora lasciali in modalità Test / sandbox. Vedi Pagamenti.

Importante: se una tariffa chiede un acconto e non è configurato nessun metodo di pagamento, gli ospiti non possono prenotarla online; la dashboard mostra un banner rosso finché non risolvi.

8. Inserisci il motore di prenotazione nel sito

Crea una pagina, per esempio Prenota, e aggiungici la barra di ricerca e i risultati: con Elementor trascina i widget dalla categoria JetBookIn; con qualsiasi altro editor usa gli shortcode [jetbookin_search] e [jetbookin_results]. Le pagine delle camere ricevono un riquadro di prenotazione con calendario. Poi inserisci l’ID di quella pagina in Impostazioni → Generale → ID della pagina di checkout, così Prenota nel riquadro di prenotazione di una camera prosegue lì. Tutti i widget e le opzioni sono in Shortcode e widget.

9. Collega le piattaforme

Se vendi anche su Booking.com, Airbnb, Vrbo o Expedia, apri Calendario → Canali e collega ogni unità a ogni piattaforma in entrambe le direzioni, così una prenotazione fatta in qualsiasi punto chiude le date ovunque. Vedi Sincronizzazione dei calendari.

10. Controlla le e-mail

Nella schermata Impostazioni, sezione E-mail, imposta nome e indirizzo del mittente e il colore dell’intestazione. Poi apri la schermata E-mail (la seconda scheda del gruppo Impostazioni) e rileggi le e-mail per gli ospiti. Se le e-mail non arrivano, inviale tramite la tua casella di posta con Posta in uscita (SMTP), nella stessa sezione. Vedi E-mail.

11. Aggiungi il cron job sul server (siti live)

Importazioni dei calendari, promemoria e addebiti automatici del saldo girano in background. WordPress esegue le attività in background solo quando qualcuno visita il sito, quindi in una notte tranquilla possono arrivare in ritardo. Apri Impostazioni → Sistema: la scheda Attività in background mostra se le attività vengono eseguite in orario e la riga esatta da dare al tuo hosting, per esempio:

*/5 * * * * cd /path/to/wordpress && wp jetbookin run-jobs --quiet

Aggiungila nella sezione cron job del pannello dell’hosting, ogni 5 minuti. Se sul server non c’è WP-CLI, funziona anche un cron job che apre ogni 5 minuti l’indirizzo wp-cron.php del tuo sito (la scheda mostra anche quell’indirizzo).

12. Attiva la licenza

Se hai acquistato Pro o il pacchetto Grecia, apri Impostazioni → Licenza, incolla la chiave e fai clic su Attiva. Vedi Attivare la licenza.

13. Fai una prenotazione di prova

1. Con i pagamenti ancora in modalità test, apri il sito in una finestra anonima del browser e prenota una camera come farebbe un ospite. Usa la carta di prova del fornitore di pagamento.
2. Controlla che la prenotazione compaia in Prenotazioni → Prenotazioni e in Oggi.
3. Controlla che siano arrivate l’e-mail di conferma all’ospite e la tua e-mail Nuova prenotazione.
4. Controlla che le date risultino chiuse in Calendario → Tariffe e disponibilità e, dopo la sincronizzazione successiva, sulle tue piattaforme.
5. Cancella la prenotazione di prova e passa i metodi di pagamento a Live.

Piani: Core, Pro e il pacchetto Grecia

JetBookIn è disponibile in due piani, a cui si possono aggiungere pacchetti per paese.

Core

La base gratuita. Un sito con Core gestisce le prenotazioni dirette dall’inizio alla fine: strutture, tipologie di camera, unità e piani tariffari; la griglia di tariffe e disponibilità, le stagioni, il riempimento dei buchi e il calendario sempre aperto; la sincronizzazione bidirezionale dei calendari; tutti i metodi di pagamento con acconti; il calendario delle camere e le prenotazioni; i widget di ricerca, risultati e prenotazione per gli ospiti. Questi moduli fanno parte di Core:

• Gestione prenotazione da parte dell’ospite: gli ospiti vedono, pagano e cancellano la loro prenotazione online.
• Condizioni di cancellazione: regole di penale per piano tariffario con calcolo automatico del rimborso.
• Strumenti GDPR: consenso, esportazione e cancellazione dei dati, anonimizzazione automatica.
• Modelli e-mail: e-mail per ospiti e staff modificabili per lingua, promemoria.

Pro

Tutto ciò che c’è in Core, più questi moduli:

Anche la garanzia con carta (l’ospite salva una carta su Stripe quando non paga nulla in anticipo) è una funzione Pro.

Pacchetto Grecia Pacchetto Grecia

Le regole valide in un solo paese arrivano come pacchetto per quel paese, in aggiunta a uno dei due piani. Il pacchetto Grecia aggiunge:

• Conformità normativa greca: il report mensile della ΤΑΚΚ, le esportazioni per il commercialista e l’e-mail mensile al commercialista.
• Fatturazione myDATA (AADE): emissione di ricevute, fatture e documenti ΤΑΚΚ direttamente su AADE myDATA.

Entrambi sono disattivati per impostazione predefinita. Anche senza il pacchetto, la ΤΑΚΚ viene comunque aggiunta ai prezzi per gli ospiti (con le Tasse di soggiorno di Pro) e i numeri di registrazione vengono comunque mostrati. Vedi Grecia.

Una schermata la cui funzione non è inclusa nella tua licenza compare comunque nel menu con il badge Pro o Add-on. Se la apri, leggi Questa è una funzione di JetBookIn Pro, con Vedi i piani e Inserisci la chiave di licenza.

Attivare e disattivare i moduli

Impostazioni → Moduli elenca tutte le funzioni raggruppate per area (Ospiti, Pagamenti, Ricavi, Operatività, Conformità e tasse, Pacchetti per paese), ciascuna con ciò che fa, il suo livello (Incluso, Pro o il pacchetto per paese) e un interruttore. La riga in alto indica quanti moduli sono attivi.

• Disattiva ciò che non usi. Le sue schermate e impostazioni spariscono; non viene eliminato nulla. Quando lo riattivi, torna tutto com’era.
• Quando un modulo è attivo, il pulsante alla sua destra ti porta dove si configura, per esempio Si imposta in Struttura → Piani tariffari per le condizioni di cancellazione, oppure indica Niente da impostare.
• Un modulo non coperto dalla tua licenza ha l’interruttore in grigio e indica Richiede una licenza Pro o Richiede il pacchetto Grecia nella tua licenza, con Vedi i piani.
• I pacchetti per i paesi in cui non hai strutture sono nascosti; Pacchetti per altri paesi li mostra.

Attivare la licenza

Core funziona senza chiave di licenza. Per Pro o per un pacchetto per paese:

1. Apri Impostazioni → Licenza. Solo gli amministratori di WordPress possono modificare la licenza; i Gestori prenotazioni ne vedono lo stato.
2. Incolla la chiave in Chiave di licenza (ha questo aspetto: XXXX-XXXX-XXXX) e fai clic su Attiva.
3. La scheda mostra lo stato (Attiva), il piano (Piano Pro), la data fino alla quale ricevi gli aggiornamenti e i tuoi add-on (per esempio Add-on: Pacchetto Grecia).

Quando una chiave è attiva, la scheda offre:

• Verifica ora: chiede a jetbookin.com lo stato attuale della licenza (utile subito dopo un rinnovo o un upgrade). Il sito controlla comunque da solo una volta al giorno.
• Cambia chiave: attiva una chiave diversa. Il posto occupato da questo sito sulla vecchia chiave viene liberato.
• Disattiva su questo sito: rimuove la licenza da questo sito, così puoi usarla su un altro.
• Rinnova licenza e Più siti o Pro: aprono il negozio di jetbookin.com con la tua chiave già inserita.

Messaggi possibili durante l’attivazione:

Quando una licenza scade

Una licenza vale per il periodo pagato. Ecco cosa succede intorno alla data di scadenza:

1. 30 giorni prima, la schermata Oggi indica La licenza JetBookIn scade il …, tra N giorni. La rinnovi per mantenere le funzioni Pro e gli aggiornamenti.
2. Alla data di scadenza gli aggiornamenti si fermano. Le funzioni Pro e gli add-on continuano a funzionare per un periodo di tolleranza di 14 giorni, così un pagamento di rinnovo non andato a buon fine non blocca il sito da un giorno all’altro. Oggi indica Rinnovi entro il …, altrimenti le funzioni Pro si disattivano e il sito continua con il Core gratuito.
3. Trascorsi i 14 giorni, le funzioni Pro e gli add-on si disattivano e il sito funziona con Core. Prenotazioni, calendario, pagamenti, sincronizzazione dei calendari e le e-mail di base continuano a funzionare. Non viene eliminato nulla: promozioni, extra, impostazioni delle tasse e tutto il resto vengono conservati.
4. Rinnovando (pulsante Rinnova licenza) si riattiva subito tutto. Se non succede entro pochi minuti, fai clic su Verifica ora in Impostazioni → Licenza.

Importante: con le Tasse di soggiorno disattivate, agli ospiti non vengono più addebitati ΤΑΚΚ, IVA o altre tasse, ma in Grecia devi comunque versare la ΤΑΚΚ per ogni notte. In questa situazione la schermata Oggi mostra un avviso per le strutture greche.

Una licenza disattivata o rimborsata perde subito le funzioni Pro, senza periodo di tolleranza.

Se per un po’ il tuo server non riesce a raggiungere jetbookin.com (un’interruzione, un firewall), non cambia nulla: l’ultima licenza confermata resta valida per 45 giorni. Solo dopo lo stato diventa Non verificabile da molto tempo e le funzioni Pro si sospendono finché il sito non riesce di nuovo a fare la verifica.

Aggiornamenti

• Gli aggiornamenti arrivano in WordPress come per qualsiasi altro plugin: Bacheca → Aggiornamenti o Plugin mostra la nuova versione e fai clic su Aggiorna ora (oppure attivi gli aggiornamenti automatici per JetBookIn).
• Arrivano da jetbookin.com e richiedono una licenza attiva e non scaduta. Con una licenza scaduta resti alla versione che hai; non ricevi le nuove.
• Le modifiche al database vengono eseguite da sole la prima volta che la nuova versione si carica. Non serve disattivare e riattivare il plugin.
• Prima di aggiornare un sito molto frequentato, leggi le novità nel changelog e aggiorna lontano dall’ora di punta dei check-out mattutini.

Siti locali e di staging

Una copia locale o di staging è un sito come un altro: il Core gratuito funziona lì senza chiave, mentre le funzioni Pro e gli add-on richiedono una licenza, qualunque sia l’indirizzo (localhost, .local, staging. e così via). Due modi per provare Pro su una copia:

• attiva la tua chiave sulla copia mentre fai le prove, poi premi Disattiva lì e attivala sul sito online – la licenza di un sito si può spostare tutte le volte che serve;
• usa un piano che copre più di un sito, così la copia e il sito online hanno la licenza nello stesso momento.

Suggerimento: quando copi un sito di staging sul dominio live, la licenza non si sposta automaticamente (è legata all’indirizzo). Apri Impostazioni → Licenza sul sito live e attiva lì la chiave.

Disattivazione e disinstallazione

• Disattivando il plugin si fermano le attività in background e i widget di prenotazione spariscono dalle pagine. Tutti i dati restano; riattivandolo torna tutto.
• Eliminando il plugin, prenotazioni, tariffe e calendari restano nel database, a meno che tu non abbia spuntato Impostazioni → Sistema → Disinstallazione → Elimina tutti i dati di JetBookIn (prenotazioni, tariffe, calendari) quando il plugin viene eliminato. È disattivata per impostazione predefinita. Spuntala solo quando vuoi davvero cancellare tutto, e prima esporta ciò che ti serve.

Prossimi passi

• Struttura, camere e unità: tutti i campi della struttura e delle tipologie di camera.
• Tariffe e disponibilità: piani tariffari, regole di cancellazione, la griglia, le stagioni e le promozioni.
• Pagamenti: Stripe, Viva Wallet, gateway delle banche greche, PayPal, bonifico bancario, acconti e rimborsi.
• Sincronizzazione dei calendari: Booking.com, Airbnb, Vrbo, Expedia e Google.
• Shortcode e widget: il motore di prenotazione nelle tue pagine.
• Prenotazioni e ospiti: prenotazioni, calendario delle camere e messaggi agli ospiti.
• E-mail, Report e strumenti, Impostazioni e funzioni avanzate.
• Grecia: ΤΑΚΚ, ΑΜΑ, dichiarazioni di soggiorno e myDATA.

Domande

Mi serve Elementor?

No. Ogni widget Elementor esiste anche come shortcode, che funziona nell’editor a blocchi e negli altri page builder.

Posso provare Pro prima di acquistarlo?

Sì: tutte le funzioni Pro sono attive nell’hotel demo su jetbookin.com, dove puoi prenotare, pagare con le carte di prova Stripe e dare un’occhiata alla dashboard. Sul tuo sito Pro richiede una licenza, anche su una copia locale o di staging (vedi Siti locali e di staging).

Ho eliminato per errore la pagina Conferma della prenotazione. E adesso?

Crea una nuova pagina con lo shortcode [jetbookin_confirmation] (o con il widget Conferma prenotazione / Gestisci prenotazione), pubblicala e inserisci il suo ID in Impostazioni → Generale → ID della pagina di conferma prenotazione. L’ID di una pagina lo trovi nella barra degli indirizzi mentre la modifichi (post=123).

Perché una nuova tipologia di camera non compare nei risultati di ricerca?

Non ha ancora prezzi, oppure la sua visibilità è Bozza. Aggiungi i prezzi in Calendario → Tariffe e disponibilità e controlla Visibilità nella scheda Dettagli della tipologia di camera.

Il mio receptionist può usare la dashboard senza essere amministratore?

Sì. Assegna al suo utente WordPress il ruolo Gestore prenotazioni. Potrà lavorare su prenotazioni, tariffe e struttura, ma non potrà modificare la licenza né le chiavi dei fornitori di pagamento.

Cosa succede alle prenotazioni se la licenza scade?

Niente. Prenotazioni, pagamenti, calendario e sincronizzazione dei calendari continuano a funzionare con Core. Si disattivano solo le funzioni Pro, 14 giorni dopo la scadenza, e tornano quando rinnovi.

Ho spostato il sito su un nuovo dominio e le funzioni Pro si sono fermate.

La licenza è legata all’indirizzo del sito. Apri Impostazioni → Licenza sul nuovo indirizzo e attiva di nuovo la chiave. Se il vecchio sito esiste ancora, disattivala prima lì, così non occupa uno dei tuoi posti disponibili.