Claude Code ve Codex için eklenti

Kurulum

Eklenti iki GitHub deposunda bulunur: biri Claude Code, biri Codex için. İkisinin içeriği ve sürüm numarası aynıdır. Yalnızca her aracın onları nasıl yüklediği bakımından farklılar. Kendi aracına ait olanı kur, çünkü diğeri yüklenmez.

Kendi aracına geç ve iki komutu art arda çalıştır:

İlk komut GitHub'dan eklenti kataloğunu (marketplace) ekler. Ardından ikincisi html2wp'yi oradan kurar. Codex'in kendi deposuna ihtiyacı var, çünkü eklentileri .agents/plugins/marketplace.json dosyası üzerinden bulur ve Claude Code deposunda bu dosya yoktur.

Güncellemeler

Güncelleme komutunun adı her araçta farklıdır. Codex'te upgrade, Claude Code'da update:

Kurulu sürümü görmek için Codex'te codex plugin list komutunu çalıştır. Claude Code'da /plugin → Marketplaces → html2wp yolunu izle.

Bir güncellemeden sonra Codex'teki sürüm değişmediyse Codex eski bir kopya saklıyordur. Onu sil ve eklentiyi yeniden kur:

Bu da işe yaramazsa Codex'te elle yapılmış bir kurulumdan kalma başka, daha eski bir kopya da olabilir. codex plugin marketplace list komutu her kataloğu yazdırır. Orada html2wp@<other-name> görürsen onu codex plugin remove html2wp@<that-name> ile kaldır.

İşin çoğu html2wp servisinde yapılır ve servis kendini günceller, yani bir sonraki dönüştürmen zaten yeni sürümle çalışır. Yalnızca bilgisayarında çalışan kısmı güncellemen gerekir: kontroller, betikler ve giden veri filtresi. Her sürümde neyin değiştiği GitHub'daki commit geçmişinde.

Gereksinimler

Bunu kendin kontrol etmen gerekmez. Bir dönüştürme başlattığında eklenti önce bilgisayarını kontrol eder ve eksikleri listeler:

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

Playwright veya chromium tarayıcısı gibi yalnızca kullanıcı klasörüne kurulan paketleri eklenti senin yerine kurmayı önerir. Her komuttan önce sorar. Docker Desktop veya daha yeni bir Node.js gibi tüm sistemi değiştiren şeyleri ise yalnızca bildirir ve sen kendin kurana kadar bekler.

Python paketlerini elle kurmak istersen:

Hangi model kullanılmalı

Bir dönüştürme sırasında yapay zekâ birçok karar vermek zorundadır. Örneğin hangi sayfanın ana sayfa olduğu, bir kontrolün neden başarısız olduğu ya da bir müşterinin iki ekran görüntüsü arasındaki farkı fark edip etmeyeceği. Bu yüzden model seçimi sonucu diğer tüm ayarlardan daha çok etkiler.

Claude Code'da işi Opus 5 yapar, önemli kararlarda ise Fable 5'e danışılır. Bir dönüştürme en sık bu kararlarda yanlış gider.

Lisans anahtarı

Ücretsiz sürümde anahtar gerekmez, bu bölümü atla. Lisansın varsa ilk dönüştürmenden önce anahtarı bilgisayarına kaydet. Bunu yalnızca bir kez, herhangi bir klasörden yaparsın:

Anahtarı dosyadan öncelikli olan H2WP_KEY ortam değişkeniyle de verebilirsin. Dosya daha güvenlidir, çünkü o zaman anahtar terminal geçmişine düşmez.

Dosyaya Pro satın aldığında aldığın html2wp lisans anahtarı yazılır. Visual Edit Pro anahtarı oraya girmez. Onu düzenlediğin sitedeki Visual Edit eklentisine girersin ve dönüştürmeler için çalışmaz.

Bir anahtarın geçerli olup olmadığını, ne için ve ne zamana kadar kullanabileceğini öğrenmek için npx html2wp-license YOUR-KEY komutunu çalıştır. Lisanslar sayfasındaki anahtar kontrolü sonucun ne anlama geldiğini açıklar. Bir lisansın neleri içerdiği ve nasıl satın alınacağı lisanslar sayfasında.

Bir projeyi dönüştürmek

Dönüştürmek istediğin projenin klasöründe bir terminal aç ve ajanını orada başlat:

Claude Code kullanıyorsan son satırda codex yerine claude yaz.

Ardından ajana tek bir komut ver:

Hepsi bu. npm install veya npm run build çalıştırmazsın, hiçbir şey de ayarlamazsın. Bolt, v0, shadcn veya bir Next.js dışa aktarımından gelen projeler de aynı şekilde dönüştürülür. Claude Code'a yalnızca /html2wp:html2wp yazabilir ya da Codex'ten html2wp'yi kullanmasını isteyebilirsin. Eklenti o zaman sana neyi dönüştüreceğini sorar.

Bir dönüştürmenin ilk dakikaları

> 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.

Son satırlarda eklenti sayfaları nasıl sınıflandırdığını kaydetti: /blog yazı listesidir, /blog/launch bir yazıdır, geri kalanlar normal sayfalardır. Bu kararı sonunda bitmiş sitede kontrol et.

Diğer girdiler

convert this project komutu bulunduğun klasörü dönüştürür. Dosyalar başka bir yerdeyse yollarını yaz, örneğin convert ./dist.

