Wave Access
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
wave-accessin/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.
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
WAVE-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.
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 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.
Pulsante flottante
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.
Aspetto e tema
| 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 Wave Tools» 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.
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():
[wave_access]
[wave_access 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 «Wave Access – 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 «Wave Access – 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.
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 Wave Tools 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: wavetools.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 un CDN: svuota la cache (ad es. WP Rocket, LiteSpeed Cache, Cloudflare) e ricarica la pagina in una finestra di navigazione in incognito. I plugin di ottimizzazione che rimandano (defer) o combinano il JavaScript possono bloccare lo script del widget — escludi lì wave-access dall'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 WAVE-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 wavetools.io — chiedi al tuo hosting di consentire le connessioni HTTPS in uscita verso wavetools.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 Wave Tools — 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.
Il layout si rompe con i plugin di ottimizzazione/minificazione
Alcuni plugin di ottimizzazione (Autoptimize, WP Rocket, SiteGround Optimizer e altri) combinano o minificano il CSS e il JavaScript in modo così aggressivo che gli stili o gli script del widget si rompono. Escludi lì i file del plugin (il percorso contiene wave-access) dalla minificazione/combinazione, svuota poi la cache e controlla la pagina in una finestra di navigazione in incognito. Le risorse del widget sono già leggere e ottimizzate — un'ulteriore minificazione non porta praticamente nulla.
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.
Supporto
Domande, errori, suggerimenti? Scrivi a support@wavetools.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.