ThemeForge Pro / Agent Kit

Balisage ThemeForge

ThemeForge construit un thème WordPress classique à partir d'un HTML statique. Vous marquez les parties modifiables avec des attributs HTML : fld-* pour les champs d'une page, opt-* pour les paramètres globaux du site, tax-* pour les champs d'une catégorie, wp-* pour WordPress lui-même (articles, menus, produits). Le générateur les transforme en champs d'administration, modèles de page et écrans que le propriétaire du site édite. Le design reste celui de la personne.

Les règles sont disponibles sur https://themeforge.pro/ai et changent avec le générateur. Ne balisez pas de mémoire ou à partir de ce fichier : récupérez les règles à chaque session. Cette compétence vous indique uniquement l'ordre de travail.

1. Convenez d'abord du plan du site

Avant d'écrire le balisage, répondez avec un plan du site et attendez la confirmation :

• chaque fichier de page avec son slug (index.html, menu.html, contacts.html…) — le nom du fichier détermine le modèle WordPress, donc blog.html est une page appelée blog, pas le flux du blog ;
• les types de contenu : articles de blog, produits, vos propres types et leurs catégories ;
• ce qui est global au site (en-tête, pied de page, contacts) — cela va dans theme-options.html ;
• les langues.

2. Récupérez les règles dont vous avez besoin

GET https://themeforge.pro/ai              la page d'entrée : lisez-la d'abord
GET https://themeforge.pro/ai?m=core       toujours, avant tout balisage
GET https://themeforge.pro/ai?m=build      lorsque vous GÉNÉREZ le site plutôt que d'en annoter un
GET https://themeforge.pro/ai?m=<module>   pages · blog · cpt · woocommerce · deploy · legacy

Chargez uniquement les modules dont ce site a besoin : un café sans boutique ne lit jamais woocommerce.

3. Balisez au fur et à mesure

Attribuez chaque section pendant que vous l'écrivez ou la lisez, pas en un second passage. Les vérifications qui attrapent la plupart des erreurs, selon les règles :

• chaque page a wp-fields-group sur <body>, sinon elle n'a aucun champ ;
• chaque champ a un nom ; un lien et sa légende ont des noms différents (Bouton / Texte du bouton) ;
• dans une liste (fld-loop), chaque carte porte les attributs, pas seulement la première ;
• les champs globaux sont déclarés sur theme-options.html.

4. Vérifiez, gratuitement et sans compte

Envoyez l'ensemble des pages en une seule requête et répétez jusqu'à ce que "ok": true :

POST https://themeforge.pro/api/validate-markup
Content-Type: application/json

{"pages":[{"name":"index.html","html":"…"},{"name":"theme-options.html","html":"…"}]}

Ou exécutez node scripts/validate.mjs <dossier-du-site> depuis ce kit. error casse le thème, warning signifie que quelque chose est silencieusement ignoré, hint est bon à savoir. Rien n'est stocké.

5. Remettez le site

Suivez ?m=deploy : un seul ZIP du contenu du site (index.html à la racine). La personne le télécharge dans un projet sur https://themeforge.pro, ouvre l'administration WordPress du thème dans le navigateur gratuitement, et télécharge le thème avec un abonnement. Si elle vous donne son identifiant de projet et son jeton, le module deploy montre comment construire le thème vous-même via HTTP.

Références

• Référence des attributs pour les personnes : https://themeforge.pro/docs
• Guide de balisage : https://themeforge.pro/docs/ai-guide
• Dictionnaire des attributs au format JSON : https://themeforge.pro/api/attributes
• Un exemple complet balisé : examples/warm-corner/ dans ce kit