Come convertire HTML in un tema WordPress: la guida all'app html2wp

Installare l'app che converte HTML in WordPress

Scarica l'app html2wp per un Mac con Apple silicon (M1 o successivo) o per Windows e installala come qualsiasi altra applicazione. La versione per Windows è ancora una Preview, e una versione per Linux arriverà più avanti.

Alla prima apertura fai clic su "Prepare environment" (prepara l'ambiente). L'app scarica tutto quello che le serve. Lo fa una volta sola e ci vuole un po'.

Per lavorare l'app ha bisogno di Docker Desktop, un programma gratuito. Docker fa girare un WordPress temporaneo, dove l'app installa il tema e lo controlla. Se non hai Docker, l'app lo scarica e avvia l'installazione per te. Nel frattempo il computer potrebbe chiederti la password.

Accesso con ChatGPT

La conversione la fa l'AI del tuo abbonamento ChatGPT, quindi non paghi a noi crediti o token.

Nell'app fai clic su "Connect with ChatGPT". L'app ti mostra un codice di 9 caratteri e apre una pagina di OpenAI nel browser. Lì scegli il tuo account ChatGPT o accedi.

Poi la pagina ti chiede un codice “dal terminale” e nomina Codex CLI. Va bene così: html2wp usa Codex, e il codice che la pagina vuole è quello dell'app. Incollalo (fai clic sul codice nell'app per copiarlo) e premi "Continue". Dopo l'accesso, l'app si aggiorna da sola.

Nuovo progetto: l'HTML che converti in un tema WordPress

Fai clic su "New project" e scegli la cartella o lo ZIP con il tuo sito. Può essere un export da Lovable, Bolt o v0, un design di Claude o un semplice sito HTML. L'app non accetta l'indirizzo di un sito (URL), perché le servono i file da cui il sito è costruito.

L'app capisce da sola quale pagina è la home e quale è il blog, un articolo o un prodotto.

Poi scegli cosa vuoi ottenere. Di solito converti l'HTML in un tema WordPress, in modalità Flash o Full. Se WordPress non ti serve, scegli invece un progetto Astro 5. Quella conversione è più breve, e il sito finito lo pubblichi direttamente dall'app su Cloudflare Pages, dove puoi ospitarlo gratis.

Flash o Full: due modi per convertire HTML in WordPress

Flash è la conversione rapida, ed è quella predefinita nell'app. Ogni passaggio gira una volta. Menu, blog, negozio e moduli vengono riconosciuti e collegati subito. Anche i controlli girano una volta, e i risultati li trovi nel report. Ci vuole circa mezz'ora, e va bene per la maggior parte dei siti e per una prova veloce.

Full è la conversione accurata. Esegue ogni controllo e prova a correggere gli errori che trova. Ci vuole circa un'ora e consuma una parte maggiore del limite del tuo abbonamento ChatGPT. Conviene quindi per i siti più complessi, o quando Flash ha lasciato nel report molti punti da rifinire.

Entrambe le modalità convertono il tuo HTML in un tema WordPress utilizzabile e aggiungono una nota su ciò che resta da fare. Il tempo esatto dipende dal numero di pagine e dalla velocità del tuo computer.

Scegliere il modello per convertire HTML in un tema

Nell'app scegli il modello di AI e il livello di ragionamento ("Reasoning effort").

• GPT-6-Luna a "Extra high" basta per le conversioni normali. Costa poco, consuma poco del limite del tuo abbonamento e gestisce da solo la maggior parte dei siti.
• GPT-6-Sol a "Medium" o "High" è quello che consigliamo quando c'è qualcosa da correggere, per esempio in una conversione Full o per le modifiche tramite la chat.
• GPT-6-Astra è il modello più forte e più caro. Per il lavoro normale non ti serve, ma aiuta quando nemmeno Sol riesce a risolvere un problema.

Puoi cambiare modello quando nessuna conversione è in corso. Ogni progetto può avere il suo.

Controllare il tema WordPress rispetto al tuo HTML

Quando la conversione finisce, l'app te lo segnala. Se qualcosa non va, prima prova a correggerlo da sola. In ogni caso consegna sempre un tema utilizzabile, con una nota su cosa rifinire.

Nella scheda "Preview" fai clic su "Open website" e guarda il nuovo sito nel browser. La scheda "Compare" mostra l'originale e la conversione affiancati, con la differenza in percentuale. Scrivi nella chat quello che non ti piace e l'app lo corregge. Poi salva le modifiche finite come nuova versione con "Make release".

