HUSKY - WooCommerce Product Filter Professional

WooCommerce AJAX Filtresi Ürün Izgarası Düzenini Bozuyor: Çözümler

Mağaza ilk filtre tıklamasına kadar doğru görünür. Sonra üç sütun dört olur, satırlarda boşluklar oluşur, ürün kartları temanın rozetlerini ya da düğmelerini kaybeder veya kenar çubuğu ürünlerin altına kayar. Bir WooCommerce AJAX filtresi ürün ızgarası düzenini bozduğunda ürünlerin kendisi doğrudur; değişen, onları çizen HTML'dir. Aşağıda HUSKY'nin AJAX modunun neyi değiştirdiğini, temaya özgü işaretlemenin yolda neden kaybolduğunu ve her belirtinin çözümünü bulacaksınız.

AJAX modu neyi değiştirir ve neyi kopyalayamaz

Mağazayı ajaxlaştırmayı dene (Try to ajaxify the shop) ayarı Evet (Yes) olduğunda (WooCommerce → Ayarlar → Products Filter → Seçenekler), eklenti mağaza ve kategori sayfalarının ürün alanını işaretler. woocommerce_before_shop_loop kancasında (öncelik 2) bir <div class="woocommerce woocommerce-page woof_shortcode_output"> kapsayıcısı açar ve içine <div id="woof_results_by_ajax"> koyar, woocommerce_after_shop_loop kancasında (öncelik 10) ikisini de kapatır.

Bir ziyaretçi filtreyi değiştirdiğinde betik, woof_draw_products eylemiyle /wp-admin/admin-ajax.php adresine bir istek gönderir. Sunucu [woof_products is_ajax=1] çıktısını oluşturur ve betik kapsayıcıyı sonuçla değiştirir. Bu sonuç yalnızca standart WooCommerce parçalarından oluşturulur:

  • woocommerce_before_shop_loop kancası (bildirimler, sonuç sayısı, sıralama açılır listesi);
  • <ul class="products columns-N"> yazdıran woocommerce_product_loop_start();
  • her ürün için content-product.php şablon parçası;
  • woocommerce_product_loop_end() ve woocommerce_after_shop_loop kancası (sayfalama).

Bundan iki sonuç çıkar. Birincisi, temanızın arşiv şablonunun iki kanca arasında kendi başına yazdırdığı her şey (ek sarmalayıcılar, bir ızgara sınıfı, bir oluşturucunun döngü teması) yeni HTML'de yoktur. İkincisi, yeni HTML mağaza sayfasında değil, bir admin-ajax isteğinde üretilir. Mağaza sayfası yüklenirken wp veya template_redirect eyleminde, arşiv şablonunun içinde ya da yalnızca is_admin() yanlış olduğunda çalışan kod bu istekte hiç çalışmaz. Izgarayı sayfa yüklenirken bir kez biçimlendiren tema betikleri de yeniden çalışmaz.

Neyin değiştiğini bulun: işaretlemeyi öncesi ve sonrasıyla karşılaştırın

Mağazayı gizli bir pencerede açın, ilk ürüne sağ tıklayın ve İncele (Inspect) seçeneğini seçin. ul.products üzerindeki, üst öğelerindeki ve ilk li.product üzerindeki sınıfları not edin. Bir filtre uygulayın ve aynı yeri yeniden inceleyin. Aradaki fark çözümü gösterir:

Filtrelemeden sonraki belirtiNedenBölüm
Farklı sütun sayısı, columns-3 yerine columns-4Temanın sütun ayarı AJAX isteğinde uygulanmıyorSütunlar ve boşluklar
3, sonra 1, sonra 3 ürünlük satırlar; ızgarada boşluklarfirst/last satır sınıfları başka bir sütun sayısına göre hesaplanıyorSütunlar ve boşluklar
Kenar çubuğu veya alt bilgi kayıyor, kayboluyor ya da tekrarlanıyor; ürünler iki kez gösteriliyorTema döngünün çevresinde iki mağaza döngüsü kancasını da çağırmıyorMağaza döngüsü kancaları
ul.products üzerindeki sınıf eksik, düğmeler veya rozetler geri geliyor, ızgara/liste görünümü kayboluyor, görseller boşTema işaretlemesi, PHP koşulları veya tema betikleriTema kart özellikleri

Filtrelemeden sonra ürün sütunları değişiyor ve boşluklar beliriyor

