Documentazione tecnica · v2

Il widget OraDove.
Due righe di codice.

Un file JavaScript, un div, zero dipendenze. Il widget si installa in cinque minuti e vive dentro un riquadro isolato: non tocca nulla del sito che lo ospita, e nulla del sito può toccare lui.

Iframe first-party Conteggio infalsificabile Filtro date stagionale GDPR compliant Zero dipendenze Blockchain Algorand

Due widget, dichiarati

Quello che provi oggi nella demo è il widget dimostrativo: si adatta da sé ai colori del sito che lo ospita e simula l'esperienza completa. Questa pagina documenta il contratto definitivo di integrazione, già scritto nel codice della piattaforma: si accende col go-live, e chi integra oggi la demo passerà al contratto definitivo cambiando due attributi.

Snippet base

Tutto quello che serve per installare il widget. Due blocchi: un div dove vuoi il widget, uno script prima di </body>.

Snippet completo
<!-- 1. Dove vuoi il widget -->
<div id="oradove-widget" data-token="il-tuo-token"></div>

<!-- 2. Prima di </body> -->
<script src="https://oradove.com/oradove-widget.js" defer></script>

defer: lo script si carica dopo che la pagina è visibile. Il sito dell'hotel non aspetta OraDove.

Parametri del div

Attributo Tipo Descrizione
data-token Obbligatorio Il token del Tesoriere, consegnato alla registrazione. È un selettore pubblico: dice al widget quale catalogo mostrare, e non contiene segreti.
data-lang Opzionale Forza la lingua dell'interfaccia. Se assente, la lingua la sceglie il Tesoriere dal proprio pannello.

Nessuna configurazione di colori o font a carico dell'hotel: il tema del widget arriva dal pannello del Tesoriere (sotto). Gli attributi data-hotel-id e data-hotel-name appartengono al solo widget dimostrativo della demo.

Iframe first-party: isolamento e conteggio

Il widget vive dentro un iframe servito da OraDove. Non è un dettaglio tecnico: è la scelta che rende vere due promesse insieme.

Nessuna interferenza, per costruzione

I CSS del widget non escono mai dal widget, e i CSS del sito non entrano mai nel widget. Non per convenzione: per costruzione. Nomi di classi come .button o .card non creano mai conflitti.

Conteggio infalsificabile

Le azioni degli ospiti si contano dentro il documento OraDove, non nel sito che lo ospita: nessun host può gonfiare i numeri da cui nascono le distribuzioni. È la stessa promessa di tutta la piattaforma: il sistema non può mentire.

L'ospite resta sull'hotel

Il dettaglio si apre come velo sopra la pagina: l'indirizzo non cambia, la sessione resta sul sito dell'hotel, il tasto ESC chiude.

Zero dipendenze

Il loader è un solo file JavaScript senza librerie. Si carica con defer e non rallenta la pagina che lo ospita.

Il tema lo sceglie il Tesoriere

Il widget definitivo veste i colori di OraDove con un colore d'accento scelto dal Tesoriere nel proprio pannello: l'hotel non configura nulla nel codice. Il rilevamento automatico dei colori del sito che vedi nella demo è una funzione del widget dimostrativo: nel contratto definitivo l'identità visiva è governata da chi cura il catalogo, così ogni widget resta riconoscibile come OraDove.

Filtro date stagionale

Ogni contenuto del catalogo ha i mesi in cui è pertinente. Quando il turista inserisce le date del soggiorno, il widget mostra solo i contenuti rilevanti per quel periodo.

Se per le date selezionate non ci sono ancora contenuti prodotti dagli studenti, il widget lo dice con onestà:

"Per queste date non sono ancora disponibili contenuti creati dagli studenti delle scuole vicine. Chiedi all'albergatore maggiori informazioni."

Non è un errore: è il mondo reale. Il catalogo cresce man mano che gli studenti producono nuovi video.

Compensi e blockchain Algorand

Le regole di distribuzione sono pubbliche e fisse: su ogni acquisto collegato a un Frutto, la commissione si ripartisce così.

DestinatarioQuota
Studente creatore del contenuto50%
Scuola dello studente20%
Tesoriere (l'albergatore che ospita il widget)15%
OraDove, per l'infrastruttura e la certificazione15%

Nei Frutti derivati (contenuti che dichiarano i propri ispiratori) e nei lavori con co-autori, le quote aggiuntive vivono dentro la quota del creatore: le quote di scuola, Tesoriere e piattaforma non cambiano mai.

Trasparenza totale. Le distribuzioni saranno regolate in euro con l'avvio dei pagamenti reali. Ogni distribuzione è certificata su blockchain Algorand, oggi in fase pilota sulla rete di test (TestNet): chiunque può verificarla. Nulla è opaco.

Privacy e GDPR

Il widget è progettato con un principio esplicito: OraDove non ha mai accesso diretto ai clienti dell'hotel.

I dati restano all'hotel

Il form "Chiedi di più" è progettato per consegnare i dati del turista solo all'hotel: OraDove non li vede, non li conserva, non li elabora. Nella versione demo l'invio è simulato.

GDPR nel form

Il consenso privacy nel form cita esplicitamente il nome dell'hotel come titolare del trattamento, non OraDove.

Zero cookie di profilazione

Il widget non imposta cookie di profilazione, non traccia il comportamento dell'utente, non comunica con server di analytics terzi.

Dominio sempre dell'hotel

Il velo si apre sopra la pagina: l'indirizzo non cambia e la sessione resta sul sito dell'hotel.

Per le Web Agency

Se gestisci siti alberghieri, OraDove è un servizio che puoi offrire ai tuoi clienti senza modificare nulla di quello che hai già costruito.

L'installazione richiede due righe: una nel template, una nel footer. L'iframe garantisce zero conflitti con qualsiasi CSS esistente, e il tema arriva dal pannello del Tesoriere: nessuna manutenzione a tuo carico.

Ogni albergatore che adotta OraDove diventa un caso studio del territorio, e un cliente che torna.

Collaboriamo.

Se lavori con strutture ricettive nella Costa degli Etruschi o in qualsiasi altro territorio italiano, siamo interessati a costruire qualcosa insieme. OraDove ha bisogno di professionisti che conoscono i siti dei loro clienti meglio di chiunque altro.

Scrivici →