HUSKY - WooCommerce Product Filter Professional

WooCommerce Filtre URL'si Değişiyor Ama Ürünler Değişmiyor: Çözüm

Bir renk ya da kategori işaretliyorsunuz, yükleme göstergesi beliriyor, adres çubuğu /shop/?swoof=1&pa_color=red gibi bir şeye dönüşüyor ve ürün ızgarası aynı ürünleri göstermeye devam ediyor. WooCommerce filtre URL'si değişip ürünler değişmediğinde, filtre kendi işini yapmıştır: arama isteğini oluşturmuştur. Ürünleri yazdıran şablon ise onu hiç okumamıştır. Bu rehber, bunu iki dakikada nasıl doğrulayacağınızı ve bir tema, sayfa oluşturucu veya özel şablonun filtreye nasıl yanıt vermesini sağlayacağınızı gösterir.

Filtre URL'si Neden Değişiyor Ama Ürünler Değişmiyor

HUSKY mağazanızın ürün ızgarasını çizmez. Koşullarını (taksonomiler, fiyat, meta alanları, metin) WooCommerce'in zaten çalıştırdığı ürün sorgularına ekler ve yalnızca onlara ekler:

  • mağaza sayfasının ve ürün kategorisi, etiketi ve nitelik arşivlerinin ana sorgusu (WooCommerce'in woocommerce_product_query adımı);
  • eklentinin kendi [woof_products] kısa kodu;
  • woocommerce_shortcode_products_query üzerinden [products] gibi WooCommerce ürün kısa kodları.

Kendi WP_Query sorgusunu oluşturan bir ürün listesi bu yolun dışında kalır. Sayfa oluşturucu ürün ızgaraları, yazı kartları ve tekrarlayıcılar, "sorgu döngüsü" öğeleri, kendi sorgusu olan tema arşiv düzenleri ve bir PHP şablonundaki elle yazılmış döngülerin tümü veritabanından ürünleri kendi yöntemleriyle ister; bu yüzden filtre ne derse desin tüm kataloğu göstermeye devam ederler. Filtrede bozuk bir şey yoktur; liste sadece onu dinlemiyordur.

İki ilgili belirti aynı kökten gelir. Filtrenin betiğinin bir WooCommerce ürün listesi bulamadığı normal bir sayfada, ziyaretçiyi sonuçları göstermek için mağaza sayfasına yönlendirir. Gerçekte bir oluşturucuyla yapılmış bir WordPress sayfası olan "kategori sayfasında" ise filtre geçerli kategoriyi bilmez, bu yüzden her terimi sunar ve tüm kataloğu arar.

Nedeni İki Dakikada Doğrulayın

  1. Filtreledikten sonra URL'yi okuyun. İçinde swoof=1 ve seçimleriniz varsa (SEO URL'leri açıkken /swoof/ ve ardından seçimler, fiyat tek seçimse yalnızca min_price ve max_price), filtre çalışmıştır. URL hiç değişmiyorsa filtre hiç gönderilmemiştir: önce tarayıcı konsolunda bir JavaScript hatası arayın.
  2. Aynı isteği standart mağaza sayfasında deneyin. ?swoof=1 ile başlayan her şeyi kopyalayıp WooCommerce mağaza sayfanızın URL'sine ekleyin. Orada filtrelenmiş, sizin sayfanızda filtrelenmemiş ürünler görmek doğrudan sayfanızın ürün listesini işaret eder.
  3. Düz bir kısa kodla test edin. Bir taslak sayfaya [woof] ve altına [woof_products per_page=12] ya da WooCommerce'in [products limit="12"] kısa kodunu koyun. Bunlar doğru filtreliyorsa, gerçek sayfanız için aşağıdaki çözümlerden birini kullanın.
  4. Sayfanın ne tür bir sayfa olduğunu kontrol edin. Düzenleme ekranına bakın: üzerinde ürün ızgarası olan bir WordPress Sayfası (Page), URL'si /category/shoes/ gibi görünse bile bir ürün arşivi değildir.

Çözüm 1: Ürünleri [woof_products] ile gösterin