[woof_products] sütun sayısını WooCommerce'in loop_shop_columns filtresinden alır; bu filtre de Görünüm → Özelleştir → WooCommerce → Ürün Kataloğu içindeki Satır başına ürün (Products per row) değerine döner. Kendi sütun seçeneği olan temalar bunu çoğunlukla yalnızca bir mağaza sayfası yüklenirken uygular. AJAX isteğinde bu kod çalışmaz; bu yüzden sonuçlar WooCommerce'in değeriyle gelir: mağaza 3 gösterirken çoğu zaman 4.

Boşlukların kökü aynıdır. WooCommerce her satırın ilk ürününe first, sonuncusuna last sınıfını verir; bunları o sütun sayısına göre hesaplar ve klasik float ızgarası her first öğesinde yeni bir satır başlatır. Temanın CSS'i satır başına 3 ürüne göre ayarlıysa ve AJAX HTML'i 4 sayıyorsa her dördüncü ürün yeni bir satıra zorlanır: 3 ürün, sonra tek başına 1, sonra yine 3.

Sütun sayısını, masaüstünde mağazanızın gösterdiği sayıyla, her istek için bir kez ayarlayın:

/**
 * Same number of columns on shop pages and in HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'loop_shop_columns', function () {
    return 3; // products per row on desktop
}, 999 );

Bunu is_shop() veya benzeri denetimlerle sarmayın, yoksa AJAX isteğinde atlanır. 999 önceliği, temanın kendi filtresine üstün gelmesini sağlar. Kısa SSS filtrelenmiş sonuçları belirli bir sütun sayısına zorlama aynı filtreyi kullanır. Özel bir sayfada [woof_products columns=3] sayıyı doğrudan belirler. Telefonlar ve tabletler her iki durumda da temanın CSS medya sorgularıyla biçimlendirilir.

Filtrelemeden sonra sınıf columns-3 yazıyor ve genişlikler hâlâ yanlışsa tema, ürünleri değiştirilen alanın dışındaki kendi sarmalayıcısındaki bir sınıfla boyutlandırıyordur. AJAX kapsayıcısı için CSS ekleyin: Görünüm → Özelleştir → Ek CSS içine ya da eklentinin Özel CSS kodu (Custom CSS code) alanına (Gelişmiş → Kod):

/* HUSKY AJAX results: 3 products per row in a float-based grid */
#woof_results_by_ajax ul.products li.product {
    width: 30.75%;
    margin-right: 3.8%;
    clear: none;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n) {
    margin-right: 0;
}
#woof_results_by_ajax ul.products li.product:nth-child(3n+1) {
    clear: both;
}

Temanız ul.products öğesini float yerine CSS grid ile düzenliyorsa tek bir kural yeterlidir: #woof_results_by_ajax ul.products { grid-template-columns: repeat(3, 1fr); }. Tema telefonlarda daha az sütun kullanıyorsa her iki sürümü de bir masaüstü medya sorgusuna sarın.

Ürünlerin altında kenar çubuğu, bozuk alt bilgi, çift sonuçlar: mağaza döngüsü kancaları

AJAX modu, temanın woocommerce_before_shop_loop kancasını ürün listesinden hemen önce, woocommerce_after_shop_loop kancasını ise hemen sonra, standart WooCommerce şablonunda olduğu gibi çağırmasını gerektirir. Çağırmadığında:

  • Kapanış kancası eksik. İki kapsayıcı hiç kapatılmaz ve tarayıcı onları yalnızca üst öğelerinin sonunda kapatır. Kenar çubuğu, ikinci sütun ya da alt bilgi ürün alanının içinde kalır: çoğu zaman kenar çubuğu sayfa yüklenirken zaten ürünlerin altındadır ve ilk filtre tıklamasından sonra kapsayıcının içindeki her şey, filtreli kenar çubuğu da dahil, sonuçlarla değiştirilir.
  • Kancalar başka bir yerde çağrılıyor. Tema bunları bir araç çubuğunda tetikleyip ürün döngüsünü woocommerce_after_shop_loop sonrasında yazdırıyorsa AJAX sonuçları kapsayıcıya düşer, özgün ızgara ise altında kalır; ürünler iki kez görünür.
  • Tema sarmalayıcıları kapsayıcıları kesiyor. Temanın woocommerce_before_shop_loop üzerinde açıp woocommerce_after_shop_loop üzerinde kapattığı bir öğe, HUSKY'nin kapsayıcılarının tamamen içinde (öncelik 2'den sonra açılıp 10'dan önce kapanan) ya da tamamen dışında olmalıdır. Aradaki her şey bunlarla çakışır ve iç içe geçmeyi bozar.

