/ Documentazione / Wave Access

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

  1. Seleziona lo ZIP del plugin nel backend di WordPress, in Plugin → Aggiungi nuovo → Carica plugin, e installalo — oppure carica la cartella wave-access 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 Wave Tools; la versione gratuita, fino alla pubblicazione su wordpress.org, la scarichi qui: wave-access.zip.

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 WAVE-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 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:

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 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.

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():

[wave_access]

[wave_access 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 «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:

  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 29 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.

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 Wave Tools 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: 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.

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@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.