WooCommerce Filtre Sayfalaması Çalışmıyor: Nedenler ve Çözümler
WooCommerce filtresi sayfalamasının çalışmaması genellikle birkaç biçimde ortaya çıkar: /wp-admin/admin-ajax.php?paged=2 adresine giden sayfa bağlantıları, tek bir 0 içeren boş sayfa, filtrelenmiş sonuçların sonunda boş sayfalar veya 404, 2. sayfada unutulan filtre ya da ilk filtrelemeden sonra duran sonsuz kaydırma. Her belirtinin kendi nedeni vardır ve çoğu filtreden değil, temanın sayfalamayı nasıl oluşturduğundan kaynaklanır. Tabloyla başlayın, sonra ilgili bölüme geçin.
| Ne görüyorsunuz | Olası neden |
|---|---|
admin-ajax.php?paged=2 bağlantıları, 0 yazan boş sayfa | Standart olmayan sayfalama işaretlemesiyle AJAX modu |
| Filtrelemeden sonra iki sayfalama veya iki "1–12 arası gösteriliyor, toplam 40" satırı | Tema, HUSKY'nin yenilediği alanın dışına kendi öğelerini yazdırıyor |
| Üründen fazla sayfa, son sayfalar 404 veya boş | HUSKY'de, temada ve oluşturucuda farklı "sayfa başına ürün" sayıları |
| 3. sayfadayken filtre değiştirince boş ızgara | Eski sayfa numarası yeni filtre bağlantısına taşınıyor |
| 2. sayfaya geçince filtre çalışmıyor veya biçimsiz | Temanın kendi AJAX sayfalaması, daha fazla yükle veya sonsuz kaydırması |
| Filtre 2. sayfada yok veya 2. sayfa filtrelenmemiş ürünler gösteriyor | Filtre sayfa içeriğine yerleştirilmiş veya sayfalama bağlantıları filtreyi düşürüyor |
| Filtrelemeden sonra hiç sayfalama yok | Sayfalamayı döngü kancalarının dışında yazdıran özel şablon veya tema |
admin-ajax.php bağlantıları: AJAX modu ve tema işaretlemesi
Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) ayarı Evet (Yes) olduğunda (veya bir sayfada [woof_products is_ajax=1] ile), HUSKY sayfayı yeniden yüklemez. Sunucudan admin-ajax.php aracılığıyla yeni ürünleri ister ve sayfalama dahil ürün bloğunu değiştirir. Bu yeni sayfalama AJAX isteği içinde oluşturulduğundan, bağlantıları admin-ajax.php?paged=2 adresine işaret eder. Bunların izlenmesi hiçbir zaman amaçlanmamıştır: HUSKY .woocommerce-pagination a.page-numbers üzerindeki tıklamaları yakalar, sayfa numarasını okur ve o sayfayı AJAX ile yükler.
Tema sayfalama işaretlemesini değiştirirse (sarmalayıcıda farklı bir sınıf, page-numbers sınıfı olmayan bağlantılar, kendi sayfalama işlevi), tıklama yakalanmaz ve tarayıcı ham bağlantıyı açar. WordPress, eylem belirtilmemiş bir admin-ajax.php isteğine 0 ile yanıt verir; boş sayfa budur. HUSKY'nin beklediği işaretleme WooCommerce'in kendi işaretlemesidir:
<nav class="woocommerce-pagination">
<ul class="page-numbers">
<li><span aria-current="page" class="page-numbers current">1</span></li>
<li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
<li><a class="next page-numbers" href="https://example.com/shop/page/2/">→</a></li>
</ul>
</nav>
Sayfalamanızı tarayıcıda inceleyin ve karşılaştırın. woocommerce/loop/pagination.php dosyasını geçersiz kılan veya kendi sayfalamasını kullanan bir tema alt temada düzeltilebilir (sarmalayıcı sınıfındaki woocmmerce-pagination gibi bir yazım hatası bile bozmaya yeter), ancak güvenilir çözüm kod gerektirmez: yönlendirme moduna geçin. Eklenti ayarlarını, Seçenekler (Options) sekmesini açın, Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) ayarını Hayır (No) yapın ve kaydedin; kısa kod bulunan sayfalarda is_ajax=0 kullanın. O zaman her filtreleme sayfayı yeniden yükler ve sayfalama temanın normal sayfalaması olur. AJAX yalnızca sayfalama için kapatılamaz. Ayrıca bkz. AJAX modunda sayfalama sorunları.
Seçenek kaydedildi diyor ama Evet (Yes) değerine dönüyorsa, Turbo modu etkindir. Turbo modu yalnızca AJAX ile çalışır ve seçeneği her sayfa yüklemesinde yeniden açar; önce Turbo modunu devre dışı bırakın.
Yinelenen sayfalama veya güncellenmeyen sonuç sayısı
Bazı temalar sonuç sayısını, sıralamayı veya sayfalamayı HUSKY'nin değiştirdiği bloğun dışına yazdırır. AJAX ile filtrelemeden sonra, temanın eski öğesini yenisinin yanında görürsünüz ya da hâlâ filtrelenmemiş mağazayı anlatan bir sayı kalır. Sayı için seçicisini, genellikle .woocommerce-result-count, Gelişmiş → Seçenekler → Sonuç sayısı css seçicisi (Advanced → Options → Result count css selector) alanına girin; HUSKY onu her filtrelemeden sonra yeniden çizer (Sıralama açılır listesi css seçicisi (Order dropdown css selector) sıralama için aynı işi yapar). Kopyalar kalırsa, yönlendirme modu onları ortadan kaldırır.
Fazladan sayfalar ve sonuçların sonunda 404
WordPress, /page/7/ sayfasının var olup olmadığına sayfanın ana sorgusuna bakarak karar verir: ana sorgunun altı sayfası varsa, o sayfadaki ürün ızgarası ne gösterirse göstersin 7. sayfa 404'tür. Sorunlar, görünen ızgara ile ana sorgu sayfa başına ürünleri farklı saydığında başlar; örneğin bir oluşturucu widget'ı sayfa başına 30 gösterirken ana sorgu temanın 12'sini kullanır: sayfalama ile var olan sayfa numaraları artık uyuşmaz, sayfalar boş kalır veya yarıda 404 ile biter. HUSKY'nin kendi ayarı olan Gelişmiş → Seçenekler → Sayfa başına ürün (Advanced → Options → Products per page) yalnızca bir filtre etkinken uygulanır (varsayılanı olan -1 "yönetme" anlamına gelir); bu yüzden onunla uyumsuzluk yalnızca filtrelemeden sonra ortaya çıkar.
- Sayıyı belirleyen her yeri bulun: tema veya WooCommerce katalog ayarları, oluşturucunun ürünler widget'ı ve HUSKY'nin Sayfa başına ürün (Products per page) ayarı.
- Hepsinde aynı sayıyı ayarlayın ya da HUSKY'ninkini
-1yapın; böylece karışmasın. - Filtre olmadan test edin: HUSKY'yi bir süreliğine devre dışı bırakın ve
/shop/page/17/gibi yüksek bir sayfayı doğrudan açın. Şimdi 404 ise, uyumsuzluk filtrede değil, tema ile oluşturucu arasındadır.
Sayfa sayısı yalnızca filtrelerken hâlâ fazlaysa, tema büyük olasılıkla sayfalamayı farklı bir sorgudan hesaplıyordur; çok fazla sayfa gösteren sayfalamayı düzeltme yazısında toplamı filtrelenmiş sorgudan almaya zorlayan bir kod parçası vardır. Avada'nın kendine özgü bir durumu vardır; Avada: sayfalamada filtre kayboluyor yazısında anlatılmıştır.
2. veya sonraki sayfada filtre değiştirdikten sonra boş sayfa
3. sayfadaki bir ziyaretçi bir filtreyi değiştirir. Yeni sonucun tek sayfası vardır; yeni bağlantı hâlâ 3. sayfayı isterse ızgara boş olur veya sayfa 404 verir. HUSKY bunu standart sayfalama için önler: oluşturduğu bağlantıdan /page/N/ ve WooCommerce'in product-page parametresini kaldırır, AJAX modunda ise her değişiklikte 1. sayfaya döner. Sorgu dizesindeki diğer sayfa parametreleri adresin geri kalanıyla birlikte yeni bağlantıya kopyalanır; örneğin düz kalıcı bağlantılı sitelerde ?paged=3 veya bir sayfa oluşturucunun kendi sayfalama parametresi. Güzel kalıcı bağlantılar (Ayarlar → Kalıcı Bağlantılar (Settings → Permalinks), Düz (Plain) dışında herhangi bir yapı) ve standart WooCommerce sayfalamasını kullanın, ayrıca filtre değiştirdikten sonra adresi kontrol edin: içinde sayfa numarası olmamalıdır.
Tema AJAX sayfalaması, daha fazla yükle ve sonsuz kaydırma
Birçok temanın kendi AJAX mağazası vardır: sayfa yenilemeden ürünleri ve kenar çubuğunu değiştiren sayfalama, "daha fazla yükle" düğmeleri, sonsuz kaydırma, AJAX sıralama veya ızgara/liste anahtarı. HUSKY formunu sayfa yüklendiğinde (ve kendi AJAX yenilemesinden sonra) başlatır. Tema yeni kenar çubuğu HTML'si yerleştirdiğinde, yeni filtre öğeleri hiç başlatılmaz; bu yüzden filtre tepki vermeyi bırakır, biçimini kaybeder veya yanlış değerler gönderir. Temanın daha fazla yükle isteği de "sonraki sayfa" için kendi sorgusunu oluşturur ve filtreden haberi yoktur; filtrelenmiş bir listeye filtrelenmemiş ürünlerin eklenmesinin nedeni budur.
- Temanın AJAX sayfalamasını, AJAX mağazasını, sonsuz kaydırmasını ve daha fazla yükle seçeneklerini kapatın ve standart sayfalamayla test edin. Bu, çoğu durumu çözer.
- Sonsuz kaydırma için HUSKY, ücretsiz YITH Infinite Scrolling eklentisi için yerleşik desteğe sahiptir: her AJAX filtrelemesinden sonra kaydırmayı yeniden başlatır ve sonraki sayfa bağlantısını düzeltir. filtrelenmiş ürünler için sonsuz kaydırma yazısında listelenen seçicileri kullanın.
- AJAX filtrelemesinden sonra yeniden başlaması gereken diğer her betik, woof_ajax_done olayı yazısında anlatılan
woof_ajax_doneolayını dinleyebilir. Hangi çağrının onu yeniden başlatacağı o betiğe bağlıdır; yazarına sorun.
/*
* Runs after every HUSKY AJAX filtering.
* Put it in a JavaScript file of your child theme.
*/
jQuery(document).on('woof_ajax_done', function () {
// call the init function of your infinite scroll or load-more script here
});
Bir tema dosyası yerine, bu işlevin gövdesi Gelişmiş → Kod → AJAX tamamlandıktan sonraki JavaScript kodu (Advanced → Code → JavaScript code after AJAX is done) alanına yazılabilir.
2. sayfada filtre yok veya unutulmuş
- Filtre 2. sayfada kayboluyor. Mağaza sayfası içeriğine veya bir kategori açıklamasına yerleştirilmiş. WooCommerce ikisini de yalnızca bir arşivin ilk sayfasında yazdırır. Filtreyi bir kenar çubuğu widget'ına, temanın her sayfada görünen bir alanına ya da açıklamanın dışındaki bir oluşturucu bloğuna koyun.
- 2. sayfa filtrelenmemiş ürünler gösteriyor. Yönlendirme modunda standart WooCommerce sayfalaması filtreyi bağlantılarında korur (
/shop/page/2/?swoof=1&pa_color=red). Bir sayfa bağlantısının üzerine gelin:swoof=1ve filtre değerleriniz yoksa, tema sorgu dizesi olmadan kendi bağlantılarını oluşturuyordur; standart sayfalamaya geçin veya temanın bağlantı işlevini düzeltin. - 2. sayfa mağazaya yönleniyor veya kategoriyi kaybediyor. Ürün URL'lerini veya arşiv kısa adlarını yeniden yazan eklentiler ve özel kod, filtre bağlantılarıyla çakışabilir. Onlar devre dışıyken test edin; bilinen bir durum için bkz. HUSKY ve Permalinks Manager Pro.
Filtrelemeden sonra sayfalama yok
AJAX modunda yenilenen blok, WooCommerce'in woocommerce_after_shop_loop kancasında yazdırdığı her şeyi içerir ve WooCommerce'in sayfalaması orada durur. Sayfalamayı o kancadan kaldırıp kendisininkini başka bir yere yazdıran bir tema, ilk AJAX filtrelemesinden sonra onu kaybeder; yönlendirme modu sorunu önler. Kendi arşiv şablonunuzu oluşturduysanız, sayfalamayı ürün döngüsünden sonra kendiniz yazdırın:
<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>
Özel bir şablonun AJAX modunun hiç çalışması için standart mağaza döngüsü kancalarına da ihtiyacı vardır; hangilerinin gerektiğini filtre URL'si değişiyor ama ürünler değişmiyor yazısı açıklar.
Ziyaretçileri sayfa değişiminden sonra ürünlerin en üstüne döndürmek için bkz. AJAX filtrelemesinden sonra otomatik kaydırma veya yönlendirme modunda ürünlere otomatik kaydırma.
WooCommerce filtre sayfalaması çalışmadığında kontrol listesi
- Tüm önbellekler temizlendikten sonra yönlendirme modunda test edildi (Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) = Hayır (No), Turbo modu kapalı, kısa kodlarda
is_ajax=0). - Sayfalama işaretlemesi
nav.woocommerce-paginationvea.page-numbersbağlantılarıdır. - Sayfa başına ürün sayısı temada, oluşturucuda ve HUSKY'de aynıdır ya da HUSKY'ninki
-1'dir. - Tema AJAX sayfalaması, daha fazla yükle ve sonsuz kaydırma kapalıdır ya da
woof_ajax_doneolayında yeniden başlatılır. - Filtrelenmiş bir sayfadaki sayfalama bağlantıları
swoof=1ve filtre değerlerini içerir; filtre değişikliğinden sonra eski bir sayfa numarası kalmaz. - Filtre, mağaza veya kategori açıklamasında değil, bir kenar çubuğunda ya da şablon alanındadır.
Temanın standart sayfalamasıyla yönlendirme modunda sayfalama hâlâ başarısız oluyorsa, HUSKY destek forumunda sayfa bağlantısı ve başarısız olan bir sayfanın adresiyle birlikte bir konu açın.