html2wp / Dokumentácia

Dokumentácia

Inštalácia appky, prvý prevod webu, výber modelu, čo odchádza z tvojho počítača a ako hotový web upravíš. Konverziu cez agenta v termináli opisuje dokumentácia pluginu pre Claude Code a Codex.

Prvá časťPrvá konverzia

Inštalácia appky

Stiahni appku html2wp pre Mac s čipom Apple (M1 a novší) alebo pre Windows a nainštaluj ju ako každú inú aplikáciu. Verzia pre Windows je zatiaľ Preview a verzia pre Linux pribudne neskôr.

Pri prvom spustení klikni na Prepare environment. Appka si stiahne všetko potrebné. Robí to len raz a chvíľu to trvá.

Na prácu potrebuje bezplatný program Docker Desktop. V ňom beží dočasný WordPress, do ktorého appka tému nainštaluje a skontroluje. Ak Docker nemáš, appka ho stiahne a spustí inštaláciu sama. Počítač si pritom môže vypýtať tvoje heslo.

Prihlásenie cez ChatGPT

Konverziu robí AI z tvojho predplatného ChatGPT, takže nám za kredity ani tokeny neplatíš.

V appke klikni na Connect with ChatGPT. Appka ti ukáže 9-znakový kód a v prehliadači otvorí stránku OpenAI. Tam vyber svoj účet ChatGPT alebo sa prihlás.

Stránka ťa potom požiada o kód „z terminálu“ a spomína Codex CLI. To je v poriadku: html2wp používa Codex a kód, ktorý stránka chce, je ten z appky. Vlož ho (kliknutím na kód v appke ho skopíruješ) a klikni na Continue. Appka sa po prihlásení aktualizuje sama.

Heslo vidí len OpenAI

Heslo do ChatGPT zadávaš len na stránke OpenAI, appka ho nikdy nevidí. Kód nikomu neposielaj a zadaj ho len vtedy, keď si prihlásenie práve spustil ty.

Nový projekt

Klikni na New project a vyber priečinok alebo ZIP so svojím webom. Môže to byť export z Lovable, Bolt alebo v0, návrh z Claude či obyčajný HTML web. Adresu webu (URL) appka neprijíma, potrebuje súbory, z ktorých je web postavený.

Appka sama zistí, ktorá stránka je úvodná a ktorá je blog, článok či produkt.

Potom vyber, čo chceš dostať. Zvyčajne je to WordPress téma a pri nej režim Flash alebo Full. Ak WordPress nepotrebuješ, zvoľ Astro 5 projekt. Konverzia je kratšia a hotový web vieš priamo v appke nasadiť na Cloudflare Pages, kde ho môžeš hosťovať zadarmo.

Flash alebo Full

Flash je rýchla konverzia a v appke je predvolená. Každý krok prebehne raz. Menu, blog, obchod aj formuláre sa rozpoznajú a zapoja hneď. Kontroly prebehnú raz a ich výsledky nájdeš v reporte. Trvá zhruba pol hodiny a hodí sa na väčšinu webov aj na rýchle vyskúšanie.

Full je dôkladná konverzia. Prejde každú kontrolu a chyby, ktoré nájde, sa pokúsi opraviť. Trvá zhruba hodinu a minie viac z limitu tvojho predplatného ChatGPT. Oplatí sa pri zložitejších weboch alebo keď Flash nechal v reporte veľa bodov na doladenie.

Oba režimy odovzdajú použiteľnú tému s popisom toho, čo prípadne zostalo. Presný čas závisí od počtu stránok a výkonu tvojho počítača.

Výber modelu

V appke si vyberáš model AI a úroveň uvažovania (Reasoning effort).

  • GPT-6-Luna na úrovni Extra high stačí na bežné konverzie. Je lacná, minie málo z limitu predplatného a väčšinu webov zvládne sama.
  • GPT-6-Sol na úrovni Medium alebo High odporúčame, keď treba niečo opraviť, napríklad vo Full konverzii alebo pri úpravách cez chat.
  • GPT-6-Astra je najsilnejší a najdrahší model. Na bežnú prácu ho netreba, pomôže, keď si s problémom neporadí ani Sol.

Model zmeníš vždy, keď práve nebeží konverzia. Každý projekt môže mať svoj vlastný.

Kontrola výsledku

Keď konverzia skončí, appka ti dá vedieť. Ak niečo nevyjde, najprv to skúsi opraviť sama. Vždy odovzdá použiteľnú tému s popisom, čo prípadne doladiť.

V záložke Preview klikni na Open website a pozri si nový web v prehliadači. V záložke Compare vidíš originál a konverziu vedľa seba aj s rozdielom v percentách. Čo sa ti nepáči, napíš do chatu a appka to opraví. Hotové zmeny uložíš ako novú verziu cez Make release.