Kontrol etmek için sayfa kaynağını açın (Ctrl+U), woof_results_by_ajax ifadesini arayın ve HTML'i aşağı doğru izleyin: ürünlerin ve sayfalamanın kapanış </ul> etiketinden sonra kenar çubuğu veya alt bilgi başlamadan önce iki </div> bulunmalıdır. Tema klasöründe arşiv şablonlarında woocommerce_after_shop_loop ifadesini arayın. AJAX moduyla çalışan bir şablonun ürün kısmı, WooCommerce'in kendi archive-product.php dosyasına benzer:

<?php
if ( woocommerce_product_loop() ) {
    do_action( 'woocommerce_before_shop_loop' );

    woocommerce_product_loop_start();
    if ( wc_get_loop_prop( 'total' ) ) {
        while ( have_posts() ) {
            the_post();
            do_action( 'woocommerce_shop_loop' );
            wc_get_template_part( 'content', 'product' );
        }
    }
    woocommerce_product_loop_end();

    do_action( 'woocommerce_after_shop_loop' );
} else {
    do_action( 'woocommerce_no_products_found' );
}

Değişikliği şablonun alt tema kopyasında yapın ya da tema yazarından eksik kancayı eklemesini isteyin. Sayfa oluşturucu düzenleri nadiren iki kancayı da çağırır; onlar için aşağıda anlatılan yönlendirme modu gerçekçi seçimdir. Hiç değişmeyen ürünler filtre URL'si değişiyor ama ürünler değişmiyor yazısında, Elementor şablonları ise Elementor Loop Grid ve arşiv şablonları filtrelemiyor yazısında ele alınıyor.

Tema kart özellikleri kayboluyor: rozetler, düğmeler, ızgara sınıfları, betikler

PHP'nizin yalnızca mağaza sayfalarında yaptığı değişiklikler

Sepete ekle düğmelerini gizleyen, bir kategori satırı veya rozet ekleyen ve bunu wp ya da template_redirect üzerinde is_shop() ile belirleyen kod AJAX isteğinde çalışmaz; bu yüzden filtrelemeden sonra varsayılan kart geri gelir. Kodu HUSKY'nin isteği için de çalıştırın. admin_init, her admin-ajax isteğinde tetiklenir:

