html2wp / Documentation

Convertir HTML en WordPress : créer un thème dans l'app html2wp

Ce guide montre comment convertir HTML en WordPress, sous forme de thème, dans l'app de bureau html2wp. Il couvre l'installation de l'app, votre première conversion, le choix d'un modèle, ce qui quitte votre ordinateur et la modification du site fini. La conversion avec un agent dans le terminal est décrite dans la documentation du plugin pour Claude Code et Codex.

Première partieVotre première conversion

Installer l'app pour convertir HTML en WordPress

Téléchargez l'app html2wp pour un Mac avec puce Apple (M1 ou plus récent) ou pour Windows, et installez-la comme n'importe quelle application. La version Windows est encore en Preview, et une version Linux arrivera plus tard.

À la première ouverture, cliquez sur "Prepare environment" (préparer l'environnement). L'app télécharge alors tout ce dont elle a besoin. Elle ne le fait qu'une fois, et cela prend un moment.

Pour travailler, l'app a besoin de Docker Desktop, un programme gratuit. Docker fait tourner un WordPress temporaire, dans lequel l'app installe le thème et le vérifie. Si vous n'avez pas Docker, l'app le télécharge et lance l'installateur pour vous. Votre ordinateur peut vous demander votre mot de passe en cours de route.

Se connecter avec ChatGPT

La conversion est faite par l'IA de votre abonnement ChatGPT : vous ne nous payez ni crédits ni tokens.

Dans l'app, cliquez sur "Connect with ChatGPT". L'app affiche un code de 9 caractères et ouvre une page OpenAI dans votre navigateur. Sur cette page, choisissez votre compte ChatGPT ou connectez-vous.

La page vous demande ensuite un code « depuis le terminal » et mentionne Codex CLI. C'est normal : html2wp utilise Codex, et le code attendu est celui de l'app. Collez-le (cliquez sur le code dans l'app pour le copier) puis cliquez sur "Continue". Une fois connecté, l'app se met à jour toute seule.

Seul OpenAI voit votre mot de passe

Vous tapez votre mot de passe ChatGPT uniquement sur la page OpenAI, et l'app ne le voit jamais. N'envoyez le code à personne, et ne le saisissez que si vous avez lancé la connexion vous-même.

Nouveau projet : convertir HTML en WordPress depuis un dossier

Cliquez sur "New project" et choisissez le dossier ou le ZIP de votre site. Ce peut être un export de Lovable, Bolt ou v0, un design de Claude ou un simple site HTML. L'app n'accepte pas l'adresse d'un site (URL), car il lui faut les fichiers dont le site est fait.

L'app détermine seule quelle page est l'accueil, et lesquelles sont le blog, un article ou un produit.

Choisissez ensuite ce que vous voulez obtenir. En général, vous convertissez le HTML en thème WordPress, en mode Flash ou Full. Si vous n'avez pas besoin de WordPress, choisissez plutôt un projet Astro 5. Cette conversion est plus courte, et vous pouvez déployer le site fini directement depuis l'app sur Cloudflare Pages, où l'hébergement peut être gratuit.

Flash ou Full : deux façons de convertir HTML en WordPress

Flash est la conversion rapide, et c'est le mode par défaut de l'app. Chaque étape tourne une fois. Menus, blog, boutique et formulaires sont reconnus et branchés tout de suite. Les contrôles tournent aussi une fois, et leurs résultats sont dans le rapport. Comptez environ une demi-heure. Ce mode convient à la plupart des sites, et aussi pour un essai rapide.

Full est la conversion approfondie. Elle lance tous les contrôles et essaie de corriger les erreurs trouvées. Elle prend environ une heure et consomme davantage de la limite de votre abonnement ChatGPT. Ce mode vaut donc le coup pour les sites plus complexes, ou quand Flash a laissé beaucoup de points à peaufiner dans le rapport.

Les deux modes transforment votre HTML en thème WordPress utilisable et ajoutent une note sur ce qui reste à faire. La durée exacte dépend du nombre de pages et de la vitesse de votre ordinateur.

Choisir un modèle pour convertir HTML en WordPress

Dans l'app, vous choisissez le modèle d'IA et le niveau de raisonnement ("Reasoning effort").

  • GPT-6-Luna en Extra high suffit pour les conversions courantes. Il coûte peu, consomme peu de la limite de votre abonnement et gère seul la plupart des sites.
  • GPT-6-Sol en Medium ou High est notre recommandation quand quelque chose doit être corrigé, par exemple dans une conversion Full ou pour des retouches via le chat.
  • GPT-6-Astra est le modèle le plus puissant et le plus cher. Vous n'en avez pas besoin au quotidien, mais il aide lorsque même Sol ne vient pas à bout d'un problème.

Vous pouvez changer de modèle dès qu'aucune conversion n'est en cours. Chaque projet peut avoir le sien.

Convertir HTML en WordPress, puis vérifier le thème

À la fin de la conversion, l'app vous prévient. Si quelque chose ne fonctionne pas, elle essaie d'abord de le corriger seule. Dans tous les cas, elle livre toujours un thème utilisable avec une note sur ce qu'il reste à peaufiner.

Dans l'onglet "Preview", cliquez sur "Open website" et regardez le nouveau site dans votre navigateur. L'onglet "Compare" (comparer) montre l'original et la conversion côte à côte, avec l'écart en pourcentage. Écrivez dans le chat ce qui ne vous plaît pas, et l'app le corrige. Enregistrez ensuite les modifications terminées comme nouvelle version avec "Make release".

Les contrôles automatiques repèrent la plupart des différences, mais pas toutes. Parcourez donc les pages avant de remettre le thème à un client. Vous enregistrez le ZIP du thème dans l'onglet "Exports" et l'envoyez dans WordPress via Apparence → Thèmes → Ajouter un thème → Téléverser un thème.

Deuxième partieEnsuite

Données et confidentialité

Notre serveur construit le thème. La plus grande partie du travail (mesure, comparaison avec l'original et corrections) tourne pourtant sur votre ordinateur, pilotée par l'IA de votre compte ChatGPT. OpenAI traite ce sur quoi travaille l'IA selon les conditions de votre compte.

Ce qui est envoyé au serveur

Votre site converti en projet Astro (pages, styles, scripts, images et polices), avec des informations sur chaque page. Le dossier d'origine du projet et les bibliothèques installées (node_modules) ne sont pas envoyés. Les données envoyées sont supprimées automatiquement après 48 heures. Seule une empreinte (hash) reste, et grâce à elle une relance compte comme une seule conversion.

Fichiers avec mots de passe et clés

Les fichiers qui ressemblent à des identifiants n'entrent jamais dans l'envoi : .env, les clés (.pem, .key, id_rsa), .npmrc, .netrc, les dossiers .ssh et .aws, ou tout fichier contenant une clé privée. Le rapport liste par leur nom tous les fichiers que l'app a écartés.

Résultats des contrôles

Après avoir testé le thème, l'app n'envoie que les résultats des contrôles : ceux qui ont réussi et ceux qui ont échoué, le nombre de pages, le plus grand écart avec l'original et le nom court des pages en échec (par exemple « about »). Elle n'envoie ni l'adresse du site, ni le domaine, ni le code, le texte, les captures d'écran, les chemins de fichiers, la clé de licence ou le nom du site.

Les contrôles tournent sur le WordPress de votre ordinateur, que notre serveur ne voit jamais. Sans leurs résultats, le serveur saurait seulement que la conversion n'a pas planté. C'est pourquoi la conversion suivante ne démarre qu'une fois que la précédente a envoyé ses résultats. L'app les envoie automatiquement. La description complète se trouve sur la page sur les données.

Modifier avec Visual Edit

Un site converti de HTML en thème WordPress n'a besoin d'aucune extension pour fonctionner. Pages, blog, formulaires, menus, SEO et redirections font tous partie du thème. Les redirections envoient les anciennes adresses vers les nouvelles : qui ouvre l'ancien lien /about.html arrive sur /about/, et le site garde son positionnement dans les moteurs de recherche.

La modification par clic vient de Visual Edit, une extension WordPress que vous ajoutez vous-même. Ce que vous cliquez est ce qui change. Aucun constructeur de pages ne reconstruit le code de la page en dessous.

FonctionLite (gratuit)Pro
Textes, images et liens en un clic✓✓
Formulaires, menus et champs SEO✓✓
Historique des modifications10 étapes300 étapes
Assistant IA (votre propre clé API OpenRouter)–✓
Retouche d'images par IA et animations à partir d'images–✓
Export du thème et protection des formulaires avec Turnstile–✓

Pro est une licence annuelle distincte, sur la page des tarifs. Chaque conversion, Free ou Pro, renvoie vers la version gratuite Lite. Si vous désactivez l'extension, les pages s'affichent toujours et le thème reste entièrement utilisable.

Licence, abonnement, bêta

Relances

Avec l'offre gratuite, vous avez 5 relances au total, toutes conversions confondues, et avec une licence Pro elles sont illimitées. Une relance, c'est le même site envoyé une nouvelle fois. Le serveur le reconnaît à son empreinte (hash) : il compte donc une relance, pas une nouvelle conversion.

Gérer et résilier votre abonnement

Vous gérez votre abonnement sur la page de gestion de l'abonnement. Le lien figure dans le pied de page du site et dans chaque e-mail de licence. Dans le portail client Paddle, vous pouvez résilier l'abonnement, changer de carte, télécharger vos factures et passer Pro du mensuel à l'annuel. Il vous connecte par un lien envoyé à l'adresse e-mail de l'achat, sans mot de passe.

La résiliation arrête le prochain renouvellement. Votre clé fonctionne jusqu'à la fin de la période payée, et chaque thème converti reste à vous. Une résiliation n'est pas un remboursement : les remboursements suivent les conditions de remboursement.

Ce que veut dire bêta

html2wp convertit de vrais sites et sert à du vrai travail. L'app compare chaque page avec l'original à 1440 et 390 px et inscrit chaque écart trouvé dans le rapport. Vous recevez le meilleur thème utilisable, avec une description de ce qui reste à reprendre. Avant de promettre un résultat à un client, regardez les pages signalées.

Si vous trouvez un bug dans le convertisseur lui-même, signalez-le comme le décrit la documentation du plugin. Une personne le lit, et les corrections arrivent sous forme de mises à jour du service.