Bővítmény Claude Code-hoz és Codexhez

Telepítés

A bővítmény két GitHub-repozitóriumban él, az egyik Claude Code-hoz, a másik Codexhez. Mindkettőnek ugyanaz a tartalma és a verziószáma. Csak abban különböznek, hogyan tölti be őket az adott eszköz. Azt telepítsd, amelyik a te eszközödhöz tartozik, mert a másik nem töltődne be.

Válts a saját eszközödre, és futtasd le egymás után mindkét parancsot:

Az első parancs hozzáadja a bővítménykatalógust (a marketplace-t) a GitHubról. A második ebből telepíti a html2wp-t. A Codexnek azért kell saját repozitórium, mert a bővítményeket a .agents/plugins/marketplace.json fájlon keresztül találja meg, és a Claude Code-repozitóriumban nincs ilyen fájl.

Frissítések

A frissítő parancsot a két eszköz másként hívja. Codexben upgrade, Claude Code-ban update:

A telepített verziót Codexben a codex plugin list paranccsal látod. Claude Code-ban menj ide: /plugin → Marketplaces → html2wp.

Ha frissítés után a verzió Codexben nem változott, a Codex egy régi másolatot tárol. Töröld, és telepítsd újra a bővítményt:

Ha ez sem segít, a Codexben egy kézi telepítésből származó másik, régebbi másolat is lehet. A codex plugin marketplace list parancs kiírja az összes katalógust. Ha ott html2wp@<other-name> szerepel, távolítsd el ezzel: codex plugin remove html2wp@<that-name>.

A munka nagy része a html2wp szolgáltatásban történik, és a szolgáltatás magától frissül, így a következő konverziód már az új verzióval fut. Csak a gépeden futó részt kell frissítened: az ellenőrzéseket, a szkripteket és a kimenő adatok szűrőjét. Hogy melyik verzióban mi változott, az a GitHubon a commitok előzményeiben látszik.

Követelmények

Ezt nem kell magadnak ellenőrizned. Amikor elindítasz egy konverziót, a bővítmény először átnézi a gépedet, és felsorolja, mi hiányzik:

Node.js                ok        v22.14.0
Python                 ok        3.12.4
Playwright             MISSING   mirroring, prerendering and every screenshot
Docker                 NOT RUNNING  installed, but the daemon is not up

A csak a felhasználói mappádba települő csomagokat, például a Playwrightot vagy a chromium böngészőt, a bővítmény felajánlja, hogy telepíti helyetted. Minden parancs előtt rákérdez. Az egész rendszert érintő dolgokat, például a Docker Desktopot vagy egy újabb Node.js-t, csak jelzi, aztán megvárja, amíg magad telepíted őket.

Ha a Python-csomagokat kézzel szeretnéd telepíteni:

Melyik modellt használd

Konverzió közben az AI-nak sok döntést kell meghoznia. Például: melyik oldal a kezdőlap, miért bukott el egy ellenőrzés, vagy egy ügyfél egyáltalán észrevenné-e a különbséget két képernyőkép között. Ezért a modell kiválasztása minden más beállításnál jobban befolyásolja az eredményt.

Claude Code-ban az Opus 5 végzi a munkát, a Fable 5-öt pedig a fontos döntéseknél kérdezi meg, mert egy konverzió leggyakrabban ott csúszik el.

Licenckulcs

Az ingyenes csomagban nem kell kulcs, ezt a részt átugorhatod. Ha van licenced, az első konverzió előtt mentsd el a kulcsot a gépeden. Ezt csak egyszer kell megtenned, bármelyik mappából:

A kulcsot a H2WP_KEY környezeti változóban is átadhatod, ez elsőbbséget élvez a fájllal szemben. A fájl biztonságosabb, mert így a kulcs nem kerül be a terminál előzményeibe.

A fájlba a html2wp licenckulcs kerül, amelyet a Pro megvásárlásakor kapsz. A Visual Edit Pro kulcs nem ide való. Azt a Visual Edit bővítménybe írod be azon az oldalon, amelyet szerkesztesz, és konverzióhoz nem működik.

Hogy egy kulcs érvényes-e, mire használhatod és meddig, azt az npx html2wp-license YOUR-KEY paranccsal tudhatod meg. Az eredmény jelentését a licencoldal kulcsellenőrzésről szóló része magyarázza el. Hogy mit tartalmaz egy licenc, és hogyan veheted meg, az a licencek oldalán van.

Projekt átalakítása

Nyiss egy terminált annak a projektnek a mappájában, amelyet át akarsz alakítani, és ott indítsd el az ügynöködet:

Ha Claude Code-ot használsz, az utolsó sorban codex helyett claude parancsot írj.

Aztán adj az ügynöknek egyetlen utasítást:

Ennyi. Nem futtatsz npm install vagy npm run build parancsot, és semmit sem állítasz be. A Bolt-, v0-, shadcn-projektek és a Next.js-exportok ugyanígy alakulnak át. Claude Code-ban azt is beírhatod, hogy /html2wp:html2wp, vagy megkérheted a Codexet, hogy használja a html2wp-t. A bővítmény ekkor megkérdezi, mit alakítson át.

A konverzió első percei

> convert this project

  Checking this machine first…
    Node.js     ok    v22.14.0
    Playwright  MISSING
  Two Python packages are missing. Shall I install them? (they go in your
  user directory, no root)

> yes

  … installed. Building the project, then prerendering it.
  7 routes found: /, /about, /pricing, /blog, /blog/launch, /contact, /faq
  Decided: /blog is the listing, /blog/launch an article, the rest are pages.
  Written to the manifest; carrying on.

