html2wp / Tài liệu

Cách chuyển HTML thành theme WordPress: hướng dẫn trong ứng dụng html2wp

Tài liệu này chỉ cách chuyển HTML thành theme WordPress trong ứng dụng desktop html2wp. Nội dung gồm cài ứng dụng, lần chuyển đổi đầu tiên, chọn model, những gì rời khỏi máy tính của bạn và cách sửa site hoàn chỉnh. Chuyển đổi bằng agent trong terminal được mô tả trong tài liệu plugin cho Claude Code và Codex.

Phần mộtLần chuyển đổi đầu tiên

Cài ứng dụng chuyển HTML thành theme WordPress

Tải ứng dụng html2wp cho máy Mac chip Apple silicon (M1 trở lên) hoặc cho Windows, và cài như mọi ứng dụng khác. Bản Windows vẫn là bản xem trước (Preview), và bản Linux sẽ có sau.

Khi mở lần đầu, hãy bấm "Prepare environment". Ứng dụng sẽ tải mọi thứ nó cần. Việc này chỉ diễn ra một lần và mất một lúc.

Để làm việc, ứng dụng cần Docker Desktop, một chương trình miễn phí. Docker chạy một WordPress tạm thời, và ứng dụng cài theme vào đó rồi kiểm tra. Nếu bạn chưa có Docker, ứng dụng tự tải và khởi động trình cài đặt cho bạn. Máy tính có thể hỏi mật khẩu trong lúc đó.

Đăng nhập bằng ChatGPT

Việc chuyển đổi do AI trong gói ChatGPT của bạn thực hiện, nên bạn không trả chúng tôi tiền credit hay token.

Trong ứng dụng, bấm "Connect with ChatGPT". Ứng dụng hiện một mã 9 ký tự và mở trang OpenAI trong trình duyệt. Ở đó, chọn tài khoản ChatGPT hoặc đăng nhập.

Tiếp theo, trang hỏi bạn mã “từ terminal” và nhắc đến Codex CLI. Không sao cả: html2wp dùng Codex, và mã trang cần chính là mã từ ứng dụng. Dán nó vào (bấm vào mã trong ứng dụng để sao chép) và bấm "Continue". Sau khi bạn đăng nhập, ứng dụng tự cập nhật.

Chỉ OpenAI thấy mật khẩu của bạn

Bạn chỉ gõ mật khẩu ChatGPT trên trang của OpenAI, và ứng dụng không bao giờ thấy nó. Đừng gửi mã cho ai, và chỉ nhập mã khi chính bạn bắt đầu đăng nhập.

Dự án mới: HTML bạn chuyển thành theme

Bấm "New project" và chọn thư mục hoặc file ZIP chứa site của bạn. Đó có thể là bản xuất từ Lovable, Bolt hay v0, một thiết kế từ Claude hoặc một site HTML thuần. Ứng dụng không nhận địa chỉ site (URL), vì nó cần các file tạo nên site.

Ứng dụng tự xác định trang nào là trang chủ, trang nào là blog, bài viết hay sản phẩm.

Sau đó chọn bạn muốn nhận gì. Thường thì bạn chuyển HTML thành theme WordPress, ở chế độ Flash hoặc Full. Nếu không cần WordPress, hãy chọn dự án Astro 5. Lần chuyển đổi đó ngắn hơn, và bạn có thể triển khai site hoàn chỉnh ngay từ ứng dụng lên Cloudflare Pages, nơi bạn lưu trữ nó miễn phí.

Flash hay Full: hai cách chuyển HTML sang theme WordPress

Flash là chuyển đổi nhanh, và là mặc định trong ứng dụng. Mỗi bước chạy một lần. Menu, blog, cửa hàng và form được nhận diện và nối ngay. Các bước kiểm tra cũng chạy một lần, và bạn tìm thấy kết quả trong báo cáo. Nó mất khoảng nửa giờ và hợp với phần lớn site, cũng như để thử nhanh.

