html2wp / Dokumentacja

Jak zamienić HTML w motyw WordPress: poradnik do aplikacji html2wp

Ten poradnik pokazuje, jak w aplikacji desktopowej html2wp zamienić HTML w motyw WordPress. Opisuje instalację aplikacji, pierwszą konwersję, wybór modelu, to, co opuszcza twój komputer, i edycję gotowej strony. Konwersję z agentem w terminalu opisuje dokumentacja wtyczki dla Claude Code i Codex.

Część pierwszaTwoja pierwsza konwersja

Instalacja aplikacji do konwersji HTML na motyw WordPress

Pobierz aplikację html2wp na Maca z procesorem Apple (M1 lub nowszym) albo na Windows i zainstaluj ją jak każdą inną aplikację. Wersja na Windows to wciąż Preview, a wersja na Linuksa pojawi się później.

Przy pierwszym uruchomieniu kliknij Prepare environment (przygotuj środowisko). Aplikacja pobiera wtedy wszystko, czego potrzebuje. Robi to tylko raz i trwa to chwilę.

Do pracy aplikacja potrzebuje Docker Desktop, darmowego programu. Docker uruchamia tymczasowy WordPress, a aplikacja instaluje w nim motyw i go sprawdza. Jeśli nie masz Dockera, aplikacja go pobiera i uruchamia za ciebie instalator. Komputer może po drodze zapytać o hasło.

Logowanie przez ChatGPT

Konwersję wykonuje AI z twojej subskrypcji ChatGPT, więc nie płacisz nam za kredyty ani tokeny.

W aplikacji kliknij Connect with ChatGPT (połącz z ChatGPT). Aplikacja pokazuje 9-znakowy kod i otwiera w przeglądarce stronę OpenAI. Tam wybierz swoje konto ChatGPT albo się zaloguj.

Następnie strona prosi o kod „z terminala” i wspomina o Codex CLI. To w porządku: html2wp używa Codex, a kod, którego chce strona, to ten z aplikacji. Wklej go (kliknij kod w aplikacji, żeby go skopiować) i kliknij Continue. Po zalogowaniu aplikacja sama się zaktualizuje.

Twoje hasło widzi tylko OpenAI

Hasło do ChatGPT wpisujesz tylko na stronie OpenAI, a aplikacja nigdy go nie widzi. Nie wysyłaj nikomu kodu i wpisuj go tylko wtedy, gdy logowanie uruchamiasz samodzielnie.

Nowy projekt: HTML, który zamieniasz w motyw WordPress

Kliknij New project i wybierz folder albo ZIP ze swoją stroną. Może to być eksport z Lovable, Bolt albo v0, projekt z Claude albo zwykła strona HTML. Aplikacja nie przyjmuje adresu strony (URL), bo potrzebuje plików, z których strona jest zbudowana.

Aplikacja sama ustala, która strona jest stroną główną, a która blogiem, artykułem albo produktem.

Potem wybierz, co chcesz dostać. Zwykle konwertujesz HTML do motywu WordPress, w trybie Flash albo Full. Jeśli nie potrzebujesz WordPressa, wybierz zamiast tego projekt Astro 5. Ta konwersja jest krótsza, a gotową stronę wdrożysz prosto z aplikacji na Cloudflare Pages, gdzie możesz ją hostować za darmo.

Flash albo Full: dwa sposoby konwersji HTML na WordPress

Flash to szybka konwersja i domyślny tryb w aplikacji. Każdy krok działa raz. Menu, blog, sklep i formularze są rozpoznawane i podłączane od razu. Kontrole też działają raz, a ich wyniki znajdziesz w raporcie. Trwa około pół godziny i pasuje do większości stron, a także do szybkiej próby.

Full to dokładna konwersja. Uruchamia każdą kontrolę i próbuje naprawić znalezione błędy. Trwa około godziny i zużywa więcej limitu twojej subskrypcji ChatGPT. Opłaca się więc przy bardziej złożonych stronach albo wtedy, gdy Flash zostawił w raporcie dużo punktów do dopracowania.

Oba tryby zamieniają twój HTML w używalny motyw WordPress i dodają notatkę o tym, co zostało. Dokładny czas zależy od liczby stron i szybkości twojego komputera.

Wybór modelu do konwersji HTML na motyw WordPress

W aplikacji wybierasz model AI i poziom rozumowania (Reasoning effort).

  • GPT-6-Luna na poziomie Extra high wystarcza do zwykłych konwersji. Jest tani, zużywa mało limitu subskrypcji i sam radzi sobie z większością stron.
  • GPT-6-Sol na poziomie Medium albo High polecamy, gdy coś trzeba naprawić, na przykład w konwersji Full albo przy poprawkach przez czat.
  • GPT-6-Astra to najmocniejszy i najdroższy model. Do zwykłej pracy go nie potrzebujesz, ale pomaga, gdy nawet Sol nie rozwiązuje problemu.

Model możesz zmienić zawsze, gdy nie trwa żadna konwersja. Każdy projekt może mieć własny.

Sprawdzenie motywu WordPress względem twojego HTML

Gdy konwersja się skończy, aplikacja da ci znać. Jeśli coś się nie uda, najpierw próbuje to naprawić sama. Tak czy inaczej zawsze przekazuje używalny motyw z notatką, co dopracować.

