getProductsCountByPageId

الحصول على عدد منتجات صفحة كتالوج بواسطة معرّف الصفحة.

الوصف

يحسب عدد المنتجات في صفحة الكتالوج ذات id المحدد، مع إمكانية التصفية حسب الشروط في body، ويُعيد IProductsCount.

.getProductsCountByPageId( , );

مخطط المعلمات

المخطط

id(required): number | string
معرّف الصفحة.
مثال: 12345

body: any[]
كائنات التصفية مع شروط البحث. الافتراضي: [].
مثال:

[
  {
    "attributeMarker": "price",
    "conditionMarker": "in",
    "statusMarker": "status_1",
    "conditionValue": {},
    "pageUrls": [
      "23-laminat-floorwood-maxima"
    ],
    "title": "Iphone 17 Pro"
  }
]

أمثلة

مثال بسيط

  const response = await Products.getProductsCountByPageId(10);

مثال مع الفلاتر

const response = await Products.getProductsCountByPageId(10, [
  { attributeMarker: 'price', conditionMarker: 'mth', conditionValue: 100 },
]);

استخدم المرشّحات للعثور على عدد منتجات محددة:

attributeMarker: المعرف النصي للخاصية المفهرسة التي يتم تصفية القيم بناءً عليها. conditionMarker: نوع الشرط الذي سيتم تطبيقه على قيمة الخاصية.

العلامة	المعنى	المثال
eq	يساوي	color = "red"
neq	لا يساوي	category ≠ "أرشيف"
in	يحتوي (مطابقة سلسلة فرعية غير حساسة لحالة الأحرف)	brand يحتوي على "app"
nin	لا يحتوي (مطابقة سلسلة فرعية غير حساسة لحالة الأحرف)	brand لا يحتوي على "fake"
mth	أكبر من	price > 100
lth	أقل من	price < 50
exs	موجود (له قيمة)	لديه وصف
nexs	غير موجود	لا توجد صورة
pat	يطابق نمط تعبير نمطي حيث يمثّل كل * حرفًا واحدًا بالضبط و_ مسافة. عند تفعيل فهرسة البحث، يجب أن يطابق النمط القيمة كاملة	currency يطابق "s" (يعثر على "usd")
same	له القيمة نفسها لمنتج آخر واحد على الأقل. يُتجاهل conditionValue	المنتجات التي تشترك في السعر
same_part	له القيمة نفسها لمنتج آخر بعد قطع المقاطع الأخيرة. conditionValue بالصيغة delimiter|count (الافتراضي -|2)؛ وتُقارَن القيمة التي لها count مقاطع أو أقل كاملةً	رمزا SKU "ABC-1-S" و"ABC-1-M" يشتركان في "ABC"

conditionValue: القيمة التي سيتم المقارنة بها.

مثال على الاستجابة

{
  "totalAll": 6,
  "totalInCategory": 6,
  "totalInCategoryWithNested": 6
}

مخطط الاستجابة

المخطط: IProductsCount

totalAll: number
عدد المنتجات المرئية المطابقة في الكتالوج بأكمله، على أي صفحة.
مثال: 100

totalInCategory: number
عدد المنتجات المطابقة على صفحة الكتالوج نفسها. دائمًا 0 لـ getProductsCount، التي لا صفحة لها.
مثال: 50

totalInCategoryWithNested: number
عدد المنتجات المطابقة على صفحة الكتالوج وفئاتها المتداخلة. دائمًا 0 لـ getProductsCount، التي لا صفحة لها.
مثال: 10

---