HTML omzetten naar een WordPress-thema: de html2wp-app stap voor stap

De app installeren om HTML naar WordPress om te zetten

Download de html2wp-app voor een Mac met Apple silicon (M1 of nieuwer) of voor Windows, en installeer hem zoals elke andere applicatie. De Windows-versie is nog een preview, en later komt er een Linux-versie.

Klik bij de eerste start op "Prepare environment" (omgeving voorbereiden). De app downloadt dan alles wat hij nodig heeft. Dat gebeurt maar één keer, en het duurt even.

Voor zijn werk heeft de app Docker Desktop nodig, een gratis programma. Docker draait een tijdelijke WordPress, waarin de app het thema installeert en controleert. Heb je geen Docker, dan downloadt de app het en start hij het installatieprogramma voor je. Je computer kan onderweg om je wachtwoord vragen.

Inloggen met ChatGPT

De conversie wordt gedaan door de AI uit je ChatGPT-abonnement, dus je betaalt ons niets voor credits of tokens.

Klik in de app op "Connect with ChatGPT". De app toont je een code van 9 tekens en opent een pagina van OpenAI in je browser. Kies daar je ChatGPT-account of log in.

Daarna vraagt de pagina om een code “uit de terminal” en noemt ze Codex CLI. Dat klopt: html2wp gebruikt Codex, en de code die de pagina wil, is die uit de app. Plak hem erin (klik op de code in de app om hem te kopiëren) en klik op "Continue". Na het inloggen werkt de app zichzelf bij.

Nieuw project: de HTML die je omzet naar een WordPress-thema

Klik op "New project" en kies de map of ZIP met je site. Dat kan een export uit Lovable, Bolt of v0 zijn, een ontwerp uit Claude of een gewone HTML-site. Een adres van een site (URL) accepteert de app niet, want hij heeft de bestanden nodig waaruit de site is opgebouwd.

De app zoekt zelf uit welke pagina de homepage is en welke de blog, een artikel of een product.

Kies daarna wat je wilt krijgen. Meestal zet je de HTML om naar een WordPress-thema, in de modus Flash of Full. Heb je geen WordPress nodig, kies dan een Astro 5-project. Die conversie is korter, en je kunt de afgewerkte site direct vanuit de app online zetten op Cloudflare Pages, waar je hem gratis kunt hosten.

Flash of Full: twee manieren om HTML naar WordPress om te zetten

Flash is de snelle conversie, en de standaard in de app. Elke stap draait één keer. Menu's, blog, shop en formulieren worden meteen herkend en gekoppeld. De controles draaien ook één keer, en hun resultaten vind je in het rapport. Het duurt ongeveer een half uur en past bij de meeste sites, en bij een snelle test.

Full is de grondige conversie. Ze draait elke controle en probeert de fouten die ze vindt op te lossen. Het duurt ongeveer een uur en gebruikt meer van de limiet van je ChatGPT-abonnement. Het loont dus bij complexere sites, of als Flash in het rapport veel punten om af te werken achterliet.

Beide modi zetten je HTML om naar een bruikbaar WordPress-thema en voegen een notitie toe over wat er nog over is. De precieze tijd hangt af van het aantal pagina's en de snelheid van je computer.

Een model kiezen om HTML om te zetten naar een thema

In de app kies je het AI-model en het denkniveau (Reasoning effort).

• GPT-6-Luna op Extra high is genoeg voor gewone conversies. Het is goedkoop, gebruikt weinig van je abonnementslimiet en redt de meeste sites alleen.
• GPT-6-Sol op Medium of High raden we aan als er iets moet worden gerepareerd, bijvoorbeeld bij een Full-conversie of voor aanpassingen via de chat.
• GPT-6-Astra is het sterkste en duurste model. Voor gewoon werk heb je het niet nodig, maar het helpt als zelfs Sol een probleem niet oplost.

Je kunt het model wisselen zolang er geen conversie loopt. Elk project kan een eigen model hebben.

Het WordPress-thema controleren naast je HTML

Is de conversie klaar, dan laat de app het je weten. Lukt er iets niet, dan probeert hij het eerst zelf op te lossen. Hoe dan ook levert hij altijd een bruikbaar thema op, met een notitie over wat er nog af te werken is.

Klik in het tabblad "Preview" op "Open website" en bekijk de nieuwe site in je browser. Het tabblad "Compare" toont het origineel en de conversie naast elkaar, met het verschil in procenten. Typ in de chat wat je niet bevalt, en de app past het aan. Sla daarna de afgewerkte wijzigingen op als nieuwe versie met "Make release".

