Plugin pre Claude Code a Codex

Inštalácia

Plugin existuje v dvoch repozitároch na GitHube, jeden pre Claude Code a jeden pre Codex. Obsah aj číslo verzie majú rovnaké, líšia sa len tým, ako ich ktorý nástroj načíta. Nainštaluj ten, ktorý patrí k tvojmu nástroju, ten druhý by sa nenačítal.

Prepni sa na svoj nástroj a spusti oba príkazy, jeden po druhom:

Prvý príkaz pridá katalóg pluginov (marketplace) z GitHubu, druhý z neho nainštaluje html2wp. Codex potrebuje samostatný repozitár, lebo plugin hľadá cez súbor .agents/plugins/marketplace.json a ten v repozitári pre Claude Code nie je.

Aktualizácie

Príkaz na aktualizáciu sa v oboch nástrojoch volá inak. V Codexe je to upgrade, v Claude Code update:

Nainštalovanú verziu zistíš v Codexe príkazom codex plugin list, v Claude Code cez /plugin → Marketplaces → html2wp.

Ak sa verzia v Codexe po aktualizácii nezmenila, má Codex uloženú starú kópiu. Vymaž ju a nainštaluj plugin znova:

Ak ani to nepomôže, môže mať Codex nainštalovanú ešte inú, staršiu kópiu z ručnej inštalácie. Príkaz codex plugin marketplace list vypíše všetky katalógy. Ak tam vidíš html2wp@<iný-názov>, odstráň ho príkazom codex plugin remove html2wp@<ten-názov>.

Väčšina práce prebieha v službe html2wp a tá sa aktualizuje sama, pri ďalšej konverzii už beží nová verzia. Aktualizovať musíš len časť, ktorá beží na tvojom počítači: kontroly, skripty a filter odosielaných dát. Čo sa v ktorej verzii zmenilo, nájdeš v histórii commitov na GitHube.

Požiadavky

Nemusíš si to overovať sám. Keď spustíš konverziu, plugin najprv skontroluje počítač a vypíše, čo chýba:

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

Balíky, ktoré sa inštalujú len do tvojho používateľského priečinka, napríklad Playwright alebo prehliadač chromium, ti plugin ponúkne nainštalovať. Pred každým príkazom sa spýta. Veci, ktoré menia celý systém, ako Docker Desktop alebo novší Node.js, len oznámi a počká, kým ich nainštaluješ sám.

Ak chceš balíky pre Python nainštalovať ručne:

Ktorý model použiť

Počas konverzie musí AI veľa rozhodovať. Napríklad ktorá stránka je úvodná, prečo neprešla kontrola alebo či rozdiel medzi dvoma snímkami by klient vôbec postrehol. Výber modelu preto ovplyvní výsledok viac než akékoľvek iné nastavenie.

V Claude Code robí prácu Opus 5 a Fable 5 sa pýta pri dôležitých rozhodnutiach, teda tam, kde sa konverzia najčastejšie pokazí.

Licenčný kľúč

V bezplatnej verzii kľúč nepotrebuješ, túto časť preskoč. Ak máš licenciu, ulož kľúč do počítača ešte pred prvou konverziou. Stačí to urobiť raz, v ľubovoľnom priečinku:

Kľúč môžeš zadať aj premennou prostredia H2WP_KEY, ktorá má prednosť pred súborom. Súbor je bezpečnejší, lebo kľúč sa tak neuloží do histórie príkazov v termináli.

Do súboru patrí licenčný kľúč html2wp, ktorý dostaneš po kúpe Pro. Kľúč od Visual Edit Pro sem nepatrí. Ten sa zadáva v plugine Visual Edit na webe, ktorý upravuješ, a na konverziu nefunguje.

Či je kľúč platný, na čo ho môžeš použiť a dokedy platí, zistíš príkazom npx html2wp-license TVOJ-KĽÚČ. Čo výsledok znamená, vysvetľuje kontrola kľúča na stránke licencií. Čo licencia obsahuje a ako ju kúpiš, nájdeš na stránke o licenciách.

Prevod projektu

Otvor terminál v priečinku projektu, ktorý chceš previesť, a spusti v ňom svojho agenta:

Ak používaš Claude Code, na poslednom riadku napíš claude namiesto codex.

Potom napíš agentovi jediný príkaz:

Viac netreba. Nespúšťaš npm install ani npm run build a nič nenastavuješ. Rovnako prevedieš aj projekty z Bolt, v0, shadcn alebo export z Next.js. Môžeš tiež napísať len /html2wp:html2wp v Claude Code alebo požiadať Codex, nech použije html2wp. Plugin sa ťa potom spýta, čo má previesť.

Prvé minúty konverzie

> 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.

V posledných riadkoch plugin zapísal, ako rozdelil stránky: /blog je zoznam článkov, /blog/launch je článok a zvyšok sú bežné stránky. Toto rozhodnutie si na konci over na hotovom webe.