Full là chuyển đổi kỹ. Nó chạy mọi bước kiểm tra và cố sửa các lỗi tìm thấy. Nó mất khoảng một giờ và dùng nhiều hạn mức gói ChatGPT của bạn hơn. Vì vậy nó đáng dùng cho site phức tạp hơn, hoặc khi Flash để lại nhiều điểm cần hoàn thiện trong báo cáo.

Cả hai chế độ đều chuyển HTML của bạn thành theme WordPress dùng được và ghi chú những gì còn lại. Thời gian chính xác tùy số trang và tốc độ máy tính của bạn.

Chọn model để chuyển HTML thành theme

Trong ứng dụng, bạn chọn model AI và mức suy luận (Reasoning effort).

  • GPT-6-Luna ở mức Extra high là đủ cho các lần chuyển đổi thông thường. Nó rẻ, dùng ít hạn mức gói và tự xử lý được phần lớn site.
  • GPT-6-Sol ở mức Medium hoặc High là model chúng tôi khuyên dùng khi có gì cần sửa, ví dụ trong chuyển đổi Full hoặc khi sửa qua chat.
  • GPT-6-Astra là model mạnh nhất và đắt nhất. Bạn không cần nó cho công việc thường ngày, nhưng nó hữu ích khi ngay cả Sol cũng không giải quyết được vấn đề.

Bạn có thể đổi model bất cứ lúc nào không có lần chuyển đổi nào đang chạy. Mỗi dự án có thể có model riêng.

Kiểm tra theme WordPress so với HTML của bạn

Khi chuyển đổi xong, ứng dụng sẽ báo cho bạn. Nếu có gì không ổn, trước tiên nó tự sửa. Dù thế nào, nó luôn bàn giao một theme dùng được, kèm ghi chú những gì cần hoàn thiện.

Trong tab "Preview", bấm "Open website" và xem site mới trong trình duyệt. Tab "Compare" hiển thị bản gốc và bản chuyển đổi cạnh nhau, kèm mức chênh lệch tính bằng phần trăm. Gõ bất cứ điều gì bạn không thích vào khung chat, và ứng dụng sẽ sửa. Sau đó lưu các thay đổi đã xong thành phiên bản mới bằng "Make release".

Kiểm tra tự động bắt được phần lớn khác biệt, nhưng không phải tất cả. Vì vậy hãy xem qua các trang trước khi giao theme cho khách hàng. Bạn lưu file ZIP theme trong tab "Exports" và tải lên WordPress tại Giao diện → Giao diện → Thêm mới → Tải giao diện lên.

Phần haiSau đó

Dữ liệu và quyền riêng tư

Máy chủ của chúng tôi build theme. Tuy vậy, phần lớn công việc (đo, so sánh với bản gốc và sửa lỗi) chạy trên máy tính của bạn, và AI trong tài khoản ChatGPT của bạn điều khiển việc đó. OpenAI xử lý những gì AI làm theo điều khoản tài khoản của bạn.

Những gì được gửi lên máy chủ

Site của bạn đã chuyển thành dự án Astro (trang, style, script, hình ảnh và font), cộng thông tin về từng trang. Thư mục dự án gốc và các thư viện đã cài (node_modules) không được gửi. Dữ liệu đã tải lên tự động bị xóa sau 48 giờ. Chỉ còn lại một dấu vân tay (hash), và nhờ nó một lần chạy lại được tính là cùng một lần chuyển đổi.

File chứa mật khẩu và khóa

Các file trông giống thông tin đăng nhập không bao giờ vào gói gửi đi: .env, khóa (.pem, .key, id_rsa), .npmrc, .netrc, thư mục .ssh và .aws, hay bất kỳ file nào chứa private key. Bạn tìm thấy mọi thứ ứng dụng đã bỏ ra, theo tên, trong báo cáo.

Kết quả kiểm tra

