v1.1.1 PRO Edizione Completa

Restaurant Table Bookings PRO

La suite completa per la prenotazione dei tavoli, la gestione della sala e il POS per l'accoglienza su WordPress. Progettata per locali ad alto flusso, bar e bistrot.

1. Panoramica e Architettura

Restaurant Table Bookings PRO unisce la solida base della versione core gratuita a una suite di strumenti professionali per la gestione della sala, progettati specificamente per le operazioni di ristorazione.

Funziona come un componente aggiuntivo leggero e ad alte prestazioni per levelnetwork-restaurant-table-bookings. Tutte le tabelle di database personalizzate (wp_pub_reservations, wp_pub_clients, wp_pub_tables) e le opzioni del plugin sono condivise al 100%, garantendo zero perdita di dati durante aggiornamenti, passaggi di versione o gestione di copie di staging.

Cosa aggiunge la versione PRO al tuo ristorante

  • Terminale POS a Schermo Intero Ottimizzato per il Touch: Progettato per tablet da ricevimento (iPad, Android) e totem desktop in sala, dotato di orologio digitale in tempo reale e intestazioni bloccate (sticky headers).
  • Selettore Tema Chiaro / Scuro OLED: Passaggio con un solo tocco tra un tema diurno ad alto contraste e un tema OLED scuro, ideale per risparmiare batteria e riposare gli occhi.
  • Occupazione della Sala in Tempo Reale e Mappa Interattiva: Barra di riepilogo KPI in tempo reale e schede dei tavoli con codice colore che riflettono la disponibilità dei posti a sedere dal vivo.
  • Motore di Automazione per l'Approvazione Intelligente: Conferma automaticamente i clienti abituali e affidabili in base alle visite completate in passato e ai punteggi di affidabilità.
  • Ruoli Multi-Staff: Ruoli dedicati restopub_manager, restopub_staff e restopub_viewer con mappature dettagliate delle capacità.
  • Backup e Ripristino JSON in 1 Click: Esporta e importa layout dei tavoli, profili CRM dei clienti e storico delle prenotazioni.
  • Aggiornamenti Automatici e Gestione Licenze: Aggiornamenti in 1 click direttamente dalla dashboard tramite GitHub Releases e licenze Lemon Squeezy.

2. Ruoli e Permessi Granulari PRO

La versione PRO registra tre ruoli WordPress dedicati e quattro capacità granulari, consentendo di configurare accessi tramite tablet per il personale di sala senza concedere l'accesso a menu di amministrazione WordPress non correlati:

Nome Ruolo Capacità Assegnate Ambito di Accesso
Restaurant Manager
restopub_manager
view_restopub_reservations
create_restopub_reservations
manage_restopub_tables
manage_restopub_settings
Controllo operativo e di configurazione completo. Può gestire prenotazioni, planimetrie della sala, profili dei clienti, orari dei turni e modelli di email.
Restaurant Staff / Hostess
restopub_staff
view_restopub_reservations
create_restopub_reservations
manage_restopub_tables
Accesso alla sala e all'accoglienza. Può utilizzare il Terminale POS dello staff, effettuare il check-in degli ospiti, assegnare tavoli e registrare clienti senza prenotazione (walk-in). Non può modificare le impostazioni globali del plugin.
Restaurant Viewer
restopub_viewer
view_restopub_reservations Monitoraggio di sola lettura. Ideale per monitor da cucina o coordinatori di sala che hanno la necessità di controllare il numero dei coperti e la rotazione dei tavoli.
ℹ️

Compatibilità con Amministratori ed Editori

Gli Amministratori e gli Editori standard di WordPress ereditano automaticamente i diritti di gestione completi, in modo che i flussi di lavoro esistenti non subiscano alcuna interruzione.

3. Terminale POS per lo Staff (Backend e Frontend) PRO

Il Terminale POS per lo Staff offre un ambiente touch-friendly e privo di distrazioni per hostess e responsabili di sala, pensato per orchestrare l'assegnazione dei tavoli durante i momenti di maggiore affluenza:

Come distribuire il terminale

  • All'interno di WP-Admin: Vai su Restaurant Bookings → Staff Terminal (`admin.php?page=levelnetwork-restaurant-table-bookings-terminal`) oppure accedivi direttamente dalla Dashboard delle Prenotazioni (vista predefinita quando la versione PRO è attiva).
  • Su Tablet nel Frontend: Crea una pagina privata o protetta da password (es. /terminal/) e inserisci lo shortcode:
    [restopub_staff_terminal]

Funzionalità Chiave del Terminale

Funzionalità Descrizione Operativa
Orologio Digitale e Data in Tempo Reale Un orologio digitale localizzato in tempo reale nella barra superiore permette alle hostess di monitorare con precisione i tempi di tolleranza delle prenotazioni e i prossimi turni.
Interruttore di Tema (Chiaro/Scuro) Passaggio immediato tra un tema chiaro pulito e un tema OLED scuro ad alto contrasto. Salvato per singolo dispositivo nella memoria locale del browser (localStorage).
Stati Touch in un Click Pulsanti grandi e reattivi per contrassegnare gli ospiti come Checked In (Registrati), Seated (Al tavolo), Completed (Completato) o No-Show (Non presentato) senza ricaricare la pagina.
Chiamate Telefoniche Dirette ed Email I numeri di telefono dei clienti includono link cliccabili di tipo tel: con icone dedicate per chiamate istantanee da tablet o softphone VoIP.
Indicatore di Affidabilità del Cliente Badge visivi immediati (Verde, Giallo, Rosso) mostrati accanto a ciascun cliente per evidenziare i clienti VIP abituali e identificare prenotazioni a rischio.
Intestazioni Fisse e Scorrimento Virtuale La griglia dei tavoli mantiene le intestazioni di colonna bloccate durante lo scorrimento verticale, impedendo allo staff di perdere il contesto nei momenti di servizio intenso.

4. Occupazione della Sala in Tempo Reale e Mappa Interattiva PRO

Situato immediatamente sotto i controlli di stato sul terminale POS e nella scheda della dashboard Live Occupancy & Table Cards:

Barra KPI in Tempo Reale

  • Total Bookings (Prenotazioni Totali): Numero complessivo di tavoli programmati per la data e il turno attivi.
  • Seated Guests (Ospiti al Tavolo): Conteggio in tempo reale delle persone attualmente sedute in sala.
  • Available Tables (Tavoli Disponibili): Numero di tavoli fisici attualmente liberi.
  • Occupancy Rate (%) (Tasso di Occupazione): Percentuale della capacità della sala attualmente impegnata.

Schede di Stato Interattive dei Tavoli

Ogni tavolo fisico è rappresentato come una scheda di stato interattiva con codice colore:

  • Disponibile Il tavolo è pulito e pronto per accogliere immediatamente clienti senza prenotazione.
  • Riservato Il tavolo è assegnato a un gruppo in arrivo durante il turno corrente.
  • Occupato Un gruppo è attualmente seduto al tavolo.

Fai clic su qualsiasi scheda per visualizzare i dettagli del gruppo, modificare l'assegnazione del tavolo o liberarlo per il turno successivo.

5. Dashboard delle Prenotazioni e Modalità di Visualizzazione Duplice

Alla voce Restaurant Bookings → Reservations (`admin.php?page=ln-restopub-dashboard&tab=reservations`), la versione PRO offre due modalità di visualizzazione:

  • Vista POS (Predefinita nel PRO): L'interfaccia ottimizzata per il touch che include la barra di occupazione in tempo reale, l'orologio e le azioni rapide in un click.
  • Vista Classica: Una griglia tabellare densa con selezione avanzata dell'intervallo di date, menu a tendina per i turni, ricerca e link di esportazione .ics. Include il salvataggio automatico istantaneo dello stato tramite AJAX con un badge verde "Salvato", un pulsante di salvataggio manuale dedicato, notifiche Toast mobili moderne e un menu a tendina per il filtro degli stati (Tutti, Confermati, In Attesa, Completati, Annullati, Non Presentati).
  • Banner di Attenzione in Tempo Reale e Badge nel Menu Laterale: Un badge con contatore in tempo reale nella barra laterale di amministrazione di WordPress (Restaurant Bookings [X]) e un banner prominente in cima alla tabella classica per avvisare il personale di sala delle richieste in attesa di revisione, con filtraggio in 1 click.