Automatické kontroly zachytia väčšinu rozdielov, nie všetky. Stránky si preto prezri skôr, ako tému odovzdáš klientovi. ZIP s témou uložíš v záložke Exports a do WordPressu ho nahráš cez Vzhľad → Témy → Pridať novú → Nahrať tému.

Druhá časťPotom

Dáta a súkromie

Tému zostavuje náš server. Väčšina práce, teda meranie, porovnávanie s originálom a opravy, však beží na tvojom počítači a riadi ju AI z tvojho účtu ChatGPT. To, na čom AI pracuje, spracúva OpenAI podľa podmienok tvojho účtu.

Čo sa odošle na server

Tvoj web prevedený do Astro projektu (stránky, štýly, skripty, obrázky a písma) a informácie o jednotlivých stránkach. Pôvodný priečinok projektu ani nainštalované knižnice (node_modules) sa neposielajú. Odoslané dáta sa automaticky vymažú po 48 hodinách. Ostane len odtlačok (hash), vďaka ktorému sa opakované spustenie ráta ako jedno.

Súbory s heslami a kľúčmi

Súbory, ktoré vyzerajú ako prihlasovacie údaje, appka do balíka vôbec nepridá: .env, kľúče (.pem, .key, id_rsa), .npmrc, .netrc, priečinky .ssh a .aws ani žiadny súbor s privátnym kľúčom. Všetko, čo vynechala, nájdeš po mene v reporte.

Výsledky kontrol

Po overení témy appka pošle len výsledky kontrol: ktoré prešli a ktoré nie, počty stránok, najväčší rozdiel oproti originálu a skratky stránok, ktoré neprešli (napríklad „about“). Neodchádza adresa webu, doména, kód, texty, snímky obrazovky, cesty k súborom, licenčný kľúč ani názov webu.

Kontroly bežia proti WordPressu na tvojom počítači, ktorý náš server nikdy nevidí. Bez ich výsledkov by server vedel len to, že konverzia nespadla. Preto sa ďalšia konverzia spustí až vtedy, keď predchádzajúca odošle svoje výsledky. Appka ich posiela automaticky. Celý popis je na stránke o ochrane súkromia.

Úpravy cez Visual Edit

Na beh webu netreba žiadny plugin. Stránky, blog, formuláre, menu, SEO aj presmerovania sú priamo v téme. Presmerovania vedú staré adresy na nové: kto otvorí starý odkaz /about.html, dostane sa na /about/, takže web si zachová pozície vo vyhľadávačoch.

Úpravy klikaním pridáva Visual Edit, WordPress plugin, ktorý si doinštaluješ. Na čo klikneš, to sa zmení. Žiadny page builder pod tým neprestavuje kód stránky.

FunkciaLite (zadarmo)Pro
Text, obrázky a odkazy klikaním✓✓
Formuláre, menu a SEO polia✓✓
História úprav10 krokov300 krokov
AI asistent (vlastný API kľúč pre OpenRouter)–✓
AI úprava obrázkov a animácie z obrázkov–✓
Export témy a ochrana formulárov cez Turnstile–✓

Pro je samostatná ročná licencia na stránke s cenníkom. Každá konverzia, Free aj Pro, odkazuje na bezplatnú verziu Lite. Keď plugin vypneš, stránky sa vykresľujú ďalej a téma zostane plne použiteľná.

Licencia, predplatné, beta

Opakované spustenia

Vo verzii zadarmo máš 5 opakovaných spustení spolu pre všetky konverzie, s licenciou Pro neobmedzene. Opakované spustenie je ten istý web nahratý znova. Server ho spozná podľa odtlačku (hash), takže sa ráta ako opakované spustenie, nie ako nová konverzia.

Správa a zrušenie predplatného

Predplatné spravuješ na stránke predplatného. Odkaz je v pätičke webu aj v každom licenčnom e-maile. Zákaznícky portál Paddle ti umožní zrušiť predplatné, zmeniť kartu, stiahnuť faktúry a prepnúť mesačné Pro na ročné. Prihlási ťa odkazom na e-mail, s ktorým si nakupoval, heslo netreba.

Zrušenie zastaví ďalšie obnovenie. Kľúč funguje do konca zaplateného obdobia a každá téma, ktorú si previedol, zostáva tvoja. Zrušenie nie je vrátenie peňazí, to upravujú podmienky vrátenia.

Čo znamená beta

html2wp prevádza skutočné weby a používa sa na skutočnej práci. Appka porovná každú stránku s originálom v šírke 1440 a 390 px a každý rozdiel, ktorý nájde, zapíše do reportu. Spolu s reportom odovzdá najlepšiu použiteľnú tému. Pozri si označené stránky skôr, ako klientovi sľúbiš výsledok.

Keď nájdeš chybu v samotnom konvertore, nahlás ju podľa postupu v dokumentácii pluginu. Prečíta si ju človek a opravy prichádzajú ako aktualizácie služby.