/ Documentazione / Libration Accessibility

Libration Accessibility

Il manuale del plugin di accessibilità: dall'installazione e dalla personalizzazione del widget fino ai report di verifica, alla dichiarazione e agli strumenti di IA. Trovi tutte le impostazioni in WordPress, in Impostazioni → Accessibilità.

Installazione

  1. Seleziona lo ZIP del plugin nel backend di WordPress, in Plugin → Aggiungi nuovo → Carica plugin, e installalo — oppure carica la cartella libration-accessibility in /wp-content/plugins/.
  2. Attiva il plugin nell'elenco dei plugin. Lì trovi anche il link diretto Impostazioni.
  3. Fatto — il widget di accessibilità compare subito in basso a destra sul tuo sito. Tutte le correzioni di base (skip link, indicatore del focus, landmark ARIA) sono attive fin dall'inizio.
Gli aggiornamenti arrivano direttamente tramite il sistema di aggiornamento di WordPress — le versioni Pro attraverso il server di aggiornamento di Libration, la versione gratuita attraverso la directory dei plugin di wordpress.org.

Attivare la licenza Pro

Trovi la tua chiave di licenza nell'e-mail dell'ordine e nell'area clienti.

  1. Apri Impostazioni → Accessibilità → Licenza.
  2. Inserisci la chiave (formato LIB-XXXX-XXXX-XXXX) e fai clic su Attiva.
  3. Viene mostrato il piano (Pro, Pro AI o Agency) e vengono sbloccate tutte le funzioni incluse — una sola chiave per tutto, anche per le funzioni di IA.

Le licenze Agency possono essere attivate su un massimo di 25 siti web; la scheda Licenza e l'area clienti mostrano il riepilogo dei posti occupati. Con «Scollega la licenza da questo sito» liberi di nuovo un posto — pratico quando sposti progetti dei clienti.

Widget: funzioni per i visitatori

Il widget offre ai visitatori dieci modalità di visualizzazione e quattro cursori — tutte le impostazioni vengono salvate per 30 giorni nel browser del visitatore (nessun tracciamento, nessuna trasmissione al server):

Modalità di visualizzazioneInverti i colori · Monocromatico · Contrasto scuro · Contrasto chiaro · Saturazione bassa · Saturazione alta · Evidenzia i link · Evidenzia i titoli · Screen reader (lettura al clic/alla selezione) · Modalità lettura
CursoriScala dei contenuti · Dimensione del testo · Altezza della riga · Spaziatura dei caratteri (ciascuno 80–200 %)
LingueL'interfaccia segue la lingua del sito — sono incluse 28 lingue europee

Nella scheda Widget puoi disattivare i gruppi di funzioni singolarmente (ad es. scala di grigi, modalità di contrasto, cursori del testo, sottolineatura dei link) se vuoi mantenere il pannello più snello.

Pulsante flottante

Tutto nella scheda Widget → Pulsante flottante:

PosizioneQuattro angoli: in basso a destra (predefinito), in basso a sinistra, in alto a destra, in alto a sinistra
Margine8–80 px di distanza dal bordo della pagina
DimensioneS (48 px) · M (56 px) · L (64 px)
IconaPersona (predefinita) · Utente in sedia a rotelle · Cursori — oppure una immagine propria dalla libreria dei media (PNG/SVG, consigliato il formato quadrato)

Puoi anche disattivare del tutto il pulsante e posizionare tu stesso il pannello al suo posto — vedi Integrazione.

Aspetto e tema

Colore di accentoColora il pulsante, le caselle attive e i cursori. Con il selettore di colore (tavolozza, HEX, RGB) — oppure come variabile CSS, vedi sotto.
Arrotondamento del pannelloRaggio degli angoli del pannello, 4–40 px
Tema del pannelloChiaro (bianco) · Scuro (antracite) · Variabili personalizzate (aggancio al design)
BrandingLink «powered by Libration» nel piè di pagina del pannello — disattivabile da Pro, white label da Agency

Aggancio al design con le variabili CSS

Per sviluppatori: invece di colori fissi, puoi agganciare il widget alle custom property CSS del tuo tema. Così seguirà automaticamente ogni cambio di design — modalità scura inclusa.

Colore di accento

Nel campo del colore di accento, al posto di un valore hex, inserisci semplicemente la variabile:

var(--primary)   oppure in breve:   --primary

Sfondo del pannello e colore del testo

