html2wp / Dokümantasyon
html2wp uygulamasında HTML'den WordPress teması oluşturma
Bu rehber, html2wp masaüstü uygulamasında HTML'den WordPress teması oluşturmayı anlatır: uygulamanın kurulumu, ilk dönüştürmen, model seçimi, bilgisayarından neyin çıktığı ve bitmiş siteyi nasıl düzenlediğin. Terminalde bir ajanla dönüştürme ise Claude Code ve Codex eklenti dokümantasyonunda anlatılır.
WordPress teması oluşturan uygulamayı kurmak
html2wp uygulamasını Apple Silicon işlemcili (M1 ve sonrası) bir Mac veya Windows için indir ve diğer uygulamalar gibi kur. Windows sürümü hâlâ önizleme (Preview) aşamasında, Linux sürümü daha sonra gelecek.
Uygulamayı ilk açtığında “Prepare environment” (ortamı hazırla) düğmesine tıkla. Uygulama ihtiyaç duyduğu her şeyi indirir. Bunu yalnızca bir kez yapar ve biraz zaman alır.
Uygulama, işi için ücretsiz bir program olan Docker Desktop'a ihtiyaç duyar. Docker geçici bir WordPress çalıştırır, uygulama temayı oraya kurar ve kontrol eder. Docker yoksa uygulama onu indirir ve kurulum programını senin için başlatır. Bu sırada bilgisayarın parolanı isteyebilir.
ChatGPT ile giriş
Dönüştürmeyi ChatGPT aboneliğindeki yapay zekâ yapar, bu yüzden bize kredi veya token için ödeme yapmazsın.
Uygulamada “Connect with ChatGPT” (ChatGPT ile bağlan) düğmesine tıkla. Uygulama sana 9 karakterlik bir kod gösterir ve tarayıcında bir OpenAI sayfası açar. Orada ChatGPT hesabını seç veya giriş yap.
Ardından sayfa senden “terminaldeki” bir kodu ister ve Codex CLI'dan bahseder. Bu normal: html2wp Codex kullanır ve sayfanın istediği kod, uygulamadaki koddur. Onu yapıştır (kopyalamak için uygulamadaki koda tıkla) ve “Continue” düğmesine bas. Giriş yaptıktan sonra uygulama kendini günceller.
Parolanı yalnızca OpenAI görür
ChatGPT parolanı yalnızca OpenAI sayfasına yazarsın, uygulama onu hiç görmez. Kodu kimseye gönderme ve yalnızca girişi kendin başlattıysan gir.
Yeni proje: WordPress temasına dönüştürdüğün HTML
“New project” (yeni proje) düğmesine tıkla ve sitenin bulunduğu klasörü veya ZIP dosyasını seç. Bu Lovable, Bolt veya v0'dan bir dışa aktarım, Claude'da yapılmış bir tasarım ya da düz bir HTML sitesi olabilir. Uygulama bir site adresi (URL) kabul etmez, çünkü sitenin oluşturulduğu dosyalara ihtiyaç duyar.
Hangi sayfanın ana sayfa, hangisinin blog, yazı veya ürün olduğunu uygulama kendisi belirler.
Sonra ne almak istediğini seç. Genellikle Flash veya Full modunda HTML'den WordPress teması oluşturmayı seçersin. WordPress'e ihtiyacın yoksa bunun yerine bir Astro 5 projesi seç. Bu dönüştürme daha kısadır ve bitmiş siteyi doğrudan uygulamadan, ücretsiz barındırabileceğin Cloudflare Pages üzerinde yayınlayabilirsin.
Flash veya Full: WordPress teması oluşturmanın iki yolu
Flash hızlı dönüştürmedir ve uygulamada varsayılan odur. Her adım bir kez çalışır. Menüler, blog, mağaza ve formlar hemen tanınır ve bağlanır. Kontroller de bir kez çalışır ve sonuçlarını raporda bulursun. Yaklaşık yarım saat sürer ve çoğu siteye, hızlı bir denemeye de uygundur.
Full kapsamlı dönüştürmedir. Her kontrolü çalıştırır ve bulduğu hataları düzeltmeye çalışır. Yaklaşık bir saat sürer ve ChatGPT abonelik sınırından daha fazla harcar. Bu yüzden daha karmaşık sitelerde ya da Flash raporda cilalanacak çok nokta bıraktığında işe yarar.
İki mod da HTML'den kullanılabilir bir WordPress teması oluşturmayı tamamlar ve kalan her şey için bir not ekler. Tam süre sayfa sayısına ve bilgisayarının hızına bağlıdır.
Tema oluşturmak için model seçimi
Uygulamada yapay zekâ modelini ve akıl yürütme seviyesini (Reasoning effort) seçersin.
- GPT-6-Luna, Extra high seviyesinde normal dönüştürmeler için yeterlidir. Ucuzdur, abonelik sınırından az harcar ve çoğu siteyi tek başına halleder.
- GPT-6-Sol, Medium veya High seviyesinde, bir şeyin düzeltilmesi gerektiğinde önerdiğimiz modeldir: örneğin bir Full dönüştürmede veya sohbet üzerinden yapılan düzenlemelerde.
- GPT-6-Astra en güçlü ve en pahalı modeldir. Normal işler için ona ihtiyacın yok, ama Sol'un bile çözemediği bir sorunda yardımcı olur.
Hiçbir dönüştürme çalışmıyorken modeli istediğin zaman değiştirebilirsin. Her projenin kendi modeli olabilir.
WordPress temasını HTML'inle karşılaştırmak
Dönüştürme bittiğinde uygulama sana haber verir. Bir şey yolunda gitmezse önce kendi başına düzeltmeye çalışır. Her durumda, neyin cilalanacağına dair bir notla birlikte kullanılabilir bir tema teslim eder.
“Preview” sekmesinde “Open website” düğmesine tıkla ve yeni siteye tarayıcında bak. “Compare” sekmesi orijinali ve dönüştürülmüş hâlini yan yana, farkı yüzde olarak gösterir. Beğenmediğin her şeyi sohbete yaz, uygulama düzeltir. Sonra bitmiş değişiklikleri “Make release” ile yeni bir sürüm olarak kaydet.
Otomatik kontroller farkların çoğunu yakalar, ama hepsini değil. Bu yüzden temayı bir müşteriye vermeden önce sayfalara göz at. Tema ZIP'ini “Exports” sekmesinde kaydeder ve WordPress'e Görünüm → Temalar → Yeni ekle → Tema yükle yoluyla yüklersin.
Veriler ve gizlilik
Temayı bizim sunucumuz oluşturur. Ancak işin çoğu (ölçüm, orijinalle karşılaştırma ve düzeltme) senin bilgisayarında yapılır ve bunu ChatGPT hesabındaki yapay zekâ yürütür. OpenAI, yapay zekânın üzerinde çalıştığı içeriği hesabının koşullarına göre işler.
Sunucuya ne gönderilir
Astro projesine dönüştürülmüş siten (sayfalar, stiller, betikler, görseller ve yazı tipleri) ve her sayfa hakkında bilgi. Orijinal proje klasörü ve kurulu kütüphaneler (node_modules) gönderilmez. Yüklenen veriler 48 saat sonra otomatik olarak silinir. Yalnızca bir parmak izi (hash) kalır ve onun sayesinde bir yeniden çalıştırma tek dönüştürme sayılır.
Parola ve anahtar içeren dosyalar
Giriş bilgilerine benzeyen dosyalar pakete hiç girmez: .env, anahtarlar (.pem, .key, id_rsa), .npmrc, .netrc, .ssh ve .aws klasörleri ya da özel anahtar içeren herhangi bir dosya. Uygulamanın dışarıda bıraktığı her şeyi adıyla raporda bulursun.
Kontrol sonuçları
Temayı test ettikten sonra uygulama yalnızca kontrol sonuçlarını gönderir: hangi kontrollerin geçip hangilerinin geçmediği, sayfa sayıları, orijinalden en büyük fark ve başarısız olan sayfaların kısa adları (örneğin “about”). Site adresini, alan adını, kodu, metni, ekran görüntülerini, dosya yollarını, lisans anahtarını veya site adını göndermez.
Kontroller, sunucumuzun hiç görmediği, bilgisayarındaki WordPress'e karşı çalışır. Sonuçları olmadan sunucu yalnızca dönüştürmenin çökmediğini bilirdi. Bu yüzden bir sonraki dönüştürme ancak önceki sonuçlarını gönderdikten sonra başlar. Uygulama onları otomatik olarak gönderir. Tam açıklama gizlilik sayfasında.
Visual Edit ile düzenleme
HTML'den WordPress teması oluşturarak dönüştürdüğün bir site, çalışmak için hiçbir eklentiye ihtiyaç duymaz. Sayfalar, blog, formlar, menüler, SEO ve yönlendirmeler temanın parçasıdır. Yönlendirmeler eski adresleri yenilerine gönderir: eski /about.html bağlantısını açan herkes /about/ sayfasına gelir, böylece site arama sıralamalarını korur.
Tıklayarak düzenleme, kendin eklediğin bir WordPress eklentisi olan Visual Edit'ten gelir. Neye tıklarsan yalnızca o değişir. Hiçbir sayfa oluşturucu arka planda sayfanın kodunu yeniden kurmaz.
| Özellik | Lite (ücretsiz) | Pro |
|---|---|---|
| Tıklayarak metin, görsel ve bağlantılar | ✓ | ✓ |
| Formlar, menüler ve SEO alanları | ✓ | ✓ |
| Düzenleme geçmişi | 10 adım | 300 adım |
| Yapay zekâ asistanı (kendi OpenRouter API anahtarın) | – | ✓ |
| Yapay zekâ ile görsel düzenleme ve görsellerden animasyon | – | ✓ |
| Tema dışa aktarımı ve Turnstile ile form koruması | – | ✓ |
Pro, fiyatlandırma sayfasında satılan ayrı bir yıllık lisanstır. Free veya Pro, her dönüştürme ücretsiz Lite sürümüne bağlantı verir. Eklentiyi kapatırsan sayfalar görüntülenmeye devam eder ve tema tamamen kullanılabilir kalır.
Lisans, abonelik, beta
Yeniden çalıştırmalar
Ücretsiz sürümde tüm dönüştürmeler için toplam 5 yeniden çalıştırma hakkın var, Pro lisansla ise sınırsız. Yeniden çalıştırma, aynı sitenin tekrar yüklenmesidir. Sunucu onu parmak izinden (hash) tanır, bu yüzden yeni bir dönüştürme değil, yeniden çalıştırma sayılır.
Aboneliği yönetmek ve iptal etmek
Aboneliğini abonelik sayfasında yönetirsin. Bağlantısı sitenin altbilgisinde ve her lisans e-postasında var. Paddle müşteri portalında aboneliği iptal edebilir, kartını değiştirebilir, faturaları indirebilir ve aylık Pro'yu yıllığa geçirebilirsin. Portal seni satın alırken kullandığın e-postaya gönderilen bir bağlantıyla içeri alır, yani parolaya ihtiyacın yok.
İptal, bir sonraki yenilemeyi durdurur. Anahtarın ödenen dönemin sonuna kadar çalışır ve dönüştürdüğün her tema senin kalır. İptal iade değildir: iadeler iade koşullarına tabidir.
Beta ne demek
html2wp gerçek siteleri dönüştürür ve gerçek işlerde kullanılır. Uygulama her sayfayı orijinaliyle karşılaştırır ve başarısız olan her kontrolü, kullanılabilir en iyi temanın ve eksik kalan noktaların açıklamasının yanında rapora yazar. Otomatik kontroller bir farkı kaçırabilir, bu yüzden bir müşteriye sonuç vaat etmeden önce sayfalara kendin göz at.
Dönüştürücünün kendisinde bir hata bulduğunda bunu eklenti dokümantasyonunda anlatıldığı gibi bildir. Bir insan okur ve düzeltmeler servis güncellemeleri olarak gelir.