dfaimetagen — Generatore IA massivo di meta title, descrizioni e ALT

Panoramica

dfaimetagen genera in massa i tuoi meta title, meta description e tag ALT delle immagini tramite IA (Anthropic Claude, OpenAI GPT o Mistral) su PrestaShop 8 e 9. Il modulo copre 6 tipi di entità (prodotti, categorie, pagine CMS, produttori, fornitori, immagini prodotto), applica pattern CTR collaudati, produce varianti A/B, controlla le lunghezze SERP e rifiuta i duplicati tramite similarità di Jaccard.

Requisiti

• PrestaShop 8.0 a 9.x
• PHP 8.1, 8.2, 8.3 o 8.4
• Estensioni PHP: curl, json, iconv
• MySQL 5.7+ o MariaDB 10.3+
• Una chiave API presso almeno un provider: Anthropic, OpenAI o Mistral

Installazione

1. Scarica dfaimetagen.zip dal tuo account cliente.
2. Nel back-office di PrestaShop, vai su Moduli > Gestore moduli > Carica un modulo.
3. Carica lo ZIP e clicca su Installa.
4. Il modulo crea 6 tabelle nel database (prefisso df_aimeta_), installa 11 pattern CTR predefiniti e genera un token CRON casuale.
5. Una nuova scheda AI Meta Generator appare sotto il menu Catalogo.

Configurazione del provider IA

1. Vai su Catalogo > AI Meta Generator > Impostazioni.
2. Seleziona il tuo provider attivo: Anthropic, OpenAI o Mistral.
3. Incolla la tua chiave API nel campo corrispondente.
4. Clicca sul pulsante Test accanto al campo per verificare la connettività — dovresti ricevere la risposta «OK».
5. I modelli predefiniti sono claude-sonnet-4-5, gpt-4o-mini e mistral-large-latest. Puoi modificarli se preferisci un altro modello dello stesso provider.

Impostazioni di generazione

Sempre in Impostazioni, puoi regolare:

• Limiti di lunghezza — allineati per impostazione predefinita alle raccomandazioni Google SERP: meta title 35–60 caratteri, meta description 120–158, ALT 25–125. Se l’IA supera, il testo viene troncato in modo pulito su un confine di parola.
• Varianti A/B per elemento — da 1 a 5 alternative generate per entità e per lingua.
• Soglia anti-duplicazione — percentuale di similarità di Jaccard oltre la quale una variante viene rifiutata (85 % per impostazione predefinita). Il confronto è insensibile agli accenti.
• Dimensione del lotto — numero di elementi elaborati per tick AJAX o CRON (10 per impostazione predefinita, fino a 100).
• Timeout HTTP — attesa massima di una risposta del provider (60 s per impostazione predefinita).
• Sovrascrivi / Ignora non vuoti — comportamento predefinito verso i meta già compilati.

Avviare una generazione in massa

1. Vai su Catalogo > AI Meta Generator > Bulk Generation.
2. Entità: prodotti, categorie, pagine CMS, produttori, fornitori o immagini prodotto.
3. Campo: meta title, meta description o ALT immagine (gli ALT si applicano alle immagini prodotto).
4. Pattern CTR: scegli un pattern specifico o lascia Auto per usare il pattern predefinito del campo.
5. Lingue: selezione multipla — la generazione si moltiplica (elementi × lingue).
6. Ambito: tutte le entità, per elenco di ID, o per filtro categoria / produttore.
7. Limite: imposta 10 o 20 per un test, 0 per elaborare tutto.
8. Clicca su Crea job.

Monitorare ed eseguire i job

La pagina Jobs elenca tutti i job con il loro avanzamento, le statistiche (riusciti / falliti / ignorati) e lo stato. Tre modalità di esecuzione:

• Esegui fino al completamento (pagina di dettaglio del job) — elabora i lotti in loop via AJAX con barra di avanzamento in tempo reale. Tieni la scheda aperta.
• Esegui un lotto — elabora un singolo lotto e ricarica la pagina.
• CRON — elaborazione in background, consigliata per cataloghi di grandi dimensioni (vedi sotto).

Un job può essere annullato in corso, riavviato dall’inizio o eliminato. La cronologia completa di ogni generazione (stato, token in ingresso/uscita, eventuale errore) è conservata nella scheda Cronologia del dettaglio del job.

Configurare il CRON

1. In Impostazioni, sezione CRON, copia l’URL visualizzato. Ha la forma:
   https://il-tuo-negozio.com/modules/dfaimetagen/cron.php?token=IL_TUO_TOKEN
