Versioni del plugin

Terza patch della linea 1.x. Wiring completo del canale di notifica update: quando pubblichiamo una nuova versione Pro, il tuo WordPress la vede entro un'ora e ti avvisa con una notice ben visibile in tutte le pagine admin, non solo in /plugins.php.

🔔 Notice sitewide di update disponibile

In tutte le pagine dell'admin WordPress appare un banner ben visibile quando è pronta una versione più recente della Pro:

🎉 Innova GEO AI Indexer Pro v1.0.5 è disponibile — hai la v1.0.3 installata. [preview 200 char del changelog] [Aggiorna ora] · Vedi changelog · Ricordamelo tra 24h · Non mostrare più per questa versione

Le quattro azioni della notice:

• Aggiorna ora — deep-link con nonce corretto a WordPress: un solo click e parte il download + install. Nessun passaggio per la pagina Plugin.
• Vedi changelog — modale nativa WordPress (Thickbox) con le release notes complete della versione disponibile.
• Ricordamelo tra 24h — la notice sparisce per un giorno intero (transient sitewide) per non intralciarti in una sessione di lavoro urgente.
• Non mostrare più per questa versione — dismiss per-utente della versione specifica. Se pubblichiamo una versione ancora più recente, la notice ricompare automaticamente.

Richiede la capability WordPress update_plugins (solo admin la vedono). Rispetta le convenzioni WordPress per i notice dismissable.

⚡ Polling ogni ora (invece di ogni 12h)

Il WP core di default controlla gli update dei plugin ogni 12 ore. Per le nostre release Pro abbiamo aggiunto un cron dedicato innogai22_pro_update_check che gira ogni ora e forza il refresh del cache remote. Nessuna nuova versione ti resta invisibile più a lungo del tempo di preparare un caffè.

Il polling è protetto da timeout 5 secondi, retry silenzioso su errore, e caching robusto — se il server geocite22 è temporaneamente giù non generiamo errori PHP né rallentiamo l'admin.

🔧 Aggiornamento nativo WordPress

La 1.0.3 ora si integra correttamente con l'infrastruttura update nativa di WordPress:

• La pagina Plugin mostra il badge "Aggiornamento disponibile" con il link diretto a "Aggiorna ora", esattamente come per i plugin di WordPress.org
• Il link "Vedi i dettagli della versione X.Y.Z" apre il popup modale nativo di WordPress con description, changelog, autore, requisiti PHP e WordPress
• La colonna "Ultimo aggiornamento" mostra la data di pubblicazione della versione remota

Prima di questa release il canale di notifica non era completamente cablato: l'header Update URI era dichiarato nel bootstrap del plugin ma WordPress non aveva codice a cui agganciarsi. Se hai la Pro attiva da prima della 1.0.3 e non hai mai visto una notifica di update, adesso sai perché.

🛡️ Nessuna azione richiesta

Aggiornamento zero-friction: nessuna modifica DB, nessuna migration, nessuna interruzione della license attiva. Il cron viene registrato al primo boot dopo l'update.

Nota: essendo questa la release che cabla il canale di notifica, l'installazione della 1.0.3 stessa dovrai farla manualmente scaricando lo ZIP dalla tua area riservata su geocite22.com (o dall'email che hai ricevuto all'acquisto). Dalla 1.0.3 in poi, tutte le versioni successive arriveranno con notifica automatica.

Prima minor patch dopo la 1.0.0. Introduce la colonna GEO nelle screen list admin di WordPress e sistema due bug della generazione multi-campo scoperti in pre-release.

✨ Nuova feature: colonna GEO nelle liste admin

Nelle screen list di Articoli, Pagine e qualsiasi Custom Post Type con i campi GEO attivi compare una nuova colonna che mostra colpo d'occhio quanti campi sono stati compilati sul totale, con indicatore semaforico.

• Formato N/M — es. 12/14 significa 12 campi GEO compilati su 14 totali attivi
• Indicatore semaforico: 🟢 verde se completeness ≥ 80% · 🟡 giallo se 40-79% · 🔴 rosso se < 40%
• Tooltip al passaggio del mouse con la percentuale esatta
• Toggleable dalla tab nativa "Opzioni schermata" di WordPress (in alto a destra della lista): basta togliere o aggiungere la spunta a "GEO". Preferenza per-utente, persistente
• Conteggio adaptive: M cambia in base ai campi effettivamente attivi (5 con solo Base, 14 con Pro, meno se hai disabilitato campi via Impostazioni)

Utile per audit periodici e per priorizzare il lavoro editoriale su archivi grandi (100+ post) senza aprire ogni singolo articolo.

Personalizzazione avanzata per sviluppatori — le soglie del semaforo sono modificabili via filter innogai22_pro_completeness_thresholds che accetta un array [soglia_verde, soglia_gialla] con valori tra 0 e 1.

🐛 Fix: la generazione multi-campo popolava solo 4 campi

Il pannello "Genera con AI (multi-campo)" riceveva correttamente dal provider AI tutti i campi richiesti, ma il JavaScript lato editor era in grado di renderizzare solo i campi scalari (Quick Answer, Direct Definition, Target Queries, Livello autorialità). I 6 campi REPEATER — FAQ, Key Takeaways, Fonti citate, Statistiche chiave, Entità correlate, Voci ItemList — venivano silenziosamente droppati. Ora tutti gli AI-generable vengono popolati correttamente in una sola chiamata AI.

