WOO API Extended Order Filters eklentisi /orders
aracılığı ile listelenen ürünler içerisinde çeşitli filrelemeler yapılabilmesini sağlar. Bu sayede farklı amaçlara yönelik olarak siparişler arasından seçimler yapılabilir. Eklenti kurulumu ile birlikte ad, soyad, e-posta, şehir, ödeme tutarı, güncelleme tarihi, mağaza adı gibi parametreler de kullanılabilir hale gelecektir.
WOO API Extended Order Filters
WOO API Extended Order Filters eklentisi, WooCommerce REST API ile birlikte çalışan, /orders
içeriğinde1 filtreleme yapılabilmesini sağlayan bir WordPress eklentisidir.
https://domain.com/wp-json/wc/v3/orders?[parametre]=[deger]
Eklentinin çalışabilmesi için WooCommerce eklentisinin kullanımı zorunludur. Opsiyonel olarak Dokar eklentisi ile birlikte mağaza filtreleme işlemlerinin de yapılabilmesi mümkün hale gelmektedir.
Aşağıda, kullanıma sunulan parametreler kullanım detayları ile birlikte listelenmiştir.
Ad & Soyad
Fatura bilgilerinde belirtilen kişi ad ve soyadına göre siparişlerin listelenmesini sağlar. Kişi bilgisine göre filtreleme işlemleri için name
parametresi tanımlanmıştır. Örnek kullanım kişi adı için ?name=John
veya ?name[first]=John
, kişi soyadına göre ise ?name[last]=Doe
şeklindedir.
E-Posta
Fatura bilgilerinin iletildiği e-posta adresine göre siparişlerin listelenmesini sağlar. Bu filtrelem işlemi için email
parametresi tanımlanmıştır. Örnek kullanımı ?email=john
, ?email=john@doe.com
şeklinde olabileceği gibi, belirli bir alan adı özelinde de siparişlerin listelenmesi sağlanabilir; ?email=gmail.com
.
Telefon
Fatura bilgilerinde yer alan telefon numarasına göre siparişlerin filtrelenmesini sağlar. Bu filtreleme işlemi için phone
parametresi kullanılmaktadır. Örnek kullanımı ?phone=5554443322
şeklindedir. Parametre aracılığı ile sadece alan kodu belirtilerek de işlemler gerçekleştirilebilmektedir; ?phone=532
veya ?phone=+90
gibi.
Şehir
Kargo bilgilerinde belirtilen şehir bilgisine göre siparişlerin filtrelenmesini sağlar. Filtreleme işlemi için city
parametresi kullanılmaktadır. Örnek kullanımı ?city=istanbul
şeklindedir.
Sipariş Güncelleme Tarihi
Sipariş ile ilgili güncellemelere göre (ödeme ve kargo durumu güncellemeleri, vb.) filtreleme işleminin gerçekleştirilmesini sağlar. Siparişlerin belirli bir tarih öncesine göre listelemek için modified_after
, tarih sonrasına göre listelemek için ise modified_before
parameresi tanımlanmıştır. Örnek kullanımı modified_after=2021-04-05
ve modified_before=2021-04-05
şeklindedir. Tarih ifadesi Yıl-Ay-Gün (%Y-%m-%d) şeklinde olabileceği gibi, sadece Yıl-Ay (%Y-%m) veya Yıl (%Y) şeklinde de belirtilebilir.
Ödeme Tutarı
Eklenti içerisinde tanımlanan total
parametresi siparişleri belirli bir ödeme tutarına göre filtrelenmesini sağlar. total
doğrudan tutar belirtilmesini sağlarken, total[greater]
belirtilen tutarın üzerindeki, total[less]
ise belirtilen tutarın altındaki siparişleri listeleyecektir. Örnek kullanımı ?total=100
, ?total[greater]=100
ve ?total[less]=100
şeklindedir.
Ödeme Yöntemi
Siparişlerin ödeme yöntemlerine göre (bacs (havale), stripe, paypal, cheque, cod (kapıda ödeme), iyzico, vb.) filtrelenmesini sağlar. Bu filtreleme işlemi için pmethod
parametresi tanımlanmıştır. Örnek kullanımı ?pmethod=bacs
şeklindedir.
Ürün ID
Siparişlerin içeriğinde yer alan ürün ID değerine göre filtrelenmesini sağlar. Bu işlem için pid
parametresi kullanılmaktadır. Örnek kullanımı ?pid=100
şeklindedir.
Mağaza
Dokan 2 çoklu-mağaza eklenti kullanıcılarının siparişleri mağazalara göre filtreleyebilmesini sağlar. Filtreleme işlemi storeid
parametresi kullanılarak mağaza ID veya storename
parameresi ile mağaza adına göre gerçekleştirilebilir. Örnek kullanımı?storeid=1
ve storename=mystore
şeklindedir.