2. Aggiungilo al crontab del tuo server, ad esempio ogni 5 minuti:
   */5 * * * * curl -s "https://il-tuo-negozio.com/modules/dfaimetagen/cron.php?token=IL_TUO_TOKEN" >/dev/null
3. Ogni passaggio elabora fino a 5 lotti del job in attesa più vecchio. Parametri opzionali: &batch=20 (dimensione del lotto) e &loops=10 (lotti per passaggio).

Varianti A/B e attivazione

Ogni generazione produce il numero di varianti configurato (1 a 5). La prima variante valida viene scritta sull’entità e contrassegnata come Attiva. Le altre restano in riserva nella pagina di dettaglio del job:

• Clicca su Attiva accanto a una variante per scriverla immediatamente sull’entità.
• Le altre varianti dello stesso triplo (entità, campo, lingua) vengono disattivate automaticamente.
• Il contatore di caratteri di ogni variante permette di verificare la conformità SERP a colpo d’occhio.

Pattern CTR

Gli 11 pattern preinstallati coprono tre famiglie:

• Meta title: beneficio + anno, lista numerata, USP tra parentesi, domanda gancio, parole di potere.
• Meta description: accumulo di benefici, prova sociale, problema-soluzione, CTA diretto.
• ALT immagini: descrittivo, contestuale.

Per creare i tuoi pattern, vai su Catalogo > AI Meta Generator > Patterns. Il template accetta token dinamici:

• {NAME}, {BRAND}, {CATEGORY}, {PRICE}, {YEAR}, {NUMBER}, {LANG_NAME} — compilati automaticamente dal modulo;
• {BENEFIT}, {USP}, {CONTEXT} — compilati dall’IA al momento della generazione.

I pattern contrassegnati come «sistema» sono forniti con il modulo e conservati durante gli aggiornamenti.

Template di prompt avanzati

Per un controllo totale del comportamento dell’IA, crea template in Catalogo > AI Meta Generator > Prompt Templates. Ogni template mira a un triplo (entità, campo, lingua — o tutte le lingue) e definisce:

• il system prompt — ruolo, tono, vincoli globali;
• lo user prompt — con i token {NAME}, {BRAND}, {CATEGORY}, {DESCRIPTION}, {PRICE}, {PATTERN}, {LANG_NAME}, {MIN_LENGTH}, {MAX_LENGTH}, {AB_VARIANTS}, {EXISTING}.

Contrassegna un template come «predefinito» affinché si applichi automaticamente al suo triplo.

Anti-duplicazione

Prima di conservare una variante, il modulo la confronta con le varianti già memorizzate:

1. Hash esatto (sha1 della versione normalizzata) — rifiuto immediato in caso di duplicato perfetto.
2. Similarità di Jaccard sugli insiemi di parole normalizzate (minuscole, senza accenti) — rifiuto se la similarità supera la soglia configurata.

Una variante rifiutata viene rigenerata automaticamente dall’IA (entro il limite di tentativi del lotto).

Dashboard

La pagina Dashboard aggrega: numero di job (totale, in attesa, completati), varianti generate e attive, generazioni riuscite / fallite, token consumati (ingresso + uscita), ultimi job e ultime generazioni. Usala per monitorare il budget IA e rilevare gli errori del provider.

Multi-negozio

Il modulo legge e scrive i valori tenendo conto del contesto negozio quando la tabella *_lang interessata possiede una colonna id_shop. Seleziona il negozio di destinazione nel modulo di generazione in massa se la tua installazione è multi-negozio.

Risoluzione dei problemi

• «FAIL» al test di connettività — verifica la chiave API, il saldo crediti del provider, e che il tuo server permetta connessioni HTTPS in uscita (cURL) verso api.anthropic.com, api.openai.com o api.mistral.ai.
• Job bloccato in «running» — rilancia un lotto manualmente dalla pagina di dettaglio, o attendi il prossimo passaggio CRON. Un job può sempre essere annullato e rilanciato.
• Varianti vuote o troncate — aumenta il timeout HTTP nelle Impostazioni, o scegli un modello più veloce.
• 403 sull’URL CRON — il token dell’URL non corrisponde più (potrebbe essere stato rigenerato). Copia di nuovo l’URL dalle Impostazioni.
• Nulla viene generato per alcune entità — se «Ignora non vuoti» è attivo, le entità già compilate vengono saltate di proposito. Spunta «Sovrascrivi» per forzare.

Disinstallazione

La disinstallazione elimina le 6 tabelle del modulo e le sue chiavi di configurazione. I meta generati e già scritti sui tuoi prodotti, categorie e immagini vengono conservati: fanno parte del tuo catalogo.