W zakładce „Preview” (Podgląd) kliknij Open website i obejrzyj nową stronę w przeglądarce. Zakładka „Compare” (Porównaj) pokazuje oryginał i konwersję obok siebie, z różnicą w procentach. Wpisz w czat wszystko, co ci się nie podoba, a aplikacja to poprawi. Potem zapisz gotowe zmiany jako nową wersję przyciskiem Make release.

Automatyczne kontrole wyłapują większość różnic, ale nie wszystkie. Przejrzyj więc strony, zanim przekażesz motyw klientowi. ZIP z motywem zapisujesz w zakładce „Exports” (Eksporty) i wgrywasz do WordPressa w Wygląd → Motywy → Dodaj nowy → Wyślij motyw na serwer.

Część drugaCo dalej

Dane i prywatność

Motyw buduje nasz serwer. Większość pracy (pomiary, porównanie z oryginałem i poprawki) działa jednak na twoim komputerze, a steruje nią AI z twojego konta ChatGPT. OpenAI przetwarza to, nad czym pracuje AI, na warunkach twojego konta.

Co trafia na serwer

Twoja strona przekonwertowana do projektu Astro (strony, style, skrypty, obrazy i fonty) oraz informacje o każdej stronie. Oryginalny folder projektu i zainstalowane biblioteki (node_modules) nie są wysyłane. Wysłane dane są automatycznie usuwane po 48 godzinach. Zostaje tylko odcisk (hash), dzięki któremu ponowne uruchomienie liczy się jako jedna konwersja.

Pliki z hasłami i kluczami

Pliki, które wyglądają na dane logowania, w ogóle nie trafiają do paczki: .env, klucze (.pem, .key, id_rsa), .npmrc, .netrc, foldery .ssh i .aws ani żaden plik z kluczem prywatnym. Wszystko, co aplikacja pominęła, znajdziesz z nazwy w raporcie.

Wyniki kontroli

Po przetestowaniu motywu aplikacja wysyła tylko wyniki kontroli: które przeszły, a które nie, liczby stron, największą różnicę od oryginału i krótkie nazwy stron, które nie przeszły (na przykład „about”). Nie wysyła adresu strony, domeny, kodu, tekstu, zrzutów ekranu, ścieżek plików, klucza licencyjnego ani nazwy strony.

Kontrole działają na WordPressie na twoim komputerze, którego nasz serwer nigdy nie widzi. Bez ich wyników serwer wiedziałby tylko, że konwersja się nie wysypała. Dlatego następna konwersja startuje dopiero wtedy, gdy poprzednia wyśle wyniki. Aplikacja wysyła je automatycznie. Pełny opis jest na stronie o prywatności.

Edycja w Visual Edit

Strona przekonwertowana z HTML do motywu WordPress nie potrzebuje do działania żadnej wtyczki. Strony, blog, formularze, menu, SEO i przekierowania są częścią motywu. Przekierowania kierują stare adresy na nowe: kto otworzy stary link /about.html, trafi na /about/, więc strona zachowuje pozycje w wyszukiwarce.

Edycję kliknięciem daje Visual Edit, wtyczka WordPress, którą dodajesz samodzielnie. Zmienia się dokładnie to, co klikniesz. Żaden page builder nie przebudowuje pod spodem kodu strony.

FunkcjaLite (za darmo)Pro
Teksty, obrazy i linki kliknięciem✓✓
Formularze, menu i pola SEO✓✓
Historia zmian10 kroków300 kroków
Asystent AI (twój własny klucz API OpenRouter)–✓
Edycja obrazów przez AI i animacje z obrazów–✓
Eksport motywu i ochrona formularzy przez Turnstile–✓

Pro to osobna roczna licencja na stronie z cennikiem. Każda konwersja, Free albo Pro, prowadzi do darmowej wersji Lite. Jeśli wyłączysz wtyczkę, strony dalej się wyświetlają, a motyw pozostaje w pełni używalny.

Licencja, subskrypcja, beta

Ponowne uruchomienia

W wersji darmowej masz łącznie 5 ponownych uruchomień we wszystkich konwersjach, a z licencją Pro są bez limitu. Ponowne uruchomienie to ta sama strona wgrana jeszcze raz. Serwer rozpoznaje ją po odcisku (hashu), więc liczy się jako ponowne uruchomienie, a nie jako nowa konwersja.

Zarządzanie subskrypcją i rezygnacja

Subskrypcją zarządzasz na stronie subskrypcji. Link jest w stopce strony i w każdym e-mailu z licencją. W portalu klienta Paddle możesz zrezygnować z subskrypcji, zmienić kartę, pobrać faktury i przełączyć miesięczny Pro na roczny. Loguje cię linkiem wysłanym na e-mail użyty przy zakupie, więc nie potrzebujesz hasła.

Rezygnacja zatrzymuje następne odnowienie. Twój klucz działa do końca opłaconego okresu, a każdy przekonwertowany motyw zostaje twój. Rezygnacja nie jest zwrotem: zwroty podlegają zasadom zwrotów.

Co oznacza beta

html2wp konwertuje prawdziwe strony i jest używany w prawdziwej pracy. Aplikacja porównuje każdą stronę z oryginałem i każdą znalezioną różnicę zapisuje w raporcie, razem z najlepszym używalnym motywem i opisem tego, czego brakuje. Przejrzyj oznaczone strony, zanim obiecasz klientowi wynik.

Gdy znajdziesz błąd w samym konwerterze, zgłoś go tak, jak opisuje dokumentacja wtyczki. Czyta go człowiek, a poprawki przychodzą jako aktualizacje usługi.