HUSKY - WooCommerce Product Filter Professional

WooCommerce Ürün Filtresi WP Rocket ve Önbellekle Çalışmıyor

Bir WooCommerce ürün filtresi WP Rocket veya başka bir optimizasyon eklentisiyle çalışmadığında tablo neredeyse her zaman aynıdır: oturum açıkken her şey çalışır, ziyaretçiler için ise tıklamalar hiçbir şey yapmaz, yükleme göstergesi sonsuza dek döner veya fiyat kaydırıcısı düz bir metin alanı olarak görünür. HUSKY her iki tarafa da aynı kodu gönderir. Fark, önbelleğe almanın ve JavaScript optimizasyonunun genellikle oturum açmış yöneticileri atlamasıdır; bu yüzden ziyaretçilerinizin aldığı optimize edilmiş sayfayı siz hiç görmezsiniz. Aşağıda şunları bulacaksınız: hatayı bir dakikada nasıl okuyacağınız, WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer ve Cloudflare'de tam olarak neyi hariç tutacağınız ve sayfa önbelleğinin AJAX filtrelemeyi nonce error ile bozmasını nasıl önleyeceğiniz.

Filtre Yöneticilerde Neden Çalışıp Ziyaretçilerde Çalışmıyor

Filtrenin ön yüzü tek bir betik dosyası değil, belirli bir sırayla çalışması gereken bir zincirdir:

  1. jQuery: her filtre betiği ona bağlıdır.
  2. Sayfaya yazdırılan satır içi ayar bloğu (sayfa kaynağında <script id="woof_front-js-before"> olarak görünür). Filtrenin ihtiyaç duyduğu değişkenleri tanımlar: woof_current_values, woof_is_ajax, swoof_search_slug, woof_ext_init_functions, güvenlik belirteci woof_front_nonce ve diğerleri.
  3. Eklenti dosyaları (/wp-content/plugins/woocommerce-products-filter/ altında): bu değişkenleri okuyan js/front.js, filtre öğelerinin ve eklentilerin betikleri ve iCheck (onay kutusu görünümleri), ion.rangeSlider (kaydırıcılar) ve plainOverlay (yükleme katmanı) gibi jQuery eklentileri.

Optimizasyon ve önbelleğe alma bu zinciri üç şekilde bozar. Optimizasyon sırayı değiştirir; örneğin dosyaları geciktirir ama satır içi bloğu geciktirmez ya da tam tersini yapar. Birleştirme veya küçültme sırasında satır içi bloğu taşır ya da yeniden yazar. Sayfa önbelleği ise son kullanma tarihi olan veriler içeren HTML'yi saklar: güvenlik belirteci. Çoğu önbellek ve optimizasyon eklentisi, oturum açmış kullanıcılara ne önbelleğe alınmış ne de optimize edilmiş bir sayfa sunar; dolayısıyla yönetici görünümü yalnızca filtrenin kendisinin çalıştığını kanıtlar.

Önce Tarayıcı Konsoluna Bakın

