می توانید از API Storefront برای فیلتر کردن محصولات در یک مجموعه استفاده کنید. این قابلیت به شما امکان می دهد یک تجربه مشتری مورد نظر را در یک فروشگاه ایجاد کنید ، مانند امکان محدود کردن نتایج جستجو که به مشتریان نشان می دهید.
این راهنما به شما نشان می دهد که چگونه می توانید محصولات را در یک نوع محصول مبتنی بر مجموعه ، فروشنده ، گزینه های مختلف ، قیمت و اینکه آیا محصول موجود است ، فیلتر کنید.
الزامات
شما محصولات و مجموعه هایی را در فروشگاه خود ایجاد کرده اید.
شما تأیید کرده اید که یک موضوع سازگار با فروشگاه اینترنتی 2. 0 ، مانند Dawn ، با بررسی اینکه آیا موضوع شما از فیلتر پشتیبانی می کند ، نصب می شود. موضوع فروشگاه اینترنتی 2. 0 نیازی به موضوع منتشر شده برای فعال کردن فیلتر محصول ندارد.
شما هر فیلتر سفارشی را که می خواهید محصولات را فیلتر کنید اضافه کرده اید. فیلترهای در دسترس بودن و قیمت اولیه به طور پیش فرض انتخاب می شوند.
برنامه شما دارای دامنه دسترسی غیر معتبر_ read_product_listings است. برای اطلاعات بیشتر در مورد درخواست Scopes Access هنگام نصب برنامه ، به شروع کار با OAuth مراجعه کنید.
شما از API نسخه 2022-01 یا بالاتر استفاده می کنید.
مرحله 1: محصولات پرس و جو
می توانید از API Storefront استفاده کنید تا سؤالات زیر را انجام دهید:
محصولات پرس و جو توسط مجموعه
برای بازیابی محصولات توسط مجموعه ای که متعلق به آنها است ، می توانید دسته مجموعه را پرس و جو کنید. شما در مراحل بعدی در این آموزش برای فیلتر کردن محصولات در یک مجموعه بر اساس نوع محصول ، فروشنده ، گزینه های مختلف ، قیمت و اینکه آیا این محصول موجود است ، استفاده خواهید کرد.
محصولات پرس و جو بر اساس نوع
شما می توانید محصولات را در یک مجموعه بر اساس نوع آنها (ProductType) پرس و جو کنید. در مثال زیر ، محصولات موجود در این مجموعه که نوع محصول "کفش" دارند بازگردانده می شوند.
محصولات پرس و جو توسط فروشنده
شما می توانید از محصولات موجود در مجموعه توسط فروشنده (ProductVendor) پرس و جو کنید. در مثال زیر ، محصولات موجود در این مجموعه که از یک فروشنده به نام "prostshop" هستند بازگردانده می شوند.
محصولات پرس و جو با گزینه های مختلف
بازرگانان می توانند انواع مختلفی را به محصولی اضافه کنند که دارای بیش از یک گزینه مانند اندازه یا رنگ باشد. هر ترکیبی از مقادیر گزینه برای یک محصول می تواند نوعی از آن محصول باشد.
شما می توانید محصولات را با نام گزینه متفاوت آنها (VariantOptionName) و مقدار (VariantOptionValue) پرس و جو کنید. به عنوان مثال ، ممکن است نام یک گزینه متفاوت رنگ باشد و مقدار گزینه Variant ممکن است قرمز باشد.
محصولات پرس و جو براساس قیمت
شما می توانید محصولات را در یک مجموعه با توجه به قیمت آنها پرس و جو کنید. در مثال زیر ، 10 محصول اول که بین محدوده قیمت 25. 00 CAD و 50. 00 CAD قرار دارند.
محدودیت ها
برای فیلترهای نوع Pricerange ، عبور در چندین محدوده پشتیبانی نمی شود. اگر چندین فیلتر قیمت را مشخص کنید ، به جز محدوده اول همه چیز نادیده گرفته می شود. به عنوان مثال ، فیلترهای زیر معادل هستند:
محصولات پرس و جو موجود در انبار
برای بازیابی اطلاعات در مورد اینکه آیا محصولات و انواع مرتبط با آنها برای فروش در دسترس است ، می توانید موجود را در دسترس مشخص کنید: فیلتر واقعی و پرس و جو از قسمت موجود در شیء محصولات.
محصولات پرس و جو با ارزش Metafield
شما می توانید محصولات موجود در یک مجموعه توسط یک محصول یا متافیلد متفاوت را پرس و جو کنید. برای مشخص کردن پارامترهای MetafieldFilter از ProductMetafield یا VariantMetafield استفاده کنید.
مثال زیر اولین محصولی را که دارای مقدار Metafield محصول Tumble Dry برای یک Metafield با کلید Drying_instructions و یک فضای نام Product_care است ، برمی گرداند.
محدودیت ها
فیلترهای متافیلد محصول و انواع برای فرافیلدهایی که با استفاده از انواع متافیلد single_line_text_field، boolean، numeric_integer، numeric_decimal با استفاده از API نسخه 2022-04 یا بالاتر تعریف شده‌اند، در دسترس هستند.
مرحله 2: فیلترها را ترکیب کنید
می توانید فیلترها را در جستارهای خود ترکیب کنید تا محصولاتی را در مجموعه ای که دارای مجموعه ای از ویژگی ها هستند، بازیابی کنید.
فیلترهای مختلف با استفاده از عملگر AND ترکیب می شوند. مثلا [< productType: "shoes" >, < productVendor: "bestshop" >] محصولاتی را برمی‌گرداند که دارای محصول نوع "کفش" هستند و از محصول فروشندگان "bestshop" هستند.
چندین فیلتر یکسان با استفاده از عملگر OR ترکیب می شوند. مثلا، [< productType: "shoes" >, < productType: "socks" >] محصولاتی را برمی‌گرداند که دارای جوراب‌های productType یا کفش هستند.
مثال زیر نحوه پرس و جو برای محصولاتی را نشان می دهد که همه ویژگی های زیر را دارند:
- نوع: کفش
- فروشنده: bestshop
- رنگ آبی
مرحله 3: فیلترهای موجود را جستجو کنید
مثال زیر نحوه پرس و جو کردن فیلترهای موجود برای محصولات در یک مجموعه را نشان می دهد. می توانید از پاسخ برای ساختن یک پنل فیلتر در ویترین فروشگاه استفاده کنید.
فیلد نوع دو نوع مؤلفه رابط کاربری (UI) را مشخص می‌کند: LIST و PRICE_RANGE. LIST گزینه های چند گزینه ای را نشان می دهد و PRICE_RANGE طیفی از قیمت ها را نشان می دهد.
هر فیلتر شامل لیستی از مقادیر قابل انتخاب با تعداد متناظر است که نشان می دهد چند محصول در مجموعه با مقدار فیلتر مطابقت دارند. هر مقدار دارای یک فیلد ورودی با مقدار سریال JSON است. مقدار سریال JSON با طرح ورودی ProductFilter مطابقت دارد و می‌تواند به عنوان ورودی فیلد فیلترها در قسمت محصولات مادر استفاده شود.
