html2wp / Документація

Як перетворити HTML на тему WordPress: посібник для застосунку html2wp

Цей посібник показує, як перетворити HTML на тему WordPress у настільному застосунку html2wp. Він описує встановлення застосунку, першу конвертацію, вибір моделі, що залишає ваш комп’ютер і як редагувати готовий сайт. Конвертацію з агентом у терміналі описано в документації плагіна для Claude Code і Codex.

Частина першаВаша перша конвертація

Встановлення застосунку, що перетворює HTML на тему WordPress

Завантажте застосунок html2wp для Mac з Apple silicon (M1 або новіший) чи для Windows і встановіть його, як будь-яку іншу програму. Версія для Windows поки що є Preview, а версія для Linux з’явиться пізніше.

Під час першого запуску натисніть «Prepare environment» (підготувати середовище). Тоді застосунок завантажить усе потрібне. Це відбувається лише один раз і займає певний час.

Для роботи застосунку потрібен Docker Desktop, безкоштовна програма. Docker запускає тимчасовий WordPress, і застосунок встановлює туди тему й перевіряє її. Якщо Docker у вас немає, застосунок завантажить його і запустить інсталятор за вас. Комп’ютер може попросити ваш пароль під час цього процесу.

Вхід через ChatGPT

Конвертацію виконує AI з вашої підписки ChatGPT, тож за кредити чи токени ви нам не платите.

У застосунку натисніть «Connect with ChatGPT». Застосунок покаже вам код із 9 символів і відкриє в браузері сторінку OpenAI. Там виберіть свій обліковий запис ChatGPT або увійдіть.

Далі сторінка попросить код «з термінала» і згадає Codex CLI. Так і має бути: html2wp використовує Codex, а сторінка просить саме код із застосунку. Вставте його (клікніть код у застосунку, щоб скопіювати) і натисніть «Continue». Після входу застосунок оновиться сам.

Ваш пароль бачить лише OpenAI

Пароль від ChatGPT ви вводите лише на сторінці OpenAI, і застосунок його ніколи не бачить. Нікому не надсилайте код і вводьте його лише тоді, коли самі почали вхід.

Новий проєкт: HTML, який ви перетворюєте на тему

Натисніть «New project» і виберіть папку або ZIP зі своїм сайтом. Це може бути експорт із Lovable, Bolt чи v0, дизайн із Claude або звичайний HTML-сайт. Адресу сайту (URL) застосунок не приймає, бо йому потрібні файли, з яких сайт зібрано.

Застосунок сам визначає, яка сторінка головна, а яка є блогом, статтею чи товаром.

Потім виберіть, що хочете отримати. Зазвичай ви конвертуєте HTML у тему WordPress, у режимі Flash або Full. Якщо WordPress вам не потрібен, виберіть натомість проєкт Astro 5. Така конвертація коротша, і готовий сайт можна розгорнути просто із застосунку на Cloudflare Pages, де його можна хостити безкоштовно.

Flash або Full: два способи перетворити HTML на тему WordPress

Flash є швидкою конвертацією, і в застосунку він стоїть за замовчуванням. Кожен крок виконується один раз. Меню, блог, магазин і форми розпізнаються й підключаються одразу. Перевірки теж виконуються один раз, а їхні результати ви знайдете у звіті. Це займає близько пів години й підходить для більшості сайтів, а також для швидкої спроби.

Full є ретельною конвертацією. Він запускає кожну перевірку й намагається виправити знайдені помилки. Це займає близько години й витрачає більше ліміту вашої підписки ChatGPT. Тому він окупається на складніших сайтах або тоді, коли Flash залишив у звіті багато пунктів для доопрацювання.

Обидва режими перетворюють ваш HTML на робочу тему WordPress і додають примітку про все, що лишилося. Точний час залежить від кількості сторінок і швидкості вашого комп’ютера.

Вибір моделі для перетворення HTML на тему

У застосунку ви вибираєте модель AI і рівень міркування (Reasoning effort).

  • GPT-6-Luna на рівні Extra high достатньо для звичайних конвертацій. Вона дешева, витрачає мало ліміту підписки й сама справляється з більшістю сайтів.
  • GPT-6-Sol на рівні Medium або High ми радимо, коли щось треба виправляти, наприклад у конвертації Full або для правок через чат.
  • GPT-6-Astra є найсильнішою й найдорожчою моделлю. Для звичайної роботи вона не потрібна, але допомагає, коли навіть Sol не може розв’язати проблему.

Модель можна змінити будь-коли, поки не йде конвертація. Кожен проєкт може мати свою.

Перевірка теми WordPress проти вашого HTML

Коли конвертація закінчиться, застосунок вам повідомить. Якщо щось не вийде, він спершу спробує виправити це сам. У будь-якому разі він завжди віддає робочу тему з приміткою про те, що доопрацювати.

