Riepilogo carrello
Il tuo carrello è vuoto
Prodotti nel carrello: 0
Totale prodotti: € 0,00
Riepilogo carrello
Il tuo carrello è vuoto
Prodotti nel carrello: 0
Totale prodotti: € 0,00
26/05/2025
In questa guida ti spieghiamo passo dopo passo come installare il widget di accessibilità LegalBlink, uno strumento essenziale per rendere il tuo sito web accessibile a tutti, inclusi gli utenti con disabilità visive, motorie o cognitive.Vedrai anche come personalizzarlo in base alle tue esigenze, scegliendo ad esempio dove posizionarlo nella pagina, così da integrarlo al meglio con il design del tuo sito.
⚠️ Attenzione: nessun widget, incluso quello di LegalBlink, può rendere un sito web completamente accessibile al 100%. Questo perché l’accessibilità richiede anche interventi manuali su sezioni del sito che nessun tool automatico è in grado di modificare.
Tuttavia, il nostro widget rappresenta un aiuto concreto: migliora la fruibilità regolando aspetti come il contrasto dei colori, la dimensione del testo, il focus, il cursore e altri elementi visivi fondamentali. Se poi vuoi una consulenza completa, i nostri avvocati e tecnici sono a tua disposizione con un pacchetto di accessibilità unico.
Vuoi avere una prima valutazione dello stato di accessibilità del tuo sito? 🔍
Prova il nostro tool gratuito e scopri subito cosa migliorare! 💡
👉 Fai il test di accessibilità di LegalBlink
🔍 Scopri quanto costa il servizio di accessibilità di LegalBlink e scopri tutti i vantaggi della nostra offerta!
Inoltre, anche se non sei obbligato per legge alla accessibilità digitale, è consigliabile installare il widget per offrire comunque una esperienza di navigazione più accessibile e inclusiva.
SOMMARIO
Cos'è il widget di accessibilità di LegalBlink
Come installare lo script del widget
1. apri il codice del tuo sito
2. trova il tag
3. inserisci lo script del widget
4. salva le modifiche
5. verifica il corretto funzionamento
Consigli per una installazione ottimale
Come personalizzare il widget di accessibilità
Dopo la configurazione il widget ma non si vede o non funziona sul sito
Errori java script nel sito
Hai bisogno di assistenza?
Il widget di LegalBlink è uno strumento progettato per rendere il tuo sito web più accessibile a tutti.
In particolare, aiuta le persone con disabilità o difficoltà di navigazione a consultare i contenuti in modo più semplice e intuitivo.
Grazie a una serie di funzionalità personalizzabili, il widget consente agli utenti di adattare l'aspetto e il comportamento del sito alle proprie esigenze visive, motorie o cognitive, favorendo così un’esperienza di navigazione più inclusiva.
Per attivare il widget LegalBlink, devi semplicemente aggiungere uno specifico script all’interno della sezione della home page. Segui questi pochi passaggi:
Accedi all’editor di testo o all’ambiente di sviluppo che utilizzi abitualmente per modificare il codice HTML del tuo sito web.
Vai alla sezione html della home page.
Nella versione html della home page individua la sezione alla fine del body.
Dopo aver inserito lo script, salva tutte le modifiche effettuate al codice HTML delle pagine.
Apri ora il tuo sito web nel browser. Se l’installazione è stata fatta correttamente, dovresti vedere subito un’icona che segnala la presenza del widget di accessibilità.
Assicurati di inserire lo script nella versione html della home page o comunque in ogni pagina del sito che vuoi rendere accessibile.
Se incontri difficoltà o non vedi il widget dopo l’installazione, verifica che lo script sia stato copiato correttamente e che non ci siano errori nel codice HTML.
Di seguito vediamo come personalizzare il tool di accessibilità in base alle tue esigenze.
La prima cosa da fare è inserire l’indirizzo URL completo del sito web sul quale desideri installare il widget di accessibilità (es. https://www.tuosito.it).
Tuttavia, se il widget non compare oppure si visualizza in modo errato, inserisci l’indirizzo in forma abbreviata, ad esempio tuosito.it, senza https:// e senza www.
Questa seconda opzione può dipendere da eventuali codici java script presenti sul sito o sistemi di blocco inseriti.
Puoi anche personalizzare i colori del widget, in tutte le sue parti, come mostrato nella figura sottostante.
Un’altra funzionalità utile è la possibilità di decidere dove posizionare il widget all’interno della pagina.
Puoi scegliere se mostrarlo in basso al centro, a sinistra o a destra. Questa opzione è particolarmente importante per evitare che il widget si sovrapponga ad altri elementi già presenti sul sito, come ad esempio una live chat, compromettendone la visibilità o l’usabilità.
Puoi personalizzare la dimensione del widget per adattarla al layout del sito. Questa opzione è fondamentale per garantire un buon equilibrio tra usabilità e esperienza di navigazione: il widget non deve essere troppo grande, per non sovrapporsi ad altri strumenti, ma nemmeno troppo piccolo, altrimenti rischia di non essere visibile o utilizzabile da una persona con disabilità.
Una volta scelto se posizionare il widget di accessibilità in basso a destra, a sinistra o al centro, puoi utilizzare le variabili X e Y per spostarlo ulteriormente, ad esempio per evitare che si sovrapponga ad altri elementi (come chatbot o pulsanti di prenotazione).
Questa opzione ti permette di personalizzare con precisione la posizione del tool e posizionarlo esattamente dove preferisci.
Ultima funzione è quella riferita alla possibilità di pubblicare il widget di accessibilità in modalità white label.
Di default infatti il widget espone il logo LegalBlink. E' però sempre possibile eliminare questa dicitura, lasciando niente oppure inserendo il riferimento a una terza società, come potrebbe essere il nome del titolare del sito o della Web Agency che ha installato il widget.
Se hai seguito tutti i passaggi ma il widget non appare sul sito oppure non funziona correttamente, ecco alcune verifiche da fare:
Controlla la posizione dello script nel codice HTML: lo script del widget deve essere inserito subito prima del "body"
Verifica di aver inserito correttamente il dominio del sito nel widget: il widget LegalBlink funziona solo se hai indicato correttamente il dominio del sito nella sezione dedicata della piattaforma. Controlla di aver fatto copia e incolla dell’indirizzo completo del sito (ad es. https://www.nomesito.it) nel pannello di configurazione. Se non lo hai fatto, il sistema non attiva il widget su quel dominio e il tool non viene caricato.
Controlla che lo script non sia stato bloccato da estensioni o da servizi terzi: estensioni come AdBlock, configurazioni del browser, impostazioni della cookie banner (es. modalità Consent Mode di Google) o altri strumenti di blocco possono impedire il caricamento dello script. Prova a disattivare eventuali estensioni o a testare il sito in una finestra in incognito.
Verifica che non ci siano errori nel codice HTML: un errore di battitura, tag mancanti o chiusure errate nel codice HTML possono interrompere il caricamento del widget. Controlla che tutto il codice sia correttamente strutturato.
Assicurati di non aver modificato lo script: lo script deve essere copiato esattamente come fornito, senza modificare l’indirizzo, i parametri o la sintassi del tag
Se il widget non compare sul tuo sito o non funziona correttamente (es. pulsanti non attivi, opzioni mancanti, malfunzionamenti), è possibile che ci siano errori JavaScript che ne bloccano il caricamento o l’esecuzione. Questi errori possono essere causati da conflitti con altri script presenti sul sito o da una configurazione errata.
Questa situazione può verificarsi con qualsiasi tool di accessibilità e non è dovuta a un malfunzionamento del widget di LegalBlink, ma piuttosto a conflitti o errori presenti nel codice del sito o nella sua configurazione.
💡 Come controllare gli errori del widget
Puoi verificare se ci sono problemi direttamente dal tuo browser, seguendo questi passaggi:
Apri il tuo sito web nel browser (consigliato: Chrome).
Premi F12 oppure clicca con il tasto destro del mouse in una zona vuota della pagina e seleziona "Ispeziona".
Vai alla scheda Console (in alto nella finestra degli strumenti per sviluppatori).
Controlla se ci sono messaggi di errore in rosso legati al file lb_as.js o a variabili come stopAnimations, keyboardNavigation o advancedSection.
📌 Se vedi errori come questi:
Uncaught ReferenceError: stopAnimations is not defined
keyboardNavigation is not defined
Access to XMLHttpRequest at https://app.legalblink.it/... has been blocked by CORS policy
allora significa che:
il dominio non è stato configurato correttamente nel pannello di LegalBlink (risolvi inserendo l'indirizzo del tuo sito nel campo "domini abilitati");
oppure sono state attivate opzioni avanzate nel widget senza che siano state supportate correttamente nel codice (es. personalizzazioni manuali non previste).
⚠️ Attenzione anche a possibili conflitti con strumenti esterni come Google Consent Mode, AdBlock, popup, plugin cookie, widget video, ecc.
Se, dopo aver verificato la posizione dello script, la configurazione del dominio e l’eventuale presenza di errori tramite la console del browser, il widget continua a non comparire o non funziona correttamente, puoi contattare il nostro team di supporto.
Scrivici a legalblink@legalblink.it, indicando:
l’email associata al tuo account su LegalBlink;
una breve descrizione del problema;
(facoltativo) uno screenshot della console del browser, se sono presenti errori.
Ti risponderemo il prima possibile per aiutarti a risolvere ogni difficoltà e completare correttamente l’installazione del widget.
Team LegalBlink