HUSKY - WooCommerce Product Filter Professional

WooCommerce Ürün Filtresi Mobilde Görünmüyor: Nedenler ve Çözümler

Filtre bilgisayarda çalışıyor, ancak telefonda kenar çubuğu yok, Filtreyi aç (Open filter) düğmesi hiç görünmüyor ya da görünüyor ama hiçbir şey yapmıyor. WooCommerce ürün filtresi mobilde görünmüyorsa, bu nadiren bir bozukluktur. HUSKY'nin mobil modu üç parçadan oluşur: sunucu ziyaretçinin telefon kullandığına karar verir, bir betik düğmeyi yerine taşır ve dokunuş formu tam ekran bir panel olarak açar. Bu parçaların her biri tema, sayfa oluşturucu, önbellek veya optimizasyon aracı tarafından durdurulabilir. Bu rehber hangi parçanın başarısız olduğunu ve nasıl düzeltileceğini gösterir.

HUSKY mobil modu nasıl çalışır

Birçok tema kenar çubuğunu telefonlarda hiç göstermez. Filtre bir kenar çubuğu widget'ıysa ve başka hiçbir şey ayarlanmamışsa, bu tek başına filtrenin neden görünmediğini açıklar. Mobil mod, eklentinin telefonlara filtreyi açan bir düğme sunma yöntemidir. Ayarlarda genel bir "mobil" anahtarı yoktur; mobil mod her filtre formu için ayrı etkinleştirilir:

  • Widget: HUSKY widget'ında Mobil mod (Mobile mode) ayarını Evet yapın.
  • Kısa kod: [woof sid="mobile" mobile_mode=1]. sid özniteliği zorunludur; o olmadan mobile_mode yok sayılır.
  • Ön yüz oluşturucu: [woof_front_builder] formunun seçeneklerinde Mobil mod (Mobile mode) ayarını açın.

Sayfa bir telefon için oluşturulduğunda, eklenti bu formu gizli olarak yazdırır ve ona iki düğme ekler: Filtreyi aç (Open filter) ve Filtreyi kapat (Close filter). Masaüstü bilgisayarlarda aynı form her zamanki gibi görüntülenir. Sayfa bir telefonda yüklendiğinde, bir betik Filtreyi aç (Open filter) düğmesini gizli formdan görünür bir yere taşır:

  1. sayfada varsa, [woof_mobile] kısa kodunun yazdırdığı kapsayıcı;
  2. yoksa .woocommerce-products-header ile eşleşen öğe, yani WooCommerce'in standart arşiv şablonunda mağaza veya kategori başlığını içeren blok.

Düğmeye dokunmak forma woof_show_filter_for_mobile sınıfını ekler ve form, sayfanın üzerinde sabit bir tam ekran panele dönüşür. AJAX modunda panel her filtrelemeden sonra kendiliğinden kapanır, böylece ziyaretçi yeni ürünleri görür.

İki olgu sorunların çoğunu açıklar. Birincisi, "telefon" kararı ekran genişliğine göre değil, istek başlıklarından yola çıkan WordPress'in wp_is_mobile() işleviyle sunucuda verilir. İkincisi, [woof_mobile] yalnızca bir yeri işaretler: aynı sayfada mobil modu açık bir form da yoksa hiçbir şey göstermez.

Filtreyi aç düğmesi görünmüyor

Şablonda düğme için yer yok. Elementor ve Divi tema oluşturucu şablonlarında, Avada düzenlerinde, ürünleri [products] kısa koduyla listeleyen özel sayfalarda ve birçok özel temada çoğu zaman .woocommerce-products-header bloğu bulunmaz. Bu durumda düğme gizli formun içinde kalır. [woof_mobile] kodunu düğmenin duracağı yere, genellikle ürünlerin üstüne, bir Kısa Kod widget'ına veya bloğuna yerleştirin. En sık başvurulan çözüm budur. Masaüstünde hiçbir şey yazdırmaz, bu yüzden sayfada kalabilir.

