Il plugin WordPress di QA Proof aggiunge un menu QAProof all'interno del tuo admin WP, dove puoi eseguire test, pianificare monitor e visualizzare report PDF — il tutto senza scrivere alcun codice API.

Requisiti

WordPress 6.0+ (le versioni precedenti potrebbero funzionare ma non sono testate).
PHP 7.4 o più recente.
Un account QA Proof e una chiave API — consulta la Guida Rapida se non ne hai ancora creato uno.
Accesso HTTPS in uscita dal tuo server WP verso api.qaproof.io.

1. Installa il plugin

Scarica il .zip del plugin dal tuo account QA Proof.
Nell'admin WP vai su Plugin → Aggiungi nuovo → Carica plugin.
Scegli il .zip, clicca su Installa ora, poi su Attiva plugin.

Una nuova voce QAProof appare nella barra laterale dell'admin WP.

2. Collega la tua chiave API

Apri QAProof → Impostazioni → Generali.
Incolla la tua chiave API (da qaproof.io/app/api-keys) nel campo Configurazione API.
Clicca su Salva modifiche.
La scheda sotto il campo dovrebbe ora mostrare l'email del tuo account, il badge del piano attuale, le generazioni IA usate / limite, il limite di monitor e il periodo di conservazione della cronologia.

3. Verifica la connessione

Clicca su Testa connessione nella stessa pagina Impostazioni. Dovresti vedere "Connected! API status: ok". Se ricevi un errore, controlla:

La chiave inizia con qap_live_sk_ e non ha spazi all'inizio/alla fine.
Il tuo hosting consente l'HTTPS in uscita verso api.qaproof.io (alcuni ambienti protetti da firewall bloccano le chiamate API di terze parti).
L'account è su un piano a pagamento se la tua chiave API è appena stata rigenerata — le vecchie chiavi smettono di funzionare immediatamente quando le rigeneri.

Cosa ottieni all'interno dell'admin WP

Dashboard — colpo d'occhio: numero totale di test, punteggio medio, monitor, generazioni IA usate / limite.
Tests — esegui un test su richiesta (Fedeltà del design, Responsive, Regressione visiva, Accessibilità o Audit del design) e sfoglia la cronologia con download PDF.
Monitors — pianifica controlli di regressione ricorrenti (giornalieri / settimanali / mensili) con notifiche via email quando i punteggi calano.
Settings — chiave API, impostazioni predefinite di monitoraggio (email di notifica, soglia di avviso), opzioni di pulizia dei dati.

Aggiornamento del plugin

Quando viene rilasciata una nuova versione del plugin, vedrai un avviso di aggiornamento in Plugin. Clicca su Aggiorna ora. I tuoi monitor, le baseline e la cronologia dei test vengono conservati durante gli aggiornamenti.

Disinstallazione

Disattiva il plugin da Plugin, poi clicca su Elimina. Per impostazione predefinita questo lascia i tuoi monitor e la cronologia dei test nel database. Per cancellare tutto, attiva Impostazioni → Pulizia dati → Rimuovi tutti i dati del plugin alla disinstallazione prima di eliminare.

Il tuo account QA Proof, la chiave API e qualsiasi baseline memorizzata sul nostro server non sono interessati — risiedono su qaproof.io.

Risoluzione dei problemi

"Could not reach the API"

Problema di firewall o DNS a livello di server. Prova:

Apri un terminale sul tuo server WP: curl -I https://api.qaproof.io/api/health — dovrebbe restituire 200 OK.
Se il tuo host blocca le chiamate in uscita, chiedi di inserire api.qaproof.io nella lista consentita.

"Invalid API key"

La chiave è stata digitata in modo errato, rigenerata su qaproof.io (vecchia chiave invalidata) o appartiene a un account diverso. Apri qaproof.io/app/api-keys, copia la chiave attuale, incollala di nuovo e salva.

Il monitor non si attiva secondo la pianificazione

I monitor si basano su WP-Cron. Se il tuo sito ha pochissimo traffico, WP-Cron potrebbe non essere eseguito in modo costante. Il plugin avvia WP-Cron dal browser quando apri la pagina Monitor; per la produzione, configura un vero cron job che richiami wp-cron.php ogni 5–10 minuti.