En güvenilir çözüm, ürünleri eklentinin yazdırmasına izin vermektir. Oluşturucunun ürün öğesini, [woof_products] içeren bir Kısa Kod widget'ı veya bloğuyla değiştirin:

[woof_products per_page=12 columns=4 is_ajax=1]

Kısa kod herhangi bir sayfada filtreye tepki verir, is_ajax=1 ile AJAX modunu destekler ve her ürünü temanızın normal WooCommerce ürün kartıyla (content-product.php şablon parçası) çizer; böylece mağaza gibi görünür. Başka bir şablon parçası kullanmak için woof_template_part filtresiyle değiştirin.

Yalnızca tek bir kategoriyi listelemesi gereken bir sayfa için aynı koşulu her iki kısa koda da verin; aksi halde filtre tüm katalogdan terimler sunar:

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

25 değerini kategori kimliğiyle değiştirin (kategoriyi düzenlerken URL'de görünür). WooCommerce'in kendi [products] kısa kodu da filtrelenir, ancak yalnızca sayfa yenilenerek. AJAX modunda istiyorsanız [products_woof limit="12" columns="4"] olarak yazın: eklenti onu sonuçlar sayfa yenilenmeden değiştirilebilsin diye sarmalar.

Çözüm 2: Oluşturucu ızgarasının veya özel WP_Query'nin filtreyi dinlemesini sağlayın

Oluşturucunun kendi kart tasarımını korumak istediğinizde, sorgusunun filtrenin sonucunu kullanmasını sağlayın. Aşağıdaki kod parçası pre_get_posts kancasına bağlanır, HUSKY'ye geçerli filtreyle hangi ürünlerin eşleştiğini sorar ve ızgaranın sorgusunu onlarla sınırlar. Sayfa oluşturucuları ve özel şablonları filtrelenebilir yapma yazısındaki kodun sağlamlaştırılmış bir sürümüdür: wp-admin ürün listelerine dokunmaz, ızgaranın sayfalamasını çalışır durumda tutar, öğenin sabit ürün seçimine saygı gösterir ve hiçbir şey eşleşmediğinde tüm katalog yerine "ürün yok" gösterir.

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

Nasıl çalışır: woof()->woof_products( array( 'get_args_only' => 1 ) ), [woof_products] kısa kodunun geçerli istek için kullanacağı sorgu argümanlarını, çalıştırmadan döndürür. Kod parçası bunları eşleşen ürün kimliklerinin bir listesine dönüştürür ve bu listeyi ızgaraya post__in olarak verir. Izgara kendi düzenini, sıralamasını ve sayfa boyutunu korur. Aynı kanca, product yazı türünü sorguladığı sürece bir şablonda kendiniz yazdığınız WP_Query sorgusunu da kapsar.

Filtrelenmiş bir sayfadaki her ürün sorgusu artık filtreyi izler; altbilgideki "en çok satanlar" veya "ilgili ürünler" gibi kaydırıcılar da buna dahildir. İstediğiniz bu değilse is_page() satırının yorumunu kaldırın ve ızgaranın bulunduğu sayfanın kimliğini yazın; bu, sayfadaki diğer her ürün listesi için bir ek veritabanı sorgusunu da önler.

AJAX Modu İki Mağaza Döngüsü Kancasına İhtiyaç Duyar

Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) ayarı Evet (Yes) olduğunda (WooCommerce → Ayarlar → Products Filter → Seçenekler), eklenti ürün listesini kendi kapsayıcısına sarar. Kapsayıcıyı woocommerce_before_shop_loop kancasında açar, woocommerce_after_shop_loop kancasında kapatır. Her filtre değişikliğinden sonra sunucudan yeni HTML ister ve o kapsayıcının içeriğini değiştirir. Standart WooCommerce arşiv şablonu her iki kancayı da çağırır; birçok oluşturucu düzeni ve özel şablon çağırmaz. Sonuç üç belirtiden biridir:

  • Hiçbir kanca çağrılmıyor: değiştirilecek bir kapsayıcı yoktur, bu yüzden her filtre değişikliği tüm sayfayı yeniden yükler.
  • Yalnızca ilk kanca çağrılıyor: açılan kapsayıcı hiç kapatılmaz ve düzenin geri kalanını, örneğin ikinci sütunu veya kenar çubuğunu yutar; kenar çubuğu birden ürün sütununun içinde belirir.
  • Kartlar filtrelemeden sonra görünümünü değiştiriyor: AJAX sonuçları sunucuda [woof_products] tarafından oluşturucunun kart tasarımıyla değil, standart WooCommerce ürün kartıyla çizilir. Oluşturucunun gizlediği yerlerde varsayılan adet alanları veya sepete ekle düğmeleri görünür.

