Lean Bunker HTML AI – WordPress Plugin

Lean Bunker HTML AI è un plugin WordPress straordinariamente leggero: meno di trenta righe di logica essenziale, racchiuse in un unico file PHP.
Niente shortcode, niente dipendenze, niente bloat. Solo un bottone nell’editor classico che, con l’aiuto dell’intelligenza artificiale, genera HTML pulito, semanticamente corretto e pronto per il tuo tema.

Perfetto per chi crede che la potenza stia nella semplicità.

Download
Lean Bunker HTML AI - 001

📌 Lean Bunker HTML AI – Descrizione Tecnica Granulare

🔹 Nome:

Lean Bunker HTML AI

🔹 Versione:

1.1.0

🔹 Autore:

Riccardo Bastillo

🔹 Licenza:

GPL-3.0+

🔹 Obiettivo primario:

Generare HTML strutturato, semanticamente corretto e stilizzabile direttamente nell’editor classico di WordPress, utilizzando l’intelligenza artificiale (Qwen/Qwen2.5-7B-Instruct-Turbo via Together API), senza shortcode, senza blocchi opachi, senza dipendenze da page builder o Gutenberg.

🔧 Architettura & Filosofia

  • ✅ Single-file: tutto il codice è contenuto in un unico file PHP (lean-bunker-html-ai.php).
  • ✅ Zero bloat: nessuna funzionalità superflua, nessun CSS inline, nessun JS frontend.
  • ✅ Separazione netta tra contenuto e presentazione:
    • Il plugin genera solo HTML con classi semantiche predefinite.
    • Lo stile visivo è interamente delegato al tema.
  • ✅ Compatibilità nativa con WordPress Multisite: ogni sito gestisce autonomamente la propria API key.
  • ✅ Vanilla JavaScript: nessuna dipendenza esterna; usa solo fetch e ajaxurl (già presenti in admin).
  • ✅ Sicurezza integrata: sanitizzazione mirata con wp_kses() personalizzato.

🎛️ Componenti principali

1. Pannello di amministrazione

  • Posizione: Impostazioni → LB HTML AI
  • Campo unico:
    • Together API Key (campo password, con link alla dashboard di Together.xyz)
  • Nessun altro campo: rimossi prompt globale, color picker, opzioni CSS — per evitare configurazioni ridondanti.

2. Metabox nell’editor classico

  • Visibile su: post, pagine e tutti i Custom Post Type pubblici.
  • Campo: textarea per il prompt contestuale (es. “Scrivi una pagina sull’F40 con FAQ e CTA…”).
  • Bottone: “Genera con AI” → chiama l’endpoint AJAX e inserisce l’HTML nel campo #content.

3. Prompt system fisso (non configurabile)

Il plugin invia all’AI un prompt strutturato e immutabile, che garantisce coerenza.

4. Sanitizzazione mirata

Utilizza un array kses personalizzato che permette:

  • Tag semantici: <section>, <h2>, <p>, <ul>, <li>, <blockquote>
  • Elementi interattivi: <details>, <summary>
  • Attributi sicuri: class, href, title
  • Blocca qualsiasi rischio XSS (inline style, script, ID arbitrari).

5. Gestione errori

  • Controlli su: capability utente, nonce, presenza API key, validità risposta AI.
  • Messaggi chiari in caso di errore (es. “API key non configurata”).

6. Correzione compatibilità Query Monitor

  • Registra dinamicamente json2.js se mancante, per evitare warning in ambienti di debug.
  • Non impatta prestazioni né frontend.

🌐 Flusso operativo

  1. L’utente inserisce un prompt specifico nel metabox (es. “Articolo su viaggi in Giappone con tab e CTA”).
  2. Clicca “Genera con AI”.
  3. Il plugin:
    • Combina il prompt con le istruzioni fisse;
    • Chiama Together API con modello Qwen/Qwen2.5-7B-Instruct-Turbo;
    • Riceve HTML puro;
    • Lo sanifica;
    • Lo inserisce nel campo #content.
  4. L’utente può modificare, salvare o pubblicare come normale post.

🧩 Classi HTML generate (standardizzate)

Elemento
Classe HTML
Uso tipico
Sezione
.content-section
Blocco principale di contenuto
Titolo sezione
.section-title
H2 con stile coerente
Pulsante CTA
.cta-button
Link promozionale
Blocco FAQ
.faq-block
Wrapper per domande
Singola FAQ
<details> + <summary>
Espandibile nativo (no JS)

ℹ️ Queste classi sono documentabili e supportabili da qualsiasi tema — ideali per leanpress.

🛡️ Sicurezza & Best Practice

  • Nessun dato esposto in frontend.
  • Tutte le chiamate AJAX protette da nonce e current_user_can().
  • Sanitizzazione rigorosa dell’output AI.
  • Timeout API di 30 secondi.
  • Nessun salvataggio di dati sensibili oltre all’API key (crittografata in DB come opzione normale).

📦 Requisiti

  • WordPress 5.0+
  • PHP 7.4+ (compatibile anche con 8.x)
  • Connessione a Internet (per chiamare Together API)
  • Account Together.xyz con crediti attivi

💡 Casi d’uso ideali

  • Creazione rapida di pagine informative (prodotti, servizi, about).
  • Generazione di contenuti strutturati (FAQ, guide, confronti).
  • Workflow editoriale per agenzie che usano l’editor classico.
  • Ambienti Multisite (leanbunker.italserver.com/sito/...) con temi standardizzati.

🚫 Cosa NON fa

  • ❌ Non genera CSS né stili inline.
  • ❌ Non richiede Gutenberg o page builder.
  • ❌ Non salva modelli, cron job o feed RSS (funzionalità delegate ad altri plugin).
  • ❌ Non espone l’API key in frontend.