Imposta il tema del pannello su Variabili personalizzate e inserisci i nomi delle variabili definite dal tuo tema, ad es.:

:root { --site-bg: #ffffff; --site-text: #1d1d1f; }
@media (prefers-color-scheme: dark) {
  :root { --site-bg: #1c1b22; --site-text: #f4f4f5; }
}

Il widget adotta background: var(--site-bg) e color: var(--site-text) e deriva automaticamente tutti i colori secondari (sfondi delle caselle, separatori, bordi) tramite color-mix(). Se il sito passa alla modalità scura per media query o per classe, il widget lo segue senza configurazione aggiuntiva.

I fallback sono integrati: se una variabile non è definita nella pagina, il widget usa bianco/antracite.

Blocco Gutenberg

Cerca nell'editor a blocchi «Pannello di accessibilità» (categoria Widget). Il blocco renderizza lo stesso pannello del pulsante flottante — ideale per il footer, i popup o una pagina dedicata all'«Accessibilità». Nella barra laterale del blocco configuri il titolo, la visibilità del titolo e il pulsante di ripristino.

Shortcode

Il pannello ovunque — anche nei file del tema tramite do_shortcode():

[libration_accessibility]

[libration_accessibility title="Aiuto alla navigazione" show_title="1" show_reset="0"]
AttributoValoriSignificato
titleTestoTitolo del pannello (predefinito: «Accessibilità»)
show_title1 / 0Mostra il titolo
show_reset1 / 0Mostra il pulsante di ripristino

Elementor

Se Elementor è attivo, il widget «Libration Accessibility – Accessibilità» compare automaticamente nel pannello di Elementor (categoria Generale, parole di ricerca «accessibility», «accessibilità»). Posizionalo con il trascinamento; il titolo, la visibilità del titolo e il pulsante di ripristino si configurano direttamente nelle opzioni del widget.

WPBakery

Se WPBakery (Visual Composer) è attivo, trovi l'elemento «Libration Accessibility – Accessibilità» nel catalogo degli elementi, in Contenuto — con le stesse tre opzioni del blocco e dello shortcode.

Divi

Con Divi attivo, il modulo «Libration Accessibility – strumenti di accessibilità» compare nel Divi Builder — con le stesse tre opzioni del blocco e dello shortcode. Divi 5 esegue il modulo tramite la sua compatibilità con Divi 4.

Dichiarazione di accessibilità Pro

La scheda Dichiarazione genera una dichiarazione di accessibilità pronta secondo l'EAA (BFSG) come pagina di WordPress:

  1. Inserisci l'organizzazione, l'e-mail di contatto e, facoltativamente, il telefono.
  2. Scegli lo stato di conformità — parzialmente conforme è lo stato abituale e onesto.
  3. Aggiungi le limitazioni note (ad es. «I vecchi documenti PDF non sono ancora accessibili»).
  4. Scegli la lingua — sono disponibili le 28 lingue del plugin (tedesco e inglese con revisione editoriale; le altre arriveranno via via).
  5. Crea pagina — la dichiarazione compare come pagina pubblicata; se fai modifiche, salva di nuovo e la pagina si aggiorna.
Collega la dichiarazione nel footer del tuo sito — è ciò che si aspettano gli utenti e la vigilanza del mercato. La dichiarazione non sostituisce la consulenza legale.

Sottotitoli e trascrizioni

La scheda Media elenca ogni file video e audio della libreria e mostra quali hanno sottotitoli verificati. Un incarico ricava dalla traccia audio una traccia di sottotitoli (WebVTT) e, se vuoi, una trascrizione e traduzioni.

Minuti media

La contabilizzazione avviene in minuti media: un minuto iniziato di durata per passaggio. Un video di dieci minuti con trascrizione e due traduzioni consuma quindi tre volte dieci minuti. Le correzioni nell’editor non costano nulla. Senza licenza c’è una prova una tantum per sito.

L’editor

«Apri nell’editor» affianca i sottotitoli all’audio. Un clic su una scheda salta al punto corrispondente. L’editor controlla le regole che rendono leggibili i sottotitoli: al massimo due righe da 37 caratteri, permanenza fra uno e sei secondi, non più di quindici caratteri al secondo. Le violazioni compaiono come nota sulla scheda: non bloccano nulla, ma quasi sempre sono fondate.

Tre scorciatoie sono integrate: Parlante antepone un nome, [suono] aggiunge un suono rilevante, Sposta i tempi corregge uno scarto sull’intero file.

L’approvazione — il punto vero

I sottotitoli automatici non soddisfano la WCAG 1.2.2: i nomi propri non sono sempre esatti, i parlanti non sono indicati, i suoni rilevanti mancano. Perciò un media conta come coperto solo dopo la tua approvazione, sia nel quadro generale sia nel testo per la dichiarazione di accessibilità. L’approvazione è un’affermazione, non una formalità: con essa confermi di aver letto e corretto i sottotitoli.

Video di terzi incorporati

YouTube e Vimeo non possono essere sottotitolati dall’esterno. Elabora qui il file originale, scarica il file SRT dall’editor dopo l’approvazione e caricalo sulla piattaforma.

Impostazioni

La traccia verificata può essere agganciata automaticamente al video in fase di consegna, anche per i video di un page builder. Una trascrizione a scomparsa sotto il media soddisfa il criterio 1.2.1 per i contenuti solo audio e giova anche alla ricerca. Nel campo Lessico di questo sito vanno nomi propri, prodotti e termini tecnici, uno per riga: quel contesto alza la qualità più di qualunque modello più grande.

Documenti PDF

I PDF pubblicati su un sito rientrano nella BFSG tramite la norma EN 301 549, capitolo 10. Una versione HTML accessibile non sostituisce espressamente un PDF inaccessibile. La scheda Documenti raccoglie quindi tutti i PDF della libreria, li verifica e può elaborarli.

Verificare non costa nulla

La verifica avviene secondo PDF/UA-1 ed esamina tag, ordine di lettura, metadati, testi alternativi, intestazioni di tabella e pagine scansionate. Non consuma alcun credito: puoi verificare ogni documento quante volte vuoi, anche senza licenza. Il risultato è un punteggio da 0 a 100 e un elenco dei rilievi per gravità.

Elaborazione e prova

L’elaborazione costa un’unità per pagina elaborata. Genera tag e struttura, imposta titolo e lingua del documento, contrassegna gli elementi decorativi come artefatti, propone testi alternativi per le figure e imposta le celle di intestazione nelle tabelle dove sono riconoscibili. La prova elabora al massimo metà delle pagine, non costa credito e restituisce un file di prova: sul documento non cambia nulla.

Il semaforo

Tre stati, e quello centrale è il più importante: non verificato, elaborato automaticamente, non controllato, controllato e approvato. Una macchina non può giudicare se l’ordine di lettura regga nel merito, se un testo alternativo dica la cosa giusta o se una tabella complessa resti comprensibile. Un documento elaborato resta perciò «elaborato automaticamente, non controllato» finché qualcuno non lo ha riletto e approvato. Solo i documenti approvati contano negli indicatori e nel testo per la dichiarazione.

Sostituire l’originale o affiancarlo

Per impostazione predefinita l’elaborazione affianca all’originale un nuovo file con il suffisso -accessibile; i link esistenti continuano a funzionare. «Sostituisci» scambia il file originale e conserva la vecchia versione come .bak. Attenzione: così decade la tutela dei documenti preesistenti.

Documenti preesistenti

Ai sensi del § 1 comma 4 della BFSG i documenti pubblicati prima del 28 giugno 2025 sono esenti dai requisiti finché restano invariati. Questi file sono contrassegnati nell’elenco. Chi ne sostituisce o ricarica uno perde l’esenzione. È un’indicazione, non un parere legale.

Testo per la dichiarazione

In fondo alla scheda si trova un paragrafo che riporta in cifre lo stato dei documenti PDF, in tedesco o in inglese, pronto da copiare. Il generatore della dichiarazione di accessibilità può riprenderlo.

Report di verifica e PDF

La scheda Report di verifica riunisce tre strumenti:

Funzioni di IA Pro AI

Le funzioni di IA vengono eseguite sui server di Libration in Germania e si sbloccano con la tua licenza. Trovi le quote di ogni piano in Piani.

Testi alternativi automatici

Lettura facilitata e lettura ad alta voce con IA

Entrambe le funzioni fanno parte del piano Pro AI e si sbloccano automaticamente con la tua licenza non appena sono disponibili per il tuo account — vedi lo stato nella scheda IA.

Opzioni del backend

Widget della bachecaRiepilogo dello stato nella bacheca di WP — disattivabile in Generale → Integrazione nel backend
Barra di amministrazioneAccesso rapido «Accessibilità» nella barra superiore — anch'esso disattivabile
Visualizzatore di tabulazioneMostra agli amministratori l'ordine di tabulazione con numeri direttamente nel frontend (scheda Ordine di tabulazione)
Avvisi via e-mailNotifica facoltativa quando viene caricata un'immagine senza testo alternativo

Piani in sintesi

FreeProPro AIAgency
Widget + correzioni di base + checklist
Verifica dei testi alternativi50 immaginiillimitata + CSVillimitata + CSVillimitata + CSV
Dichiarazione di accessibilità + report PDF
IA: testi alternativi / lettura facilitata / lettura ad alta voce✓ (condiviso)
Siti web11fino a 25
Branding disattivabile / white label✓ / —✓ / —✓ / ✓

Prezzi e acquisto: libration.io/#pricing · Gestione: area clienti

Risoluzione dei problemi

Gli inciampi più frequenti e le loro soluzioni — la maggior parte dei problemi si risolve in pochi minuti.

Il widget non compare nel frontend

Controlla prima che il plugin sia davvero attivato nell'elenco dei plugin e che il pulsante flottante sia acceso nella scheda Widget. Dopodiché, la causa è di solito un plugin di cache o di ottimizzazione: svuota la cache (ad es. WP Rocket, LiteSpeed Cache, Cloudflare) e ricarica la pagina in una finestra in incognito. Se il widget continua a non comparire, escludi i file di Libration Access dall'ottimizzazione — la procedura è descritta in dettaglio in Plugin di cache e ottimizzazione. Verifica anche se sono attive regole di esclusione (pagine o tipi di contenuto specifici).

La chiave di licenza non viene accettata

La chiave ha il formato LIB-XXXX-XXXX-XXXX — attenzione agli spazi all'inizio o alla fine quando la copi dall'e-mail dell'ordine. Se il limite di siti del tuo piano è stato raggiunto, il server rifiuta l'attivazione: apri l'area clienti e libera un posto con «Scollega la licenza da questo sito». Se l'attivazione fallisce con un errore di connessione, il tuo server non raggiunge libration.io — chiedi al tuo hosting di consentire le connessioni HTTPS in uscita verso libration.io (firewall, file hosts).

Le funzioni di IA non restituiscono risultati

Causa più frequente: la quota mensile è esaurita — la scheda IA mostra il consumo e ricevi un'e-mail di avviso all'80 % e al 100 %. Puoi acquistare quota aggiuntiva nell'area clienti. Verifica inoltre se il tuo piano include l'IA (Pro AI o Agency — vedi Piani). Se le richieste restano del tutto senza risposta, può darsi che il tuo server blocchi le connessioni HTTPS in uscita verso il proxy di Libration — nel dubbio, chiedi al tuo hosting.

La lettura ad alta voce usa la voce di sistema invece della voce IA

La voce IA richiede una licenza Pro AI (o Agency) attiva e quota disponibile — se manca una delle due cose, il widget ricorre automaticamente alla voce di sistema del browser. Controlla la licenza e il consumo nella scheda IA. La prima lettura di una pagina richiede inoltre un momento: l'audio viene generato sul server e poi salvato nella cache — dalla seconda riproduzione in poi parte all'istante.

Il widget non si intona visivamente con il tema

La posizione, la dimensione, il colore di accento e il tema del pannello si configurano in Impostazioni → Accessibilità → Widget. Se vuoi che il widget segua automaticamente i colori del tuo tema — modalità scura inclusa —, aggancialo al tuo design con le variabili CSS: vedi Aggancio al design. Così resta coerente anche dopo un cambio di tema, senza ritoccare i colori a mano.

Plugin di cache e ottimizzazione: escludere Libration Accessibility nel modo giusto

Se il widget manca, il pannello si apre senza stile o il pulsante non reagisce, dietro c'è quasi sempre un plugin di ottimizzazione: combina il JavaScript, lo minifica o ne rimanda l'esecuzione («Delay JavaScript», «Defer»). La soluzione è sempre la stessa — escludere Libration Access dall'ottimizzazione. Cambia solo la scrittura: ad alcuni plugin basta la parola chiave libration-accessibility, altri richiedono il percorso completo di ogni singolo file JavaScript.

Questi sono i file interessati — si trovano tutti nella cartella del plugin:

/wp-content/plugins/libration-accessibility/assets/frontend.js
/wp-content/plugins/libration-accessibility/assets/frontend.css
/wp-content/plugins/libration-accessibility/assets/libration-tts.js
/wp-content/plugins/libration-accessibility/assets/libration-easy-lang.js

libration-tts.js e libration-easy-lang.js vengono caricati solo se sono attive la lettura vocale con IA o la lingua facile. Se il tuo plugin chiede gli handle di WordPress invece dei percorsi (un elenco di selezione anziché un campo di testo), sono libration-frontend, libration-tts e libration-easy-lang.

Importante: frontend.js dipende da due cose che WordPress stampa subito prima — jQuery e un piccolo blocco di configurazione (libration_ajax). Se un ottimizzatore sposta lo script del widget ma lascia la configurazione dov'è (o spinge jQuery in fondo alla pagina), il widget si rompe. Escludi quindi sempre anche jQuery quando escludi Libration Access da «delay» o «defer».

Dove va inserita l'esclusione nei singoli plugin (le diciture dei menu cambiano leggermente tra le versioni, il punto resta lo stesso):

WP RocketOttimizzazione dei file → «File JavaScript esclusi» e inoltre «Ritarda l'esecuzione di JavaScript → File esclusi». Voce: libration-accessibility (un modello per riga) e jquery.
LiteSpeed CacheOttimizzazione pagina → Impostazioni JS → «JS Excludes» e «JS Deferred Excludes». Voce: libration-accessibility.
AutoptimizeJS, CSS & More → «Escludi script da Autoptimize» — un elenco separato da virgole. Da aggiungere: libration-accessibility/assets/.
W3 Total CacheMinify → «Never minify the following JS files». Qui la parola chiave non basta — inserisci il percorso senza dominio: wp-content/plugins/accessibility/assets/frontend.js (una riga per file).
SiteGround OptimizerFrontend → JavaScript → «Escludi file JS da combinazione/rinvio». La selezione avviene per handle: libration-frontend, libration-tts, libration-easy-lang.
PerfmattersAssets → JavaScript → esclusioni di «Delay JavaScript» oppure Script Manager. Voce: libration-accessibility.
Jetpack Boost / NitroPackElenco di esclusione dell'ottimizzazione JavaScript. Voce: libration-accessibility.
Cloudflare Rocket LoaderNon prevede un elenco di esclusione. Se il widget si rompe solo con Rocket Loader attivo, disattivalo oppure escludi le pagine interessate con una regola.

Metodo collaudato quando non sai quale impostazione sia responsabile: disattiva del tutto «combina JavaScript» e «ritarda l'esecuzione di JavaScript», svuota la cache e controlla la pagina in incognito. Se a quel punto il widget funziona, riattiva le opzioni una alla volta — con le esclusioni indicate sopra. In due o tre giri individuerai l'opzione responsabile senza rinunciare all'ottimizzazione dell'intero sito.

Rinunciarvi qui non ti costa quasi nulla: le risorse di Libration Access sono già minificate e raggruppate — un'ulteriore minificazione risparmia pochi kilobyte.

La scansione esterna segnala «quota raggiunta» o un errore

La scansione ha limiti mensili per piano: Free 2, Pro 20, Agency 100 scansioni — il contatore si azzera al cambio di mese. Inoltre, lo scanner può analizzare solo pagine accessibili pubblicamente: la modalità di manutenzione, la protezione con password basic-auth o un ambiente di sviluppo locale impediscono l'accesso e provocano un errore. Disattiva la protezione per un momento o scansiona il sito in produzione.

Un aggiornamento disponibile non viene mostrato

WordPress controlla gli aggiornamenti solo all'incirca ogni dodici ore. Avvia il controllo manualmente: Bacheca → Aggiornamenti → «Controlla di nuovo» — questo svuota il transient degli aggiornamenti. Se l'aggiornamento Pro continua a non comparire, verifica la tua licenza: se è scaduta, il server di aggiornamento fornisce solo gli aggiornamenti della versione gratuita; dopo il rinnovo nell'area clienti, gli aggiornamenti Pro tornano subito disponibili.

Il tuo problema non è nell'elenco? Scrivici — tutti i dettagli in Supporto. La licenza, le fatture e le quote le gestisci nell'area clienti.

Supporto

Domande, errori, suggerimenti? Scrivi a support@libration.io — ai clienti Pro rispondiamo con priorità. Ci aiuta conoscere la tua versione di WordPress e del plugin (vedi l'elenco dei plugin) e una breve descrizione di ciò che ti aspettavi e di ciò che hai visto invece.