Il personale può passare agevolmente dalla Vista POS alla Vista Classica utilizzando i pulsanti di azione in alto.

6. Motore di Automazione per l'Approvazione Intelligente PRO

Smetti di perdere tempo a verificare manualmente ogni cliente abituale, proteggendo al contempo i tavoli dei weekend di punta contro i mancati arrivi (no-show).

Come funziona la Modalità Intelligente

Quando abilitato in Restaurant Bookings → Settings, il sistema esegue un controllo automatico in background sulle prenotazioni online in arrivo confrontandole con il profilo CRM del cliente:

  1. L'ospite inserisce i propri dati nel modulo di prenotazione nel frontend.
  2. Il sistema controlla lo storico del cliente in wp_pub_clients tramite indirizzo email e numero di telefono.
  3. Se l'ospite ha completato almeno smart_min_completed visite (es. 2 visite) e mantiene un punteggio di affidabilità ≥ smart_min_score (es. 80%), la sua prenotazione viene confermata automaticamente all'istante e viene inviato un invito .ics.
  4. I nuovi clienti o gli ospiti con precedenti mancate presentazioni vengono trattenuti nello stato In Attesa (Pending) per la revisione da parte dello staff.

7. CRM Clienti e Punteggio di Affidabilità

Ogni cliente viene tracciato all'interno della directory CRM (wp_pub_clients). La percentuale di affidabilità viene calcolata automaticamente:

Punteggio di Affidabilità (%) = (Prenotazioni Completate / Prenotazioni Totali) * 100

I badge compaiono in tutte le griglie e nelle schede del POS:

  • 80% - 100% Affidabile: Clienti abituali che onorano regolarmente le prenotazioni.
  • 50% - 79% Moderato / Attenzione: Cancellazioni occasionali.
  • 0% - 49% Rischio Elevato: Cancellazioni frequenti o precedenti mancate presentazioni.

I gestori possono cercare, modificare i conteggi delle visite o eliminare i record da Restaurant Bookings → Dashboard → Clients.

8. Gestione Tavoli e Layout della Sala

Gestisci le aree di ristorazione e le configurazioni dei singoli tavoli in Restaurant Bookings → Dashboard → Tables & Layout:

  • Aree di Ristorazione: Organizza i tavoli per zona (Sala Principale Interna, Terrazza, Patio, Bar).
  • Capacità: Imposta il numero minimo e massimo di posti a sedere. La procedura guidata di prenotazione abbina automaticamente le dimensioni del gruppo ai tavoli disponibili.
  • Interruttori di Attivazione: Abilita o disabilita i tavoli per eventi privati o riconfigurazioni della sala.

9. Backup e Ripristino JSON in 1 Click PRO

Proteggi i dati del tuo ristorante o sincronizza le impostazioni tra gli ambienti di staging e produzione in Restaurant Bookings → Settings → Data Maintenance:

  • Esporta Layout Tavoli: Genera un file JSON pulito contenente tutte le aree di ristorazione, i tavoli, le capacità e gli stati attivi.
  • Esporta CRM Clienti: Esegue il backup di tutti i profili dei clienti, dello storico delle visite e dei punteggi di affidabilità.
  • Esporta Storico Prenotazioni: Esporta interi archivi di prenotazione per scopi fiscali, contabili o di conformità alle normative.
  • Importa Backup JSON: Ripristina qualsiasi file JSON esportato con un controllo di importazione sanificato in un solo click.

10. Modulo di Prenotazione per il Cliente e Layout

Incorpora la procedura guidata di prenotazione in qualsiasi pagina utilizzando:

[ln_restaurant_booking_form]

Scegli direttamente nelle Impostazioni tra Schede Moderne (card elevate con intestazione grigio ardesia e accenti azzurro elettrico), Bistrot Classico (griglia a due colonne con tab a pillola segmentati e vivaci accenti ambra e oro), Modalità Scura Luxe (stile ultra-premium nero ossidiana OLED e oro liquido 24K) o Divisione Laterale (layout a due colonne con riepilogo della prenotazione sempre visibile).