🏁 Conclusione

Lean Bunker HTML AI incarna perfettamente i principi del tuo stack:

Leggerezza, controllo, sicurezza, autonomia, compatibilità.

È uno strumento per sviluppatori e editor avanzati che vogliono sfruttare l’AI senza perdere il controllo del markup — ideale per il tuo ecosistema leanpress.

Se lo abbinerai a Lean Bunker Security e a un tema ben strutturato, avrai un sistema scalabile, sicuro e performante, pronto per migliaia di siti.

❓ FAQ – Lean Bunker HTML AI

🔹 Prima dell’installazione

1. Cosa fa esattamente questo plugin?

Genera HTML strutturato (con sezioni, titoli, FAQ, pulsanti CTA, ecc.) direttamente nell’editor classico di WordPress, usando l’intelligenza artificiale. Il risultato è HTML pulito, senza shortcode né blocchi opachi, pronto per essere stilizzato dal tuo tema.

2. Funziona con Gutenberg?

No. È progettato esclusivamente per l’editor classico (TinyMCE). Se usi Gutenberg, questo plugin non è per te — e viceversa: se preferisci l’editor classico, sei nel posto giusto.

3. Di cosa ho bisogno per farlo funzionare?

  • Un sito WordPress con accesso admin.
  • Una API key gratuita da Together.xyz.
  • L’editor classico abilitato (di default su tutti i post/pagine se non usi Gutenberg).

4. È compatibile con Multisite?

Sì. Ogni sito della rete può configurare la propria API key e generare contenuti in autonomia.

5. Quanto pesa il plugin?

Un solo file PHP, meno di 300 righe utili. Zero asset esterni. Zero bloat.

6. Usa OpenAI o ChatGPT?

No. Usa esclusivamente Qwen/Qwen2.5-7B-Instruct-Turbo tramite Together API — più veloce, economico e adatto alla generazione strutturata.

🔹 Dopo l’installazione

7. Dove configuro la mia API key?

Vai in Impostazioni → LB HTML AI e incolla la tua chiave. Non serve altro.

8. Come genero un contenuto?

Modifica un post o una pagina. Nel metabox laterale “Lean Bunker HTML AI”, scrivi un prompt come:

“Scrivi una pagina sulla Ferrari F40 con una FAQ e un pulsante CTA verso /auto/classiche/”
Poi clicca “Genera con AI”.

9. Il testo sostituisce quello esistente?

Sì. Prima di generare, ti chiede conferma. Se vuoi mantenere il testo attuale, copialo altrove.

10. Che classi HTML usa? Posso cambiarle?

Usa classi semantiche fisse:

  • .content-section (per blocchi principali)
  • .section-title (per titoli H2)
  • .cta-button (per link promozionali)
  • .faq-block + <details> (per FAQ espandibili)

Non sono configurabili — ma sono standardizzate, documentate e facili da stilizzare nel tuo tema.

11. Perché non vedo lo stile (colori, bordi, padding)?

Perché il plugin non genera CSS. Lo stile lo gestisce il tuo tema. Aggiungi le regole CSS nel tuo style.css o in un customizer.

12. È sicuro? L’AI potrebbe inserire script malevoli?

No. L’output viene sanitizzato rigorosamente con wp_kses() personalizzato:

  • Blocca <script>, style="", onload, ID arbitrari.
  • Permette solo tag e attributi sicuri.
  • Nessun dato sensibile esce dal backend.

13. Posso usare link interni o esterni?

Sì. Basta indicarli nel prompt:

“Linka ‘scopri di più’ a /servizi/web-design/”
L’AI genererà un <a href="/servizi/web-design/" class="cta-button">.

14. Supporta FAQ, tab, accordion?

Sì — ma in modo nativo e accessibile:

  • Le FAQ usano <details><summary>, funzionanti senza JavaScript.
  • I tab non sono supportati di default (richiedono JS), ma puoi chiedere all’AI di generare una struttura con ancore e sezioni — poi il tuo tema aggiunge l’interattività.

15. Perché vedo un errore “json2 mancante” in Query Monitor?

È un falso positivo legato a plugin di debug. La versione 1.1.1 risolve automaticamente questo avviso. Se usi una versione precedente, aggiorna il plugin.

16. Posso generare contenuti in batch o da RSS?

Non in questo plugin. Questo è uno strumento editoriale manuale. Per generazione automatica, usa Lean Bunker SEO AI (che integra questa logica in cron job e feed).

17. Cosa succede se l’API non risponde?

Il plugin mostra un messaggio di errore (“Errore di rete”) e non modifica il contenuto. Puoi riprovare quando vuoi.

18. Devo pagare per l’uso dell’AI?

Together offre crediti gratuiti al primo accesso (~$25). Ogni generazione costa pochi centesimi di millesimo. Per siti con uso intensivo, valuta un piano a consumo.

19. Posso distribuire questo plugin ai miei clienti?

Sì. È sotto licenza GPL-3.0+, quindi libero di usare, modificare e ridistribuire — purché mantenga la stessa licenza.

20. Chi sviluppa questo plugin?

Riccardo Bastillo, come parte dell’ecosistema Lean Bunker (Security, SEO AI, Checker), pensato per agenzie e sviluppatori che amano il controllo, la semplicità e la scalabilità.

🔹 Bonus: Best practice

  • ✅ Stilizza le classi nel tuo tema, non nel plugin.
  • ✅ Usa prompt specifici: “con FAQ”, “con CTA verso X”, “in 3 sezioni”.
  • ✅ Controlla sempre l’output prima di pubblicare — l’AI è potente, ma non infallibile.
  • ✅ Tieni l’API key segreta: non condividerla, non esporla in frontend.