Questa guida presuppone che il plugin WP sia già installato e connesso — in caso contrario, inizia con Installazione del plugin WordPress.

1. Scegli un tipo di test

Apri QAProof → Tests nel tuo admin WP. Vedrai cinque schede in alto:

Fedeltà del design — confronta la tua pagina live con un design Figma o un'immagine caricata. Usalo dopo che uno sviluppatore ha pubblicato una nuova pagina per verificare che corrisponda al design approvato.
Responsive — cattura la pagina su desktop / tablet / mobile e segnala i problemi di layout specifici di ciascuno. Usalo dopo modifiche al CSS per individuare rotture su mobile.
Regressione visiva — confronta la pagina con una baseline approvata in precedenza. Usalo (manualmente o tramite un monitor pianificato) per individuare modifiche visive indesiderate.
Accessibilità — audit WCAG 2.1 (Livello A / AA / AAA configurabile). Usalo prima della pubblicazione o per i report di conformità.
Audit del design — misura la coerenza del design system nella pagina (colori, font, spaziatura, componenti) e produce un Design Debt Score.

Se stai testando per la prima volta, scegli Accessibilità — non richiede una baseline né un design Figma e fornisce subito risultati concreti.

2. Compila il modulo

Ogni tipo di test ha un modulo leggermente diverso. Campi comuni:

URL della pagina — la pagina live da testare. Deve essere raggiungibile pubblicamente dai nostri server (niente localhost / staging dietro VPN).
Livello WCAG (solo Accessibilità) — A, AA o AAA. Il valore predefinito AA è ciò a cui mirano la maggior parte dei contratti e degli audit.
URL Figma o caricamento immagine (solo Fedeltà del design) — il design di origine con cui confrontare.

Clicca su Esegui test. Appare un indicatore di avanzamento con le fasi: Caricamento → Acquisizione screenshot → Analisi. Tempo di esecuzione totale: 30–90 secondi a seconda delle dimensioni della pagina e del tipo di test.

3. Leggi il risultato

Al termine del test, la pagina dei risultati mostra:

Punteggio complessivo 0–100 con un'etichetta colorata (Buono / Da migliorare / Scarso).
Suddivisione per categoria — ogni tipo di test valuta da 5 a 8 categorie in modo indipendente. Guarda qui per primo per trovare l'area che abbassa il punteggio complessivo.
Problemi rilevati — ogni problema individuato, etichettato con gravità (alta / media / bassa) e una descrizione precisa.
Raccomandazioni — correzioni concrete da affidare a uno sviluppatore.
Screenshot — per la Regressione visiva ottieni baseline + corrente affiancate; gli altri tipi di test mostrano la pagina acquisita.

4. Salva o condividi

Il risultato viene salvato automaticamente nella Cronologia test. Da lì puoi:

Riaprire qualsiasi risultato passato con screenshot completi ed elenco dei problemi.
Scaricare come PDF — un report brandizzato da inviare via email a un cliente o da allegare a un ticket Jira.
Eliminare i vecchi risultati, oppure affidarti alla pulizia automatica (la conservazione dipende dal tuo piano: 7 / 90 / 365 giorni).

Cosa succede al mio conteggio di generazioni IA?

Ogni test riuscito consuma una generazione IA. I test falliti non contano — addebitiamo solo i risultati effettivamente restituiti. Sui piani a pagamento (Pro / Business / Scale) il contatore si azzera all'inizio di ogni periodo di fatturazione; sul piano Free non si azzera mai (Free è una prova una tantum a vita di 10 generazioni). Monitora l'utilizzo su qaproof.io/app/api-keys o in QAProof → Settings dentro WP.

Problemi comuni alla prima esecuzione

"Capture appears unstable" con punteggio 100

La pipeline di acquisizione screenshot ha rilevato che il proprio output non è affidabile (ad es. un carosello JS reso in modo diverso tra le acquisizioni). Il sistema restituisce intenzionalmente il punteggio 100 invece di una falsa regressione. Riesegui il test — di solito riesce al secondo tentativo.

"Baseline capture is unstable — 7 image(s) failed to load"

Il tuo sito o la sua CDN ha limitato la frequenza del nostro scraper. Attendi 1–2 minuti e riprova. Rifiutiamo di salvare una baseline difettosa perché ogni futura esecuzione di regressione la confronterebbe con i buchi.

"You have reached your free trial limit"

Gli utenti del piano Free vedono questo messaggio a 10 generazioni (la prova a vita è esaurita — il piano Free non si azzera). Effettua l'upgrade in Impostazioni → Fatturazione per continuare a eseguire test.

Prossimi passi

Configura un monitor di regressione — controlli automatici giornalieri / settimanali / mensili con avvisi via email.
Comprendere la dashboard — cosa significa ogni numero sulla dashboard del plugin WP.