Şablon koduna sahipseniz, her iki kancayı da döngünün çevresinde çağırın:

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

İki kanca arasındaki her şey her AJAX isteğinde değiştirilir; bu yüzden her ürünün etrafında istediğiniz sarmalayıcı işaretleme arşiv şablonuna değil, content-product.php dosyasına aittir. Kendi döngünüzün özel koşulları (örneğin "son 60 günün ürünleri") AJAX sonucunun parçası değildir, çünkü sunucu onu [woof_products] ile oluşturur; bu tür koşulları woof_products_query kancasıyla ekleyin ya da yönlendirme modunu kullanın.

Şablonu değiştiremiyorsanız, ki oluşturucularda genellikle durum budur, Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) ayarını Hayır (No) yapın. Yönlendirme modunda her filtre değişikliği filtrelenmiş URL'yi yükler ve Çözüm 2'deki kod parçası oluşturucu ızgarasının doğru ürünleri göstermesini sağlar. Otomatik gönderim açıksa her seçim hemen uygulanır; yalnızca AJAX değişimi yerine sayfa yüklemesiyle.

Filtre Mağaza Sayfasına Atlıyor veya Kategoriyi Yok Sayıyor

Sonuçlar mağaza sayfasında açılıyor. Ürün arşivi olmayan bir sayfada filtrenin betiği bir WooCommerce ürün listesi arar: bir .woocommerce kapsayıcısı içinde products sınıflı bir öğe ya da eklentinin kendi çıktısı. Hiçbirini bulamazsa aramayı mağaza sayfasına gönderir ve sayfanızdaki filtre kaybolmuş gibi görünür. Çözüm 1 bunu çözer; açılış sayfaları ve ana sayfa için kısa kod kurulumları özel bir sayfada ürün filtresi yazısındadır. Oluşturucu ızgaranız Çözüm 2 sayesinde filtreye zaten tepki veriyor ama farklı bir işaretleme kullanıyorsa, betiğe sayfada kalmasını söyleyin:

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

Filtre diğer kategorilerden terimler sunuyor. Eklenti geçerli kategoriyi WordPress'ten alır (bir ürün taksonomisi arşivinin sorgulanan nesnesi). Kategori gibi görünmesi için yapılmış bir WordPress sayfasında bu yoktur, bu yüzden filtre tüm katalogla çalışır. Gerçek kategori arşivini kullanıp oluşturucunuzun arşiv veya tema oluşturucu şablonuyla biçimlendirin ya da Çözüm 1'de gösterildiği gibi her iki kısa koda taxonomies=product_cat:ID verin. WooCommerce desteği olmadan geliştirilmiş özel bir tema gerçek arşivlerde de aynı etkiyi yaratabilir; bir after_setup_theme geri çağrısında add_theme_support( 'woocommerce' ) bildirmek algılamayı düzeltir, ancak temanın ürün şablonlarının sonra düzenlenmesi gerekebilir. Sayfa gerçek bir arşivse ve kategori yine algılanmıyorsa, Gelişmiş → Seçenekler altında Kategori sayfasının ek denetimi (Additional check of the category page) ayarını Evet (Yes) yapın. Blok temalar bu denetimi otomatik olarak alır. Geçerli kategoride ürünü olmayan terimleri gizlemek için yalnızca geçerli kategorinin filtre seçeneklerini gösterme yazısına bakın.