🐛 Fix: Target Queries salvate come CSV invece che una per riga

Il tool schema definisce Target Queries come array di stringhe. Il JavaScript le convertiva con String(array) producendo "query1,query2,query3" (formato CSV di JavaScript) invece che una per riga come atteso dalla textarea. Ora vengono correttamente separate da a-capo, come da specifica del campo Textarea (una per riga).

🛡️ Nessuna azione richiesta

Aggiornamento zero-friction: nessuna modifica DB, nessuna migration, i fix sono lato JavaScript e admin PHP. Update automatico dall'admin WordPress.

Patch che aggiunge la colonna GEO nelle screen list dell'admin WordPress (Articoli, Pagine e qualsiasi Custom Post Type con i campi GEO abilitati). Ogni riga mostra colpo d'occhio quanti campi sono stati compilati sul totale, con indicatore semaforico.

✨ Cosa aggiunge

• Colonna "GEO" in wp-admin/edit.php (posizionata dopo il titolo del post)
• Formato N/M — es. 12/14 significa 12 campi GEO compilati su 14 totali attivi
• Indicatore semaforico:
  • 🟢 verde se completeness ≥ 80% — pronto per la pubblicazione
  • 🟡 giallo se 40-79% — parziale, migliorabile
  • 🔴 rosso se < 40% — da compilare
• Tooltip al passaggio del mouse con percentuale esatta

⚙️ Come attivarla o nasconderla

La colonna è toggleable dalla tab nativa "Opzioni schermata" di WordPress (in alto a destra della pagina lista): basta togliere/aggiungere la spunta a "GEO". Nessuna configurazione aggiuntiva richiesta — la preferenza è per-utente e persistente.

🧠 Conteggio adaptive

Il totale M cambia in base ai campi effettivamente attivi:

• Solo Base attivo: M = 5 (i 5 campi core del plugin free)
• Pro attivo: M = 14 (5 core + 9 advanced)
• Se hai disabilitato uno o più campi via Impostazioni: M cala di conseguenza

Non serve fare nulla — la colonna si aggiorna automaticamente al cambio di configurazione.

🚀 Perché è utile

Se gestisci siti con centinaia o migliaia di post, ora puoi vedere colpo d'occhio dove intervenire senza aprire ogni singolo post. Perfetto per audit periodici e per priorizzare il lavoro editoriale su ciò che ancora non è pronto per essere citato dalle AI.

🔧 Personalizzazione avanzata

Sviluppatori: le soglie del semaforo sono personalizzabili via filter:

add_filter('innogai22_pro_completeness_thresholds', function () {
    return [0.9, 0.5]; // verde ≥ 90%, giallo ≥ 50%
});

Prima release ufficiale di Innova GEO AI Indexer Pro, l'add-on premium per il plugin free su WordPress.org.

Richiede il plugin base innova-geo-ai-indexer ≥ 3.0.0 installato e attivo, WordPress ≥ 6.4 e PHP ≥ 8.1.

✨ Feature incluse

• 9 campi GEO advanced: Key Takeaways, Target Queries, Fonti citate, Statistiche chiave, Entità correlate (con sameAs Wikidata), Tipo Schema primario (HowTo / Recipe / …), Livello autorialità, Ultima verifica dati, Voci ItemList per listicle.
• Generazione multi-campo in un solo click dal metabox: selezioni i campi da generare tutti insieme, una sola chiamata AI, un solo consumo di token.
• Page builder support: se usi Elementor / Divi / Beaver Builder o blocchi con contenuto dinamico, il Pro può inviare all'AI il testo estratto dall'HTML pubblico della pagina invece del solo post_content — quello che vede realmente il lettore.
• Output frontend dei campi: Quick Answer / FAQ / Takeaways visibili ai lettori dell'articolo, non solo nel JSON-LD. Auto-inject nel contenuto, shortcode o blocchi Gutenberg — per campo, con posizione configurabile.
• Custom post types + matrix: abilita i campi GEO su qualsiasi CPT e sceglie quali mostrare per ogni tipo (es. FAQ solo su guide, ItemList solo su listicle).
• Debug log + export JSON: toggle in Impostazioni che cattura ogni generazione AI con dettagli tecnici estesi, esportabile in JSON dalla pagina Supporto per allegare a un ticket.
• Supporto prioritario: SLA 48h lavorative via email.

🛡️ Licensing

• License key nel formato INNOGAI22-XXXX-XXXX-XXXX — validazione remota su geocite22.com con cache 12h.
• Grace period di 7 giorni dopo la scadenza: le feature Pro restano attive per evitare interruzioni accidentali.
• Alla scadenza definitiva, le feature Pro si disattivano gracefully — i 5 campi core, il JSON-LD e il llms.txt del plugin free continuano a funzionare senza perdita dati.

🔄 Aggiornamenti

Aggiornamenti automatici dall'admin WordPress via update-checker integrato — nessuna configurazione manuale.