Documentazione

Tutto ciò che devi sapere per installare, configurare e usare Alt Text IA — dalla prima impostazione alla generazione in massa.

1. Installazione

  1. Dalla tua dashboard WordPress, vai su Plugin > Aggiungi nuovo.
  2. Cerca "Alt Text IA".
  3. Clicca su Installa, poi su Attiva.

Un nuovo menu Impostazioni > Alt Text IA apparirà nella tua dashboard.

2. Ottenere una chiave API (piano gratuito)

In modalità gratuita, usi la tua chiave API personale del provider IA scelto. È gratuita da ottenere, e la maggior parte offre una quota gratuita sufficiente per testare.

Opzione consigliata: Google Gemini (gratis, senza carta)

  1. Vai su aistudio.google.com/apikey
  2. Accedi con un account Google
  3. Clicca su "Create API key"
  4. Copia la chiave generata

Alternativa: OpenAI

  1. Crea un account su platform.openai.com
  2. Vai su API Keys, clicca su "Create new secret key"
  3. Potrebbe essere richiesta una carta di credito a seconda del tuo account (fatturazione a consumo, pochi centesimi per generazione)

Alternativa: Anthropic Claude

  1. Crea un account su console.anthropic.com
  2. Vai su API Keys, crea una nuova chiave

3. Configurazione del plugin

  1. Vai su Impostazioni > Alt Text IA
  2. Scegli il tuo provider IA dal menu a tendina
  3. Incolla la tua chiave API nel campo corrispondente
  4. Indica la lingua di generazione desiderata (es. it_IT per l'italiano)
  5. Verifica che "Genera automaticamente..." sia selezionato
  6. Clicca su Salva
La lingua di generazione non viene rilevata automaticamente dal tuo contenuto: la imposti tu. Se i testi tornano nella lingua sbagliata, controlla prima questo campo.

4. Come funziona

Generazione automatica: a ogni nuovo caricamento di immagine nella tua libreria multimediale, Alt Text IA genera un testo alternativo se l'immagine non ne ha già uno. Un'immagine che ha già un testo alternativo non viene mai modificata.

Analisi della libreria: il pulsante "Analizza la mia libreria" (nelle impostazioni) analizza tutte le immagini esistenti e mostra quante non hanno testo alternativo — disponibile sia in gratuito che in Pro.

Generazione in massa (funzione Pro): elabora automaticamente tutte le immagini rilevate dall'analisi, senza doverle modificare una per una.

5. Limiti del piano gratuito

FunzioneGratuitoPro
Generazione automatica al caricamento10 / meseIllimitata
Chiave APIPersonaleInclusa
Generazione in massa (esistente)—✓

La quota gratuita si azzera automaticamente il 1° di ogni mese.

6. Risoluzione dei problemi

SintomoCausa probabile
Il testo alternativo resta vuoto dopo il caricamentoChiave API mancante o non valida, quota mensile raggiunta, o casella "Generazione automatica" deselezionata
Il testo torna nella lingua sbagliataCorreggi il campo "Lingua di generazione" nelle impostazioni
Non succede nulla su un'immagine già esistenteNormale: la generazione automatica si applica solo ai nuovi caricamenti. Usa "Analizza la mia libreria", poi passa a Pro per elaborare l'esistente in massa
Errore che menziona un "modello" IAIl provider scelto ha cambiato la disponibilità di un modello; il plugin riprova automaticamente con un altro modello disponibile al tentativo successivo
Se il problema persiste dopo aver verificato questi punti, controlla la quota e la validità della tua chiave direttamente sul sito del provider (OpenAI, Google AI Studio o Anthropic Console) — è la causa più frequente.

7. Passare a Pro

Da Impostazioni > Alt Text IA, clicca su "Passa a Pro per sbloccare la generazione in massa". Il pagamento e la gestione delle licenze sono gestiti in modo sicuro da Freemius; nessuna chiave API da configurare in modalità Pro.