Documentazione

Tutto quello che ti serve per installare, configurare e usare Kubook al meglio.

Guida installazione

Installa Kubook sul tuo sito WordPress in meno di 5 minuti.

  1. 1

    Scarica il plugin

    Accedi alla tua area account su kubook.it e scarica il file kubook.zip. Se non hai ancora un account, registrati gratuitamente per ottenere il piano Free.

  2. 2

    Carica su WordPress

    Vai su WordPress > Plugin > Aggiungi nuovo > Carica plugin. Seleziona il file kubook.zip appena scaricato e clicca "Installa ora".

  3. 3

    Attiva il plugin

    Dopo l'installazione, clicca "Attiva plugin". Vedrai la nuova voce "Kubook" nel menu laterale di WordPress.

  4. 4

    Inserisci la license key

    Vai su Kubook > Impostazioni > Licenza e inserisci la license key ricevuta via email. Per il piano Free la key viene generata automaticamente alla registrazione.

  5. 5

    Segui il wizard di configurazione

    Il wizard ti guida nei passaggi iniziali: informazioni attivita, creazione primo servizio, configurazione orari e inserimento widget nel sito. In 5 step il tuo sistema di prenotazione e pronto.

Requisiti di sistema

WordPress 6.0+, PHP 8.0+, MySQL 5.7+ o MariaDB 10.3+. Hosting condiviso o VPS. Compatibile con SiteGround, Aruba, Netsons, Register.it, OVH, Hetzner.

Guida configurazione

Configura ogni aspetto di Kubook dalle impostazioni. Panoramica tab per tab.

Nome attivita

Il nome che appare nell'header del widget e nelle email di conferma. Esempio: "Salone Stile & Taglio".

Fuso orario

Timezone della tua sede. Determina gli orari mostrati ai clienti nel widget. Default: Europe/Rome.

Lingua widget

Italiano di default. Supporta anche inglese, francese, tedesco e spagnolo. Cambia automaticamente se il sito e multilingua (WPML/Polylang).

Valuta

EUR di default. Supporta tutte le valute supportate da Stripe (USD, GBP, CHF, etc.).

Durata slot

Intervallo base per la griglia del calendario (15, 30 o 60 minuti). I servizi possono avere durate diverse.

Buffer tra appuntamenti

Minuti di pausa automatica tra un appuntamento e il successivo. Utile per preparare la postazione. Default: 10 min.

Prenotazione minima

Con quante ore di anticipo un cliente puo prenotare. Default: 2 ore. Evita prenotazioni last-minute.

Cancellazione

Tempo limite per la cancellazione gratuita da parte del cliente. Oltre il limite, l'acconto non viene rimborsato.

Widget, Shortcode & Gutenberg

Inserisci il widget in qualsiasi pagina o articolo.

Shortcode disponibili

[kubook]

Widget completo con tutti i servizi e operatori. Il modo piu semplice per iniziare.

[kubook service="taglio-uomo"]

Widget preselezionato su un servizio specifico (usa lo slug del servizio). Il cliente vede solo quel servizio.

[kubook staff="marco-rossi"]

Widget preselezionato su un operatore specifico. Utile per pagine personali dello staff.

[kubook category="capelli"]

Widget filtrato per categoria di servizi. Mostra solo i servizi della categoria specificata.

[kubook location="sede-milano"]

Widget filtrato per una sede specifica (piano Pro+). Utile per business multi-sede.

[kubook theme="dark"]

Widget in modalita dark. Rispetta anche prefers-color-scheme del browser se impostato su "auto".

Blocco Gutenberg: Nell'editor di WordPress, cerca “Kubook” tra i blocchi disponibili. Il blocco offre un'interfaccia visuale per configurare gli stessi parametri dello shortcode senza scrivere codice. Supporta anteprima live nell'editor.

CSS personalizzazione

Personalizza l'aspetto del widget sovrascrivendo le CSS custom properties nel tuo tema:

VariabileDefaultDescrizione
--kbw-primary#4C6EF5Colore primario del widget (header, bottoni, selezione)
--kbw-text#1a1a2eColore del testo principale
--kbw-bg#ffffffSfondo del widget
--kbw-border#e5e7ebColore dei bordi
--kbw-radius8pxBorder radius dei componenti interni
--kbw-fontinheritFont family (eredita dal tema di default)

REST API Reference

Namespace: kubook/v1. Auth: Application Passwords o cookie auth per endpoint admin.

GET/kubook/v1/servicesNessuna

Lista tutti i servizi attivi con durata, prezzo e categorie.

Esempio response

{ "data": [{ "id": 1, "name": "Taglio uomo", "duration": 30, "price": 15.00, "category": "capelli" }] }
GET/kubook/v1/staffNessuna

Lista tutti gli operatori con profilo e servizi associati.

Esempio response

{ "data": [{ "id": 1, "name": "Marco Rossi", "services": [1, 2, 3] }] }
GET/kubook/v1/availabilityNessuna

Slot disponibili. Query params: service_id, staff_id, date (YYYY-MM-DD).

Esempio response

{ "date": "2026-03-20", "slots": ["09:00", "09:30", "10:00", ...] }
POST/kubook/v1/appointmentsNonce/Cookie