Selettore di Prefisso Telefonico Internazionale: Gli ospiti possono scegliere tra oltre 40 prefissi internazionali con bandierine emoji. Il sistema rileva automaticamente il paese all'istante dal fuso orario e dalla lingua del browser, supportato da una ricerca IP asincrona.

Verifica degli Input in Tempo Reale: Valida la sintassi email RFC 5322 e i numeri di telefono ITU-T E.164 con badge di avviso in linea per garantire prenotazioni prive di errori.

Tag per Richieste Speciali: I tag per richieste speciali (⚠️ Allergia, 🌾 Senza Glutine, 🥕 Vegano, 👶 Seggiolone, 🎂 Compleanno) o tag personalizzati racchiusi tra parentesi quadre (es. [ VIP ]) vengono inviati direttamente al terminale POS e alla tabella delle prenotazioni per una visibilità immediata da parte della cucina e dell'accoglienza.

11. Riferimento Shortcode

Shortcode Pubblico di Riferimento Funzione
[ln_restaurant_booking_form]
alias: [ln_restaurant_booking], [restopub_booking_form]
Visitatori del Sito Pubblico Procedura guidata di prenotazione in più passaggi per i clienti, con calcolo degli slot dei turni in tempo reale, selettore di prefisso telefonico e sincronizzazione immediata del calendario .ics.
[ln_restaurant_cancel_booking]
alias: [restopub_cancel_booking]
Ospiti con Prenotazione Renderer del template interno per l'auto-cancellazione da parte degli ospiti. Verifica i token di sicurezza crittografici HMAC passati dai link dell'email di conferma ({cancel_booking_link}), mostra il riepilogo della prenotazione e rilascia immediatamente i tavoli. (Nota: Gestito al 100% automaticamente tramite i link nelle email; non richiede la creazione manuale di alcuna pagina).
[restopub_staff_terminal]
alias: [ln_restaurant_staff_terminal]
Personale di Sala, Hostess, Camerieri Terminale POS a schermo intero ottimizzato per il touch, dotato di orologio in tempo reale, selettore tema Chiaro/Scuro OLED e barra di occupazione della sala dal vivo.

12. Configurazione e Impostazioni

