Filter Radio
فیلتر radio برای انتخاب یک گزینه از چند مقدار و محدود کردن نتایج query.
نکته: از radio buttonها زمانی استفاده کنید که کاربران باید فقط یک گزینه فیلتر انتخاب کنند. با تنظیم «Action» ترکیب کنید تا dropdownهای مرتبسازی یا انتخابگرهای نتایج-در-هر-صفحه ایجاد شود.
تنظیمات
- Target query (query-list) — queryای که این فیلتر باید هدف قرار دهد را انتخاب کنید. در این نسخه فقط post queryها پشتیبانی میشوند.
- URL parameter (text) — یک نام پارامتر URL منحصربهفرد و خواناتر برای این فیلتر تعریف کنید.
- Apply on (select) — زمان اعمال فیلتر را انتخاب کنید. گزینهها: Input (فوری)، Submit (نیاز به کلیک دکمه). پیشفرض: Input.
- Action (select) — رفتار فیلتر. گزینهها: Filter (فیلتر سنتی)، Sort (کنترل مرتبسازی)، Results per page (کنترل صفحهبندی).
- Source (select) — منبع داده برای گزینههای فیلتر. گزینهها: Taxonomy، WordPress field، Custom field.
- Field type (select) — نوع فیلد هنگام استفاده از منبع WordPress field یا Custom field. گزینهها: Post، Term، User.
- Field (select) — فیلد خاص برای فیلتر/مرتبسازی (بسته به نوع فیلد و action متفاوت است).
- Taxonomy (select) — taxonomy برای فیلتر کردن هنگامیکه منبع taxonomy است.
- Order by (select) — نحوه مرتبسازی termهای taxonomy. گزینهها: Name، Slug، Term ID، Description، Parent، Count، Include، Menu Order، Meta Value، Meta Value Num.
- Order meta key (text) — meta key برای مرتبسازی هنگام استفاده از مرتبسازی meta value.
- Order (select) — جهت مرتبسازی. گزینهها: ASC، DESC. پیشفرض: ASC.
- Terms: Include (select) — termهای taxonomy خاصی که در گزینههای فیلتر گنجانده شوند.
- Terms: Exclude (select) — termهای taxonomy خاصی که از گزینههای فیلتر حذف شوند.
- Top level terms only (checkbox) — فقط termهای سطح بالا (parent = 0) را هنگامیکه منبع taxonomy است نمایش دهید.
- Hide count (checkbox) — تعداد نتایج هر گزینه را مخفی کنید.
- Hide empty (checkbox) — گزینههای با صفر نتیجه را مخفی کنید.
- Hide count bracket (checkbox) — براکتهای اطراف مقادیر تعداد را حذف کنید.
- Hierarchical (checkbox) — termهای taxonomy را در ساختار سلسلهمراتبی نمایش دهید.
- Indent: Prefix (text) — متن پیشوند برای تورفتگی سلسلهمراتبی. پیشفرض: —.
- Indent: Gap (number) — فاصلهگذاری تورفتگی برای سلسلهمراتب.
- Provider (select) — ارائهدهنده custom field برای integration (ACF، Meta Box و غیره).
- Meta key (text) — کلید custom field برای فیلتر کردن.
- Compare (select) — عملگر مقایسه برای فیلتر کردن. پیشفرض: Equal.
- Mode (select) — حالت نمایش radio buttonها. گزینهها: Default (radio buttonهای سنتی)، Button (استایل دکمه مدرن).
- Sort options (repeater) — گزینههای مرتبسازی را هنگامیکه Action روی Sort تنظیم شده پیکربندی کنید.
- Option source (text) — فیلد و جهت مرتبسازی (مثلاً post_date_DESC).
- Option label (text) — برچسب نمایشی برای گزینه مرتبسازی.
- Option order (select) — override جهت مرتبسازی.
- Option meta key (text) — meta key برای مرتبسازی بر اساس meta.
- Results per page options (text) — لیست جداشده با کاما از گزینههای نتایج در هر صفحه هنگامیکه Action روی Results per page تنظیم شده. پیشفرض: 10، 20، 50، 100.
- Active filter — تنظیمات نمایش فیلتر فعال.
- Prefix (text) — متن نمایش دادهشده قبل از مقدار فیلتر.
- Suffix (text) — متن نمایش دادهشده بعد از مقدار فیلتر.
- Title (text) — attribute title سفارشی برای لینکهای فیلتر.
مرجع توسعهدهنده
برای JSON schema کامل به Filter - Radio Schema مراجعه کنید.