WooCommerce sepete ekle butonu çalışmıyor sorunu, bir e-ticaret sitesinde doğrudan satış kaybına yol açan en kritik problemlerden biridir. Ziyaretçi ürünü beğenir, satın almaya niyetlenir ama butona bastığında hiçbir şey olmaz, sayfa yenilenir, ürün sepete düşmez ya da varyasyon seçimi tamamlanmadan işlem ilerlemez. Bu durumda sorun çoğu zaman tek bir yerden değil; ürün ayarı, stok durumu, tema, eklenti çakışması, önbellek veya JavaScript hatasından kaynaklanır.
Bu rehberde teknik bilgi seviyesi düşük kullanıcıların da uygulayabileceği şekilde adım adım kontrol listesi bulacaksınız. Eğer sorun ödeme sayfasında devam ediyorsa ayrıca WooCommerce checkout çalışmıyor rehberine de göz atabilirsiniz.
WooCommerce sepete ekle butonu çalışmıyor: İlk kontrol edilmesi gerekenler
Önce sorunun tüm ürünlerde mi, tek bir üründe mi yaşandığını anlamak gerekir. Tek üründe sorun varsa genellikle ürün ayarı, stok veya varyasyon kaynaklıdır. Tüm ürünlerde sorun varsa tema, eklenti, sepet sayfası, permalink veya önbellek ihtimali daha güçlüdür.
- Farklı bir tarayıcıda veya gizli sekmede ürünü sepete eklemeyi deneyin.
- Mobil ve masaüstü görünümde aynı hatanın olup olmadığını kontrol edin.
- Yalnızca varyasyonlu ürünlerde mi, basit ürünlerde de mi sorun var bakın.
- Son yüklenen eklenti, tema güncellemesi veya özel kod değişikliğini not edin.
Bu kısa test, gereksiz yere tüm siteyi kurcalamadan doğru noktaya odaklanmanızı sağlar.
1. Ürün stok ve satış ayarlarını kontrol edin
WooCommerce’de ürün stokta değilse, fiyat girilmemişse veya ürün satın alınabilir durumda değilse sepete ekle butonu beklediğiniz gibi çalışmayabilir. WordPress panelinde ilgili ürünü açın ve şu alanları kontrol edin:
- Ürün fiyatı boş bırakılmamış olmalı.
- Stok durumu “Stokta” olmalı.
- Stok yönetimi açıksa stok miktarı sıfır olmamalı.
- Ürün durumu “Yayınlandı” olmalı.
- Harici/bağlantılı ürün kullanılıyorsa buton metni ve ürün URL’si doğru girilmeli.
Özellikle manuel stok takibi yapan mağazalarda stok sıfıra düştüğü için butonun pasif görünmesi çok sık karşılaşılan bir durumdur.
2. Varyasyonlu ürünlerde tüm seçenekleri tamamlayın
Sorun sadece renk, beden, numara gibi seçenekli ürünlerde görülüyorsa varyasyon ayarlarını inceleyin. Varyasyonlu ürünlerde her kombinasyon için fiyat, stok ve aktiflik durumu doğru olmalıdır. Bir varyasyonda fiyat yoksa WooCommerce o seçeneği satın alınabilir kabul etmez.
- Ürün verisi alanında ürün tipi “Varyasyonlu ürün” seçili mi?
- Nitelikler “Varyasyonlar için kullanılır” olarak işaretli mi?
- Her varyasyonun fiyatı girilmiş mi?
- Varyasyon stokları doğru mu?
- Varsayılan form değerleri seçili mi?
Kullanıcı seçenekleri seçmeden butona basıyorsa ürün sepete eklenmeyebilir. Bu normaldir; fakat seçenekler seçildiği halde işlem olmuyorsa tema veya JavaScript çakışması ihtimali yükselir.
3. Sepet sayfasının doğru atandığından emin olun
WooCommerce sayfaları yanlış atanırsa sepete ekleme süreci bozulabilir. Panelden WooCommerce > Ayarlar > Gelişmiş bölümüne girin. Sepet, ödeme ve hesabım sayfalarının doğru seçildiğini kontrol edin. Sepet sayfasında WooCommerce sepet bloğu veya klasik sepet kısa kodu bulunmalıdır.
Sepet sayfası silindiyse, taslak durumdaysa veya başka bir sayfaya yönlendiriliyorsa buton çalışıyor gibi görünse bile kullanıcı doğru sepete ulaşamaz.
4. Kalıcı bağlantıları yeniden kaydedin
Basit ama etkili bir yöntem de kalıcı bağlantıları yenilemektir. Ayarlar > Kalıcı bağlantılar sayfasına girip hiçbir değişiklik yapmadan “Değişiklikleri kaydet” butonuna basın. Bu işlem WordPress’in bağlantı kurallarını yeniden oluşturur.
Özellikle taşıma, SSL geçişi, alan adı değişikliği veya yeni eklenti kurulumu sonrasında bu adım birçok WooCommerce sorununu düzeltebilir.
5. Önbellek ve optimizasyon eklentilerini test edin
Sepete ekleme işlemi dinamik çalışır. Bu nedenle önbellek eklentileri, CDN ayarları, JavaScript erteleme seçenekleri veya minify işlemleri sepete ekle butonunu bozabilir. İlk test için site, tarayıcı ve varsa CDN önbelleğini temizleyin.
- Sepet, ödeme ve hesabım sayfalarını önbellekten hariç tutun.
?add-to-cart=içeren isteklerin cachelenmediğinden emin olun.- JavaScript erteleme veya geciktirme özelliğini geçici olarak kapatın.
- WooCommerce script dosyalarını minify hariç bırakmayı deneyin.
Site hızlandırma ayarları satış akışını bozuyorsa hız kazanımı yerine dönüşüm kaybı yaşanır. Bu yüzden optimizasyon her zaman WooCommerce testleriyle birlikte yapılmalıdır.
6. Tema kaynaklı çakışmaları ayırın
Bazı temalar ürün kartlarını, tekil ürün şablonunu veya AJAX sepete ekleme alanını özelleştirir. Tema güncellemesi sonrası buton çalışmamaya başladıysa geçici olarak varsayılan bir WordPress temasına geçerek test yapabilirsiniz. Canlı sitede risk almak istemiyorsanız bu testi staging ortamında yapmak daha güvenlidir.
Tema değişince sorun düzeliyorsa problem büyük ihtimalle tema şablonunda, eski WooCommerce template dosyalarında veya özel JavaScript dosyalarındadır. Böyle bir durumda temanın WooCommerce uyumluluğunu ve güncel sürümünü kontrol edin.
7. Eklenti çakışmalarını kontrollü test edin
WooCommerce sepete ekle butonu çalışmıyor hatasının en yaygın nedenlerinden biri eklenti çakışmasıdır. Özellikle fiyatlandırma, kupon, stok, varyasyon, kargo, ödeme, üyelik ve güvenlik eklentileri sepete ekleme sürecine müdahale edebilir.
Test için önce son kurulan eklentileri devre dışı bırakın. Sorun çözülmezse WooCommerce dışındaki eklentileri tek tek kapatarak deneyin. Her değişiklikten sonra gizli sekmede ürünü yeniden sepete ekleyin. Bu yöntem biraz zaman alır ama sorunlu eklentiyi net şekilde bulmanızı sağlar.
Kupon veya indirim sistemiyle ilgili ek bir problem yaşıyorsanız WooCommerce kupon kodu çalışmıyor rehberi de faydalı olabilir.
8. JavaScript hatalarını kontrol edin
Butona basıldığında hiçbir tepki olmuyorsa tarayıcı konsolunda JavaScript hatası olabilir. Chrome’da ürünü açın, sağ tıklayıp “İncele” seçeneğine basın ve Console sekmesini kontrol edin. Kırmızı hata mesajları genellikle hangi dosyanın sorun çıkardığını gösterir.
Hata bir optimizasyon eklentisinden, tema dosyasından veya üçüncü parti pazarlama scriptinden geliyor olabilir. Bu dosyayı tespit etmek, rastgele eklenti kapatıp açmaktan daha hızlı sonuç verir.
9. AJAX sepete ekleme ayarını deneyin
WooCommerce ürün arşivlerinde AJAX ile sepete ekleme seçeneği bulunur. Bazı temalarda bu özellik sorunsuz çalışırken bazılarında çakışma yaratabilir. WooCommerce > Ayarlar > Ürünler bölümünde AJAX sepete ekleme ayarını geçici olarak kapatıp açarak test edin.
Tekil ürün sayfasında sorun yok, kategori sayfasında sorun varsa bu ayar özellikle kontrol edilmelidir.
10. Güvenlik ve bot koruma ayarlarını inceleyin
Bazı güvenlik eklentileri veya sunucu tarafı koruma sistemleri, sepete ekleme isteklerini şüpheli algılayabilir. Bu durumda kullanıcı ürünü sepete eklemeye çalışır ama istek engellenir. Güvenlik eklentisinin log kayıtlarında WooCommerce istekleriyle ilgili bloklama olup olmadığını kontrol edin.
Özellikle agresif firewall, bot koruma, ülke engelleme ve rate limit ayarları e-ticaret sitelerinde dikkatli yapılandırılmalıdır.
11. Mobil görünümde butonun üstünü kapatan öğeleri kontrol edin
Bazen buton teknik olarak çalışır fakat mobilde başka bir öğe butonun üstünü kapattığı için tıklama algılanmaz. Sabit WhatsApp butonu, kampanya barı, çerez bildirimi veya sticky header bu soruna neden olabilir. Mobil görünümde butonun gerçekten tıklanabilir olduğundan emin olun.
Bu tarz arayüz problemleri dönüşümü ciddi şekilde düşürür. Profesyonel destek veya site yenileme ihtiyacınız varsa web tasarım paketleri sayfasını inceleyebilir, özel WooCommerce düzenlemeleri için iletişim sayfasından ulaşabilirsiniz.
12. Test siparişiyle tüm satın alma akışını doğrulayın
Sepete ekle butonu düzeldikten sonra yalnızca ürün sayfasında kalmayın. Ürünü sepete ekleyin, sepet sayfasına gidin, kupon varsa deneyin, kargo seçeneklerini kontrol edin ve ödeme adımına kadar ilerleyin. Kargo tarafında problem görürseniz WooCommerce kargo ücreti çıkmıyor yazısı ilgili kontrolleri içerir.
Bu test, müşterinin yaşadığı gerçek satın alma yolculuğunu görmenizi sağlar. Sorun sadece butonda değil, sepet sonrası adımlarda da devam ediyor olabilir.
Sonuç: Sorunu sistemli ilerleyerek çözün
WooCommerce sepete ekle butonu çalışmıyor hatasında en doğru yaklaşım, önce ürün ve stok ayarlarını kontrol etmek, ardından sepet sayfası, kalıcı bağlantılar, önbellek, tema ve eklenti çakışmalarını sırayla test etmektir. Rastgele ayar değiştirmek yerine her adımı not alarak ilerlerseniz sorunun kaynağını daha hızlı bulursunuz.
Satış yapan bir WooCommerce sitesinde sepete ekleme, ödeme ve kargo akışı düzenli olarak test edilmelidir. Küçük bir JavaScript çakışması veya yanlış önbellek ayarı bile reklam bütçesinin boşa gitmesine neden olabilir. Düzenli bakım, güncelleme ve test siparişi alışkanlığı bu tür sorunları müşteriler fark etmeden yakalamanıza yardımcı olur.