На вкладці «Preview» натисніть «Open website» і перегляньте новий сайт у браузері. Вкладка «Compare» показує оригінал і конвертацію поруч, із різницею у відсотках. Напишіть у чат усе, що вам не подобається, і застосунок це виправить. Потім збережіть готові зміни як нову версію кнопкою «Make release».

Автоматичні перевірки ловлять більшість відмінностей, але не всі. Тому перегляньте сторінки, перш ніж передати тему клієнту. ZIP із темою ви зберігаєте на вкладці «Exports» і завантажуєте у WordPress через Зовнішній вигляд → Теми → Додати нову → Завантажити тему.

Частина другаПісля цього

Дані й конфіденційність

Тему збирає наш сервер. Проте більша частина роботи (вимірювання, порівняння з оригіналом і виправлення) відбувається на вашому комп’ютері, і веде її AI у вашому обліковому записі ChatGPT. OpenAI обробляє те, з чим працює AI, за умовами вашого облікового запису.

Що надсилається на сервер

Ваш сайт, перетворений на проєкт Astro (сторінки, стилі, скрипти, зображення й шрифти), плюс інформація про кожну сторінку. Початкова папка проєкту і встановлені бібліотеки (node_modules) не надсилаються. Завантажені дані видаляються автоматично через 48 годин. Залишається лише відбиток (хеш), і завдяки йому повторний запуск рахується як одна конвертація.

Файли з паролями й ключами

Файли, схожі на облікові дані, у пакет не потрапляють узагалі: .env, ключі (.pem, .key, id_rsa), .npmrc, .netrc, папки .ssh і .aws або будь-який файл із приватним ключем. Усе, що застосунок пропустив, ви знайдете поіменно у звіті.

Результати перевірок

Після тестування теми застосунок надсилає лише результати перевірок: які перевірки пройшли, а які ні, кількість сторінок, найбільшу різницю з оригіналом і короткі назви сторінок, що не пройшли (наприклад «about»). Адресу сайту, домен, код, текст, скриншоти, шляхи до файлів, ліцензійний ключ чи назву сайту він не надсилає.

Перевірки працюють із WordPress на вашому комп’ютері, якого наш сервер ніколи не бачить. Без їхніх результатів сервер знав би лише те, що конвертація не впала. Тому наступна конвертація починається тільки після того, як попередня надіслала свої результати. Застосунок надсилає їх автоматично. Повний опис є на сторінці про конфіденційність.

Редагування у Visual Edit

Сайту, який ви сконвертували з HTML у тему WordPress, для роботи не потрібен жоден плагін. Сторінки, блог, форми, меню, SEO і перенаправлення є частиною теми. Перенаправлення ведуть зі старих адрес на нові: хто відкриє старе посилання /about.html, потрапить на /about/, тож сайт зберігає позиції в пошуку.

Редагування кліком дає Visual Edit, плагін WordPress, який ви додаєте самі. Що ви клікнули, те й змінюється. Жоден конструктор сторінок не перебудовує код сторінки під ним.

ФункціяLite (безкоштовно)Pro
Текст, зображення й посилання кліком✓✓
Форми, меню й поля SEO✓✓
Історія змін10 кроків300 кроків
AI-асистент (ваш власний API-ключ OpenRouter)–✓
AI-редагування зображень і анімації із зображень–✓
Експорт теми й захист форм через Turnstile–✓

Pro є окремою річною ліцензією на сторінці з цінами. Кожна конвертація, Free чи Pro, дає посилання на безкоштовну версію Lite. Якщо вимкнути плагін, сторінки й далі відображаються, а тема лишається повністю робочою.

Ліцензія, підписка, бета

Повторні запуски

На безкоштовній версії у вас 5 повторних запусків загалом на всі конвертації, а з ліцензією Pro вони необмежені. Повторний запуск означає той самий сайт, завантажений знову. Сервер упізнає його за відбитком (хешем), тож він рахується як повторний запуск, а не як нова конвертація.

Керування підпискою та її скасування

Підпискою ви керуєте на сторінці підписки. Посилання є в підвалі сайту і в кожному листі про ліцензію. У клієнтському порталі Paddle можна скасувати підписку, змінити картку, завантажити рахунки й перевести місячний Pro на річний. Він впускає вас за посиланням, надісланим на пошту, з якою ви купували, тож пароль не потрібен.

Скасування зупиняє наступне продовження. Ваш ключ працює до кінця оплаченого періоду, і кожна сконвертована тема залишається вашою. Скасування не є поверненням коштів: повернення регулюють умови повернення коштів.

Що означає бета

html2wp конвертує справжні сайти й використовується в реальній роботі. Застосунок порівнює кожну сторінку з оригіналом на ширинах 1440 і 390 px і записує у звіт кожну відмінність, яку знаходить. Разом із темою ви отримуєте опис того, що ще треба доопрацювати. Перегляньте позначені сторінки, перш ніж обіцяти клієнту результат.

Коли знайдете помилку в самому конвертері, повідомте про неї, як описує документація плагіна. Її прочитає людина, а виправлення приходять як оновлення сервісу.