Sau khi kiểm thử theme, ứng dụng chỉ gửi kết quả kiểm tra: bước nào đạt và bước nào không, số trang, mức khác biệt lớn nhất so với bản gốc và tên ngắn của các trang không đạt (ví dụ “about”). Nó không gửi địa chỉ site, tên miền, mã, nội dung chữ, ảnh chụp màn hình, đường dẫn file, khóa giấy phép hay tên site.

Các bước kiểm tra chạy trên WordPress trong máy tính của bạn, nơi máy chủ của chúng tôi không bao giờ thấy. Không có kết quả của chúng, máy chủ chỉ biết lần chuyển đổi không bị treo. Vì vậy lần chuyển đổi tiếp theo chỉ bắt đầu sau khi lần trước đã gửi kết quả. Ứng dụng tự gửi chúng. Mô tả đầy đủ có trên trang quyền riêng tư.

Chỉnh sửa bằng Visual Edit

Site bạn chuyển từ HTML thành theme WordPress không cần plugin nào để chạy. Trang, blog, form, menu, SEO và chuyển hướng đều là một phần của theme. Chuyển hướng đưa địa chỉ cũ sang địa chỉ mới: ai mở link cũ /about.html sẽ tới /about/, nên site giữ được thứ hạng tìm kiếm.

Việc chỉnh sửa bằng cách trỏ và bấm đến từ Visual Edit, một plugin WordPress bạn tự thêm vào. Bạn bấm vào đâu thì chỗ đó thay đổi. Không page builder nào dựng lại mã trang bên dưới.

Tính năngLite (miễn phí)Pro
Chữ, hình ảnh và liên kết bằng cách bấm vào✓✓
Form, menu và trường SEO✓✓
Lịch sử chỉnh sửa10 bước300 bước
Trợ lý AI (API key OpenRouter của bạn)–✓
Sửa ảnh bằng AI và tạo animation từ ảnh–✓
Xuất theme và bảo vệ form bằng Turnstile–✓

Pro là giấy phép theo năm riêng, có trên trang bảng giá. Mọi lần chuyển đổi, Free hay Pro, đều dẫn tới bản Lite miễn phí. Nếu bạn tắt plugin, các trang vẫn hiển thị và theme vẫn dùng được đầy đủ.

Giấy phép, gói đăng ký, beta

Chạy lại

Ở bản miễn phí, bạn có tổng cộng 5 lần chạy lại cho mọi lần chuyển đổi, và với giấy phép Pro thì không giới hạn. Chạy lại là tải lên lại cùng một site. Máy chủ nhận ra nó qua dấu vân tay (hash), nên nó được tính là chạy lại, không phải lần chuyển đổi mới.

Quản lý và hủy gói đăng ký

Bạn quản lý gói đăng ký trên trang gói đăng ký. Link có ở chân trang và trong mọi email về giấy phép. Trong cổng khách hàng của Paddle, bạn có thể hủy gói, đổi thẻ, tải hóa đơn và chuyển Pro theo tháng sang theo năm. Cổng đăng nhập cho bạn bằng một link gửi tới email bạn đã dùng khi mua, nên bạn không cần mật khẩu.

Hủy gói dừng lần gia hạn tiếp theo. Khóa của bạn chạy đến hết kỳ đã trả, và mọi theme bạn đã chuyển đổi vẫn là của bạn. Hủy gói không phải là hoàn tiền: hoàn tiền tuân theo điều kiện hoàn tiền.

Beta nghĩa là gì

html2wp chuyển đổi site thật và được dùng cho công việc thật. Ứng dụng so sánh từng trang với bản gốc và ghi mọi bước kiểm tra không đạt vào báo cáo, cạnh theme dùng được tốt nhất và mô tả những chỗ chưa đạt. Kiểm tra tự động có thể bỏ sót một khác biệt, nên hãy tự xem qua các trang trước khi hứa với khách hàng một kết quả.

Khi bạn tìm thấy lỗi trong chính công cụ chuyển đổi, hãy báo cáo như tài liệu plugin mô tả. Một người sẽ đọc, và bản sửa đến dưới dạng cập nhật dịch vụ.