İlk WordPress Eklentim: AJAX Tabanlı Bir İstek Formu Projesi
WordPress ile çalışmaya başladığımdan beri bu altyapının en güçlü yönlerinden birinin, küçük ihtiyaçları dahi büyüyen projelere uygun şekilde ele alabilmesi olduğunu düşünüyorum. Bir yanda “hemen çalışsın” beklentisi varken, diğer yanda veri düzeni, performans ve bakım kolaylığı gibi konular zaman içinde belirleyici hale gelir. Bu proje, tam olarak bu denge noktasında ortaya çıktı. Basit görünen bir istek formu ihtiyacını, kontrol edilebilir ve net bir yapıyla karşılamak hedeflendi.
WP AJAX İstek Formu, WordPress üzerinde geliştirdiğim ilk eklenti. Bu ifade bir başlangıç vurgusu taşıyor ancak romantik bir anlam yüklemiyor. İlk eklentilerde çoğu zaman hız öncelik kazanır; burada ise bilinçli bir şekilde “küçük ama düzgün” bir sistem inşa edildi. Kullanıcı formu doldurur, istek sayfa yenilenmeden iletilir, yönetici tüm kayıtları tek bir yerde görür ve veriler WordPress’in içerik yapılarıyla karışmaz. Ortaya çıkan yapı, AJAX tabanlı bir WordPress istek formu eklentisi olarak konumlanır.
Proje Ne Yapıyor, Ne Yapmıyor
WP AJAX İstek Formu, önyüzde bir istek formu sunar; kullanıcıdan ad, istek ve mesaj bilgilerini alır. Gönderim işlemi AJAX ile gerçekleştirilir ve elde edilen veriler eklentiye özel bir veritabanı tablosunda saklanır. Yönetim panelinde ise bu kayıtların listelendiği sade bir ekran bulunur. Proje, genel amaçlı WordPress form eklentileri gibi davranmaz; sürükle-bırak alanlar, kapsamlı ayar panelleri veya üçüncü parti entegrasyonlar içermez. Bu, bilinçli olarak çizilmiş bir sınırdır.
Yapmadıkları, yaptıkları kadar nettir. WP AJAX İstek Formu bir üyelik altyapısı değildir, klasik bir iletişim formu değildir ve e-ticaret sipariş süreçlerine dahil olmaz. Tek bir senaryoya odaklanır: WordPress üzerinde AJAX tabanlı bir istek formu ihtiyacını karşılamak. Radyo projeleri, topluluk siteleri veya hızlı geri bildirim gerektiren sayfalar için pratik bir çözüm sunar. Bu netlik, eklentinin bakımını kolaylaştırır ve kullanım amacını belirsizleştirmez.
Somut Teknik İskelet
Bu proje yalnızca “AJAX ile çalışıyor” ifadesiyle sınırlı değildir. WordPress’in kendi mekanizması kullanılarak inşa edilmiştir. Önyüzden gönderilen istekler, WordPress’in AJAX uç noktası olan admin-ajax.php üzerinden işlenir. Ayrı bir framework, harici bir API katmanı veya WordPress dışı bir yapı kullanılmaz. Bu tercih, AJAX tabanlı WordPress eklentilerinde uyumluluğu korur ve uzun vadeli bakım açısından avantaj sağlar.
Form yapısı shortcode mantığıyla tasarlanmıştır. Bu sayede AJAX tabanlı WordPress istek formu, tema bağımsız şekilde sayfa veya yazılar içinde kullanılabilir. Temanın dosyalarına müdahale gerekmez. Bu yaklaşım, eklentinin farklı WordPress projelerinde yeniden kullanılabilmesini mümkün kılar. İlerleyen aşamalarda şablon entegrasyonu gibi alternatifler eklenebilir; ancak ilk sürümde öncelik, her WordPress kurulumunda kolayca konumlandırılabilen bir yapı oluşturmaktır.
Önyüz davranışı, eklentiye ait JavaScript dosyası üzerinden kontrol edilir. Form gönderimi yakalanır, alanlar okunur, AJAX isteği hazırlanır ve kullanıcıya geri bildirim sunulur. Başarılı gönderim sonrası form alanlarının temizlenmesi gibi detaylar da bu katmanda ele alınır. AJAX tabanlı istek formu deneyimini güçlü kılan unsurlar, çoğu zaman bu küçük ama kritik ayrıntılarda ortaya çıkar.
Veritabanı Tarafı: İçerikle Karışmayan Veri
Bu projede özellikle önem verilen konulardan biri, istek verilerinin WordPress’in yazı veya yorum sistemine eklemlenmemesidir. Birçok hazır WordPress istek formu çözümü, kolaylık adına bu tür verileri içerik yapısına dahil eder. Kısa vadede pratik görünen bu yaklaşım, uzun vadede bakım ve performans sorunlarına yol açar. WP AJAX İstek Formu bu nedenle veriyi özel bir tabloda tutar. Kullanılan tablo adı wp_requests olup alanlar doğrudan ihtiyaca göre belirlenmiştir: id, name, song_request, message, created_at.
created_at alanı, kayıtların zaman bilgisini net biçimde tutar ve tarihe göre sıralama ile filtreleme için sağlam bir zemin oluşturur. Ayrıca bu alan üzerinde tanımlanan indeks (idx_created_at), kayıt sayısı arttığında dahi listeleme performansını korumayı hedefler. Özel veritabanı kullanan WordPress eklentilerinde veri yapısının baştan doğru kurulması, ileride oluşabilecek teknik borçları ciddi ölçüde azaltır.
Tablonun otomatik olarak oluşturulmaması da bilinçli bir tercihtir. İlk sürümde veri şemasının geliştirici kontrolünde netleştirilmesi ve kurulum davranışının dışarıdan yönetilmesi amaçlanmıştır. phpMyAdmin üzerinden tablo eklenir ve ihtiyaç halinde wp_ öneki değiştirilebilir. Bu yaklaşım, “tek tıkla kurulum” konforundan ziyade “kontrollü veri” anlayışını öne çıkarır.
Güvenlik ve Veri Temizliği
Form verisi söz konusu olduğunda güvenlik göz ardı edilmez. WP AJAX İstek Formu’nda kullanıcıdan gelen veri, doğrudan sisteme yazılmaz. Önce doğrulama ve temizlik adımlarından geçirilir. AJAX isteği karşılandığında alanlar kontrol edilir, boş değerler ayıklanır ve uygun filtreleme işlemleri uygulanır. Bu süreç, WordPress AJAX eklenti geliştirme yaklaşımında veri bütünlüğünü korumak açısından önemlidir.
WordPress ekosisteminde form işlemlerinde nonce kullanımı temel bir alışkanlıktır. Bu projede de isteklerin gerçekten site üzerinden gönderildiğinin doğrulanması hedeflenir. Küçük bir WordPress eklentisi olsa bile, temel güvenlik reflekslerinin doğru kurulması uzun vadede sistemin sağlıklı kalmasını sağlar.
Yönetim Paneli: Sadelik ve İşlev
WP AJAX İstek Formu’nun yönetim paneli tarafı, gösterişten uzak ve işlev odaklıdır. Gelen kayıtlar sade bir liste halinde sunulur. Tarih bilgisiyle birlikte hızlıca taranabilir ve gerektiğinde geriye dönük kontrol yapılabilir. Gereksiz ayar ekranları veya karmaşık yapılandırmalar bu alanda yer almaz.
Bu yaklaşımda yönetim paneli, her şeyi kontrol etmeye çalışan bir merkez değil; yalnızca ihtiyaç duyulan bilgiyi sunan bir araçtır. İlerleyen aşamalarda arşivleme, silme veya durum etiketleme gibi özellikler eklenebilir. Ancak ilk sürümde amaç, sağlam çalışan ve net bir temel oluşturmaktır.
Neden Bu Proje Bir Vitrin Parçası
Sadikozdogan.tr’de bir projeyi paylaşırken iki temel soru belirleyici olur: Bu çalışma gerçekten var mı ve hangi düşünceyle geliştirildi? WP AJAX İstek Formu, bu soruların her ikisine de net cevap verir. AJAX tabanlı WordPress istek formu geliştirme yaklaşımının; veri yönetimi, kullanıcı deneyimi ve sistem bütünlüğü açısından nasıl ele alındığı somut biçimde ortaya konur.
Bu eklenti, daha büyük planların küçük ama sağlam bir örneği olarak değerlendirilebilir. Hazır bir WordPress eklentisini kurup geçmek yerine, ihtiyacın arka planındaki veri ve akış mantığını doğru kurmak hedeflenmiştir. WordPress ile ilgili farklı çözümler, teknik notlar ve proje odaklı içerikler de bu yaklaşımın devamı olarak WordPress Çözüm Merkezi sayfasında bir araya getirilmektedir.
Benzer şekilde, WordPress tarafında eklenti yükleme ve kurulum süreçlerini kendi yaklaşımımla ele aldığım yazıda; panelden yükleme, zip ile kurulum ve FTP gibi yöntemlerin artı ve eksileri genel çerçevede anlatılmaktadır. Bu tür temel konulara dair genel bakış için WordPress eklenti yükleme
Başlıklı yazım, bu proje sayfasını rehbere dönüştürmeden tamamlayıcı bir okuma sunar.