/**
 * Card changes for shop pages AND for HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
function my_shop_card_changes() {
    // Example: no add-to-cart buttons in the product grid
    remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );
}

// Normal page loads of the shop and product archives
add_action( 'wp', function () {
    if ( is_shop() || is_product_taxonomy() ) {
        my_shop_card_changes();
    }
} );

// HUSKY AJAX filtering, sent through admin-ajax.php
add_action( 'admin_init', function () {
    if ( wp_doing_ajax() && isset( $_REQUEST['action'] ) && 'woof_draw_products' === $_REQUEST['action'] ) {
        my_shop_card_changes();
    }
} );

Kartı değiştiren tema seçenekleri (bir kategori satırı, bir üzerine gelme görseli, bir hızlı görünüm düğmesi) de çoğunlukla tema içinde aynı şekilde uygulanır. Filtrelemeden sonra kayboluyorlarsa ve temada AJAX isteklerini de kapsayan bir kanca yoksa yönlendirme modunu kullanın.

Temanın ürün listesine eklediği sınıflar

Karşılaştırma, ul.products üzerinde sayfa yüklenirken var olan ama filtrelemeden sonra eksik olan bir sınıf gösteriyorsa, onu woof_draw_products_html filtresiyle AJAX yanıtına ekleyin. Filtre, tarayıcıya gönderilmek üzere olan HTML'i alır:

/**
 * Add the theme's grid class to the product list in HUSKY AJAX results.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
    return str_replace(
        '<ul class="products columns-',
        '<ul class="products my-theme-grid columns-', // use the class from your page
        $html
    );
}, 10, 2 );

Aranan dize, WooCommerce'in kendi loop/loop-start.php dosyasıyla eşleşir; temanız bu dosyayı geçersiz kılıyorsa açılış etiketini sayfa kaynağından kopyalayın. Tema kartları content-product.php dışında bir şablon parçasıyla çiziyorsa adını woof_template_part filtresiyle döndürün: product-grid değeri, temanızın woocommerce klasöründeki content-product-grid.php dosyasını yükler.

Tema betikleri: tembel görseller, eşit yükseklikler, masonry, hızlı görünüm

Sayfa yüklenirken bir kez çalışan betikler (tembel yüklenen görseller, eşit yükseklikli kartlar, masonry, ızgara/liste anahtarları, hızlı görünüm düğmeleri) yeni ürünleri görmez. HUSKY her değişimden sonra woof_ajax_done jQuery olayını tetikler; temanın başlatma çağrısını buraya, bir tema JS dosyasına ya da AJAX tamamlandıktan sonraki JavaScript kodu (JavaScript code after AJAX is done) alanına (Gelişmiş → Kod) koyun. İşlevin adını tema yazarı söyleyebilir; olay hakkında daha fazlası woof_ajax_done yazısında.

jQuery(document).on('woof_ajax_done', function () {
    // Many layout scripts recalculate on resize
    jQuery(window).trigger('resize');
    // Call your theme's own init function here if it has one
});

Sonuç sayısı veya sıralama iki kez gösteriliyor

Ürün alanının dışında kendi sayısını ve sıralama çubuğunu yazdıran bir tema, AJAX sonuçlarının içinde yine de WooCommerce'in varsayılan kopyalarını alabilir. İç kopyaları, yalnızca gerçekten yinelenmişlerse gizleyin:

#woof_results_by_ajax .woocommerce-result-count,
#woof_results_by_ajax .woocommerce-ordering {
    display: none;
}

Alanın dışındaki temanın kendi sayısı filtrelemeden sonra güncellenmiyorsa CSS seçicisini Sonuç sayısı css seçicisi (Result count css selector) alanına (Gelişmiş → Seçenekler) koyun: eklenti o zaman her AJAX yanıtıyla yeni bir sayı gönderir ve bulduğu öğeyi değiştirir.

AJAX'tan ne zaman vazgeçilir: yönlendirme modu ve Turbo modu

Bazı düzenler standart WooCommerce parçalarından yeniden kurulamaz: oluşturucu döngü temaları, atlıkarıncalar, kancaları olmayan tema şablonları. Mağazayı ajaxlaştırmayı dene (Try to ajaxify the shop) ayarını Hayır (No) yapın. O zaman her filtre değişikliği filtrelenmiş URL'yi yükler ve temanız tüm sayfayı her zamanki gibi oluşturur; böylece ızgara, filtrelenmemiş mağazayla aynı olur. Kaybettiğiniz şey yerinde güncellemedir. Her tıklamadan sonra değil, arama başına bir kez yeniden yüklemek için Otomatik gönderme (Autosubmit) ayarını Hayır (No) yapın, böylece filtre düğmesini bekler; ziyaretçiyi sonuçlara indirmek için yönlendirme modunda ürünlere otomatik kaydırma yazısına bakın.

Mağazayı ajaxlaştırmayı dene (Try to ajaxify the shop) tekrar Evet (Yes) durumuna dönüyorsa Turbo modu açıktır: her sayfa yüklenişinde AJAX modunu açar. Önce kendi sekmesinde Turbo modunu etkinleştir (Enable turbo mode) ayarını Hayır (No) yapın, sonra AJAX'ı kapatın ve ziyaretçiler yeni ayarı alsın diye sayfa önbelleğini temizleyin.

Kontrol listesi

  • İşaretleme, tarayıcı denetçisinde filtrelemeden önce ve sonra karşılaştırıldı.
  • loop_shop_columns, mağazanın sütun sayısını sayfa koşulları olmadan döndürüyor.
  • Sayfa kaynağında iki HUSKY kapsayıcısı ürünlerden ve sayfalamadan hemen sonra kapanıyor.
  • PHP'deki kart değişiklikleri woof_draw_products isteği için de çalışıyor; tema betikleri woof_ajax_done olayında yeniden çalışıyor.
  • Düzen hâlâ farklıysa: Mağazayı ajaxlaştırmayı dene (Try to ajaxify the shop) = Hayır (No), Turbo modu kapalı ve önbellekler temizlenmiş.

Düzen, Storefront gibi varsayılan bir temayla ve yalnızca HUSKY etkinken de bozuluyorsa, mağaza sayfasının bağlantısı ve filtrelemeden sonra nelerin değiştiğinin açıklamasıyla birlikte HUSKY destek forumunda bir konu açın.