De automatische controles vangen de meeste verschillen op, maar niet allemaal. Loop de pagina's daarom door voordat je het thema aan een klant geeft. De ZIP met het thema sla je op in het tabblad "Exports", en je uploadt hem in WordPress onder Weergave → Thema's → Nieuw thema toevoegen → Thema uploaden.

Gegevens en privacy

Onze server bouwt het thema. Het meeste werk (meten, vergelijken met het origineel en repareren) draait echter op je computer, en de AI in je ChatGPT-account stuurt het aan. OpenAI verwerkt waar de AI aan werkt onder de voorwaarden van je account.

Wat naar de server gaat

Je site, omgezet naar een Astro-project (pagina's, stijlen, scripts, afbeeldingen en lettertypen), plus informatie over elke pagina. De oorspronkelijke projectmap en de geïnstalleerde bibliotheken (node_modules) gaan niet mee. De geüploade gegevens worden na 48 uur automatisch verwijderd. Alleen een vingerafdruk (hash) blijft, en daardoor telt een herhaalde run als één conversie.

Bestanden met wachtwoorden en sleutels

Bestanden die op inloggegevens lijken, gaan nooit mee in het pakket: .env, sleutels (.pem, .key, id_rsa), .npmrc, .netrc, de mappen .ssh en .aws, of elk bestand met een privésleutel. Alles wat de app heeft weggelaten, vind je bij naam in het rapport.

Resultaten van de controles

Nadat de app het thema heeft getest, stuurt hij alleen de resultaten van de controles: welke controles slaagden en welke niet, aantallen pagina's, het grootste verschil met het origineel en de korte namen van de pagina's die faalden (bijvoorbeeld “about”). Hij stuurt geen adres van de site, domein, code, tekst, screenshots, bestandspaden, licentiesleutel of naam van de site.

De controles draaien tegen de WordPress op je computer, die onze server nooit ziet. Zonder hun resultaten zou de server alleen weten dat de conversie niet is gecrasht. Daarom start de volgende conversie pas als de vorige haar resultaten heeft gestuurd. De app stuurt ze automatisch. De volledige beschrijving staat op de privacypagina.

Bewerken met Visual Edit

Een site die je van HTML naar een WordPress-thema omzet, heeft geen plugin nodig om te draaien. Pagina's, blog, formulieren, menu's, SEO en redirects horen allemaal bij het thema. De redirects sturen oude adressen door naar nieuwe: wie de oude link /about.html opent, komt op /about/ terecht, zodat de site haar posities in zoekmachines houdt.

Bewerken met aanwijzen en klikken komt van Visual Edit, een WordPress-plugin die je zelf toevoegt. Wat je aanklikt, verandert. Geen page builder bouwt de paginacode eronder opnieuw op.

Pro is een aparte jaarlicentie op de prijspagina. Elke conversie, Free of Pro, linkt naar de gratis versie Lite. Zet je de plugin uit, dan worden de pagina's gewoon weergegeven en blijft het thema volledig bruikbaar.

Licentie, abonnement, bèta

Herhaalde runs

In de gratis versie heb je in totaal 5 herhaalde runs voor al je conversies samen, en met een Pro-licentie zijn ze onbeperkt. Een herhaalde run is dezelfde site die opnieuw wordt geüpload. De server herkent hem aan zijn vingerafdruk (hash), dus hij telt als herhaalde run en niet als nieuwe conversie.

Je abonnement beheren en opzeggen

Je beheert je abonnement op de abonnementspagina. De link staat in de footer van de site en in elke e-mail over je licentie. In het klantenportaal van Paddle kun je het abonnement opzeggen, je kaart wijzigen, facturen downloaden en Pro van maandelijks naar jaarlijks overzetten. Je logt in met een link die naar het e-mailadres van je aankoop wordt gestuurd, dus je hebt geen wachtwoord nodig.

Opzeggen stopt de volgende verlenging. Je sleutel werkt tot het einde van de betaalde periode, en elk thema dat je hebt omgezet, blijft van jou. Opzeggen is geen terugbetaling: terugbetalingen volgen de voorwaarden voor terugbetaling.

Wat bèta betekent

html2wp zet echte sites om en wordt voor echt werk gebruikt. De app vergelijkt elke pagina met het origineel op 1440 en 390 px en zet elk verschil dat hij vindt in het rapport, samen met het beste bruikbare thema. Zo bekijk je de gemarkeerde pagina's voordat je ze oplevert. Beloof een klant geen resultaat dat je niet hebt bekeken.

Vind je een fout in de converter zelf, meld die dan zoals de documentatie van de plugin beschrijft. Een mens leest de melding, en oplossingen komen als updates van de dienst.