Mağazayı oturum açmadığınız bir gizli pencerede açın. F12 tuşuna basın (Mac'te Cmd+Option+I), Konsol (Console) sekmesini açın, sayfayı yeniden yükleyin ve bir filtreye tıklayın. İlk kırmızı hata nereye bakmanız gerektiğini söyler.

Konsol mesajıNe anlama geliyor
woof_current_values is not defined, aynısı woof_is_ajax, swoof_search_slug, woof_ext_init_functions için de geçerli (Firefox: assignment to undeclared variable, Safari: Can't find variable)Satır içi ayar bloğu front.js dosyasından önce çalışmadı: geciktirilmiş, taşınmış, kaldırılmış veya bozulmuş
jQuery is not definedjQuery geciktirilmiş veya ertelenmiş, ancak ona ihtiyaç duyan kod daha önce çalışmış
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a functionEklenti dosyası yüklenmedi ya da ikinci bir jQuery kopyası sonradan yüklenip jQuery nesnesinin yerini aldı
woof_husky_txt is not definedMetin aramasının veri bloğu kaldırıldı veya kendi dosyasından ayrıldı
Satır içi bloğu gösteren SyntaxErrorSatır içi blokta geçersiz kod var; çoğunlukla eklentinin kendi özel JavaScript alanından kaynaklanır (aşağıya bakın)
Identifier 'woof_front_nonce' has already been declaredAyar bloğu iki kez çalıştı: bir optimize edici veya AJAX sayfa geçişleri kullanan bir tema satır içi betikleri yeniden çalıştırdı
"nonce error" is not valid JSONSayfa önbellekten geldi ve güvenlik belirtecinin süresi doldu
Unexpected token '<' ... is not valid JSONSunucu filtre isteğine HTML ile yanıt verdi: bir PHP bildirimi, bir güvenlik duvarı sayfası veya önbellekteki bir sayfa
Bad escaped character in JSONBir şey AJAX yanıtını tarayıcıya giderken yeniden yazdı

Hiç hata yok, ama kaydırıcı düz bir giriş alanı, hiyerarşik listelerin + açıcıları yok ve tıklamalar hiçbir şey yapmıyorsa: betikler henüz çalışmamıştır. "Kullanıcı etkileşimine kadar JavaScript'i geciktir" özellikleri böyle görünür. Sayfa kaynağını görüntüleyin ve woof_front araması yapın: betik etiketlerinde rocketlazyloadscript veya litespeed/javascript gibi bir tür varsa, bir optimize edici onları tutuyor demektir. woof_front kaynakta hiç yoksa, Eklentiyi yalnızca sonraki site sayfalarında başlat (Init plugin on the next site pages only) alanını (Gelişmiş → Kod) kontrol edin: alanda sayfalar listelenmişse eklenti yalnızca oralarda yüklenir.

JavaScript Optimizasyonundan Nelerin Hariç Tutulacağı

Kural her araçta aynıdır: jQuery, satır içi bloklar ve eklenti dosyaları birlikte ve özgün sıralarıyla kalmalıdır. Yalnızca front.js dosyasını hariç tutmak yaygın bir yarım çözümdür ve işe yaramaz, çünkü ayar bloğu ile jQuery hâlâ geciktirilir. Şu üç satır her şeyi kapsar:

/wp-includes/js/jquery/
woocommerce-products-filter
woof_

İlk satır jQuery ve jQuery UI ile eşleşir (WooCommerce tarzı fiyat kaydırıcısı onu kullanır). İkinci satır eklentinin ve eklentilerinin her dosyasıyla eşleşir. Üçüncü satır satır içi bloklarla eşleşir: kimlikleri ve içlerindeki değişkenler woof_ ile başlar. Optimizasyon eklentilerinin hariç tutma alanları genellikle bir anahtar sözcüğü hem dosya URL'siyle hem de satır içi betiklerin içeriğiyle karşılaştırır.

  • WP Rocket. Dosya Optimizasyonu (File Optimization) bölümünde, bu satırları JavaScript yürütmesini geciktir (Delay JavaScript execution) seçeneğinin hariç tutulan dosyalarına ekleyin; filtre yine bozuksa bunları JavaScript'i ertelenmiş yükle (Load JavaScript deferred) hariç tutmalarına da ekleyin veya o seçeneği kapatın. CSS teslimini optimize et (Optimize CSS delivery) kullanılmayan CSS'i kaldıracak şekilde ayarlıysa, eklentinin stillerini ve .woof sınıflarını CSS güvenli listesine ekleyin: birçok filtre sınıfı yalnızca JavaScript çalıştıktan sonra ortaya çıkar, bu yüzden statik sayfanın taranması onları kullanılmayan sayar.
  • LiteSpeed Cache. JS Birleştirme (JS Combine) ve JS'i Ertelenmiş Yükle (Load JS Deferred) (ertelenmiş veya geciktirilmiş) olağan nedenlerdir; satırları JS hariç tutmalarına ve ertelenen/geciktirilen hariç tutmalarına ekleyin. Filtre isteği dönüyor ama ürünler yenilenmiyorsa ve konsolda Bad escaped character in JSON görünüyorsa, CDN Eşleme (CDN Mapping) seçeneğini kapatın: doğrulanmış durumlarda AJAX yanıtını yeniden yazmıştır.
  • Autoptimize. JavaScript birleştirildiğinde jQuery sayfanın sonundaki birleşik dosyaya taşınır, satır içi kod ise yerinde kalır ve çok erken çalışır. js/jquery/jquery.min.js ve woocommerce-products-filter değerlerini Betikleri Autoptimize dışında tut (Exclude scripts from Autoptimize) alanında tutun.
  • SiteGround Speed Optimizer, WP-Optimize ve benzerleri. Birleştirme, erteleme ve "satır içi betikleri geciktir" seçeneklerinin hepsi aynı hariç tutmalara ihtiyaç duyar ya da kapalı olmalıdır.
  • Cloudflare Rocket Loader. Satır içi bloklar dahil tüm betikleri eşzamansız yükler ve ayrıca Filtre ön yüz oluşturucu (Filter front builder) eklentisinin başlamasını da engeller. Cloudflare'in hız ayarlarından kapatın, ardından Cloudflare önbelleğini temizleyin.
  • HTML küçültme "gereksiz karakterleri kaldırdığında" satır içi betiklere zarar verebilir. Satır içi JavaScript küçültmesini kapatın.
  • script_loader_tag filtresindeki tema veya kod parçacığı kodu. WordPress, satır içi bloğu betik etiketiyle birlikte bu filtreden geçirir; bu nedenle orada öznitelikleri silen veya tırnakları değiştiren kod onu bozabilir. Böyle bir kodu kaldırın ya da yalnızca başka tanıtıcılarla sınırlayın.

Filtrenin İçindeki İki Ayar

AJAX tamamlandıktan sonraki JavaScript kodu (JavaScript code after AJAX is done) (WooCommerce → Ayarlar → Products Filter → Gelişmiş → Kod) satır içi ayar bloğuna bir işlevin gövdesi olarak eklenir. Oradaki bir yazım hatası, örneğin kapatılmamış bir parantez, tüm bloğu bozar ve her filtre değişkeni "tanımlı değil" olur. Test için alanı boşaltın; filtrelemeden sonra kod çalıştırmak için woof_ajax_done olayı daha güvenli bir yerdir.

HUSKY JavaScript dosyalarının yüklenmesini optimize et (Optimize loading of HUSKY JavaScript files) (Gelişmiş → Seçenekler) iki yükleme yöntemi arasında geçiş yapar: Hayır (No) front.js dosyasını ve radyo düğmeleri, onay kutuları ve açılır listeler için dört ayrı betiği yükler; Evet (Yes) sayfa altında tek bir sıkıştırılmış dosyayı, js/front_comprssd.js dosyasını yükler. Bazı optimize edici kurulumları bir değerle çalışır, diğeriyle çalışmaz. İkisini de deneyin ve her değişiklikten sonra tüm önbellekleri temizleyin.

Sayfa Önbelleği ve "nonce error"

AJAX modunda (Seçenekler sekmesindeki Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) ayarı veya bir [woof_products is_ajax=1] sayfası) ve ajax_redraw özniteliğiyle, filtre sunucudan yeni ürünler ister ve sayfadan aldığı woof_front_nonce belirtecini gönderir. Sunucu bunu denetler ve geçerli değilse düz metin olarak nonce error yanıtı verir. Betik JSON bekler, bu yanıtı okuyamaz ve yükleme göstergesi ekranda kalır.

Belirteç HTML oluşturulurken üretilir. Oturum açmamış ziyaretçiler için WordPress nonce'ları en az 12, en fazla 24 saat geçerlidir. Bundan daha eski bir önbellekten sunulan sayfa süresi dolmuş bir belirteç taşır. Sorunun önbellek oluşturulduktan bir gün sonra önbellekli sayfalarda ortaya çıkmasının ve yeniden yüklemenin bazen işe yaramasının nedeni budur: tesadüfen taze bir kopyaya denk gelir. Önbelleği temizlemek sorunu yalnızca birkaç saatliğine giderir. Kalıcı çözümler:

  • HTML sayfalarının önbellek ömrünü 12 saatin altında tutun. WP Rocket'in varsayılan 10 saatlik ömrü güvenlidir; CDN'de uzun ömürlü HTML önbelleği tipik suçludur.
  • Mağaza ve kategori HTML'sini CDN'de önbelleğe almayın. Cloudflare ile mağaza, /product-category/ URL'leri ve filtrenin bulunduğu diğer tüm sayfalar için önbelleği atlayan bir önbellek kuralı ekleyin ve kendi ömrüne uyan WordPress sayfa önbelleğinizi koruyun. Yalnızca filtrelenmiş URL'leri atlamak yeterli değildir: ziyaretçinin kullandığı belirteç, filtrelemenin başladığı sayfadan gelir.
  • Yalnızca bu belirtecin ömrünü uzatın. WordPress 6.1'den beri nonce_life filtresi eylem adını alır; böylece sitedeki başka hiçbir nonce'a dokunmadan filtrenin belirteci daha uzun yaşayabilir. Belirteç yalnızca herkese açık ürün listesi isteğini korur.
/*
 * HUSKY: keep the filter token valid longer than the page cache lifespan.
 * A token is valid for at least half of this time (here: 2 days).
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('nonce_life', function ($life, $action = -1) {
    if ('woof_front_nonce' === $action) {
        return 4 * DAY_IN_SECONDS;
    }
    return $life;
}, 10, 2);

AJAX'sız ve ajax_redraw olmadan düz yönlendirme modu belirteci hiç kullanmaz: her filtre değişikliği yeni bir URL yükler ve sayfa önbelleği filtrelenmiş URL'leri diğer sayfalar gibi sunabilir. Filtreyi kendi kodunuzdan çağırıyorsanız, örneğin woof_draw_products işlevine özel bir jQuery isteğiyle, istek verileri nonce_filter: woof_front_nonce değerini içermelidir; aksi halde sunucu hiç önbellek olmasa bile nonce error yanıtı verir.

Eski Filtreler ve Diğer Önbellek Yan Etkileri

  • Değiştirilen filtre ayarları görünmüyor. Ayarlar, önbellekteki HTML'nin ve satır içi bloğun parçasıdır. Kaydettikten sonra her önbellek katmanını temizleyin: önbellek eklentisini, sunucu önbelleğini (Varnish, Nginx, barındırma önbelleği), CDN'i; ardından tarayıcıyı zorla yenileyin (Ctrl+F5, Mac'te Cmd+Shift+R).
  • Filtrelenmiş bir bağlantı hiçbir şey seçili olmadan açılıyor ya da temiz bir mağaza eski seçimlerle açılıyor. Önbellek, farklı sorgu dizelerine sahip URL'leri tek bir sayfa olarak görür. Her ?swoof=1&... URL'si ya ayrı ayrı önbelleğe alınmalı ya da hiç alınmamalıdır; bu yüzden önbelleği mağaza URL'lerinde sorgu dizelerini yok sayacak şekilde asla ayarlamayın.
  • Mobil filtre masaüstünde görünüyor veya tam tersi. Filtrenin mobil modu ve bazı eklentiler, neyin yazdırılacağına sunucuda, tarayıcının kullanıcı aracısına göre karar verir. Bir telefon için önbelleğe alınmış sayfa masaüstüne sunulmamalıdır: mobil cihazlar için ayrı önbellek dosyalarını etkinleştirin.
  • Yeni bir filtre kombinasyonuna ilk ziyaret daha yavaştır: o URL'nin henüz önbellekte bir kopyası yoktur. Genel hız için büyük kataloglarda filtrelemeyi hızlandırma yazısına bakın.

Güvenli Bir Test Sırası

  1. Oturumu kapalı bir gizli pencerede, konsol açıkken çalışın.
  2. Tüm JavaScript optimizasyonlarını (küçültme, birleştirme, erteleme, geciktirme, Rocket Loader) kapatın ve her önbellek katmanını temizleyin. Filtre şimdi çalışıyorsa neden optimizasyondur. Hâlâ çalışmıyorsa neden başka yerdedir: ilk konsol hatasını okuyun ve hazırlık ortamındaki bir kopyada varsayılan bir temayla test edin.
  3. Seçenekleri tek tek geri açın, her seferinde önbelleği temizleyin ve test edin. Biri filtreyi bozduğunda, üç hariç tutma satırını o seçeneğe ekleyin veya kapalı bırakın.
  4. AJAX modunda, filtreyi bir gündür önbellekte duran bir sayfada yeniden kontrol edin. nonce error görünmüyorsa önbellek ömrü ya da belirteç ömrü doğrudur.
  5. Masaüstünün yanı sıra telefonda ve sonuçların ikinci sayfasında da test edin.

Bu adımlardan sonra filtre hâlâ yalnızca oturum açmış kullanıcılar için çalışıyorsa, sayfa bağlantısı, ilk konsol hatası ve etkinleştirdiğiniz optimizasyon seçeneklerinin listesiyle HUSKY destek forumunda bir konu açın, biz de bakalım.