Girdi her zaman diskinde olmalıdır. Eklenti canlı bir sitenin adresini dönüştürmez. Tarayıcının gösterdiğine değil, sitenin oluşturulduğu dosyalara ihtiyaç duyar.

Bir Lovable projesi nasıl dönüştürülür

Bir Lovable uygulaması React ile yapılır. index.html dosyası yalnızca boş bir öğe ve bir betik içerir, sayfa ancak tarayıcıda canlanır. Bu yüzden eklenti önce projeyi derler, gerçek bir tarayıcıda açar ve her sayfayı bitmiş HTML olarak kaydeder. Açık akordeonlar veya açılır menüler gibi yalnızca betikler çalıştıktan sonra görünen içeriği de yakalar. Sonra temayı bu sayfalardan oluşturur. Ayrıntılar Lovable'dan WordPress'e rehberinde.

Senin yerine neye karar verir

Hangi sayfa ne

Sonucu en çok etkileyen tek bir karar var: hangi sayfanın ana sayfa, hangisinin yazı listesi, hangilerinin yazı ve hangilerinin ürün olduğu. Eklenti bunu sayfa kodundan çıkarır, not eder ve sormadan devam eder. Yalnızca karar veremediğinde durur. Örneğin sitede sınırının izin verdiğinden fazla sayfa olduğunda ya da iki sayfa aynı sayfa gibi göründüğünde.

Bunu yanlış yaparsa düzeltmesi ucuzdur. Sınıflandırmayı düzeltir ve dönüştürmeyi yeniden çalıştırırsın. Bu bir yeniden çalıştırmadır ve dönüştürme sınırından düşmez.

Sonra çoğunlukla kendi kendine ilerler

Sayfa sayısına ve bilgisayarının hızına bağlı olarak Flash yaklaşık yarım saat, Full yaklaşık bir saat sürer. Bu sırada eklenti siteyi derler, orijinaliyle karşılaştırır ve dönüştürme için html2wp servisine gönderir. Ardından bitmiş temayı bilgisayarındaki Docker'da geçici bir WordPress'e kurar ve orada test eder.

Atlayamayacağın inceleme

Sonunda eklenti her sayfayı orijinaliyle yan yana tek bir görüntüde gösterir. Her görüntüye bak ve ne gördüğünü söyle.

Eline ne geçer

• ZIP dosyası olarak tema. Onu WordPress'e Görünüm → Temalar → Yeni ekle → Tema yükle yoluyla yüklersin. Eklenti bozuk bir temayı hiç oluşturmaz: örneğin PHP'de bir sözdizimi hatası varsa, içerik eksikse, tema ekran görüntüsünün boyutu yanlışsa ya da mağazadan bir şey satın alınamıyorsa.
• CONVERSION-REPORT.md raporu, ZIP ile aynı klasörde. Dönüştürülen sayfaları, bağlanan menüleri, incelemede bulduğun her şeyi, dönüştürmedeki her uyarıyı ve hâlâ yapılması gerekenleri listeler.
• Visual Edit Lite bağlantısı, tıklayarak düzenleme için ücretsiz editör. Editör temanın parçası değildir ve tema onsuz çalışır. Visual Edit Pro ayrı, ücretli bir lisanstır.

Tema bağımsızdır. Sayfalar, blog, formlar, menüler, SEO ve yönlendirmeler kodunun parçasıdır ve eklentisiz çalışır. Kod okunabilir PHP, CSS ve JavaScript'tir. Sana aittir ve bize bağlı değildir. Tema hiçbir yere bağlanmaz. Onu tıklayarak nasıl düzenleyeceğin uygulama dokümantasyonunun Visual Edit bölümünde anlatılır.

Bilgisayarından neler çıkar

Tarayıcı işini bilgisayarın yapar: sayfaları derlemek, ekran görüntülerini karşılaştırmak ve son kontroller için Docker'da geçici bir WordPress çalıştırmak. Temanın kendisini html2wp servisi oluşturur. Bu yüzden eklenti servise derlenmiş siteyi gönderir ve temayı geri alır.

Tema kontrolleri senin tarafında çalışır, bu yüzden servis sonuçlarını görmez. Eklenti bu nedenle sonunda sonuçları servise gönderir. Bu zorunludur: servis, önceki dönüştürme sonuçlarını gönderene kadar bir sonraki dönüştürmeyi başlatmaz.

• Gönderilenler: kontrollerin adları, geçip geçmedikleri, sayfa sayıları, en kötü eşleşme yüzdesi ve başarısız olan sayfaların about veya pricing gibi kısa adları.
• Gönderilmeyenler: sitenin adresi veya alan adı, kod, metin, ekran görüntüleri, dosya yolları, lisans anahtarı ya da site adı. Eklenti yalnızca önceden tanımlanmış alanları gönderir, başka hiçbir şey göndermez.
• Kendin kontrol et: send-verdicts.sh <workspace> --dry-run komutu tam olarak neyin gönderileceğini yazdırır ama hiçbir şey göndermez. Okuyabileceğin kısa bir betiktir.

Eklenti başka hiçbir veri göndermez, bitmiş tema ise hiçbir şey göndermez. Verileri ne kadar sakladığımız dahil tam açıklama gizlilik sayfasında.

Hata bildirmek

Dönüştürücünün kendisi bir hata yaparsa bu komutla bildir:

Her bildirimi bir insan okur. Düzeltme ardından servise girer, böylece her kullanıcıya yardımcı olur.