L'app elenca nel report ogni differenza che trova. Guarda le pagine segnalate prima di consegnare il tema a un cliente. Lo ZIP del tema lo salvi nella scheda "Exports" e lo carichi in WordPress da Aspetto → Temi → Aggiungi nuovo → Carica tema.

Dati e privacy

Il tema lo costruisce il nostro server. Gran parte del lavoro però (misurare, confrontare con l'originale e correggere) gira sul tuo computer, e lo guida l'AI del tuo account ChatGPT. OpenAI tratta ciò su cui lavora l'AI secondo i termini del tuo account.

Cosa viene inviato al server

Il tuo sito convertito in un progetto Astro (pagine, stili, script, immagini e font), più le informazioni su ogni pagina. La cartella originale del progetto e le librerie installate (node_modules) non vengono inviate. I dati caricati si cancellano in automatico dopo 48 ore. Resta solo un'impronta (hash), grazie alla quale una riesecuzione conta come una sola conversione.

File con password e chiavi

I file che sembrano credenziali di accesso non entrano mai nel pacchetto: .env, chiavi (.pem, .key, id_rsa), .npmrc, .netrc, le cartelle .ssh e .aws, o qualsiasi file con una chiave privata. Tutto quello che l'app ha escluso lo trovi per nome nel report.

Risultati dei controlli

Dopo aver testato il tema, l'app invia solo i risultati dei controlli: quali sono passati e quali no, il numero di pagine, la differenza più grande rispetto all'originale e i nomi brevi delle pagine fallite (per esempio “about”). Non invia l'indirizzo del sito, il dominio, il codice, i testi, gli screenshot, i percorsi dei file, la chiave di licenza o il nome del sito.

I controlli girano sul WordPress del tuo computer, che il nostro server non vede mai. Senza i loro risultati il server saprebbe solo che la conversione non si è bloccata. Per questo la conversione successiva parte solo dopo che la precedente ha inviato i suoi risultati. L'app li invia in automatico. La descrizione completa è nella pagina sulla privacy.

Modificare con Visual Edit

Un sito che converti da HTML in un tema WordPress non ha bisogno di plugin per funzionare. Pagine, blog, moduli, menu, SEO e reindirizzamenti fanno tutti parte del tema. I reindirizzamenti portano dai vecchi indirizzi ai nuovi: chi apre il vecchio link /about.html arriva su /about/, così il sito conserva le sue posizioni nei motori di ricerca.

Le modifiche con un clic arrivano da Visual Edit, un plugin WordPress che aggiungi tu. Cambia esattamente quello su cui fai clic. Nessun page builder ricostruisce il codice della pagina sotto.

Pro è una licenza annuale separata, nella pagina dei prezzi. Ogni conversione, Free o Pro, rimanda alla versione Lite gratuita. Se disattivi il plugin, le pagine continuano a funzionare e il tema resta del tutto utilizzabile.

Licenza, abbonamento, beta

Riesecuzioni

Con il piano gratuito hai 5 riesecuzioni in totale su tutte le conversioni, con una licenza Pro sono illimitate. Una riesecuzione è lo stesso sito caricato di nuovo. Il server lo riconosce dall'impronta (hash), quindi conta come riesecuzione e non come nuova conversione.

Gestire e annullare l'abbonamento

L'abbonamento lo gestisci nella pagina dell'abbonamento. Il link è nel footer del sito e in ogni email sulla licenza. Nel portale clienti di Paddle puoi annullare l'abbonamento, cambiare la carta, scaricare le fatture e passare Pro da mensile ad annuale. Accedi con un link inviato all'email usata per l'acquisto, quindi non ti serve una password.

L'annullamento blocca il prossimo rinnovo. La chiave funziona fino alla fine del periodo pagato, e ogni tema convertito resta tuo. Annullare non è un rimborso: i rimborsi seguono le condizioni di rimborso.

Cosa significa beta

html2wp converte siti reali e si usa per lavori reali. L'app confronta ogni pagina con l'originale a 1440 e 390 px ed elenca nel report ogni differenza che trova. Se un controllo fallisce, l'app consegna il miglior tema utilizzabile con la descrizione di cosa resta da sistemare. Prima di promettere un risultato a un cliente, guarda le pagine segnalate.

Se trovi un bug nel convertitore stesso, segnalalo come spiega la documentazione del plugin. Lo legge una persona, e le correzioni arrivano con gli aggiornamenti del servizio.