Guida all'installazione
Aggiungi Harku a qualsiasi sito in meno di un minuto — un tag script, nessun build step.
1. Crea un progetto
Registrati su Harku e crea un progetto per il sito su cui vuoi raccogliere feedback. Ogni progetto ottiene la propria chiave pubblica — un identificatore sicuro e pubblico che inserirai nello snippet.
2. Copia il tuo snippet
Nella pagina del tuo progetto, copia lo snippet di installazione — la tua chiave pubblica è già compilata per te:
<script async src="https://cdn.harku.app/loader.js" data-harku-key="YOUR_PUBLIC_KEY"></script>3. Incollalo nel tuo sito
Incolla lo snippet appena prima del tag di chiusura </body>, su ogni pagina dove vuoi il pulsante Feedback. Nessun build step, nessun SDK, nessuna dipendenza — il loader è minuscolo e si carica in modo asincrono, quindi non blocca mai la tua pagina.
Il widget completo si carica — in un iframe isolato — solo quando un visitatore lo apre effettivamente, così rimane leggero sul tuo thread principale.
Opzioni dello snippet
Lo snippet accetta alcuni attributi:
data-harku-key— obbligatorio. La chiave pubblica del tuo progetto.data-harku-theme— opzionale.lightodarkper il primo rendering; la tua impostazione del dashboard prende il controllo una volta caricata la config.data-harku-api— avanzato. Sovrascrive l'URL base dell'API (per sviluppo o self-hosting).
Personalizzalo dal dashboard
Non devi mai più toccare lo snippet per ridisegnare il widget. Dalle impostazioni di aspetto del tuo progetto puoi cambiare:
- Colore principale — il pulsante Feedback e i punti salienti.
- Posizione — in basso a destra o in basso a sinistra.
- Tema — chiaro o scuro.
Il widget rilegge queste impostazioni ad ogni caricamento, quindi le modifiche appaiono la prossima volta che un visitatore aggiorna la pagina — nessun redeploy necessario.