شورتکد جستجو
راهنمای کامل شورتکد wgcr_search؛ همهی ویژگیها با مقدار پیشفرض و مقدارهای مجاز، نمونههای کاربردی و تفاوت آن با ویجت المنتور.
شورتکد [wgcr_search] همان ویجت جستجوی زنده را بدون المنتور در هر جای سایت میسازد: داخل محتوا، در الگوی پوسته، یا با do_shortcode() در PHP.
[wgcr_search]جدول کامل ویژگیها
| ویژگی | پیشفرض | مقدارهای مجاز | توضیح |
|---|---|---|---|
source | post | هر پستتایپ عمومی و قابل جستجو | منبع نتایج |
placeholder | خودکار | متن دلخواه | خالی بماند: «جستجو در مقالات…» یا برای course «جستجو در دورهها…» |
limit | 5 | عدد 1 تا 50 | تعداد نتایج در هر صفحه |
columns | 1 | عدد 1 تا 6 | فقط در mode="page" |
masonry | no | yes / no | فقط در mode="page" |
equal_height | no | yes / no | فقط در mode="page" و وقتی masonry خاموش است |
thumb | yes | yes / no | نمایش بندانگشتی |
excerpt | yes | yes / no | نمایش خلاصه |
all | «نمایش همه نتایج» | متن دلخواه | متن پیوند صفحهی نتایج کامل |
template | 0 | شناسهی قالب المنتور | رندر نتایج با قالب سفارشی |
mode | modal | modal / page | حالت نمایش نتایج |
orderby | relevance | relevance, date, title, author, rand, menu_order | ترتیب نتایج |
order | DESC | DESC / ASC | جهت ترتیب |
date | all | all, week, month, year | بازهی زمانی |
terms | خالی | [taxonomy:]id با جداکنندهی ویرگول | فیلتر رده/برچسب |
terms_op | exclude | include / exclude | شامل یا استثنا |
ignore_sticky | yes | yes / no | اگر no، نوشتههای چسبنده اول میآیند |
query_id | خالی | کلید ساده (sanitize_key) | برای فیلتر wgcr_search_query_args/{query_id} |
pagination | none | none, numbers, prev_next, load_on_click, load_on_scroll | نوع صفحهبندی |
spacer | no | yes / no | فاصلهی اضافی پیش از صفحهبندی |
more_text | «مشاهده مقالات بیشتر» | متن دلخواه | متن دکمهی «بارگذاری بیشتر» |
more_icon | yes | yes / no | آیکون روی دکمه |
more_id | خالی | حروف انگلیسی، عدد، - و _ | شناسهی HTML دکمه |
no_more | «نوشتهی بیشتری موجود نیست.» | متن دلخواه | پیام پایان نتایج |
مقدارهای بولی
برای ویژگیهای بله/خیر، این چهار مقدار «بله» شمرده میشوند و بقیه «خیر»:
yes · 1 · true · onیعنی [wgcr_search thumb="1"] و [wgcr_search thumb="on"] هر دو تصویر را نشان میدهند.
نمونهها
جستجوی ساده در نوشتهها
[wgcr_search limit="8" thumb="no"]جستجوی دورهها با گرید سهستونی
[wgcr_search source="course" mode="page" columns="3" limit="9" pagination="load_on_click" placeholder="جستجو در دورهها…"]نتایج فقط از دو ردهی مشخص
[wgcr_search terms="category:12,category:18" terms_op="include" orderby="date" order="DESC"]جستجوی یک سال اخیر با صفحهبندی شمارهای
[wgcr_search date="year" pagination="numbers" limit="10" spacer="yes"]نتایج با قالب المنتور و ارتفاع برابر
[wgcr_search template="1482" mode="page" columns="2" equal_height="yes"]استثناکردن یک برچسب
[wgcr_search terms="post_tag:57" terms_op="exclude"]استفاده در PHP
echo do_shortcode( '[wgcr_search mode="page" columns="3" limit="12"]' );یا مستقیم با تابع رندر (بدون هزینهی تجزیهی شورتکد):
if ( function_exists( 'wgcr_search_render' ) ) {
echo wgcr_search_render(
array(
'source' => 'post',
'limit' => 12,
'mode' => 'page',
'columns' => 3,
'pagination' => 'numbers',
)
);
}پارامتر دوم wgcr_search_render() یک شناسهی دلخواه است؛ اگر خالی بماند، افزونه خودش شناسهی یکتا میسازد (sc1، sc2 و به همین ترتیب).
تفاوت با ویجت المنتور
| مورد | ویجت المنتور | شورتکد |
|---|---|---|
| ویرایش ظاهری با کنترل | بله | خیر (با CSS یا ویژگیها) |
| پیشنمایش زنده در ویرایشگر | بله | خیر |
مقدار پیشفرض limit | 12 | 5 |
| استایلدهی با بخشهای استایل | بله | با متغیرهای CSS (صفحهی استایلدهی) |
| قابل استفاده در پوسته/PHP | با ویجت المنتور | مستقیم |
اعتبارسنجی مقدارها
همهی ورودیها پیش از استفاده پاکسازی و محدود میشوند؛ اگر مقدار نامعتبری بدهید، افزونه خطا نمیدهد بلکه به مقدار پیشفرض برمیگردد:
| ورودی نامعتبر | نتیجه |
|---|---|
source="anything" که پستتایپ عمومی نیست | post |
limit="999" | 50 |
limit="0" | 5 |
columns="12" | 6 |
mode="popup" | modal |
orderby="price" | relevance |
terms="category:abc" | نادیده گرفته میشود |
terms="999999" (ترم ناموجود) | نادیده گرفته میشود |
more_id="my button!" | mybutton |