Il comportamento globale del plugin viene configurato alla voce Restaurant Bookings → Settings:

  • Modalità di Approvazione e Soglie Intelligenti PRO: Seleziona la modalità Smart per sbloccare la soglia minima di prenotazioni completate (smart_min_completed) e la soglia del punteggio di affidabilità (smart_min_score). Quando la versione PRO è attiva, i clienti abituali e affidabili vengono approvati automaticamente in autonomia.
  • Email di Notifica per lo Staff del Ristorante: Imposta uno o più indirizzi email separati da virgola ai quali il personale riceve notifiche di avviso istantanee per ogni nuova prenotazione online e cancellazione da parte degli ospiti.
  • Avviso Urgente allo Staff per Prenotazioni in Sospeso: Quando una prenotazione online arriva nello stato di "In Attesa" (Pending), l'oggetto dell'email dello staff evidenzia automaticamente [ACTION REQUIRED - Pending Approval] con un pulsante di call-to-action diretto che rimanda direttamente alla dashboard di amministrazione per esaminare e confermare o annullare la richiesta.
  • Modello di Avviso Staff Personalizzabile: Personalizzazione completa degli oggetti e del corpo dei messaggi per le notifiche allo staff sulle prenotazioni online in arrivo tramite tag dinamici ({booking_code}, {client_name}, {client_phone}, {table_name}, {admin_booking_url}, ecc.).
  • Email per Prenotazione in Sospeso (Avviso Cliente): Notifica dedicata inviata agli ospiti quando la loro prenotazione viene inserita nello stato di Approvazione in Sospeso, spiegando il processo di revisione senza inviare una conferma prematura o un invito .ics. Oggetto e corpo interamente personalizzabili nelle Impostazioni.
  • Invio Automatico di Conferma e .ics: Nel momento in cui lo staff modifica una prenotazione in sospeso impostandola su Confermata nella tabella di amministrazione o nel modale di modifica, viene generata e inviata automaticamente al cliente l'email di conferma ufficiale con l'invito di calendario .ics allegato.
  • Finestre di Pranzo e Cena: Configura gli orari di apertura e chiusura dei turni. Lascia vuoto per disabilitare un turno.
  • Intervallo degli Slot: 15, 30 o 60 minuti.
  • Durata della Prenotazione: Tempo di permanenza al tavolo in minuti (predefinito: 90 min).
  • Giorni di Chiusura e Vacanze: Blocca le prenotazioni online nei giorni di chiusura settimanale o nei periodi di vacanza programmati del locale.
  • Eleganti Modelli di Email in HTML e Caricamento in 1 Click: Carica all'istante modelli di email HTML reattivi e progettati professionalmente, dotati di accenti di lusso, intestazioni brandizzate, riquadri di prenotazione chiari e pulsanti di call-to-action. Include un modale di anteprima dal vivo e un pulsante immediato Annulla / Ripristina Precedente che consente di tornare ai template personalizzati ogni volta che lo si desidera.
  • Email Transazionali e Formattazione HTML Ricca: Personalizza i modelli di Conferma, Sospeso, Modifica, Cancellazione e Avviso Staff con segnaposto dinamici ({booking_code}, {client_name}, {booking_date}, {booking_time}, {table_location}, {ics_download_link}, {cancel_booking_link}, {cancel_booking_url}, {late_arrival_notice}). Tutti i corpi dei template supportano pienamente tag HTML personalizzati (<strong>, <a>, <img>, <span style="...">, pulsanti, stili) con bilanciamento automatico dei tag.
  • Migliori Pratiche per la Consegna delle Email: WordPress si affida a wp_mail() (funzione mail/sendmail di PHP), la quale risulta inattiva o non configurata nello sviluppo locale (Local, Docker, MAMP) e in molti ambienti di hosting condiviso. Per garantire una consegna affidabile in produzione, configura un servizio SMTP utilizzando un plugin come WP Mail SMTP, FluentSMTP o Brevo.
  • Caricamento Dati di Demo: Pre-popola i dati di test su una nuova installazione.
  • Elimina Tutti i Dati alla Disinstallazione: Cancella in sicurezza tabelle e impostazioni personalizzate al momento dell'eliminazione del plugin, se abilitato.

13. Gestione Licenze e Aggiornamenti Automatici PRO

Gestisci la tua licenza PRO direttamente nella scheda dedicata Restaurant Table Bookings PRO Licence posizionata nella barra laterale di Restaurant Bookings → Settings:

  • Integrazione Lemon Squeezy: Inserisci la chiave di licenza e fai clic su Validate Licence per sbloccare istantaneamente tutte le funzionalità PRO. La verifica dell'ID prodotto viene eseguita direttamente dal codice e tramite le API di Lemon Squeezy (senza alcuna necessità per i clienti di inserire manualmente un ID prodotto).
  • Azioni sulla Licenza: Fai clic su Sync Status per riverificare lo stato con Lemon Squeezy, oppure su Unlink Licence per rilasciare lo slot di attivazione e riutilizzarlo su un altro dominio.
  • Disattivazione Automatica alla Disinstallazione: Quando il plugin PRO viene eliminato tramite l'amministrazione di WordPress (Plugin → Elimina), richiama automaticamente l'endpoint /v1/licenses/deactivate di Lemon Squeezy, rilasciando immediatamente lo slot di attivazione sui server centrali.
  • Bypass per Localhost e Staging: Lo sviluppo in locale su domini localhost, 127.0.0.1 o .local è automaticamente consentito senza consumare attivazioni di licenza attive. Sui server di staging remoti, è inoltre possibile definire define('LN_RESTOPUB_PRO_DEV_MODE', true); all'interno del file wp-config.php.
  • Aggiornamenti in 1 Click: Una volta attivato, le nuove versioni vengono distribuite senza interruzioni tramite i normali aggiornamenti di WordPress (tramite rilasci privati su GitHub e verifica della licenza Lemon Squeezy).

14. FAQ e Risoluzione Problemi

D: Il personale di sala può accedere al terminale POS senza privilegi amministrativi?

