Plugin untuk Claude Code dan Codex

Instalasi

Plugin ini tersedia di dua repositori GitHub, satu untuk Claude Code dan satu untuk Codex. Isi dan nomor versinya sama. Bedanya hanya cara masing-masing alat memuatnya. Pasang repositori yang sesuai dengan alat Anda, karena yang satunya tidak akan termuat.

Pilih alat Anda dan jalankan kedua perintah ini secara berurutan:

Perintah pertama menambahkan katalog plugin (marketplace) dari GitHub. Perintah kedua lalu memasang html2wp dari katalog itu. Codex butuh repositori sendiri karena ia menemukan plugin lewat file .agents/plugins/marketplace.json, dan repositori Claude Code tidak punya file tersebut.

Pembaruan

Nama perintah pembaruan berbeda di tiap alat. Di Codex namanya upgrade, di Claude Code namanya update:

Untuk melihat versi yang terpasang, jalankan codex plugin list di Codex. Di Claude Code, buka /plugin → Marketplaces → html2wp.

Jika versi di Codex tidak berubah setelah pembaruan, berarti Codex menyimpan salinan lama. Hapus salinan itu dan pasang ulang plugin:

Jika itu juga tidak membantu, mungkin Codex punya salinan lain yang lebih lama dari instalasi manual. Perintah codex plugin marketplace list menampilkan semua katalog. Jika Anda melihat html2wp@<other-name> di sana, hapus dengan codex plugin remove html2wp@<that-name>.

Sebagian besar pekerjaan terjadi di layanan html2wp, dan layanan itu memperbarui dirinya sendiri, jadi konversi Anda berikutnya sudah memakai versi baru. Anda hanya perlu memperbarui bagian yang berjalan di komputer Anda: pemeriksaan, skrip, dan filter untuk data keluar. Perubahan di tiap versi tercatat di riwayat commit di GitHub.

Persyaratan

Anda tidak perlu memeriksanya sendiri. Saat konversi dimulai, plugin lebih dulu memeriksa komputer Anda dan mendaftar apa yang kurang:

Node.js                ok        v22.14.0
Python                 ok        3.12.4
Playwright             MISSING   mirroring, prerendering and every screenshot
Docker                 NOT RUNNING  installed, but the daemon is not up

Untuk paket yang hanya terpasang di folder pengguna Anda, seperti Playwright atau browser chromium, plugin menawarkan untuk memasangnya. Ia bertanya sebelum setiap perintah. Hal yang mengubah seluruh sistem, seperti Docker Desktop atau Node.js versi baru, hanya dilaporkan. Setelah itu plugin menunggu sampai Anda memasangnya sendiri.

Jika ingin memasang paket Python secara manual:

Model yang dipakai

Selama konversi, AI harus mengambil banyak keputusan. Misalnya halaman mana yang menjadi beranda, mengapa sebuah pemeriksaan gagal, atau apakah klien akan menyadari perbedaan antara dua screenshot. Jadi pilihan model memengaruhi hasil lebih besar daripada pengaturan lain mana pun.

Di Claude Code, Opus 5 mengerjakan tugasnya dan Fable 5 dimintai pendapat untuk keputusan penting, yaitu titik di mana konversi paling sering salah.

Kunci lisensi

Di paket gratis Anda tidak butuh kunci, jadi lewati bagian ini. Jika Anda punya lisensi, simpan kuncinya di komputer sebelum konversi pertama. Cukup sekali, dari folder mana pun:

Anda juga bisa memberikan kunci lewat variabel lingkungan H2WP_KEY, yang lebih diutamakan daripada file. File lebih aman, karena kuncinya tidak tercatat di riwayat terminal.

File itu diisi dengan kunci lisensi html2wp yang Anda terima saat membeli Pro. Kunci Visual Edit Pro tidak dimasukkan ke sana. Kunci itu Anda isi di plugin Visual Edit pada situs yang Anda edit, dan tidak berlaku untuk konversi.

Untuk mengetahui apakah kunci valid, untuk apa bisa dipakai, dan sampai kapan, jalankan npx html2wp-license YOUR-KEY. Pemeriksaan kunci di halaman lisensi menjelaskan arti hasilnya. Isi lisensi dan cara membelinya ada di halaman lisensi.

Mengonversi proyek

Buka terminal di folder proyek yang ingin Anda konversi, lalu jalankan agen Anda di sana:

Jika Anda memakai Claude Code, ketik claude sebagai ganti codex di baris terakhir.

Lalu beri agen satu perintah:

Itu saja. Anda tidak menjalankan npm install atau npm run build, dan tidak mengatur apa pun. Proyek dari Bolt, v0, shadcn, atau ekspor Next.js dikonversi dengan cara yang sama. Di Claude Code Anda juga bisa mengetik /html2wp:html2wp saja, atau meminta Codex memakai html2wp. Plugin kemudian menanyakan apa yang ingin dikonversi.

Menit-menit pertama konversi

> convert this project

  Checking this machine first…
    Node.js     ok    v22.14.0
    Playwright  MISSING
  Two Python packages are missing. Shall I install them? (they go in your
  user directory, no root)

> yes

  … installed. Building the project, then prerendering it.
  7 routes found: /, /about, /pricing, /blog, /blog/launch, /contact, /faq
  Decided: /blog is the listing, /blog/launch an article, the rest are pages.
  Written to the manifest; carrying on.

