WooCommerce Ürünlerini ACF Alanına Göre Filtreleme: Türler, Kurulum, Çözümler
WooCommerce ürünlerini ACF alan değerlerine göre HUSKY ile filtreleyebilirsiniz, ancak yalnızca alan değerini bir veritabanı sorgusunun karşılaştırabileceği biçimde saklıyorsa. Tek değerli alanlar (Select, Radio Button, True / False, Number, Text, Date Picker) sorunsuz filtrelenir. Onay kutusu (Checkbox) alanları ve Çoklu Seçim (Select Multiple) açık olan Select alanları ya filtrede hiç görünmez ya da her zaman 0 ürün bulan seçenekler gösterir. Aşağıda HUSKY'nin ACF verilerini nasıl okuduğunu, hangi alan türlerinin çalıştığını, her birinin nasıl kurulacağını ve çok değerli alanlarla ne yapılacağını bulacaksınız.
HUSKY'nin ACF alanlarını okuma yolları
ACF her alanı sıradan ürün meta verisi olarak kaydeder: wp_postmeta tablosunda, alanın Alan Adı (Field Name) değeri altında, kaydedilen değeri tutan bir satır. HUSKY'nin bu tür satırlara göre filtreleyen iki yerleşik uzantısı vardır. İkisi de sistem uzantısıdır ve her zaman etkindir, dolayısıyla açılacak bir şey yoktur.
- ACF uzantısı (ACF alanları (ACF fields)) ACF alan gruplarınızı otomatik olarak bulur ve bunların Select, Radio Button ve True / False alanlarını Yapı (Structure) sekmesinde Alan etiketi (Grup başlığı) (Field label (Group title)) olarak listeler. Alanın yanındaki açılır listeyi Evet (Yes) yapın, kaydedin; alan filtrededir. Diğer alan türleri hiç listelenmez. Ayrıntılar ACF uzantısı sayfasındadır.
- Meta Veri sekmesi (Meta filtresi (Meta filter) uzantısı) ACF olsun olmasın her meta anahtarıyla çalışır. Anahtarı kendiniz eklersiniz ve nasıl gösterileceğini seçersiniz: Kaydırıcı (Slider), Metne göre ara (Search by text), Onay kutusu (Checkbox), Açılır liste (Drop-down), Çoklu açılır liste (Multi Drop-down) veya Tarih seçici (Datepicker); ayrıca hangi tür veri tuttuğunu: sayı (number), metin (string) veya tarih (date). Bkz. meta alanlarına göre filtreleme.
ACF uzantısının kurulumu daha hızlıdır, ancak "alan görünmüyor" ve "0 ürün" bildirimlerinin çoğunu açıklayan üç kuralı vardır:
- Alan grubu yazı türüne göre atanmış olmalıdır. HUSKY yalnızca Konum (Location) kuralları Yazı Türü Ürün'e eşittir (Post Type is equal to Product) içeren grupları alır. Yalnızca ürün kategorisi gibi bir kuralla gösterilen grup atlanır, bu yüzden alanları Yapı (Structure) sekmesine hiç ulaşmaz.
- Her seçeneğin değeri etiketiyle eşleşmelidir. ACF'de
xl : Extra largebiçiminde yazılan bir seçenek üründexlkaydeder, ancak ACF uzantısı etiketi, yaniExtra largedeğerini arar ve hiçbir şey bulamaz. Satır başına tek sözcük olarak yazılan seçenekler (değer ve etiket aynıdır) veya yalnızcared : Redgibi harf büyüklüğüyle ayrılanlar çalışır. Tırnak karakteri içeren etiketler hiçbir zaman eşleşmez. - Çoklu Seçim kapalı olmalıdır. Çoklu Seçim (Select Multiple) etkin olan bir Select alanı yine listelenir, ancak aşağıda açıklanan nedenle hiçbir ürün bulmaz.
Bir alan bu kurallardan birini bozuyorsa, anahtarı ve tam değerleri sizin denetlediğiniz Meta Veri sekmesi üzerinden filtreleyin.
Hangi ACF alan türleri filtrelenebilir
| ACF alan türü | Üründe ne kaydedilir | HUSKY'de nasıl filtrelenir |
|---|---|---|
| Select (tek), Radio Button | Tek bir seçenek değeri | ACF uzantısı veya Meta Veri Açılır liste (Drop-down) / Çoklu açılır liste (Multi Drop-down) |
| Button Group | Tek bir seçenek değeri | Meta Veri Açılır liste (Drop-down) / Çoklu açılır liste (Multi Drop-down) |
| True / False | 1 veya 0 | ACF uzantısı veya Meta Veri Onay kutusu (Checkbox) |
| Number, Range | Bir sayı | Meta Veri Kaydırıcı (Slider), tür sayı (number) |
| Text, Email, URL | Bir metin dizesi | Meta Veri Metne göre ara (Search by text) veya değerleri listelenmiş Açılır liste (Drop-down) |
| Date Picker | 20250131 biçiminde bir tarih (Ymd) | Meta Veri Tarih seçici (Datepicker) artı bir kanca (aşağıya bakın) |
| Checkbox, Çoklu Seçim (Select Multiple) açık Select, çok değerli Relationship / Post Object / Taxonomy | Serileştirilmiş bir dizi | Normal karşılaştırmayla değil; aşağıdaki iki çıkış yoluna bakın |
| Repeater, Flexible Content | specs_0_width gibi numaralı satırlar | Tek bir alan olarak filtrelenemez |
Bir Group alanının içindeki alanlar groupname_fieldname altında kaydedilir ve kendi türleri gibi filtrelenir. Date Time Picker, Tarih seçici filtresinin karşılaştıramayacağı 2025-01-31 14:00:00 gibi metin kaydeder.
Onay kutusu ve çoklu seçim alanları neden hiçbir şey bulmaz
Bir alan birden fazla değer tutabildiğinde, ACF bunları PHP'nin serileştirilmiş biçiminde tek bir dizeye paketler. Klimalı ve ısıtmalı koltuklu bir araç şuna benzer tek bir meta satırı alır:
a:2:{i:0;s:2:"ac";i:1;s:12:"heated_seats";}
ACF uzantısı ile Açılır liste, Çoklu açılır liste ve Onay kutusu görünümleri, veritabanından değerin seçilen seçeneğe eşit olduğu satırları ister. ac o dizenin tamamına eşit değildir, bu yüzden sonuç 0'dır. ACF'de Çoklu Seçim (Select Multiple) ayarını kapatmak mevcut ürünleri düzeltmez: değerleri, her ürün tek bir değerle yeniden kaydedilene kadar serileştirilmiş kalır.
Meta Veri sekmesinde bir ACF alanı kurun
- Gerçek meta anahtarını bulun. Bu, etiketi değil, ACF'deki alanın Alan Adı (Field Name) değeridir (örneğin
body_type). Meta Veri (Meta Data) sekmesinde Anahtarları kimliğine göre herhangi bir üründen al (Get keys from any product by its ID) bir ürünün her anahtarını listeler. Her ACF alanı iki kez görünür:body_typedeğeri tutar,_body_typeACF'nin dahili alan referansını tutar. Alt çizgisiz anahtarı kullanın. Anahtarlar büyük/küçük harfe duyarlıdır ve hiçbir zaman boşluk ya da köşeli ayraç içermez. - Anahtarı ekleyin: Özel anahtarı elle ekle (Add Custom key by hands) ile ya da listeden, bir başlık girin ve görünümü ile türü seçin. Metin değerleri için metin (string) seçin. sayı (number) ile MySQL,
Coupegibi metni karşılaştırmadan önce 0'a çevirir ve filtre anahtara sahip her ürünü döndürür; bu da "filtre hiçbir şey yapmıyor" gibi görünür. - Seçenekleri listeleyin: Açılır liste (Drop-down) ve Çoklu açılır liste (Multi Drop-down) için. Bir meta alanı serbest metindir, bu yüzden HUSKY değer listesini kendisi oluşturamaz; siz yazarsınız, virgülle ayırarak. Görünen başlık kaydedilen değerden farklıysa
title^valuekullanın.coupe : Coupevesuv : SUV / CrossoverACF seçenekleri için bu şöyledir:Coupe^coupe,SUV / Crossover^suv^işaretinden sonraki kısım, etiketi değil, ACF'nin kaydettiği seçenek değeri olmalıdır. - Kaydedin, Yapı (Structure) sekmesini açın, yeni öğeyi Evet yapın, yerine sürükleyin ve yeniden kaydedin. Yanındaki çark simgesi görünümün kendi seçeneklerini içerir; örneğin bir Onay kutusu için Arama seçeneği (Search option) ve Arama değeri (Search value), ya da Metne göre ara (Search by text) için Metin arama koşulu (Text search conditional) (LIKE veya EXACT).
Onay kutusu (Checkbox) tek bir anahtar için tek bir onay kutusudur. Değeri 1 olan ürünleri (True / False alanları), yes gibi başka bir Arama değeri (Search value) olan ürünleri veya Arama seçeneği (Search option) Değer var (Value exists) olarak ayarlandığında alanı dolu olan her ürünü bulur.
Kaydedilen bir değerin kendisi virgül içeriyorsa, tüm Açılır liste ve Çoklu açılır liste listeleri için ayırıcıyı değiştirin, ardından listeleri | ile yeniden yazın:
/*
* HUSKY: separate meta filter options with | instead of a comma.
* Child theme functions.php or a code snippets plugin.
* Example list afterwards: Wood, oak|Wood, pine|Metal
*/
add_filter( 'woof_meta_options_separator', function ( $separator ) {
return '|';
} );
Number ve Range alanları bir Kaydırıcı (Slider) içine aittir; aralıklar, adımlar ve ondalıklar nitelikler ve meta alanları için aralık kaydırıcı filtrelerinde ele alınır.
Bir ACF tarih alanına göre filtreleyin
Tarih seçici filtresi varsayılan olarak Unix zaman damgalarını karşılaştırır, oysa ACF'nin Date Picker alanı tarihleri 20250131 olarak kaydeder. woof_meta_use_acf_dateformat kancası, filtrenin aramadan önce seçilen tarihleri aynı biçime dönüştürmesini sağlar:
/*
* HUSKY: Datepicker meta filters search ACF Date Picker values (Ymd).
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'woof_meta_use_acf_dateformat', '__return_true' );
ACF anahtarını Meta Veri sekmesinde Tarih seçici (Datepicker) görünümüyle ekleyin ve türü sayı (number) olarak bırakın: dönüştürülen tarihler sayı olarak karşılaştırılır ve tarih (date) türü burada kullanılabilir tarihler üretmez. Kanca sitedeki her Tarih seçici filtresine uygulanır, bu yüzden hepsi ACF Date Picker alanlarına işaret etmelidir. Bir geçerlilik süresi (başlangıç / bitiş) için başlangıç ve bitiş alanlarını iki ayrı filtre olarak ekleyin.
Onay kutusu ve çoklu seçim alanları: iki çıkış yolu
Önerilen: değerleri bir taksonomiye taşıyın
Ürün başına birden fazla değer içeren veri, taksonomilerin tam da yapıldığı iştir. Taksonomiyle her değer için bir onay kutusu, sayımlar, seçilen değerler arasında VE veya VEYA mantığı ve bir meta alanının sunamadığı Turbo modu desteği elde edersiniz. Düzenleme için ACF'den vazgeçmeniz gerekmez:
- Donanım (Equipment) gibi bir ürün taksonomisi oluşturun; özel taksonomi olarak ya da Ürünler → Nitelikler (Products → Attributes) altında genel bir nitelik olarak.
- ACF'de Checkbox alanını, ona işaret eden ve Terimleri Kaydet (Save Terms) ile Terimleri Yükle (Load Terms) açık olan bir Taksonomi (Taxonomy) alanıyla değiştirin. ACF o zaman bir dizi saklamak yerine seçilen terimleri ürüne atar.
- Ürünler yeniden kaydedildiğinde terimlerini alır; büyük bir katalog için bunu toplu yapın. Taksonomi, ardından HUSKY'nin Yapı (Structure) sekmesinde diğerleri gibi görünür.
Alanı koruyun: saklanan dizinin içinde arayın
Alan olduğu gibi kalmak zorundaysa, karşılaştırma değiştirilebilir. Aşağıdaki kod parçası, listelenen anahtarlar için HUSKY'nin "eşittir" koşulunu tırnak içindeki değer için bir LIKE aramasına çevirir; böylece ac, LIKE '%"ac"%' olur ve serileştirilmiş dizenin içindeki öğeyle eşleşir, ancak ac_rear ile eşleşmez. Seçenek sayımlarını da düzeltir.
/*
* HUSKY: Drop-down / Multi Drop-down meta filters for ACF Checkbox
* and Select Multiple fields (values stored as serialized arrays).
* Child theme functions.php or a code snippets plugin.
*/
function my_husky_serialized_keys() {
return array( 'equipment' ); // ACF field names
}
function my_husky_match_serialized( $meta_query ) {
if ( ! is_array( $meta_query ) ) {
return $meta_query;
}
foreach ( $meta_query as $i => $clause ) {
if ( ! is_array( $clause ) ) {
continue;
}
if ( isset( $clause['key'], $clause['value'], $clause['compare'] )
&& '=' === $clause['compare']
&& is_scalar( $clause['value'] )
&& in_array( $clause['key'], my_husky_serialized_keys(), true ) ) {
$meta_query[ $i ]['compare'] = 'LIKE';
$meta_query[ $i ]['value'] = '"' . $clause['value'] . '"';
$meta_query[ $i ]['type'] = 'CHAR';
} else {
$meta_query[ $i ] = my_husky_match_serialized( $clause );
}
}
return $meta_query;
}
// Products found by the filter
add_filter( 'woof_get_meta_query', 'my_husky_match_serialized', 100 );
// Counts next to the options (Show count + Dynamic recount)
add_filter( 'woof_dynamic_count_attr', function ( $args ) {
if ( isset( $args['meta_query'] ) ) {
$args['meta_query'] = my_husky_match_serialized( $args['meta_query'] );
}
return $args;
}, 100 );
Ardından equipment anahtarını Meta Veri sekmesine Açılır liste (Drop-down) veya Çoklu açılır liste (Multi Drop-down) olarak, metin (string) türüyle ve ^ sonrasında ACF seçenek değerleriyle ekleyin; örneğin Air conditioning^ac,Heated seats^heated_seats. Sınırları bilin: Çoklu açılır liste, seçilen değerlerin herhangi birine sahip ürünleri bulur, hepsine değil; bir LIKE '%…%' araması veritabanı dizinini kullanamaz ve büyük kataloglarda yavaşlar; ayrıca kod parçası Turbo modunda uygulanmaz. Kanca hakkında daha fazlası woof_get_meta_query sayfasındadır.
Varyasyonlar, Turbo modu ve özel ürün ızgaraları
- Varyasyonlardaki değerler aranmaz. Mağaza sorgusu üst ürünleri döndürür ve üst ürünün kendi meta verisini kontrol eder. Nitelikler varyasyonlar için çalışır, çünkü üst ürün tüm varyasyonlarının terimlerini taşır; meta değerleri taşımaz. Değeri üst ürüne koyun.
- Turbo modu tarayıcıda, yalnızca Meta Veri sekmesinde eklenen anahtarları içeren kendi veri dosyasından filtreler. ACF uzantısıyla gösterilen alanlar ve yukarıdaki kod parçaları gibi PHP kancaları orada kullanılmaz. Bkz. Turbo modu sorun giderme.
- URL değişiyor ama her ürün yine de gösteriliyor. O zaman sorun alan değildir: sayfa oluşturucu ızgarası veya özel şablon kendi sorgusunu çalıştırır ve her filtreyi yok sayar. Çözüm filtre URL'si değişiyor ama ürünler filtrelenmiyor sayfasındadır.
ACF filtresi hâlâ ürün bulmuyorsa
- Gerçekte neyin kaydedildiğini kontrol edin. phpMyAdmin veya benzeri bir araçta bir ürün kimliğiyle (ve tablo önekinizle)
SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = 123çalıştırın.a:ile başlayan bir değer serileştirilmiş bir dizidir; beklediğinizden farklı bir anahtar, ACF'nin başka bir ad altında kaydettiği anlamına gelir. - Meta Veri sekmesi: baştaki alt çizgi olmadan, aynı harf büyüklüğüyle anahtar; metin için metin (string) türü;
^sonrasında kaydedilen seçenek değeri. - ACF uzantısı için: grubun konumu Yazı Türü Ürün'e eşittir (Post Type is equal to Product), seçenek değerleri etiketleriyle eşleşiyor, Çoklu Seçim (Select Multiple) kapalı ve ürünler değiştirildikten sonra yeniden kaydedildi.
- Değer varyasyonlarda değil, üst üründedir.
- Aynı sayfada bir taksonomi filtresi çalışıyor. Çalışmıyorsa, önce ürün ızgarasını düzeltin.
Her madde doğru çıkıyor ve filtre hâlâ hiçbir şey bulmuyorsa, alanın türünü ve ayarlarını, meta anahtarını ve kaydedilen değerden bir örneği ekleyerek HUSKY destek forumunda bir konu açın, biz de bakalım.