پرش به محتویات

Rating


title: Rating description: المان Rating امتیاز عددی را به‌صورت ردیف آیکون (پیش‌فرض: ستاره) نمایش می‌دهد.


المان Rating یک امتیاز عددی را به‌صورت ردیفی از آیکون‌ها (پیش‌فرض: ستاره) نمایش می‌دهد. از مقادیر کسری (مثلاً 3.5 در مقیاس ۵) با پر کردن آیکون‌های کامل، یک آیکون جزئی با width mask و آیکون‌های خالی برای باقیمانده پشتیبانی می‌کند.

این المان از امتیاز محصول (WooCommerce) مجزاست. از Rating برای نمایش امتیازهای استاتیک یا پویای نقد در هر جای سایت استفاده کنید.

تنظیمات

  • Rating (number) — امتیاز فعلی. حداقل 0، گام 0.1. از dynamic data پشتیبانی می‌کند. پیش‌فرض: 3.5.

  • Max. rating (number) — حداکثر مقیاس (مثلاً 5). حداقل 1. از dynamic data پشتیبانی می‌کند.

  • Gap (number with units) — فاصله بین آیکون‌ها (gap روی root).

آیکون (Icon)

  • Icon (icon) — آیکون سفارشی اختیاری؛ پیش‌فرض SVG ستاره داخلی است.

  • Icon color: Full (color) — بخش پر/فعال.

  • Icon color: Empty (color) — بخش خالی/غیرفعال.

  • Icon size (number with units) — اندازه آیکون.

اسکیمای امتیاز (Schema)

JSON-LD اختیاری schema.org برای Review + Rating.

  • Generate review schema (checkbox) — اسکیمای review تولید کنید.

وقتی فعال است، موارد زیر الزامی‌هستند:

  • Required: Reviewed item type (text) — مثلاً Product، Service.

  • Required: Reviewed item name (text) — نام آیتم مورد بررسی.

اختیاری:

  • Optional: Review author (text) — نویسنده نقد.

  • Additional item reviewed properties (repeater) — Property name، Property value، Value type (Text، Number، Nested object).

  • Additional review properties (repeater) — همان ساختار؛ فیلدهایی روی شیء Review اضافه می‌کند (مثلاً reviewBody، datePublished).

داده‌های ساختاریافته، Rating و Max. rating شما را به یک node از نوع Rating با bestRating برابر 5 (نرمال‌شده از مقیاس شما) نگاشت می‌کند.

مرجع توسعه‌دهنده

JSON schema کامل: rating Schema