Crea una nuova prenotazione. Body: service_id, staff_id, date, time, customer (name, email, phone).

Esempio response

{ "id": 42, "status": "confirmed", "payment_url": "https://..." }
GET/kubook/v1/appointments/{id}Token/Cookie

Dettaglio di una prenotazione specifica.

Esempio response

{ "id": 42, "service": "Taglio uomo", "staff": "Marco Rossi", "date": "2026-03-20", "time": "10:00", "status": "confirmed" }
PATCH/kubook/v1/appointments/{id}Admin

Aggiorna lo stato: confirmed, cancelled, no-show, completed.

Esempio response

{ "id": 42, "status": "cancelled" }
DELETE/kubook/v1/appointments/{id}Admin

Cancella una prenotazione. Se abilitato, attiva il rimborso Stripe.

Esempio response

{ "deleted": true, "refund_status": "succeeded" }
GET/kubook/v1/locationsNessuna

Lista le sedi configurate con indirizzo e coordinate.

Esempio response

{ "data": [{ "id": 1, "name": "Sede Milano", "address": "Via Roma 1" }] }
GET/kubook/v1/settingsAdmin

Impostazioni pubbliche del plugin.

Esempio response

{ "business_name": "Salone Stile", "timezone": "Europe/Rome", "currency": "EUR" }
GET/kubook/v1/analyticsAdmin

KPI per un periodo. Query params: from, to.

Esempio response

{ "bookings": 127, "revenue": 3420.50, "no_show_rate": 0.042 }

FAQ

Quali versioni di WordPress sono supportate?

Kubook richiede WordPress 6.0+ e PHP 8.0+. Consigliamo l'ultima versione stabile. Testato con WordPress 6.9.4 e PHP 8.3.

Il plugin rallenta il mio sito?

No. Il widget JS viene caricato solo nelle pagine con lo shortcode [kubook] o il blocco Gutenberg (caricamento condizionale). Il bundle pesa < 50KB gzipped. Le altre pagine non subiscono alcun impatto.

Posso usare Kubook con qualsiasi tema WordPress?

Si. Il CSS e scoped sotto .kubook-widget, nessun conflitto con il tema. Supporta custom properties (--kbw-*) per personalizzare colori, font e bordi senza toccare il CSS del tema.

Come funziona il backup dei dati?

I dati risiedono nelle tabelle del tuo database WordPress (prefisso kb_). Vengono inclusi automaticamente nel backup del sito. Nessun dato transita verso server esterni, tranne la verifica della license key.

Posso usare il plugin su piu siti?

Dipende dal piano. Free e Starter: 1 dominio. Pro: fino a 3. Agency: illimitati. Gestisci le licenze dalla tua area account su kubook.it.

Come funziona la sincronizzazione Google Calendar?

Ogni operatore collega il proprio Google Calendar via OAuth2. Le prenotazioni Kubook creano eventi su GCal. Gli eventi esistenti su GCal bloccano gli slot. Sync ogni 5 min via WP Cron.

Il plugin e GDPR compliant?

Si. Include: checkbox consenso obbligatorio, data retention configurabile (default 24 mesi), diritto alla cancellazione con tool admin, export dati in JSON. Tutti i dati restano nel tuo database WordPress.

Come funziona Stripe Connect?

Colleghi il tuo Stripe in un click via OAuth. Il denaro va direttamente nel tuo conto. Piano Free: 2% application fee. Piani a pagamento: 0% da Kubook (restano le fee Stripe standard).

Posso personalizzare le email?

Si. L'admin include un editor visuale per i template. Inserisci logo, cambia colori, modifica testo, aggiungi campi dinamici ({client_name}, {service}, {date}, {manage_link}).

Come creo una prenotazione manuale?

Dashboard admin > Kubook > Calendario > click su slot vuoto. Compila servizio, operatore, dati cliente e conferma. Il cliente riceve conferma via email.

Esiste un limite alle prenotazioni?

Free: 50/mese, Starter: 500/mese, Pro e Agency: illimitate. Ricevi notifica all'80% del limite. Superato il 100%, nuove prenotazioni in coda fino al mese successivo o upgrade.

Posso migrare da un altro sistema?

Al momento non c'e un importatore automatico. Il team puo aiutarti con migrazione assistita per piani Agency/Enterprise. Contatta il supporto.

Il widget funziona su mobile?

Si, e 100% responsive da 320px. Touch-friendly con pulsanti grandi e scroll fluido. Il 70% delle prenotazioni dei nostri utenti avviene da smartphone.

Posso usare Kubook senza pagamenti online?

Assolutamente. La modalita pagamento puo essere impostata su "Nessuno". Il cliente prenota e paga in sede. Stripe non e obbligatorio.

Come funzionano i no-show?

Dalla dashboard puoi segnare un appuntamento come no-show. Le analytics tracciano il tasso di no-show per periodo. I reminder automatici (email, SMS, WhatsApp) riducono i no-show fino all'80%.

Video Tutorial

Non trovi quello che cerchi?

Il nostro team di supporto e a tua disposizione per qualsiasi domanda tecnica.

Contattaci