Plugin pro Claude Code a Codex

Instalace

Plugin žije ve dvou repozitářích na GitHubu, jednom pro Claude Code a jednom pro Codex. Oba mají stejný obsah i stejné číslo verze. Liší se jen tím, jak je který nástroj načítá. Nainstaluj ten, který patří k tvému nástroji, protože ten druhý by se nenačetl.

Přepni na svůj nástroj a spusť oba příkazy, jeden po druhém:

První příkaz přidá katalog pluginů (marketplace) z GitHubu. Druhý z něj pak nainstaluje html2wp. Codex potřebuje vlastní repozitář, protože pluginy hledá přes soubor .agents/plugins/marketplace.json a ten v repozitáři pro Claude Code není.

Aktualizace

Příkaz pro aktualizaci se v každém nástroji jmenuje jinak. V Codexu je to upgrade, v Claude Code update:

Nainstalovanou verzi zjistíš příkazem codex plugin list v Codexu. V Claude Code jdi do /plugin → Marketplaces → html2wp.

Pokud se verze v Codexu po aktualizaci nezměnila, má Codex uloženou starou kopii. Smaž ji a nainstaluj plugin znovu:

Pokud nepomůže ani to, může mít Codex ještě jinou, starší kopii z ruční instalace. Příkaz codex plugin marketplace list vypíše všechny katalogy. Pokud tam vidíš html2wp@<other-name>, odstraň ho příkazem codex plugin remove html2wp@<that-name>.

Většina práce probíhá ve službě html2wp a služba se aktualizuje sama, takže tvoje další konverze už běží na nové verzi. Aktualizovat musíš jen část, která běží na tvém počítači: kontroly, skripty a filtr odesílaných dat. Co se v které verzi změnilo, najdeš v historii commitů na GitHubu.

Požadavky

Nemusíš to kontrolovat sám. Když spustíš konverzi, plugin nejdřív zkontroluje tvůj počítač a vypíše, co chybí:

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, které se instalují jen do tvé uživatelské složky, například Playwright nebo prohlížeč chromium, ti plugin nabídne nainstalovat. Před každým příkazem se zeptá. Věci, které mění celý systém, jako Docker Desktop nebo novější Node.js, jen ohlásí a počká, než je nainstaluješ sám.

Pokud chceš balíčky pro Python nainstalovat ručně:

Jaký model použít

Během konverze musí AI hodně rozhodovat. Například která stránka je úvodní, proč neprošla kontrola nebo jestli by klient rozdíl mezi dvěma snímky vůbec postřehl. Volba modelu proto ovlivní výsledek víc než jakékoli jiné nastavení.

V Claude Code dělá práci Opus 5 a Fable 5 radí u důležitých rozhodnutí, tedy tam, kde se konverze nejčastěji pokazí.

Licenční klíč

V bezplatné verzi klíč nepotřebuješ, takže tuto část přeskoč. Pokud máš licenci, ulož klíč do počítače ještě před první konverzí. Stačí to udělat jednou, v libovolné složce:

Klíč můžeš předat i v proměnné prostředí H2WP_KEY, která má přednost před souborem. Soubor je bezpečnější, protože klíč se pak neuloží do historie příkazů v terminálu.

Do souboru patří licenční klíč html2wp, který dostaneš po nákupu Pro. Klíč Visual Edit Pro tam nepatří. Ten se zadává v pluginu Visual Edit na webu, který upravuješ, a pro konverze nefunguje.

Jestli je klíč platný, k čemu ho můžeš použít a do kdy, zjistíš příkazem npx html2wp-license YOUR-KEY. Co výsledek znamená, vysvětluje kontrola klíče na stránce licencí. Co licence obsahuje a jak ji koupit, najdeš na stránce o licencích.

Převod projektu

Otevři terminál ve složce projektu, který chceš převést, a spusť v něm svého agenta:

Pokud používáš Claude Code, napiš na posledním řádku claude místo codex.

Pak dej agentovi jediný příkaz:

To je všechno. Nespouštíš npm install ani npm run build a nic nenastavuješ. Projekty z Bolt, v0, shadcn nebo export z Next.js převedeš stejně. Můžeš také napsat jen /html2wp:html2wp v Claude Code nebo požádat Codex, ať použije html2wp. Plugin se tě pak zeptá, co má převést.

První minuty konverze

> 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 řádcích plugin zapsal, jak roztřídil stránky: /blog je výpis článků, /blog/launch je článek a zbytek jsou běžné stránky. Toto rozhodnutí si na konci zkontroluj na hotovém webu.

Jiný vstup

Příkaz convert this project převede složku, ve které právě jsi. Pokud jsou soubory jinde, napiš cestu k nim, například convert ./dist.

