Documentazione Alt Audit

Guida completa per integrare Alt Audit nel tuo flusso di lavoro con configurazione del plugin WordPress, integrazione API e migliori pratiche.

Per Iniziare

Avvio Rapido

Inizia con Alt Audit in meno di 5 minuti:

  1. Crea il tuo account gratuito (25 crediti inclusi)
  2. Installa il plugin WordPress o ottieni la tua chiave API
  3. Inizia a generare testo alternativo perfetto automaticamente

Configurazione Account

Il tuo account Alt Audit include tutto il necessario per iniziare:

  • 25 crediti gratuiti - Nessuna carta di credito richiesta
  • Accesso plugin WordPress - Disponibile immediatamente
  • Accesso API - Genera token dalla tua dashboard
  • Analisi utilizzo - Traccia i tuoi miglioramenti di accessibilità

Come Funzionano i Crediti

Capire il sistema di crediti:

  • 1 1 credito = 1 immagine elaborata - Semplice e trasparente
  • I crediti si azzerano mensilmente per i piani di abbonamento
  • I pacchetti di crediti una tantum non scadono mai

Configurazione Plugin WordPress

Scarica Plugin

Scarica l'ultima versione del plugin WordPress Alt Audit da WordPress.org:

Scarica da WordPress.org

Compatibile con WordPress 6.2+ • PHP 7.4+

Passaggi di Installazione

Passo 1: Installa il Plugin

  1. Scarica il file alt-audit.zip
  2. Vai alla tua dashboard di amministrazione WordPress
  3. Naviga su Plugin > Aggiungi Nuovo
  4. Clicca su "Carica Plugin" e seleziona il file zip
  5. Clicca su "Installa Ora" e poi su "Attiva"

Passo 2: Connetti il Tuo Account

  1. Vai su Impostazioni > Alt Audit nel tuo admin WordPress
  2. Inserisci il tuo indirizzo email Alt Audit
  3. Clicca su "Connetti Account"
  4. Segui il processo di verifica (controlla la tua email)
  5. La tua chiave API verrà configurata automaticamente

Passo 3: Configura Impostazioni

Personalizza il comportamento del plugin:

  • Genera automaticamente al caricamento - Elabora automaticamente nuove immagini
  • Elabora immagini esistenti - Elaborazione in blocco della tua libreria media
  • Rilevamento intelligente - Elabora solo immagini pubbliche

Funzionalità del Plugin

Elaborazione Automatica

  • • Testo alternativo generato al caricamento dell'immagine
  • • Funziona con caricamenti dalla libreria media
  • • Compatibile con costruttori di pagine
  • • Supporta caricamenti drag-and-drop

Elaborazione in Blocco

  • • Elabora libreria media esistente
  • • Filtra per intervallo di date
  • • Salta immagini con testo alternativo esistente
  • • Tracciamento progressi e report

Rilevamento Intelligente

  • • Identifica immagini pubbliche vs private
  • • Salta immagini di amministrazione/backend
  • • Ottimizza l'utilizzo dei crediti
  • • Regole di rilevamento personalizzabili

Tracciamento Utilizzo

  • • Dashboard utilizzo crediti
  • • Cronologia elaborazione
  • • Stato elaborazione immagini
  • • Report utilizzo mensili

Risoluzione Problemi

Problemi Plugin WordPress

Attivazione plugin fallita

  • Assicurati di avere WordPress versione 5.0 o superiore
  • Verifica versione PHP (7.4+ richiesta)
  • Verifica permessi di scrittura in wp-content/plugins/
  • Disattiva temporaneamente plugin in conflitto

Le immagini non vengono elaborate automaticamente

  • Controlla connessione API in Impostazioni > Alt Audit
  • Verifica di avere crediti rimanenti
  • Assicurati che "Genera automaticamente" sia abilitato
  • Controlla se le immagini sono accessibili pubblicamente

Elaborazione in blocco bloccata

  • Aggiorna la pagina e controlla i progressi
  • Riduci la dimensione del lotto nelle impostazioni
  • Controlla i limiti di timeout del server
  • Contatta il supporto se il problema persiste

Problemi Integrazione API

Errori di autenticazione

  • Verifica che il token API sia corretto e attivo
  • Controlla il formato dell'intestazione di autorizzazione
  • Rigenera il token API se necessario
  • Assicurati che il token abbia permessi sufficienti

Problemi URL immagine

  • Assicurati che gli URL delle immagini siano accessibili pubblicamente
  • Verifica i requisiti HTTPS
  • Verifica formato immagine (JPG, PNG, GIF, WebP)
  • Conferma limiti dimensione immagine (max 10MB)

Limite di velocità

  • Implementa backoff esponenziale
  • Controlla intestazioni limite velocità nella risposta
  • Considera l'aggiornamento del piano per limiti più alti
  • Raggruppa le richieste quando possibile

Hai Ancora Bisogno di Aiuto?

Non riesci a trovare la soluzione che cerchi?

Contatta Supporto

Migliori Pratiche

Qualità Testo Alt

✅ Buone Pratiche

  • • Mantieni descrizioni concise ma descrittive
  • • Concentrati sullo scopo e contesto dell'immagine
  • • Includi parole chiave rilevanti in modo naturale
  • • Rivedi il testo generato dall'IA per accuratezza
  • • Considera il contenuto circostante

❌ Evita Questo

  • • Iniziare con "Immagine di..." o "Foto di..."
  • • Descrizioni eccessivamente lunghe
  • • Riempimento di parole chiave
  • • Descrivere solo elementi visivi ovvi
  • • Usare testo segnaposto generico

Ottimizzazione Crediti

  • 1 Abilita rilevamento intelligente per evitare di elaborare immagini di amministrazione/backend
  • 2 Rivedi testo alt esistente prima dell'elaborazione in blocco per evitare duplicati
  • 3 Usa elaborazione selettiva per immagini che necessitano davvero di testo alt
  • 4 Monitora utilizzo attraverso la dashboard per tracciare il consumo di crediti

Ottimizzazione SEO

Integrazione Parole Chiave

Alt Audit include automaticamente parole chiave rilevanti, ma puoi migliorare la SEO:

  • Rivedendo il testo alt generato per parole chiave del brand
  • Aggiungendo termini specifici della località quando rilevante
  • Includendo nomi prodotti e numeri modello
  • Garantendo coerenza con il contenuto della pagina

Conformità Accessibilità

Assicurati che il tuo testo alt soddisfi gli standard di accessibilità:

  • Mantieni le descrizioni sotto i 125 caratteri quando possibile
  • Concentrati sullo scopo dell'immagine, non solo sull'aspetto
  • Usa testo alt vuoto (alt="") per immagini decorative
  • Testa con screen reader quando possibile

Hai ancora domande? Siamo qui per aiutarti!

Contatta Supporto