HUSKY Turbo Modu Çalışmıyor: Grileşen Filtre ve Eksik Ürünler
HUSKY Turbo modu çalışmadığında belirtiler birbiriyle ilgisiz görünür: filtre gri kalır, bir kategori hiç ürün döndürmez, yeni ürünler bir türlü görünmez, sayımlar yanlıştır ya da AJAX modu kapatılamaz. Neredeyse hepsi tek bir tasarım kararından kaynaklanır: Turbo modunda filtreleme, ziyaretçinin tarayıcısında, önceden oluşturulmuş bir ürün verisi dosyası üzerinde yapılır. Aşağıda bu dosyanın nasıl oluşturulup kullanıldığını ve her belirtinin çözümünü bulacaksınız.
Turbo modu nasıl çalışır ve ne zaman kullanmaya değer
Normal modda her filtre tıklaması, sunucunun bir WooCommerce sorgusu çalıştırmasına ve her terim için ürünleri saymasına yol açar. Turbo modu bu işi tarayıcıya taşır. HUSKY, yayınlanmış tüm ürünleri ve varyasyonlarını tek bir JSON dosyasına yazar (varsayılan olarak wp-content/uploads/uploads_woof_turbo_mode/ içine); dosyada kimlik, başlık, SKU, fiyatlar, stok durumu, her ürün taksonomisinin terimleri ve Meta filtre alanlarının değerleri bulunur. Tarayıcı bu dosyayı eklentinin çalıştığı her ön yüz sayfasında indirir (bu sayfaları Gelişmiş (Advanced) sekmesindeki Eklentiyi yalnızca şu site sayfalarında başlat (Init plugin on the next site pages only) ayarıyla sınırlayabilirsiniz), eşleşen ürünleri bulur ve sayımları çizer; sunucu yalnızca bulunan ürünleri kimliklerine göre oluşturur.
Dolayısıyla sonuçlar dosya kadar günceldir, dosyada olmayan bir ürün bulunamaz, yalnızca tarayıcının anladığı koşullar uygulanır ve her ziyaretçi kataloğun tamamını indirir; on binlerce ürün ve varyasyonda bu, megabaytlarca veri ve telefonlarda yavaş bir başlangıç demektir. Turbo modu, kataloğu orta büyüklükte olan ve nadiren değişen, zayıf bir sunucuda işe yarar. Sunucu sorguları çalıştırabiliyorsa önce büyük kataloglarda ürün filtrelemeyi hızlandırma yazısında anlatılan önbelleklerle normal modu deneyin.
Doğru sırayla açın
- WooCommerce → Ayarlar → Products Filter → Uzantılar (Extensions): Turbo modu (Turbo mode) kutusunu işaretleyin ve kaydedin.
- Gelişmiş (Advanced) → Turbo modu (Turbo mode): Turbo modunu etkinleştir (Enable turbo mode) ayarını Evet (Yes) yapın ve kaydedin.
- Ürün verilerini şimdi yeniden oluştur! (Reassemble products data now!) altındaki Şimdi güncelle! (Update now!) düğmesine tıklayın ve Dosya güncellendi!!! (File updated!!!) yazısı görünene kadar sayfayı açık tutun. Dosya olmadan filtre arama yapamaz.
- WordPress Cron aralığı (WordPress Cron period) ve Ürün verileri dosyası nerede saklansın (Where to keep products data file) seçeneklerini belirleyin ve kaydedin.
- Seçenekler (Options) sekmesinde, Turbo modunda ayrı kopyalar olan Sayıyı göster (Show count), Dinamik yeniden sayım (Dynamic recount) ve Boş terimleri gizle (Hide empty terms) ayarlarını yapın (aşağıda açıklanıyor), ardından sayfa önbelleğini ve varsa CDN önbelleğini temizleyin.
Filtre gri kalıyor ve hiç tıklanabilir olmuyor
Gri katman, woof_turbo_mode_overlay sınıfına sahip bir öğedir. Filtreyi ilk andan itibaren kaplar; Turbo modu betiği dosya yüklenip sayımlar çizildikten sonra onu kaldırır. Katman kalıyorsa bu betik işini tamamlayamamıştır:
- Geciktirilen, ertelenen veya birleştirilen betikler. WP Rocket, LiteSpeed Cache ve benzeri eklentilerdeki optimizasyon özellikleri betikleri geç, sırasız ya da hiç başlatmayabilir. Turbo modu, jQuery'den sonra
wp-content/plugins/woocommerce-products-filter/altındakiext/turbo_mode/js/turbo_mode.jsveext/quick_search/js/alasql/alasql.min.jsdosyalarına ihtiyaç duyar. Eklenti klasörünü geciktirme, erteleme ve birleştirme işlemlerinin dışında bırakın, ardından tüm önbellekleri temizleyin; hariç tutulacaklar WP Rocket ve önbellekleme ile filtre yazısında açıklanıyor. - Bir JavaScript hatası. Tarayıcı konsolunu (F12) açın ve sayfayı yeniden yükleyin. İlk kırmızı hata, geri kalanları durduran betiği gösterir.
- Yavaş bağlantıda büyük dosya. Ağ (Network) sekmesinde
data_0000_xxx.jsondosyasının boyutuna ve süresine bakın. İndirme filtreyi saniyelerce gri tutuyorsa katalog Turbo modu için çok büyüktür.
Katmanı CSS ile gizlemek (.woof_turbo_mode_overlay{display:none;}) yalnızca belirtiyi saklar: filtre tıklanabilir olur, ancak dosya yüklenmediği için arama yapamaz.
Dosya yüklenemediğinde filtrenin yerini Eyvah! Filtre arama dosyasını açamıyor gibi görünüyor. (Oh no! It looks like the filter can't open the search file.) bildirimi alır. Şunları kontrol edin:
- dosya mevcut mu? Eklenti klasöründe tutulan dosya (plugins\woocommerce-products-filter\ext\turbo_mode\data) her eklenti güncellemesinde silinir; bu yüzden güncellemelerden sonra yeniden oluşturun ya da dosyayı wp-uploads\uploads_woof_turbo_mode içinde tutun;
- hiçbir sunucu kuralı veya güvenlik eklentisi uploads içindeki
.jsondosyalarını engelliyor mu? Ağ sekmesindeki dosya adresini doğrudan açın; - adres doğru mu? Eklenti
wp-content/uploads/uploads_woof_turbo_mode/adresini ister; bu yüzden çoklu sitede bir alt sitede ya da uploads klasörü başka yere taşınmışsa istek 404 döndürür. Bu durumda dosyayı eklenti klasöründe tutun.
Ürün bulunamıyor veya filtrelemeden sonra ürünler kayboluyor
Turbo modu yalnızca dosyada bulunan ürünleri, orada saklanan verilere göre eşleştirerek döndürür. İkisini de, filtrenin bulunduğu bir sayfada yüklendikten sonra tarayıcı konsolundan kontrol edin:
woof_turbo_mode_file.length // records in the file: products + variations
woof_turbo_mode_file.find(p => p.id == 123) // what is stored for product 123
İlk sayıyı yayınlanmış ürünlerinizin ve varyasyonlarının toplamıyla karşılaştırın; WP-CLI ile wp post list --post_type=product,product_variation --post_status=publish --format=count bu sayıyı verir. Bir ürün için undefined dönüyorsa dosyada yok demektir. Dosyada varsa taxonomies ve stock alanlarına bakın.
Dosya güncel değil
Yeni ürünler, değişen kategoriler, nitelikler, fiyatlar ve stok, filtreye ancak bir sonraki yeniden oluşturmayla ulaşır. Tipik belirtiler: yeni bir ürün mağaza sayfasında listelenir ama ilk filtre tıklamasından sonra kaybolur, yeni terimlerde sayım 0 görünür, son sayfalama sayfaları boştur ya da son yeniden oluşturmadan sonra eklenen bir Meta filtre öğesi hiçbir şey bulmaz. İçe aktarmalardan sonra ve filtrenin öğelerini değiştirdikten sonra dosyayı yeniden oluşturun.
15.000 sınırı
Şimdi güncelle! (Update now!) 15.000 kayıttan sonra durur ve varyasyonlar da sayılır. Sekizer varyasyonlu 2.000 değişken ürüne sahip bir mağaza zaten 18.000 kayda ulaşır. Düğme önce en yeni ürünleri işler; dolayısıyla dışarıda kalanlar en eski ürünlerinizdir. Düğmenin yanındaki sayaç Ürünler ve Varyasyonlar: 15000 (Products and Variants: 15000) değerinde durduysa sınıra takılmışsınız demektir. Sınırı woof_turbo_mode_products_limit kancasıyla yükseltin ve dosyayı yeniden oluşturun:
/*
* HUSKY Turbo mode: let "Update now" write up to 40,000 products and variations.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_turbo_mode_products_limit', function ($limit) {
return 40000;
});
Zamanlanmış yeniden oluşturma bu kancayla sınırlanmaz; kataloğun tamamını işler.
Alt kategorilerdeki ürünler bulunamıyor
Dosya, her üründe yalnızca işaretlenmiş kategorileri saklar ve tarayıcı bunları harfi harfine karşılaştırır; kategori ağacını bilmez. WordPress, alt kategorilerin ürünlerini üst kategoride gösterir, Turbo modu ise göstermez: yalnızca Koşu ayakkabıları kategorisinde işaretli bir ürün, ilk filtre tıklamasına kadar Ayakkabılar sayfasında listelenir, sonra kaybolur; Ayakkabılar filtre terimi onu bulamaz ve Ayakkabılar sayımı onu hesaba katmaz. Bu tür ürünlerde zincirin her düzeyini (Ayakkabılar ve Koşu ayakkabıları) işaretleyin, örneğin Ürünler → Tüm Ürünler içindeki toplu düzenlemeyle, ardından dosyayı yeniden oluşturun.
Gizli ve stokta olmayan ürünler
Katalog görünürlüğü (Catalog visibility) değeri Yalnızca mağaza (Shop only) veya Gizli (Hidden) olan ürünler aramadan gizlenmiş sayılır ve Katalog görünürlüğünü dinle (Listen catalog visibility) ne derse desin, Turbo modu bunları filtrelemeden sonra asla döndürmez. Bu nedenle Yalnızca mağaza (Shop only) ürünü mağaza sayfasında görünür ve ilk tıklamada kaybolur; filtrelenebilmesini istiyorsanız Mağaza ve arama sonuçları (Shop and search results) olarak ayarlayın. WooCommerce'in Stokta olmayan ürünleri katalogdan gizle (Hide out of stock items from the catalog) ayarı açıkken stokta olmayan ürünler dosyaya yazılmaz ve yeniden stoğa giren bir ürün, bir sonraki yeniden oluşturmaya kadar eksik kalır.
WPML dilleri
WPML ile HUSKY her dil için ayrı bir dosya yazar (data_0000_en.json, data_0000_de.json) ve geçerli dilin dosyasını yükler. Çevirisi olmayan bir ürün o dilin dosyasında bulunmaz; bu yüzden çeviriden sonra dosyayı yeniden oluşturun.
Arama dosyasını güncel tutma
Şimdi güncelle! (Update now!) dosyayı on ürün veya varyasyonluk gruplar halinde, saniyede en fazla bir grup olacak şekilde ve Ürünler ve Varyasyonlar (Products and Variants) sayacıyla oluşturur. Her grup dosyanın tamamını yeniden yazdığı için 15.000 kayıt en az 25 dakika sürer. Zamanlanmış yeniden oluşturmanın aksine, düğme önce mevcut dosyayı siler ve işlem bitene kadar site eksik verilerle filtreler: bunu sakin bir saatte çalıştırın, sayfayı açık tutun ve işlemin ortasında Turbo modunu kapatmayın.
WordPress Cron aralığı (WordPress Cron period) otomatik yeniden oluşturmayı belirler: günlük (daily), haftalık (weekly) (varsayılan), ayda iki kez (twicemonthly), aylık (monthly), min1 veya güncelleme yok (without update). Adına rağmen bu bir WP-Cron olayı değildir. HUSKY kendi zamanlamasını tutar (woof_turbo_init_wpcrone_ seçeneği): bir yeniden oluşturma zamanı geldiğinde, eklentiyle WordPress'i yükleyen her istek (en fazla beş saniyede bir) geçici bir dosyaya sonraki on kaydı ekler ve bu dosya son gruptan sonra canlı dosyanın yerini alır. O zamana kadar ziyaretçiler önceki verileri kullanır. Bundan çıkan sonuçlar:
- WP Crontrol ve benzeri araçlar bunu listelemez,
DISABLE_WP_CRONda onu durdurmaz. - Hız, PHP'ye ulaşan isteklere bağlıdır; sayfa önbelleğinden sunulan sayfalar sayılmaz. 20.000 kayıt, beş saniye arayla en az 2.000 istek gerektirir; bu, kesintisiz trafikte yaklaşık üç saat, sakin bir sitede ise günler demektir.
- İlk otomatik yeniden oluşturma, zamanlamayı kaydettikten bir tam aralık sonra gelir; bu yüzden etkinleştirdikten sonra Şimdi güncelle! (Update now!) düğmesine tıklayın.
- Aralık, önceki yeniden oluşturmanın bitişinden itibaren sayılır. min1 bir sonrakini bir dakika sonra başlatır, yani site sürekli yeniden oluşturur; yalnızca küçük kataloglarda kullanın.
- Otomatik bir yeniden oluşturma sırasında tıklanan Şimdi güncelle! (Update now!) onun geçici dosyasını da siler; otomatik çalışma bittiğinde, sizin eksiksiz dosyanızın yerine sonradan oluşturduğu kısmı koyar. Elle yeniden oluşturmadan saatler sonra ürünler yine kayboluyorsa düğmeye bir kez daha tıklayın.
Trafiği düşük bir sitede istekleri bir sunucu cron işi sağlayabilir; SSS'deki otomatik cron güncellemeleri neden başarısız olur yazısı kurulumu ve PHP sınırlarını gösterir. Günde bir kez değil, her dakika çağırın; çünkü her çağrı bir grup ekler. Eklentiyi Eklentiyi yalnızca şu site sayfalarında başlat (Init plugin on the next site pages only) ile sınırladıysanız, eklentinin her zaman yüklendiği /wp-admin/admin-ajax.php adresini istemesini sağlayın. Yine de saatte yalnızca 600 kayıt ekler; bu nedenle toplu değişen kataloglarda her içe aktarmadan sonra Şimdi güncelle! (Update now!) düğmesine tıklayın.
Başka aralıklar, eklenti dosyalarını düzenlemeden woof_turbo_mode_schedules kancasıyla eklenebilir; ardından yeni aralığı seçin ve kaydedin:
/*
* HUSKY Turbo mode: add "every 12 hours" to WordPress Cron period.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_turbo_mode_schedules', function ($schedules) {
$schedules['every_12_hours'] = array(
'name' => 'every 12 hours',
'value' => 12 * HOUR_IN_SECONDS,
);
return $schedules;
});
Dosya her yeniden oluşturmadan sonra aynı adreste kalır. Bir CDN veya tarayıcı .json dosyalarını önbelleğe alıyorsa ziyaretçiler eski verileri almaya devam edebilir: uploads_woof_turbo_mode klasörünü CDN önbelleğinden hariç tutun ya da yeniden oluşturmalardan sonra temizleyin.
Turbo modu AJAX gerektirir ve kendi sayım ayarlarına sahiptir
Turbo modu etkinken HUSKY, her sayfa yüklenişinde dört ayarı sıfırlar: Mağazayı ajaxlaştırmayı dene (Try to ajaxify the shop) Evet (Yes) olur; normal Sayıyı göster (Show count), Dinamik yeniden sayım (Dynamic recount) ve Boş terimleri gizle (Hide empty terms) ise Hayır (No) olur. Seçenekler (Options) sekmesi bu üçünün Turbo moduna ait kopyalarını aynı adlarla gösterir ve Dinamik yeniden sayım (Dynamic recount), Evet, tüm cihazlar için (Yes, for all devices) veya Evet, yalnızca PC için (Yes, only for PC) seçeneklerini sunar.
- Turbo modu açıkken AJAX kapatılamaz. Turbo modunu etkinleştir (Enable turbo mode) ayarını Hayır (No) yapın, kaydedin ve ancak ondan sonra Mağazayı ajaxlaştırmayı dene (Try to ajaxify the shop) ayarını değiştirin.
- Temanın ürün ızgarası AJAX filtrelemeden sonra bozuluyorsa (satır başına tek ürün, kaybolan sütunlar, bozuk sayfalama), Turbo modu bunu devralır: AJAX modunda sütun sayısını ayarlama ve AJAX modunda sayfalama sorunları yazılarına bakın ya da o tema için Turbo modunu kapalı tutun.
- Turbo modunu kapattıktan sonra Sayıyı göster (Show count), Dinamik yeniden sayım (Dynamic recount) ve Boş terimleri gizle (Hide empty terms) ayarlarını yeniden yapın: hâlâ Hayır (No) durumdadırlar ve sayaçlar o anda bu yüzden kaybolur.
- Boş terimleri gizle (Hide empty terms) yalnızca Sayıyı göster (Show count) ve Dinamik yeniden sayım (Dynamic recount) açıkken çalışır; Sayıyı göster (Show count) kapatıldığında diğer ikisi de kapanır.
- Filtredeki her öğe için dinamik yeniden sayım numarasını önbelleğe al (Cache dynamic recount number for each item in filter), Terimleri önbelleğe al (Cache terms) ve Fiyat filtresini optimize et (Optimize price filter) ayarları, Turbo modu açıkken Gelişmiş → Seçenekler bölümünden kaybolur; Turbo moduna uygulanmazlar.
Turbo modunun yapamadıkları
- Hiyerarşik açılır liste (Hierarchy drop-down) öğesi onunla çalışmaz; bu durum Turbo modu uzantısı sayfasında belirtilmiştir.
- Sayımlar ve Boş terimleri gizle (Hide empty terms) standart öğelerde çalışır (onay kutusu, radyo düğmesi, açılır listeler, renk, görsel, etiket, kaydırıcı). Smart Designer ile oluşturulan öğelerde sayım olmaz.
- Stokta (In stock) yalnızca her ürünün kendi stok durumuna bakar; varyasyonları denetleyen ayar etkisizdir, bu nedenle bir beden filtresi yine de stokta olmayan varyasyonları gösterebilir.
- Metin araması, metin arama öğesi açıklamalarda veya başka alanlarda arayacak şekilde ayarlanmış olsa bile yazılan kelimeleri yalnızca ürün başlıklarıyla karşılaştırır. Ayrı SKU öğesi çalışır.
- PHP'de eklenen koşullar aramada rol oynamaz, çünkü hangi ürünlerin eşleştiğine tarayıcı karar verir.
woof_products_queryveyapre_get_postsüzerindeki özel kodlar, özel uzantılar ve ürünleri satıcıya ya da müşteri grubuna göre sınırlayan eklentiler en fazla bulunan bazı ürünleri sonradan gizleyebilir; bu da sayımları ve sayfalamayı birbirinden koparır.
Mağazanız bunlardan herhangi birine ihtiyaç duyuyorsa ya da fiyatları ve stoku saatlik değişiyorsa Turbo modunu kapatın ve normal modu önbellekle hızlandırın.
Kontrol listesi
- Konsolda kırmızı hata yok; eklentinin betikleri geciktirme, erteleme ve birleştirme işlemlerinin dışında tutuluyor.
woof_turbo_mode_file.lengthyayınlanmış ürünler artı varyasyonlarla eşleşiyor; sayaç sınırda durmadı.- Dosya son içe aktarmadan veya filtre değişikliğinden sonra yeniden oluşturuldu; sayfa önbelleği ve CDN temizlendi.
- Ürünler tüm kategori zincirinde işaretli ve Mağaza ve arama sonuçları (Shop and search results) görünürlüğünde.
- Sayım ayarları Turbo modunun kopyalarında yapıldı ve Turbo modu kapatıldıktan sonra yeniden yapıldı.
Filtre hâlâ düzgün çalışmıyorsa sayfa bağlantısı, konsol hataları, woof_turbo_mode_file.length değeri ve ürün ile varyasyon sayınızla birlikte HUSKY destek forumunda bir konu açın.