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

Создание темы WordPress из HTML в приложении html2wp

Это руководство показывает создание темы WordPress из HTML в настольном приложении html2wp: установку приложения, первую конвертацию, выбор модели, то, что покидает ваш компьютер, и правку готового сайта. Конвертация с агентом в терминале описана в документации плагина для Claude Code и Codex.

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

Установка приложения для создания темы WordPress

Скачайте приложение html2wp для Mac на Apple silicon (M1 или новее) или для Windows и установите его, как любую другую программу. Версия для Windows пока в статусе Preview, а версия для Linux выйдет позже.

При первом запуске нажмите «Prepare environment» (подготовить окружение). Приложение скачает всё, что ему нужно. Это делается один раз и занимает некоторое время.

Для работы приложению нужен Docker Desktop, бесплатная программа. Docker запускает временный WordPress, и приложение устанавливает туда тему и проверяет её. Если Docker у вас нет, приложение скачает его и само запустит установщик. По ходу компьютер может спросить ваш пароль.

Вход через ChatGPT

Конвертацию выполняет ИИ из вашей подписки ChatGPT, поэтому вы не платите нам за кредиты или токены.

В приложении нажмите «Connect with ChatGPT». Приложение покажет код из 9 символов и откроет в браузере страницу OpenAI. Там выберите свой аккаунт ChatGPT или войдите в него.

Затем страница попросит код «из терминала» и упомянет Codex CLI. Так и должно быть: html2wp использует Codex, а нужный странице код и есть тот, что в приложении. Вставьте его (нажмите на код в приложении, чтобы скопировать) и нажмите «Continue». После входа приложение обновится само.

Ваш пароль видит только OpenAI

Пароль от ChatGPT вы вводите только на странице OpenAI, и приложение его никогда не видит. Никому не отправляйте код и вводите его, только если вход начали вы сами.

Новый проект: создание темы WordPress из вашего HTML

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

Приложение само определяет, какая страница главная, а какая блог, статья или товар.

Затем выберите, что хотите получить. Обычно вы конвертируете HTML в тему WordPress, в режиме Flash или Full. Если WordPress вам не нужен, выберите вместо этого проект Astro 5. Такая конвертация короче, и готовый сайт можно прямо из приложения опубликовать на Cloudflare Pages, где его можно бесплатно разместить.

Flash или Full: создание темы WordPress двумя способами

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

Full работает как тщательная конвертация. Он запускает все проверки и пытается исправить найденные ошибки. Это занимает около часа и расходует больше лимита вашей подписки ChatGPT. Поэтому он окупается на более сложных сайтах или когда после Flash в отчёте осталось много пунктов для доводки.

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

Выбор модели: создание темы WordPress из HTML

В приложении вы выбираете модель ИИ и уровень рассуждения (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 в разделе «Внешний вид → Темы → Добавить новую тему → Загрузить тему».

Часть втораяПосле этого

Данные и конфиденциальность

Тему собирает наш сервер. Но большая часть работы (измерение, сравнение с оригиналом и исправления) идёт на вашем компьютере, и ведёт её ИИ в вашем аккаунте ChatGPT. OpenAI обрабатывает то, с чем работает ИИ, по условиям вашего аккаунта.

Что отправляется на сервер

Ваш сайт, сконвертированный в проект 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 шагов
ИИ-ассистент (ваш собственный API-ключ OpenRouter)–✓
ИИ-редактирование изображений и анимации из них–✓
Экспорт темы и защита форм через Turnstile–✓

Pro продаётся как отдельная годовая лицензия на странице с ценами. Каждая конвертация, Free или Pro, ссылается на бесплатную версию Lite. Если выключить плагин, страницы продолжают отображаться, и тема остаётся полностью рабочей.

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

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

На бесплатном тарифе у вас всего 5 повторных запусков на все конвертации, а с лицензией Pro они не ограничены. Повторный запуск означает, что тот же сайт загружен снова. Сервер узнаёт его по отпечатку (хешу), поэтому он считается повторным запуском, а не новой конвертацией.

Управление подпиской и отмена

Подпиской вы управляете на странице подписки. Ссылка на неё есть в подвале сайта и в каждом письме о лицензии. В клиентском портале Paddle можно отменить подписку, сменить карту, скачать счета и перевести месячный Pro на годовой. Портал впускает вас по ссылке, отправленной на почту, с которой вы покупали, поэтому пароль не нужен.

Отмена останавливает следующее продление. Ключ работает до конца оплаченного периода, и каждая сконвертированная тема остаётся вашей. Отмена не является возвратом денег: возвраты идут по условиям возврата.

Что значит бета

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

Если вы нашли ошибку в самом конвертере, сообщите о ней так, как описано в документации плагина. Её прочтёт человек, а исправления выходят как обновления сервиса.