57. Configurare il tablet kiosk

Ti serve quando hai comprato il tablet e vuoi prepararlo per tenerlo acceso 12 ore al giorno bloccato sul tuo sito clienti.

Hardware consigliato

Tablet 10 pollici minimo (8 pollici e’ troppo piccolo per il menu griglia).
Sistema operativo Android o iPadOS indifferentemente.
Connessione WiFi stabile della pizzeria (non hotspot del telefono — se cade la linea cade tutto).
Supporto a muro o piedistallo con cavo di alimentazione fisso (il tablet deve restare sempre carico).

1. Apri il sito in modalita’ kiosk

Sul tablet, apri il browser (Chrome o Safari) e digita:

https://ordina.IL-TUO-DOMINIO.it/IL-TUO-SLUG?mode=kiosk

Esempio per Peperoncino:

https://ordina.peperoncinopizzeria.it/peperoncino?mode=kiosk

Il parametro ?mode=kiosk e’ la chiave: appena apri questa URL, il sistema:

Salva una flag in localStorage del browser (“ricordati che sono kiosk”)
Rimuove il ?mode=kiosk dall’indirizzo (URL pulita)
Mostra la schermata di benvenuto “Tocca per iniziare”
Attiva il timer di inattivita’ (auto-reset dopo 2 minuti senza tocchi)

Da questo momento in poi, anche se chiudi e riapri Chrome, il sito ricordera’ di essere in modalita’ kiosk finche’ non cancelli i dati del browser.

2. Aggiungi alla schermata Home (PWA)

Sui tablet moderni puoi installare il sito come app:

Chrome/Android: menu (…) -> “Aggiungi a schermata Home” o “Installa app”
Safari/iPad: pulsante condivisione -> “Aggiungi alla schermata Home”

L’icona compare sul desktop come una vera app. Aprendola da li’ parte gia’ a schermo intero, senza barra di Chrome o Safari.

3. Blocca il tablet sul sito (kiosk mode di sistema)

Questo passaggio e’ fuori da Peppe — lo fai a livello sistema operativo del tablet:

Android: Impostazioni -> Sicurezza -> “Blocco schermo” o app dedicate (Fully Kiosk Browser, Scalefusion).
iPad: Impostazioni -> Accessibilita’ -> “Accesso guidato” -> tocca 3 volte il tasto Home/Power per attivare lock sull’app aperta.

Senza questo passaggio, il cliente puo’ uscire dal browser e aprire Instagram. Con questo passaggio, il tablet e’ inchiodato al tuo sito.

4. Disabilita le notifiche di sistema

Sul tablet, disattiva tutte le notifiche (WhatsApp, email, push del sistema). Una notifica popup nel mezzo dell’ordine e’ l’incubo del kiosk — il cliente la tocca, esce dal sito.

5. Imposta la luminosita’ al massimo e auto-rotazione bloccata

Il tablet sta su un piedistallo, deve essere leggibile in pieno giorno. Luminosita’ al 80-100% sempre. Rotazione bloccata in verticale o orizzontale secondo come hai montato il supporto.

Account staff dedicato? No, non serve

Il kiosk non richiede login admin ne’ un account staff dedicato: e’ un’interfaccia cliente, non amministrativa. Il cliente che usa il kiosk ordina come ospite, esattamente come se aprisse il sito sul suo telefono.

Schermo bloccato in kiosk mode? Si’, a 2 livelli

Lato app Peppe: la flag isKiosk (vedi lib/kiosk-context.tsx) nasconde i bottoni “esci”, “logout”, modifica modalita’ ordine. Il cliente vede solo cio’ che serve per ordinare.
Lato sistema operativo: il blocco vero e proprio (non uscire dal browser) lo fai con kiosk mode Android/iPad — vedi step 3.

Forzare kiosk per un’intera installazione

Se vuoi che tutti i tablet della pizzeria partano gia’ in kiosk senza dover digitare ?mode=kiosk, il referente tecnico puo’ impostare la variabile d’ambiente:

NEXT_PUBLIC_MODE=kiosk

In questo caso ogni device che apre il sito e’ kiosk per default. Utile se hai 5 tablet identici e non vuoi configurarli uno per uno.

Suggerimento: prima di mettere il tablet in produzione, fai un giro completo di prova: apri il kiosk, fai un finto ordine dall’inizio alla fine, paga in cassa, verifica che l’ordine arrivi in /admin/orders e in cucina (KDS). Solo cosi’ scopri eventuali problemi prima del primo cliente vero.

Attenzione: se cambi la connessione WiFi o cancelli i dati del browser, la flag kiosk in localStorage viene persa e il tablet torna alla modalita’ normale (con bottoni esci visibili). In quel caso, riapri l’URL con ?mode=kiosk e ricarica.