O şablona kısa kod yerleştiremiyorsanız, woof_mobile_btn_place_container kancasıyla düğmeyi kendi öğenize yönlendirin. Bu öğeye benzersiz bir kimlik verin (Elementor'da: Gelişmiş → CSS Kimliği (Advanced → CSS ID)) ve onu kullanın:

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

Yalnızca tek bir öğeyle eşleşen bir seçici kullanın. .elementor-widget-container gibi geniş bir sınıf, düğmeyi sayfadaki eşleşen her öğeye kopyalar. Sayfada bir [woof_mobile] kapsayıcısı varsa kanca kullanılmaz.

Düğmenin görünmemesinin diğer nedenleri:

  • Yer, tema tarafından telefonlarda gizleniyor (yalnızca masaüstünde görünen bir üst bilgi veya araç çubuğu). Mobilde görünen bir yer seçin.
  • Düğme önce görünüp filtrelemeden sonra kayboluyor: [woof_mobile] kapsayıcısı, AJAX'ın değiştirdiği ürün listesinin içinde duruyor. Onu listenin üstüne taşıyın.
  • JavaScript optimizasyonu betikleri ilk dokunuşa veya kaydırmaya kadar erteliyor (WP Rocket ve benzerlerindeki "JavaScript yürütmesini ertele" özelliği). Düğme yalnızca eklentinin betiği çalıştığında taşınır. /wp-content/plugins/woocommerce-products-filter/ yolunu erteleme, geciktirme ve birleştirme dışında bırakın, ardından önbellekleri temizleyin. Ayrıntılar WP Rocket ve önbellekleme ile filtre yazısındadır.
  • CSS optimizasyonu (birleştirme veya "kullanılmayan CSS'i kaldırma") eklentinin stillerini sildi; bu yüzden düğme sayfada var ama gizli ya da biçimsiz. Eklentinin CSS dosyasını da hariç tutun.
  • Tablette test yapıyorsunuz. iPad'deki Safari ve daha büyük Android tabletlerdeki Chrome varsayılan olarak sitelerin masaüstü sürümünü ister, dolayısıyla bu tabletler masaüstü düzenini alır. Tema kenar çubuğunu tablet genişliğinde gizliyorsa filtre orada kaybolur; kenar çubuğunu CSS ile gösterin veya formu içerik alanına yerleştirin.

Düğme var ama hiçbir şey açılmıyor

Form gizli bir şeyin içinde duruyor. Düğme dışarı taşındı, ancak panel hâlâ özgün yerindeki formun kendisidir. Tema kenar çubuğunu telefonlarda display: none ile gizliyorsa, panel gizli bir kutunun içinde açılır ve görünmez kalır. Üç çözüm yolu vardır:

  • Kenar çubuğunu telefonlarda CSS ile gösterin. İçindeki HUSKY formu düğmeye dokunulana kadar gizli kalır, ancak o kenar çubuğundaki diğer widget'lar da görünür olur; bu yüzden yalnızca filtreyi barındıran bir kenar çubuğuna uygundur.
  • Mobil moddaki formu kenar çubuğundan içerik alanına, örneğin ürünlerin üstüne taşıyın.
  • Widget'ı masaüstü için bırakın (Mobil mod (Mobile mode) Hayır) ve eklentinin yalnızca telefonlarda ürünlerin üstüne bir filtre yerleştirmesine izin verin: Seçenekler → Filtreyi otomatik yerleştir → Evet, ama yalnızca mobil cihazlar için (Options → Set filter automatically → Yes, but only for mobile devices), ayrıca göster/gizle düğmesi için Tasarım → Otomatik filtreyi varsayılan olarak gizle → Evet (Design → Hide auto filter by default → Yes). Bu, standart WooCommerce ürün döngüsünü çalıştıran bir şablon gerektirir.

Birinci yol için tipik bir kural şöyledir; seçiciyi temanıza göre uyarlayın:

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

Filtre bir temanın ekran dışı çekmecesinin veya bir Elementor açılır penceresinin içindeyse de aynısı olur: çekmecenin ya da açılır pencerenin kendi görünürlük kuralları ve betikleri vardır, panel de onun içinden açılamaz. Çekmeceyi ya da HUSKY'nin mobil modunu kullanın, ikisini birden değil.

sid içinde boşluk var. sid="flat_grey woof_auto_3_columns" gibi kaplama (skin) sözdizimi formun görünümü için çalışır, ancak 3.4.6 sürümünde mobil düğme, sid değeri iki sözcükten oluşan bir formu bulamaz. Mobil moddaki bir form için tek sözcüklü bir sid kullanın.

Filtrenin iki kopyası var. Sayfa oluşturucular çoğu zaman masaüstü için bir bölüm ve mobil için duyarlı görünürlükle gizlenmiş bir kopya içerir. İkisi de HTML'de bulunur, yalnızca CSS ile gizlenir; aynı tanımlayıcılara sahip iki form birbiriyle çakışır: bölümler açılmaz, iki filtre simgesi belirir ya da düğme göremediğiniz kopyayı açar. Sayfa başına tek bir filtre bırakın ve telefonları mobil moda bırakın.

Bir betik hatası. Sayfayı telefonda ya da yeniden yükledikten sonra masaüstü cihaz emülasyonunda açın ve tarayıcı konsoluna bakın. HUSKY'den önce yüklenen herhangi bir betikteki hata onu da durdurur.

Masaüstünde mobil düzen, telefonda masaüstü düzeni

Karar sayfa oluşturulurken verildiğinden, herkes için tek bir kopya saklayan bir sayfa önbelleği, ilk gelen cihaza ne sunulmuşsa onu sunar. O zaman masaüstü ziyaretçileri Filtreyi aç (Open filter) düğmesini ve gizli bir form alır, ya da telefon ziyaretçileri tam kenar çubuğunu alır ama düğme olmaz; üstelik bu, her önbellek temizlemeden sonra değişir. Çözüm filtrede değil, önbelleğin kendisindedir:

  • WP Rocket: mobil önbelleklemeyi ve Mobil cihazlar için ayrı önbellek dosyaları (Separate cache files for mobile devices) seçeneğini etkinleştirin.
  • LiteSpeed Cache: Mobili önbelleğe al (Cache Mobile) seçeneğini açın.
  • Cloudflare sayfa önbelleklemesi, Varnish veya bir barındırma önbelleği: cihaz türüne göre önbellekleyin ya da mağaza ve kategori sayfalarını hariç tutun.

Değişiklikten sonra tüm önbellekleri temizleyin. Aynısı, kayan panel (slideout) eklentisinin mobil görünürlüğü için ve Filtreyi otomatik yerleştir (Set filter automatically) ayarının Evet, ama yalnızca mobil cihazlar için (Yes, but only for mobile devices) ve Evet, ama yalnızca masaüstü için (Yes, but only for desktop) değerleri için de geçerlidir; bunlar da wp_is_mobile() kullanır.

Aynı nedenle, bir masaüstü tarayıcı penceresini yeniden boyutlandırmak filtreyi asla mobil moda geçirmez. Gerçek bir telefonda, oturumu kapatılmış hâlde ya da tarayıcının cihaz emülasyonunda sayfayı yeniden yükleyerek test edin.

Açılan panelin içindeki sorunlar

Açılır listeler daralmış, boş ya da klavyeyi açıyor. Chosen ve SelectWoo açılır listeleri genişliklerini form hâlâ gizliyken, sayfa yüklenirken hesaplar ve telefon klavyesini getiren bir arama alanıyla birlikte gelir. En temiz çözüm Tasarım → Açılır liste teması → Yerel (Design → Drop-down skin → Native) seçeneğidir: telefonlar kendi seçim listesini gösterir, arama alanı ve genişlik sorunu olmaz. Chosen veya SelectWoo'yu korumak için onlara bir minimum genişlik verin:

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

Panel yarı saydam, yapışkan üst bilginin altında kalıyor ya da metni görünmüyor. Panel varsayılan olarak biraz saydamdır ve z-index: 9999 kullanır; bazı yapışkan üst bilgiler bunu aşar. Özel CSS'inizde ayarlayın:

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

Panel yine de üst bilginin altında açılıyorsa (üst bilgi, panelin yükselemeyeceği bir yığınlama bağlamında duruyordur), ilk kurala padding-top: 90px; ekleyin; böylece Filtreyi kapat (Close filter) düğmesi üst bilginin altından başlar.

Panel her dokunuştan sonra kapanıyor. Otomatik gönderim ve AJAX ile her seçim filtreyi çalıştırır ve panel sonuçları göstermek için kapanır. Ziyaretçiler genellikle birkaç seçeneği birleştiriyorsa, bu form için otomatik gönderimi kapatın, [woof sid="mobile" mobile_mode=1 autosubmit=0]; böylece seçimi yapıp sonra filtre düğmesine dokunurlar.

iPhone'daki küçük aksaklıklar. Metin arama alanında kayık duran yer tutucu .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; } ile düzeltilir. Etiket türü filtrelerdeki ürün sayaçlarının etiketlerinden uzaklaşması .woof_container_label .woof_list_label li { position: relative; } ile düzeltilir.

Düğmeyi değiştirme

Düğmenin görünümü Tasarım (Design) sekmesinde ayarlanır: Mobil filtre düğmesi için görsel (Image for mobile filter button), Mobil filtre düğmesi için metin (Text for mobile filter button), Mobil filtreyi kapatmak için görsel (Image to close mobile filter) ve Mobil filtreyi kapatmak için metin (Text to close mobile filter). Yalnızca metin göstermek için bir görsel alanına, yalnızca simge göstermek için bir metin alanına -1 girin. Boşluk ve renk, .woof_show_mobile_filter üzerinde düz CSS ile ayarlanır, örneğin .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.

Temel kurulum adımları için filtrenin mobil cihazlarda nasıl gösterileceği yazısına; ana kısa kodun tüm öznitelikleri için [woof] başvurusuna bakın.

Kontrol listesi

  • Sayfada mobil modu açık tek bir filtre formu var (widget seçeneği, ya da tek sözcüklü sid ile mobile_mode=1, ya da ön yüz oluşturucu seçeneği).
  • [woof_mobile], düğmenin duracağı yere, ürün listesinin dışına, telefonlarda görünen bir yere yerleştirilmiş.
  • Formun kendisi, telefonlarda gizlenen bir kenar çubuğunun, çekmecenin ya da açılır pencerenin içinde değil.
  • Eklentinin JavaScript ve CSS dosyaları erteleme, geciktirme, birleştirme ve kullanılmayan CSS'i kaldırma işlemlerinin dışında tutulmuş.
  • Sayfa önbelleği mobil cihazlar için ayrı kopyalar saklıyor ve tüm önbellekler temizlenmiş.
  • Gerçek bir telefonda ya da cihaz emülasyonunda, yeniden yükleyerek ve oturum kapalıyken test edilmiş.

Filtre telefonda hâlâ görünmüyorsa, HUSKY destek forumunda sayfa bağlantısı, kullandığınız kısa kod veya widget ayarları ve tarayıcı konsolundaki hatalarla birlikte bir konu açın.