Yönlendirme Çakışmaları: SEO URL'leri ve Kalıcı Bağlantılar

SEO URL isteği eklentisi açıkken filtre, sorgu dizesi yerine yolun bir parçası olur; örneğin /shop/swoof/color-red/. Bazı oluşturucular URL'leri ve şablonları kendileri çözümler (Bricks bilinen bir örnektir) ve bu yolu tanımaz; filtre arayüzü çalışırken ürünler hiç değişmez ya da sayfa filtrelenmemiş bir şablona geri döner. Test etmek için Gelişmiş → SEO URL isteği bölümünü açın, Etkinleştir/Devre dışı bırak (Enable/Disable) ayarını Hayır (No) yapın, tüm önbellekleri temizleyin ve yeniden filtreleyin. Düz ?swoof=1&... bağlantıları çalışıyorsa neden yönlendirmedir; o sitede SEO URL'lerini kapalı tutun.

SEO URL'leri ayrıca düzgün kalıcı bağlantılar da gerektirir. Ayarlar → Kalıcı Bağlantılar altında Düz (Plain) seçiliyse başka bir yapı seçin, kaydedin ve yeniden test edin.

Yaygın Oluşturucu Durumları

Ürünleri ne gösteriyorNe yapmalı
Oluşturucu ürün ızgarası, yazı kartları, tekrarlayıcı veya sorgu döngüsü öğesi (Avada Post Cards, Oxygen Repeater, Bricks sorgu döngüsü, özel sorgulu bir Query Loop bloğu)Çözüm 2, yönlendirme modu. Ya da öğeyi [woof_products] ile değiştirin.
Mağaza veya kategori şablonunun yerini alan tema oluşturucu düzeni (Avada layouts, YOOtheme, Flatsome, Beaver Themer, Breakdance)Düzen WooCommerce döngüsünü kullanıyorsa yönlendirme modunda çalışır. AJAX modu yalnızca düzen her iki mağaza döngüsü kancasını da çağırıyorsa çalışır; aksi halde Mağazayı AJAX'laştırmayı dene (Try to ajaxify the shop) ayarını Hayır (No) yapın.
Elementor ürün widget'ları ve döngü ızgaralarıElementor ürün ızgaralarını filtrelenebilir yapma yazısına bakın.
Bir PHP şablonunda elle yazılmış WP_QueryÇözüm 2 onu kapsar; AJAX modu için iki kancayı ekleyin.
Ürün sorgusunun veya şablonunun yerini alan başka bir eklentiTest için devre dışı bırakın. Filtre bundan sonra çalışıyorsa, o eklentinin standart WooCommerce sorgusunu kullanması gerekir.

Hâlâ Çalışmıyorsa

  • Oturum kapalıyken bir gizli pencerede test edin. Sorgu dizesini yok sayan bir sayfa önbelleği her filtre URL'si için aynı filtrelenmemiş HTML'yi sunar; swoof içeren URL'leri sayfa önbelleğinden hariç tutun.
  • Kod parçasını ekledikten sonra bir filtre URL'sini doğrudan açın. Izgara hâlâ filtrelenmemişse, öğe muhtemelen product yazı türünü sorgulamıyordur ya da ürünlerini filtre parametreleri olmadan kendi AJAX isteğiyle sonradan yüklüyordur (bazı "daha fazla yükle" düğmeleri böyle yapar).
  • İlk sayfa doğru filtreleniyor ama 2. sayfa 404 veriyor ya da filtrelenmemiş ürünler gösteriyorsa, ızgaranın sayfalama bağlantıları filtre parametrelerini düşürüyordur. 2. sayfa bağlantısının hâlâ swoof=1 ve seçimlerinizi içerdiğini kontrol edin; daha fazla neden filtre sayfalaması çalışmıyor yazısındadır.

İlk bölümdeki kısa kod testi çalışıyor ama şablonunuz hâlâ çalışmıyorsa, sayfa bağlantısı, tema veya oluşturucu ve ürünleri gösteren öğeyle HUSKY destek forumunda bir konu açın.