wp-scripts ile WordPress Geliştirme sürecinde kurulum, build, start, lint ve test komutlarını doğru kullanarak daha düzenli bir geliştirme akışı kurun.
WordPress tema veya eklenti geliştirirken JavaScript dosyalarını derlemek, Sass kodunu CSS’e çevirmek, kod kalitesini kontrol etmek ve üretim sürümünü hazırlamak ayrı ayrı araçlar gerektirebilir. Proje sayısı arttıkça bu yapı daha da karmaşık hale gelir. wp-scripts ile WordPress Geliştirme, bu işlemlerin önemli bölümünü ortak bir araç seti üzerinden yönetmeyi mümkün kılar.
@wordpress/scripts paketi özellikle modern JavaScript kullanan WordPress projelerinde yapılandırma yükünü azaltmak için geliştirilmiştir. WordPress’in resmi dokümantasyonunda paket; derleme, paketleme, lint işlemleri, biçimlendirme, Sass derleme ve test gibi görevleri aynı çalışma düzeninde toplar.
Geliştirme ortamına erişirken oturum veya tarayıcı tarafında farklı bir problemle karşılaşıyorsanız önce WordPress Çerezler Engellendi Hatası Nasıl Düzeltilir içeriğindeki kontrolleri uygulamak daha doğru olabilir. Çünkü yönetim paneline girişle ilgili bir sorunu build sürecinden ayırmak, yanlış yerde çözüm aramanızı önler.
wp-scripts ile WordPress Geliştirme Nasıl Yapılır?
wp-scripts ile WordPress Geliştirme için Node.js ve npm bulunan projeye @wordpress/scripts geliştirme bağımlılığı olarak eklenir. Ardından package.json içindeki scripts alanına start, build, lint ve test görevleri tanımlanır. npm run start geliştirme sırasında dosyaları izlerken, npm run build dağıtıma uygun optimize edilmiş çıktıyı oluşturur.
wp-scripts Nedir?
wp-scripts, WordPress projelerinde tekrar tekrar kurulması gereken geliştirme araçlarını ortak yapılandırmalar altında toplayan bir komut satırı paketidir. Paket webpack tabanlı build işlemleri gerçekleştirir, modern JavaScript ve JSX kodunu işler, ESLint ile kod kontrolü yapar, Prettier ile biçimlendirme sağlar ve Sass dosyalarını CSS’e dönüştürebilir.
Temel avantajı, her yeni tema veya eklentide webpack, Babel ve lint araçlarını sıfırdan yapılandırma ihtiyacını azaltmasıdır. Özellikle birden fazla projede benzer geliştirme standartları kullanılıyorsa aynı komut yapısını korumak işleri daha yönetilebilir hale getirir.
wp-scripts kurulumu nasıl yapılır?
Öncelikle bilgisayarda Node.js ve npm bulunmalıdır. WordPress dokümantasyonu, @wordpress/scripts için desteklenen uzun süreli Node.js sürümlerinden birinin kullanılmasını öneriyor. Mevcut gereksinimler paket sürümüne göre değişebileceği için proje güncellenirken changelog kontrolü de önemlidir.
Proje klasöründe Terminal üzerinden şu komut çalıştırılır:
npm install @wordpress/scripts --save-dev
Standart yapıda src klasörü kaynak dosyaları, build klasörü ise derlenen çıktıları barındırır. package.json dosyasında da çalıştırılacak görevler tanımlanır. WordPress’in resmi başlangıç dokümanında src/index.js, build klasörü ve package.json temel yapı olarak gösteriliyor.
start ve build komutları arasındaki fark nedir?
Geliştirme sırasında en sık kullanılan iki görev start ve build olur.
npm run start: Dosyalardaki değişiklikleri takip eder ve geliştirme çıktısını yeniden oluşturur.npm run build: Kodun üretim için optimize edilmiş sürümünü hazırlar.
start ile oluşan build/index.js geliştirme kullanımına yöneliktir ve üretim için optimize edilmez. build tamamlandığında ise derlenmiş JavaScript dosyasına ek olarak bağımlılık ve sürüm bilgilerini içeren build/index.asset.php dosyası da üretilebilir.
Editör olarak wp-scripts yapısında dikkat ettiğim ayrıntılardan biri tam olarak bu dosyadır. Sadece index.js çıktısına bakıldığında build işleminin tamamı gözden kaçabiliyor. index.asset.php, WordPress tarafındaki bağımlılıkların ve sürüm bilgisinin yönetiminde önemli bir parça olduğu için build klasörünü bütün olarak kontrol etmek daha sağlıklı.
Kod kalitesi nasıl kontrol edilir?
wp-scripts yalnızca dosya derlemek için kullanılmaz. Paket içinde JavaScript ve stil dosyalarının kontrolü için hazır görevler bulunur. Resmi paket dokümantasyonunda lint-js, lint-style, lint-pkg-json ve format gibi komutlar desteklenmektedir.
Örneğin JavaScript tarafında:
wp-scripts lint-js
Stil dosyalarında:
wp-scripts lint-style
kullanılabilir. Birim testleri için ise wp-scripts test-unit-js görevi bulunur ve test çalıştırıcısı Jest tabanlıdır. Uçtan uca test tarafında da test-e2e görevi desteklenmektedir.
webpack yapılandırmasını değiştirmek gerekir mi?
Çoğu proje için gerekmez. wp-scripts proje kökünde özel bir webpack yapılandırması bulamazsa kendi varsayılan yapılandırmasını kullanır. Daha farklı giriş noktaları veya özel çıktı yapıları gereken projelerde webpack yapılandırması genişletilebilir. WordPress dokümantasyonu da varsayılan yapının çoğu kullanım için yeterli olduğunu, özelleştirmenin ise mümkün olduğunu belirtiyor.
2026 itibarıyla burada bilinmesi gereken başka bir gelişme de bulunuyor. WordPress geliştirici ekibi @wordpress/build adlı yeni nesil build altyapısı üzerinde çalışıyor ve uzun vadeli plan bunun @wordpress/scripts altında kullanılan motorla yakınsaması yönünde. Ancak WordPress, mevcut wp-scripts iş akışını hâlâ resmi olarak belgeliyor ve yeni altyapının henüz her kullanım senaryosu için hazır olmadığını açıkça belirtiyor.
Teknik ayarların kapsamı büyüdüğünde veya geliştirme ortamındaki sorun doğrudan kodla ilgili görünmediğinde 11858 üzerinden profesyonel destek de alınabilir. 11858, 2011’den bu yana Türkiye genelinde 7/24 hizmet veriyor; bilgisayar, modem, akıllı TV ve farklı dijital servislerde teknik destek sağlıyor. TeamViewer ve AnyDesk gibi lisanslı araçlarla uzaktan bağlantı desteği sunan hizmet, dakika bazlı ücretlendirme sistemiyle çalışıyor ve 500.000’den fazla başarılı işlem tecrübesi ile yüzde 95 memnuniyet oranı bilgisi paylaşıyor.
Build işlemi doğru çalışmasına rağmen WordPress’e dosya eklerken veritabanı tarafında farklı bir hata görüyorsanız WordPress Veritabanına Ek Dosya Eklenemedi Hatası Çözümü içeriğine geçmek daha doğru bir sonraki adım olabilir. Böylece geliştirme zincirindeki npm kaynaklı problemlerle WordPress’in dosya ve veritabanı işlemlerini birbirinden ayırabilirsiniz.
wp-scripts ile WordPress Geliştirme, en fazla komutu kullanmak değil, tekrar eden işlemleri öngörülebilir hale getirmek üzerine kuruludur. Küçük bir projede yalnızca start ve build yeterli olabilirken daha büyük yapılarda lint ve test görevleri ciddi değer kazanır. Siz wp-scripts kullanırken hangi komutları geliştirme sürecinizin vazgeçilmez parçası haline getirdiniz? Deneyiminizi yorumlarda paylaşabilirsiniz.