R: Sì! Assegna il ruolo di Personale del Ristorante (restopub_staff) al loro account WordPress. Potranno così gestire il terminale, effettuare il check-in degli ospiti e registrare le prenotazioni senza avere accesso alle impostazioni del sito, ai plugin o ai temi.

D: Come posso abilitare il tema OLED scuro sul tablet dell'hostess?

R: Sul terminale POS, tocca il pulsante per il cambio del tema (☀️ / 🌙) nella barra delle azioni in alto. La modalità scura è ottimizzata per ambienti con scarsa illuminazione (come bar e sale da pranzo serali) e viene salvata su quel tablet specifico.

D: L'esportazione del calendario .ics funziona sui dispositivi mobili?

R: Sì. Il flusso del calendario è conforme agli standard RFC 5545. Toccando il link su iOS o Android, l'utente viene invitato direttamente ad aggiungere la prenotazione ad Apple Calendar o Google Calendar.

D: Cosa succede se la versione PRO viene disattivata?

R: Il plugin gratuito di base continua a funzionare normalmente. Tutte le prenotazioni, gli storici CRM dei clienti e i tavoli rimangono integri al 100%. Riattivando la versione PRO in qualsiasi momento verranno ripristinate all'istante tutte le funzionalità premium.

D: Qual è lo scopo del ruolo Restaurant Viewer (restopub_viewer)?

R: Il ruolo di Visualizzatore è progettato per il monitoraggio di sola lettura (possedendo esclusivamente la capacità view_restopub_reservations). È ideale per schermi di visualizzazione in cucina o per i coordinatori di sala che hanno la necessità di monitorare in tempo reale il numero dei coperti, i prossimi orari di arrivo, le note sulle diete e l'occupazione della sala, senza alcuna possibilità di modificare, eliminare o riassegnare per errore tavoli e prenotazioni.

D: Come funzionano le cancellazioni fai-da-te da parte degli ospiti e gli avvisi via email?

R: Ogni email di conferma al cliente contiene un link sicuro per l'auto-cancellazione ({cancel_booking_link}). Quando viene fatto clic su di esso, la prenotazione viene verificata tramite un token di sicurezza crittografato HMAC e annullata, il tavolo assegnato viene immediatamente rilasciato e reso nuovamente disponibile, il punteggio di affidabilità CRM del cliente viene aggiornato e viene inviato un avviso immediato alla casella di posta delle notifiche del ristorante.

D: È necessario creare manualmente una pagina di cancellazione con [restopub_cancel_booking]?

R: No, assolutamente no. L'auto-cancellazione da parte del cliente è gestita al 100% in modo automatico e sicuro tramite email. Il link generato da {cancel_booking_link} contiene un token crittografato univoco associato a quella specifica prenotazione. Se un visitatore apre direttamente una pagina autonoma contenente [restopub_cancel_booking] (senza fare clic su un link autentico ricevuto via email), il sistema mostra intenzionalmente un avviso di sicurezza con la dicitura "Link di Cancellazione Non Valido". Questo impedisce a terze parti malintenzionate di tentare di indovinare i codici di prenotazione e cancellare il tavolo di qualcun altro.

D: Come posso nascondere il conteggio esatto dei tavoli rimanenti o la capacità dei posti dal modulo di prenotazione pubblico?

R: In Restaurant Bookings → Settings → Operating Hours & Capacity Rules, configura l'impostazione Public Availability Display. Per impostazione predefinita, è impostata su Discreto / Semplificato (mostrando avvisi chiari come "Tavoli disponibili per la prenotazione" e "Tavolo disponibile per il tuo gruppo" senza rivelare i numeri esatti della capacità). Puoi anche scegliere Nascondi Capacità Posti (mostra solo il conteggio dei tavoli) o Dettagliato (mostra sia il conteggio dei tavoli che la capacità residua dei posti).

D: Perché le email non raggiungono le caselle di posta durante la fase di test?

R: Per impostazione predefinita, la funzione wp_mail() di WordPress si affida all'utilità locale PHP mail() del server, la quale non è attiva o configurata nell'ambiente di sviluppo locale (Local, Docker, MAMP) e in molti ambienti di hosting condiviso. Per garantire una consegna affidabile in produzione, installa un plugin SMTP autenticato come WP Mail SMTP, FluentSMTP o Brevo.