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

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/.
Attiva il plugin nell'elenco dei plugin. Lì trovi anche il link diretto Impostazioni.
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, fino alla pubblicazione su wordpress.org, la scarichi qui: libration-accessibility.zip.

Attivare la licenza Pro

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

Apri Impostazioni → Accessibilità → Licenza.
Inserisci la chiave (formato LIB-XXXX-XXXX-XXXX) e fai clic su Attiva.
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.

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 visualizzazione	Inverti 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
Cursori	Scala dei contenuti · Dimensione del testo · Altezza della riga · Spaziatura dei caratteri (ciascuno 80–200 %)
Lingue	L'interfaccia segue la lingua del sito — sono incluse 29 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.

Tutto nella scheda Widget → Pulsante flottante:

Posizione	Quattro angoli: in basso a destra (predefinito), in basso a sinistra, in alto a destra, in alto a sinistra
Margine	8–80 px di distanza dal bordo della pagina
Dimensione	S (48 px) · M (56 px) · L (64 px)
Icona	Persona (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.

Colore di accento	Colora il pulsante, le caselle attive e i cursori. Con il selettore di colore (tavolozza, HEX, RGB) — oppure come variabile CSS, vedi sotto.
Arrotondamento del pannello	Raggio degli angoli del pannello, 4–40 px
Tema del pannello	Chiaro (bianco) · Scuro (antracite) · Variabili personalizzate (aggancio al design)
Branding	Link «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"]

Attributo	Valori	Significato
`title`	Testo	Titolo del pannello (predefinito: «Accessibilità»)
`show_title`	`1` / `0`	Mostra il titolo
`show_reset`	`1` / `0`	Mostra 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.

Dichiarazione di accessibilità Pro

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

Inserisci l'organizzazione, l'e-mail di contatto e, facoltativamente, il telefono.
Scegli lo stato di conformità — parzialmente conforme è lo stato abituale e onesto.
Aggiungi le limitazioni note (ad es. «I vecchi documenti PDF non sono ancora accessibili»).
Scegli la lingua — sono disponibili le 29 lingue del plugin (tedesco e inglese con revisione editoriale; le altre arriveranno via via).
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.

Report di verifica e PDF

La scheda Report di verifica riunisce tre strumenti:

Riepilogo — statistica delle immagini senza testo alternativo, avanzamento della checklist e stato generale. Da qui avvii anche il report di verifica in PDF Pro: una documentazione giustificativa ottimizzata per la stampa (riepilogo, misure attive, checklist completa, elenco delle immagini) che salvi come PDF dalla finestra di stampa.
Analisi delle immagini — elenco dettagliato di tutte le immagini senza testo alternativo, con anteprima, posizioni e link diretto per modificarle. Free mostra le prime 50 immagini; Pro analizza senza limiti ed esporta in CSV.
Checklist EAA — 27 criteri secondo le WCAG 2.1 AA in cinque categorie, con barra di avanzamento e funzione di salvataggio. L'autovalutazione confluisce nel report PDF.

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

Al caricamento: interruttore «Testi alternativi automatici al caricamento» — le nuove immagini vengono descritte in modo asincrono.
Completare l'esistente: «Analizza la libreria dei media» conta le immagini senza testo alternativo; «Genera ora» le elabora con indicatore di avanzamento. I testi alternativi esistenti non vengono toccati.
Lingua: segue la lingua del sito; si può cambiare nella scheda IA.

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 bacheca	Riepilogo dello stato nella bacheca di WP — disattivabile in Generale → Integrazione nel backend
Barra di amministrazione	Accesso rapido «Accessibilità» nella barra superiore — anch'esso disattivabile
Visualizzatore di tabulazione	Mostra agli amministratori l'ordine di tabulazione con numeri direttamente nel frontend (scheda Ordine di tabulazione)
Avvisi via e-mail	Notifica facoltativa quando viene caricata un'immagine senza testo alternativo

Piani in sintesi

	Free	Pro	Pro AI	Agency
Widget + correzioni di base + checklist	✓	✓	✓	✓
Verifica dei testi alternativi	50 immagini	illimitata + CSV	illimitata + CSV	illimitata + CSV
Dichiarazione di accessibilità + report PDF	—	✓	✓	✓
IA: testi alternativi / lettura facilitata / lettura ad alta voce	—	—	✓	✓ (condiviso)
Siti web	∞	1	1	fino 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 Rocket	Ottimizzazione dei file → «File JavaScript esclusi» e inoltre «Ritarda l'esecuzione di JavaScript → File esclusi». Voce: `libration-accessibility` (un modello per riga) e `jquery`.
LiteSpeed Cache	Ottimizzazione pagina → Impostazioni JS → «JS Excludes» e «JS Deferred Excludes». Voce: `libration-accessibility`.
Autoptimize	JS, CSS & More → «Escludi script da Autoptimize» — un elenco separato da virgole. Da aggiungere: `libration-accessibility/assets/`.
W3 Total Cache	Minify → «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 Optimizer	Frontend → JavaScript → «Escludi file JS da combinazione/rinvio». La selezione avviene per handle: `libration-frontend`, `libration-tts`, `libration-easy-lang`.
Perfmatters	Assets → JavaScript → esclusioni di «Delay JavaScript» oppure Script Manager. Voce: `libration-accessibility`.
Jetpack Boost / NitroPack	Elenco di esclusione dell'ottimizzazione JavaScript. Voce: `libration-accessibility`.
Cloudflare Rocket Loader	Non 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@librationtools.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.