Di baris terakhir, plugin mencatat cara ia mengelompokkan halaman: /blog adalah daftar artikel, /blog/launch adalah artikel, dan sisanya halaman biasa. Periksa keputusan ini di situs jadi pada akhir proses.

Input lain

Perintah convert this project mengonversi folder tempat Anda berada. Jika file ada di tempat lain, ketik path-nya, misalnya convert ./dist.

Input harus selalu ada di disk Anda. Plugin tidak mengonversi alamat situs yang sudah online. Ia membutuhkan file penyusun situs, bukan tampilan di browser.

Cara proyek Lovable dikonversi

Aplikasi Lovable dibuat dengan React. File index.html-nya hanya berisi elemen kosong dan sebuah skrip, dan halamannya baru hidup di browser. Jadi plugin lebih dulu mem-build proyek, membukanya di browser sungguhan, dan menyimpan setiap halaman sebagai HTML jadi. Plugin juga menangkap konten yang baru muncul setelah skrip berjalan, seperti accordion yang terbuka atau menu dropdown. Setelah itu ia membuat tema dari halaman-halaman ini. Detailnya ada di panduan Lovable ke WordPress.

Yang diputuskan untuk Anda

Halaman mana yang mana

Satu keputusan paling berpengaruh pada hasil: halaman mana yang menjadi beranda, mana daftar artikel, mana artikel, dan mana produk. Plugin menyimpulkannya dari kode halaman, mencatatnya, lalu melanjutkan tanpa bertanya. Ia hanya berhenti saat tidak bisa memutuskan. Misalnya ketika situs punya lebih banyak halaman daripada batas Anda, atau ketika dua halaman tampak seperti halaman yang sama.

Jika keputusannya salah, perbaikannya murah. Anda membetulkan pengelompokan dan menjalankan konversi lagi. Itu disebut proses ulang (re-run), dan tidak mengurangi batas konversi Anda.

Setelah itu sebagian besar berjalan sendiri

Flash butuh sekitar setengah jam, Full sekitar satu jam, tergantung jumlah halaman dan kecepatan komputer Anda. Sementara itu plugin mem-build situs, membandingkannya dengan aslinya, dan mengirimkannya ke layanan html2wp untuk dikonversi. Setelah itu tema jadi dipasang ke WordPress sementara di Docker pada komputer Anda dan diuji di sana.

Pemeriksaan yang wajib

Di akhir, plugin menampilkan setiap halaman berdampingan dengan aslinya dalam satu gambar. Lihat setiap gambar dan katakan apa yang Anda lihat.

Yang Anda dapatkan

• Tema dalam file ZIP. Anda mengunggahnya ke WordPress lewat Tampilan → Tema → Tambah Baru → Unggah Tema. Plugin sama sekali tidak membuat tema yang rusak, misalnya jika PHP-nya punya kesalahan sintaks, ada konten yang hilang, screenshot tema berukuran salah, atau toko tidak bisa dipakai untuk membeli.
• Laporan CONVERSION-REPORT.md di folder yang sama dengan ZIP. Laporan ini berisi halaman yang dikonversi, menu yang sudah terhubung, semua temuan Anda saat pemeriksaan, setiap peringatan dari konversi, dan apa yang masih perlu dikerjakan.
• Tautan ke Visual Edit Lite, editor gratis untuk mengedit dengan klik. Editor ini bukan bagian dari tema, dan tema berfungsi tanpanya. Visual Edit Pro adalah lisensi berbayar terpisah.

Tema ini mandiri. Halaman, blog, formulir, menu, SEO, dan redirect adalah bagian dari kodenya dan berjalan tanpa plugin. Kodenya berupa PHP, CSS, dan JavaScript yang mudah dibaca. Kode itu milik Anda dan tidak terikat dengan kami. Tema tidak terhubung ke mana pun. Cara mengeditnya dengan klik dijelaskan di bagian Visual Edit dalam dokumentasi aplikasi.

Data yang keluar dari komputer

Komputer Anda mengerjakan bagian browser: mem-build halaman, membandingkan screenshot, dan menjalankan WordPress sementara di Docker untuk pemeriksaan akhir. Temanya sendiri dibuat oleh layanan html2wp. Jadi plugin mengirimkan situs yang sudah di-build ke layanan itu dan menerima tema kembali.

Pemeriksaan tema berjalan di sisi Anda, jadi layanan tidak melihat hasilnya. Karena itu di akhir proses plugin mengirimkan hasil tersebut. Ini wajib: layanan tidak memulai konversi berikutnya sampai konversi sebelumnya mengirim hasilnya.

• Yang dikirim: nama pemeriksaan, lolos atau tidak, jumlah halaman, persentase kecocokan terburuk, dan nama pendek halaman yang gagal, seperti about atau pricing.
• Yang tidak dikirim: alamat atau domain situs, kode, teks, screenshot, path file, kunci lisensi, atau nama situs. Plugin hanya mengirim kolom yang sudah ditentukan, tidak lebih.
• Periksa sendiri: perintah send-verdicts.sh <workspace> --dry-run menampilkan persis apa yang akan dikirim, tanpa mengirim apa pun. Ini satu skrip pendek yang bisa Anda baca.

Plugin tidak mengirim data lain, dan tema jadi tidak mengirim apa pun. Uraian lengkap, termasuk berapa lama kami menyimpan data, ada di halaman privasi.

Melaporkan bug

Jika konverter sendiri membuat kesalahan, laporkan dengan perintah ini:

Setiap laporan dibaca oleh seorang manusia. Perbaikannya lalu masuk ke layanan, jadi membantu semua pengguna.