Az utolsó sorokban a bővítmény rögzítette, hogyan sorolta be az oldalakat: a /blog a cikklista, a /blog/launch egy cikk, a többi pedig szokásos oldal. Ezt a döntést a végén a kész oldalon ellenőrizd.

Más bemenet

A convert this project parancs azt a mappát alakítja át, amelyben vagy. Ha a fájlok máshol vannak, írd be az útvonalukat, például convert ./dist.

A bemenetnek mindig a lemezeden kell lennie. A bővítmény élő oldal címét nem alakítja át. Azokra a fájlokra van szüksége, amelyekből az oldal felépül, nem arra, amit a böngésző mutat.

Hogyan alakul át egy Lovable-projekt

A Lovable-alkalmazás Reactban készül. Az index.html fájljában csak egy üres elem és egy szkript van, az oldal csak a böngészőben kel életre. Ezért a bővítmény előbb megépíti a projektet, megnyitja egy valódi böngészőben, és minden oldalt kész HTML-ként ment el. Azt a tartalmat is rögzíti, amely csak a szkriptek lefutása után jelenik meg, például a nyitott harmonikákat vagy a legördülő menüket. Ezekből az oldalakból készíti el aztán a témát. A részletek a Lovable-útmutatóban vannak.

Mit dönt el helyetted

Melyik oldal melyik

Egy döntés hat a legjobban az eredményre: melyik oldal a kezdőlap, melyik a cikklista, melyek a cikkek és melyek a termékek. A bővítmény ezt az oldalak kódjából találja ki, leírja, és kérdezés nélkül folytatja. Csak akkor áll meg, ha nem tud dönteni. Például ha a webhelynek több oldala van, mint amennyit a kereted megenged, vagy ha két oldal ugyanannak látszik.

Ha ezt elrontja, a javítás olcsó. Kijavítod a besorolást, és újra lefuttatod a konverziót. Ez újrafuttatás, és nem számít bele a konverziós keretedbe.

Utána nagyrészt magától fut

A Flash körülbelül fél óra, a Full nagyjából egy óra, az oldalak számától és a géped sebességétől függően. Közben a bővítmény megépíti az oldalt, összeveti az eredetivel, és elküldi a html2wp szolgáltatásnak átalakításra. Utána a kész témát telepíti egy ideiglenes WordPressbe a gépeden futó Dockerben, és ott teszteli.

Az átnézés, amelyet nem hagyhatsz ki

A végén a bővítmény minden oldalt egy képen mutat meg az eredeti mellett. Nézz meg minden képet, és mondd el, mit látsz.

Mit kapsz

• A témát ZIP-fájlként. A WordPressben a Megjelenés → Témák → Új hozzáadása → Téma feltöltése menüben töltöd fel. Hibás témát a bővítmény egyáltalán nem épít: például ha a PHP-ben szintaktikai hiba volt, tartalom hiányzott, a téma képernyőképe rossz méretű volt, vagy a webshopban nem lehetett vásárolni.
• A CONVERSION-REPORT.md jelentést ugyanabban a mappában, ahol a ZIP van. Felsorolja az átalakított oldalakat, a bekötött menüket, mindent, amit az átnézésnél találtál, a konverzió összes figyelmeztetését, és hogy mi van még hátra.
• Egy linket a Visual Edit Lite-hoz, az ingyenes, rámutatással és kattintással működő szerkesztőhöz. A szerkesztő nem része a témának, és a téma nélküle is működik. A Visual Edit Pro külön fizetős licenc.

A téma önálló. Az oldalak, a blog, az űrlapok, a menük, a SEO és az átirányítások a kódjának részei, és bővítmények nélkül működnek. A kód olvasható PHP, CSS és JavaScript. A tiéd, és nincs hozzánk kötve. A téma sehová nem kapcsolódik. Hogy hogyan szerkesztheted kattintással, azt az alkalmazás dokumentációjának Visual Edit része írja le.

Mi hagyja el a gépedet

A böngészős munkát a géped végzi: megépíti az oldalakat, összeveti a képernyőképeket, és a végső ellenőrzésekhez ideiglenes WordPresst futtat Dockerben. Magát a témát a html2wp szolgáltatás készíti. Ezért a bővítmény elküldi neki a megépített oldalt, és visszakapja a témát.

A téma ellenőrzései nálad futnak, így a szolgáltatás nem látja az eredményüket. A végén ezért a bővítmény elküldi neki őket. Ez kötelező: a szolgáltatás addig nem indítja a következő konverziót, amíg az előző el nem küldte az eredményeit.

• Amit elküld: az ellenőrzések nevét, hogy átmentek-e, az oldalak számát, a legrosszabb egyezési százalékot és az elbukott oldalak rövid nevét, például about vagy pricing.
• Amit nem küld el: az oldal címét vagy domainjét, a kódot, a szöveget, a képernyőképeket, a fájlútvonalakat, a licenckulcsot és az oldal nevét. A bővítmény csak előre meghatározott mezőket küld, semmi mást.
• Ellenőrizd magad: a send-verdicts.sh <workspace> --dry-run parancs pontosan kiírja, mi menne el, de semmit sem küld. Ez egyetlen rövid szkript, amelyet elolvashatsz.

A bővítmény más adatot nem küld, a kész téma pedig egyáltalán semmit. A teljes leírás, azzal együtt, hogy meddig őrizzük az adatokat, az adatvédelmi oldalon van.

Hiba bejelentése

Ha maga a konverter hibázik, ezzel a paranccsal jelentsd:

Minden bejelentést egy ember olvas el. A javítás aztán a szolgáltatásba kerül, így minden felhasználónak segít.