Vstup musí být vždy na tvém disku. Adresu živého webu plugin nepřevede. Potřebuje soubory, ze kterých je web postavený, ne to, co ukáže prohlížeč.

Jak se převede projekt z Lovable

Aplikace z Lovable je postavená v Reactu. Její index.html obsahuje jen prázdný prvek a skript a stránka ožije až v prohlížeči. Plugin proto projekt nejdřív sestaví, otevře ho ve skutečném prohlížeči a každou stránku uloží jako hotové HTML. Zachytí i obsah, který se objeví až po spuštění skriptů, například otevřené akordeony nebo rozbalovací menu. Z těchto stránek pak vytvoří šablonu. Podrobnosti jsou v návodu pro převod z Lovable do WordPressu.

Co rozhodne za tebe

Která stránka je která

Největší vliv na výsledek má jedno rozhodnutí: která stránka je úvodní, která je výpis článků, které jsou články a které produkty. Plugin to určí z kódu stránek, zapíše si to a pokračuje bez ptaní. Zastaví se jen tehdy, když se rozhodnout nedá. Například když má web víc stránek, než dovoluje tvůj limit, nebo když dvě stránky vypadají jako jedna a tatáž.

Pokud se splete, oprava je levná. Opravíš roztřídění a spustíš konverzi znovu. To je opakované spuštění a do limitu konverzí se nepočítá.

Pak to většinou běží samo

Flash trvá zhruba půl hodiny, Full zhruba hodinu, podle počtu stránek a výkonu tvého počítače. Plugin mezitím sestaví web, porovná ho s originálem a pošle ho ke konverzi službě html2wp. Pak hotovou šablonu nainstaluje do dočasného WordPressu v Dockeru na tvém počítači a tam ji otestuje.

Kontrola, kterou nevynecháš

Na konci ti plugin ukáže každou stránku vedle originálu v jednom obrázku. Každý obrázek si prohlédni a napiš, co vidíš.

Co dostaneš

• Šablonu jako ZIP soubor. Do WordPressu ji nahraješ přes Vzhled → Šablony → Přidat novou → Nahrát šablonu. Rozbitou šablonu plugin vůbec nesestaví: například kdyby PHP mělo syntaktickou chybu, chyběl obsah, náhled šablony měl špatný rozměr nebo kdyby v obchodě nešlo nic koupit.
• Zprávu CONVERSION-REPORT.md ve stejné složce jako ZIP. Najdeš v ní převedené stránky, zapojená menu, všechno, co jsi našel při kontrole, každé varování z konverze a co ještě zbývá udělat.
• Odkaz na Visual Edit Lite, bezplatný editor pro úpravy klikáním. Editor není součástí šablony a šablona funguje i bez něj. Visual Edit Pro je samostatná placená licence.

Šablona je samostatná. Stránky, blog, formuláře, menu, SEO i přesměrování jsou součástí jejího kódu a fungují bez pluginů. Kód je čitelné PHP, CSS a JavaScript. Patří tobě a není vázaný na nás. Šablona se nikam nepřipojuje. Jak ji upravovat klikáním, popisuje část o Visual Edit v dokumentaci aplikace.

Co odchází z tvého počítače

Tvůj počítač dělá práci v prohlížeči: sestavení stránek, porovnání snímků a dočasný WordPress v Dockeru pro závěrečné kontroly. Samotnou šablonu vyrábí služba html2wp. Plugin jí proto pošle sestavený web a zpět dostane šablonu.

Kontroly šablony běží u tebe, takže služba jejich výsledky nevidí. Na konci jí je proto plugin pošle. Je to povinné: dokud předchozí konverze neodešle výsledky, další služba nespustí.

• Co se posílá: názvy kontrol, jestli prošly, počty stránek, nejhorší procento shody a krátké názvy stránek, které neprošly, například about nebo pricing.
• Co se neposílá: adresa ani doména webu, kód, texty, snímky obrazovky, cesty k souborům, licenční klíč ani název webu. Plugin posílá jen předem určená pole, nic jiného.
• Ověř si to sám: příkaz send-verdicts.sh <workspace> --dry-run vypíše přesně to, co by se poslalo, ale nic neodešle. Je to jeden krátký skript, který si můžeš přečíst.

Jiná data plugin neposílá a hotová šablona neposílá vůbec nic. Celý popis, včetně toho, jak dlouho data uchováváme, je na stránce o ochraně soukromí.

Nahlášení chyby

Pokud udělá chybu samotný konvertor, nahlas ji tímto příkazem:

Každé hlášení si přečte člověk. Oprava pak jde do služby, takže pomůže všem uživatelům.