Iný vstup

Príkaz convert this project prevedie priečinok, v ktorom práve si. Ak sú súbory inde, napíš cestu k nim, napríklad convert ./dist.

Vstup musí byť vždy na tvojom disku. Adresu živého webu plugin neprevedie. Potrebuje súbory, z ktorých je web postavený, nie to, čo zobrazí prehliadač.

Ako prebehne konverzia projektu z Lovable

Aplikácia z Lovable je postavená v Reacte. Jej index.html obsahuje len prázdny prvok a skript, stránka vznikne až v prehliadači. Plugin preto projekt najprv zostaví, otvorí ho v skutočnom prehliadači a každú stránku uloží ako hotové HTML. Zachytí aj obsah, ktorý sa objaví až po spustení skriptov, napríklad otvorené akordeóny alebo rozbaľovacie menu. Z týchto stránok potom robí tému. Podrobnosti sú v návode z Lovable do WordPressu.

Čo rozhodne za teba

Ktorá stránka je ktorá

Na výsledok má najväčší vplyv jedno rozhodnutie: ktorá stránka je úvodná, ktorá je zoznam článkov, ktoré sú články a ktoré produkty. Plugin to určí z kódu stránok, zapíše si to a pokračuje bez otázok. Zastaví sa len vtedy, keď sa rozhodnúť nedá, napríklad keď má web viac stránok, než dovoľuje tvoj limit, alebo keď sa dve stránky tvária ako tá istá.

Ak sa pomýli, oprava je lacná. Opravíš rozdelenie a spustíš konverziu znova. To je opakované spustenie a z limitu konverzií neuberá.

Potom beží väčšinou sama

Flash trvá zhruba pol hodiny, Full zhruba hodinu, podľa počtu stránok a výkonu tvojho počítača. Plugin medzitým zostaví web, porovná ho s originálom a pošle ho službe html2wp na konverziu. Hotovú tému nainštaluje do dočasného WordPressu v Dockeri na tvojom počítači a tam ju vyskúša.

Kontrola, ktorú nevynecháš

Na konci ti plugin ukáže každú stránku vedľa originálu v jednom obrázku. Každý obrázok si prezri a napíš, čo vidíš.

Čo dostaneš

• Tému ako ZIP súbor. Do WordPressu ju nahráš cez Vzhľad → Témy → Pridať novú → Nahrať tému. Pokazenú tému plugin vôbec nezostaví, napríklad ak by PHP malo chybu v syntaxi, chýbal obsah, náhľad témy mal zlý rozmer alebo by sa v obchode nedalo nakúpiť.
• Report CONVERSION-REPORT.md v rovnakom priečinku ako ZIP. Nájdeš v ňom prevedené stránky, zapojené menu, všetko, čo si našiel pri kontrole, všetky varovania z konverzie a čo ešte treba dorobiť.
• Odkaz na Visual Edit Lite, bezplatný editor na úpravy klikaním. Editor nie je súčasťou témy a téma funguje aj bez neho. Visual Edit Pro je samostatná platená licencia.

Téma je samostatná. Stránky, blog, formuláre, menu, SEO aj presmerovania sú priamo v jej kóde a fungujú bez pluginov. Kód je čitateľné PHP, CSS a JavaScript, patrí tebe a nie je viazaný na nás. Téma sa nikam nepripája. Ako ju upravovať klikaním, opisuje časť o Visual Edit v dokumentácii appky.

Čo odchádza z tvojho počítača

Na tvojom počítači prebieha práca v prehliadači: zostavenie stránok, porovnanie snímok a dočasný WordPress v Dockeri na záverečné kontroly. Samotnú tému vyrába služba html2wp. Plugin jej preto pošle zostavený web a späť dostane tému.

Kontroly témy bežia u teba, takže služba ich výsledky nevidí. Na konci jej ich preto plugin pošle. Je to povinné: kým predchádzajúca konverzia neodošle výsledky, ďalšiu služba nespustí.

• Čo sa posiela: názvy kontrol, či prešli, počty stránok, najhoršie percento zhody a krátke názvy stránok, ktoré neprešli, napríklad about alebo pricing.
• Čo sa neposiela: adresa ani doména webu, kód, texty, snímky obrazovky, cesty k súborom, licenčný kľúč ani názov webu. Plugin pošle len vopred určené polia, nič iné.
• Over si to sám: príkaz send-verdicts.sh <workspace> --dry-run vypíše presne to, čo by sa poslalo, ale nič neodošle. Je to jeden krátky skript, ktorý si môžeš prečítať.

Iné údaje plugin neposiela a hotová téma neposiela nič. Celý popis aj to, ako dlho dáta uchovávame, je na stránke o ochrane súkromia.

Nahlásenie chyby

Ak urobí chybu samotný konvertor, nahlás ju týmto príkazom:

Každé hlásenie si prečíta človek. Oprava sa potom dostane do služby, takže pomôže všetkým používateľom.