آموزش Query Loop در وردپرس؛ ساخت فهرست نوشته‌ها بدون کدنویسی
🗓 آخرین به‌روزرسانی:
Query Loop در وردپرس بلوکی پیشرفته برای نمایش نوشته‌ها، برگه‌ها و انواع محتوای دیگر براساس فیلتر و ترتیب دلخواه است. با این بلوک می‌توانید بدون نوشتن حلقه PHP، یک صفحه وبلاگ، فهرست مقالات یک دسته، بخش مطالب جدید، آرشیو نویسنده، Grid نمونه‌کارها یا مجموعه‌ای از محتواهای مرتبط بسازید.
Query Loop فقط یک فهرست ساده نیست. این بلوک یک Query اصلی دارد که تعیین می‌کند چه محتواهایی انتخاب شوند و داخل آن یک Post Template قرار می‌گیرد که ظاهر هر نتیجه را می‌سازد. بلوک‌هایی مانند Featured Image، Post Title، Excerpt، Date، Author، Categories و Read More داخل Post Template تکرار می‌شوند. Pagination، No Results و Query Total نیز تجربه کامل‌تری برای کاربر ایجاد می‌کنند.
در این آموزش، ساخت Query Loop از صفر، انتخاب Pattern، تفاوت Query Type پیش‌فرض و سفارشی، فیلتر دسته و نویسنده، مرتب‌سازی، Offset، Sticky Posts، ساخت Grid، Pagination، No Results، Query Total، استفاده در Templateها، سئو، سرعت، دسترس‌پذیری و رفع خطاهای رایج را بررسی می‌کنیم.
نسخه بررسی‌شده
این مقاله در ژوئیه ۲۰۲۶ براساس WordPress 7.0.2 و مستندات رسمی Query Loop بازبینی شده است. گزینه‌های دقیق می‌توانند براساس قالب، افزونه‌ها، Post Type و Taxonomyهای ثبت‌شده در سایت متفاوت باشند.
Query Loop چیست؟
Query Loop بلوکی از هسته وردپرس با نام فنی core/query است. وظیفه آن اجرای یک درخواست برای دریافت محتوا و نمایش نتایج با یک Layout قابل طراحی است. از نظر مفهومی شبیه WordPress Loop در PHP عمل می‌کند، اما تنظیمات اصلی آن از رابط بلوکی انجام می‌شوند.
برای مثال می‌توانید به Query Loop بگویید:
- فقط نوشته‌ها را نمایش بده.
- فقط مطالب دسته «وردپرس» را نشان بده.
- نوشته‌های یک نویسنده خاص را انتخاب کن.
- سه مقاله جدید را نمایش بده.
- یک نوشته اول را رد کن و از نوشته دوم شروع کن.
- نتایج را به‌صورت Grid سه‌ستونه نشان بده.
- در پایین صفحه Pagination قرار بده.
تفاوت Query Loop با Latest Posts
Latest Posts برای نمایش سریع نوشته‌های جدید مناسب است، اما امکانات محدودتری دارد. Query Loop کنترل بیشتری روی Post Type، فیلتر، Layout، Pagination، Post Template و No Results ارائه می‌دهد.
| ویژگی | Query Loop | Latest Posts |
|---|---|---|
| فیلتر دسته و نویسنده | گسترده | محدودتر |
| Post Type | قابل انتخاب | معمولاً نوشته |
| طراحی کارت | کاملاً بلوکی | محدود |
| Pagination | دارد | معمولاً ندارد |
| No Results | دارد | ندارد |
| استفاده در Template | بسیار مناسب | محدودتر |
ساختار Query Loop
Query Loop چند بخش تودرتو دارد. برای مشاهده دقیق ساختار، List View را باز کنید.
Query Loop
بلوک والد است و تنظیمات انتخاب محتوا را نگهداری می‌کند؛ مانند Post Type، تعداد، ترتیب و فیلتر.
Post Template
بخش تکرارشونده است. هر بلوکی که داخل آن قرار گیرد برای هر نتیجه تکرار می‌شود. اگر Featured Image را بالای عنوان قرار دهید، این ساختار برای همه نتایج اجرا خواهد شد.
Pagination
برای حرکت میان صفحات نتایج استفاده می‌شود. می‌تواند شامل Previous، Page Numbers و Next باشد.
No Results
زمانی نمایش داده می‌شود که Query هیچ نتیجه‌ای پیدا نکند. بهتر است این بخش حذف نشود تا فضای خالی و مبهم برای کاربر ایجاد نشود.
Query Total
تعداد کل نتایج Query را نمایش می‌دهد. این بلوک برای آرشیو، جست‌وجو، نمونه‌کار و صفحه فهرست محتوا مفید است.
روش افزودن Query Loop
- یک نوشته، برگه یا Template را باز کنید.
- روی + کلیک کنید.
- عبارت Query Loop را جست‌وجو کنید.
- بلوک را درج کنید.
- Choose a pattern یا Start blank را انتخاب کنید.
- List View را باز کنید.
- Query، Post Template و بخش‌های داخلی را شناسایی کنید.
روش سریع‌تر این است که در یک خط خالی /query را تایپ و Query Loop را انتخاب کنید.
Choose a Pattern یا Start Blank؟
Choose a Pattern
قالب یا هسته وردپرس چند Layout آماده ارائه می‌دهد. این روش برای شروع سریع مناسب است. Pattern انتخاب‌شده شامل ترکیبی از Featured Image، Title، Excerpt و Pagination است.
Start Blank
با Start Blank می‌توانید یک ساختار ساده مانند Title & Date، Image & Title یا Grid پایه را انتخاب کنید و سپس بلوک‌های دلخواه را اضافه کنید.
برای یادگیری بهتر، Start Blank انتخاب مناسبی است؛ زیرا ساختار واقعی Post Template را واضح‌تر می‌بینید.
Query Type پیش‌فرض و سفارشی
یکی از مهم‌ترین تنظیمات، Query Type است.
Default یا Inherit
در این حالت Query از Template جاری پیروی می‌کند. برای مثال در Category Template، همان دسته جاری را نمایش می‌دهد و در Search Template نتایج عبارت جست‌وجوشده را نشان می‌دهد.
این حالت برای Templateهای آرشیو بسیار مهم است. اگر آن را به Custom تغییر دهید، ممکن است همه دسته‌ها یک فهرست ثابت و اشتباه نشان دهند.
Custom
برای ساخت یک فهرست مستقل داخل برگه یا بخش خاص استفاده می‌شود. پس از انتخاب Custom، گزینه‌های Post Type، Order By، Sticky Posts، Display Options و Filters ظاهر می‌شوند.
چه زمانی از Inherit Query استفاده کنیم؟
- Category Template
- Tag Template
- Author Archive
- Search Results
- Home یا Blog Index
- Custom Post Type Archive
در این صفحات، Query باید با درخواست جاری هماهنگ باشد.
چه زمانی Query سفارشی مناسب است؟
- نمایش سه مقاله جدید در صفحه اصلی
- فهرست مطالب یک دسته در برگه خدمات
- مقالات منتخب نویسنده
- بخش آموزش‌های مرتبط
- نمایش برگه‌های فرزند
- Grid نمونه‌کار
- نمایش محصولات یا Post Type سفارشی در صورت پشتیبانی
انتخاب Post Type
در Query سفارشی می‌توانید نوع محتوا را انتخاب کنید. گزینه‌های رایج:
- Posts
- Pages
- Portfolio
- Product یا سایر Post Typeهای افزونه‌ها
نمایش Post Typeهای سفارشی به نحوه ثبت آن‌ها و پشتیبانی افزونه بستگی دارد. ممکن است بعضی Post Typeها در Query Loop ظاهر نشوند.
مرتب‌سازی نتایج
گزینه Order By معمولاً شامل موارد زیر است:
- جدیدترین به قدیمی‌ترین
- قدیمی‌ترین به جدیدترین
- حروف الفبا A تا Z
- حروف الفبا Z تا A
برای وبلاگ، ترتیب تاریخ نزولی استاندارد است. برای فهرست خدمات یا منابع، ترتیب الفبایی ممکن است خواناتر باشد.
تنظیم Sticky Posts
برای نوشته‌های سنجاق‌شده می‌توانید رفتار Query را تعیین کنید:
- Include: نوشته سنجاق‌شده را لحاظ کن.
- Exclude: آن را حذف کن.
- Ignore: رفتار سنجاق‌شدن را نادیده بگیر.
- Only: فقط نوشته‌های سنجاق‌شده را نمایش بده.
اگر بخش «مطالب منتخب» می‌سازید، گزینه Only می‌تواند مفید باشد.
Items per Page
این گزینه تعداد نتایج هر صفحه را تعیین می‌کند. برای Grid سه‌ستونه، تعداد ۶، ۹ یا ۱۲ معمولاً چیدمان منظم‌تری می‌سازد.
تعداد بالا زمان بارگذاری، حجم تصویر و طول صفحه را افزایش می‌دهد. برای موبایل و سرعت، مقدار منطقی انتخاب کنید.
Offset چیست؟
Offset تعداد مشخصی از نتایج اول را رد می‌کند. برای مثال اگر یک مقاله جدید را در Hero جداگانه نمایش داده‌اید، Query Loop بعدی می‌تواند Offset برابر ۱ داشته باشد تا همان مقاله دوباره تکرار نشود.
Offset همراه Pagination ممکن است رفتار پیچیده ایجاد کند؛ صفحات بعدی را دقیق آزمایش کنید.
Max Page to Show
این گزینه تعداد کل صفحات یا نتایجی را که Query اجازه نمایش دارد محدود می‌کند. برای بخش کوچک صفحه اصلی می‌توانید بدون Pagination فقط چند نتیجه محدود نشان دهید.
فیلتر براساس دسته و برچسب
در Filters گزینه Taxonomies را اضافه کنید. سپس دسته یا برچسب مورد نظر را انتخاب کنید. در نسخه‌های جدید، امکان Include و Exclude کردن Termها نیز وجود دارد.
نمونه
برای نمایش فقط مطالب دسته «آموزش وردپرس»:
- Query Type را روی Custom بگذارید.
- Post Type را Posts انتخاب کنید.
- Filters → Taxonomies را باز کنید.
- Category مورد نظر را انتخاب کنید.
- تعداد نتایج و ترتیب را تنظیم کنید.
فیلتر براساس نویسنده
Authors را به Filters اضافه کنید و یک یا چند نویسنده انتخاب کنید. این قابلیت برای صفحه معرفی نویسنده، تیم تحریریه یا بخش مقالات متخصص کاربرد دارد.
فیلتر Keyword
Keyword نتایجی را نمایش می‌دهد که با واژه تعیین‌شده مطابقت دارند. برای ساخت سیستم جست‌وجوی کامل مناسب نیست، اما برای فهرست محتوای دارای یک عبارت مشخص مفید است.
اگر چند Keyword وارد کنید، رفتار تطبیق را روی داده واقعی آزمایش کنید. فیلتر Keyword جای Taxonomy ساختاریافته را نمی‌گیرد.
فیلتر Parent برای برگه‌ها
وقتی Post Type روی Page باشد، می‌توانید برگه‌های فرزند یک Parent مشخص را نمایش دهید. این قابلیت برای ساخت فهرست خدمات زیرمجموعه یا مستندات سلسله‌مراتبی مناسب است.
طراحی Post Template
Post Template قلب ظاهر Query Loop است. تمام بلوک‌های داخل آن برای هر نتیجه تکرار می‌شوند.
یک کارت استاندارد می‌تواند شامل موارد زیر باشد:
- Post Featured Image
- Post Terms
- Post Title
- Post Excerpt
- Post Date
- Read More
همه این بلوک‌ها را داخل Group قرار دهید تا Background، Padding، Border و Gap مشترک داشته باشند.
لینک کردن عنوان و تصویر
عنوان و تصویر همیشه در همه Patternها خودکار لینک نمی‌شوند. بلوک Post Title را انتخاب و گزینه Make title a link را فعال کنید. در Featured Image نیز Link to post را روشن کنید.
کارت بدون لینک واضح تجربه ضعیفی ایجاد می‌کند. حداقل عنوان یا تصویر باید به نوشته متصل باشد.
ساخت Grid چندستونه
- Post Template را انتخاب کنید.
- Layout را از List به Grid تغییر دهید.
- تعداد ستون‌ها را مشخص کنید.
- Gap افقی و عمودی را تنظیم کنید.
- عرض کارت و تصویر را بررسی کنید.
- نمای موبایل را آزمایش کنید.
سه ستون برای دسکتاپ و یک ستون برای موبایل ساختار رایجی است. تعداد ستون بیشتر ممکن است عنوان و خلاصه را بسیار باریک کند.
ساخت List با تصویر کنار متن
داخل Post Template یک Columns یا Row قرار دهید. Featured Image را در یک سمت و Group شامل Title، Date و Excerpt را در سمت دیگر بگذارید.
در موبایل، Row باید Wrap شود یا Columns به‌صورت عمودی نمایش داده شوند.
تنظیم نسبت تصویر
برای Grid منظم، Featured Imageها باید Aspect Ratio یکسان داشته باشند؛ مانند ۱۶:۹، ۴:۳ یا مربع. گزینه Crop را بررسی کنید تا ارتفاع کارت‌ها هماهنگ شود.
Crop ممکن است بخش مهم تصویر را حذف کند. تصاویر شاخص باید با نقطه تمرکز مناسب انتخاب شوند.
استفاده از Post Excerpt
Excerpt توضیح کوتاهی از نوشته نمایش می‌دهد. طول آن را محدود کنید تا کارت‌ها متعادل بمانند. اگر خلاصه دستی نوشته نشده باشد، وردپرس بخشی از محتوای اصلی را استفاده می‌کند.
خلاصه بسیار طولانی، Grid را نامنظم می‌کند. برای کارت‌های کوچک، یک تا سه خط کافی است.
افزودن Read More
Read More لینک ورود به نوشته است. متن روشن مانند «مطالعه مقاله» یا «ادامه آموزش» بهتر از عبارت مبهم «بیشتر» است.
افزودن دسته، نویسنده و تاریخ
از Post Terms، Post Author و Post Date استفاده کنید. Metaهای زیاد کارت را شلوغ می‌کنند. فقط اطلاعاتی را نشان دهید که برای تصمیم کاربر مفید هستند.
Pagination در Query Loop
Pagination برای فهرست‌های طولانی ضروری است. داخل Query Loop می‌توانید بلوک‌های زیر را داشته باشید:
- Previous
- Page Numbers
- Next
Pagination باید داخل همان Query Loop قرار گیرد تا Query ID صحیح را دریافت کند.
Reload Full Page و Enhanced Pagination
در تنظیمات پیشرفته Query Loop ممکن است گزینه Reload Full Page دیده شود. حالت فعال، کل صفحه را هنگام تغییر صفحه نتایج Reload می‌کند و معمولاً رفتار قابل پیش‌بینی‌تری دارد.
با غیرفعال کردن آن، ممکن است فقط نتایج Query به‌روزرسانی شوند. این تجربه سریع‌تر است، اما باید URL، Back Button، Focus، اسکرول و دسترس‌پذیری را بررسی کنید.
No Results را حذف نکنید
داخل No Results یک پیام مفید قرار دهید؛ برای مثال:
- مطلبی با این شرایط پیدا نشد.
- فیلتر را تغییر دهید.
- از جست‌وجو استفاده کنید.
- به صفحه مقالات برگردید.
می‌توانید Search Block یا دکمه صفحه اصلی نیز اضافه کنید.
Query Total چیست؟
Query Total تعداد کل نتایج را نمایش می‌دهد. این بلوک از نسخه‌های جدید وردپرس برای استفاده داخل Query Loop ارائه شده است.
کاربردهای آن:
- نمایش تعداد نتایج جست‌وجو
- تعداد مطالب دسته
- تعداد نمونه‌کارها
- نمایش بازه فعلی نتایج
Query Title چیست؟
Query Title عنوان آرشیو جاری را نمایش می‌دهد. برای مثال «دسته: وردپرس» یا عنوان نتایج جست‌وجو. این بلوک بیشتر در Templateهای آرشیو استفاده می‌شود.
Heading Level را درست انتخاب کنید. در بیشتر Templateهای آرشیو، Query Title می‌تواند H1 اصلی باشد.
ساخت صفحه وبلاگ با Query Loop
- برگه وبلاگ یا Home Template را باز کنید.
- Query Loop اضافه کنید.
- اگر Template آرشیوی است، Inherit Query را فعال نگه دارید.
- Post Template را Grid کنید.
- Featured Image، Title، Excerpt و Date اضافه کنید.
- Pagination و No Results را قرار دهید.
- موبایل و صفحات بعدی را تست کنید.
ساخت بخش مطالب جدید در صفحه اصلی
در این حالت Query Type باید Custom باشد. Post Type را Posts، ترتیب را Newest to Oldest و Items per Page را ۳ یا ۶ انتخاب کنید. Pagination معمولاً لازم نیست و یک دکمه «مشاهده همه مقالات» در پایین کافی است.
ساخت بخش مطالب یک دسته
فیلتر Taxonomy را روی دسته مورد نظر قرار دهید. اگر این بخش داخل صفحه اصلی است، عنوان واضحی مانند «آموزش‌های وردپرس» اضافه کنید.
ساخت مطالب مرتبط
Query Loop هسته به‌صورت پیش‌فرض سیستم هوشمند Related Posts کامل ندارد. می‌توانید بر مبنای دسته یا برچسب Query بسازید، اما حذف نوشته جاری و سنجش ارتباط دقیق ممکن است به افزونه یا توسعه سفارشی نیاز داشته باشد.
نمایش همان نوشته در بخش مرتبط تجربه ضعیفی است. گزینه Exclude Current در نسخه و تنظیمات موجود را بررسی کنید یا راهکار توسعه‌ای مطمئن استفاده کنید.
استفاده در Category Template
در Category Template، Query Type را روی Default یا Inherit نگه دارید. Query Title، Query Loop، Pagination و No Results را اضافه کنید.
اگر Query را Custom کنید و یک دسته ثابت بدهید، همه صفحات دسته ممکن است همان محتوای ثابت را نشان دهند.
استفاده در Search Template
Search Template باید از Query جاری ارث ببرد. Query Title، Query Total، Query Loop و No Results را قرار دهید. Excerpt برای فهم نتیجه جست‌وجو بسیار مفید است.
Query Loop و Templateها
Query Loop یکی از مهم‌ترین بلوک‌های ساخت Archive، Home، Search و Front Page است. برای یادگیری ساخت Template، مقاله آموزش ساخت Template نوشته و برگه با Site Editor را مطالعه کنید.
ذخیره Query Loop به‌صورت Pattern
اگر Layout مشابه را در چند صفحه نیاز دارید، Query Loop را به Pattern تبدیل کنید. اگر Query و محتوا باید در همه نمونه‌ها یکسان بمانند، Synced Pattern مناسب است؛ اما برای Queryهای متفاوت، Pattern معمولی انتخاب امن‌تری است.
ویرایش Synced Pattern می‌تواند همه صفحات را تغییر دهد. مقاله Pattern و Synced Pattern در وردپرس را ببینید.
Query Loop و Global Styles
برای رنگ، فونت و فاصله کارت‌ها از Global Styles و Presetهای قالب استفاده کنید. استایل محلی زیاد، نگهداری و تغییر برند را دشوار می‌کند.
Query Loop و WoodMart
در dev-source.ir قالب WoodMart 8.3.7 فعال است. Query Loop داخل محتوای Gutenberg قابل استفاده است، اما WoodMart برای نوشته، محصول و Layoutهای فروشگاهی عناصر و Builderهای اختصاصی نیز دارد.
- برای فهرست مقاله داخل محتوای بلوکی، Query Loop قابل استفاده است.
- برای Grid محصول پیشرفته، ابزار WoodMart یا WooCommerce ممکن است امکانات بیشتری داشته باشد.
- برای Layout فروشگاه، WoodMart Layout Builder مسیر اصلی است.
- چند Query سنگین و Widget مشابه را هم‌زمان استفاده نکنید.
سئو Query Loop
- عنوان و تصویر به نوشته لینک شوند.
- Query Title ساختار H1 منطقی داشته باشد.
- Pagination قابل خزیدن باشد.
- Archiveهای بی‌ارزش بی‌هدف ایجاد نشوند.
- Excerpt تکراری و بسیار طولانی نباشد.
- تصاویر Alt مناسب داشته باشند.
- لینک‌های کارت واضح باشند.
Query Loop به‌تنهایی امتیاز سئو ایجاد نمی‌کند؛ ساختار صفحه، محتوا، سرعت و لینک‌سازی مهم‌اند.
سرعت و عملکرد
هر Query درخواست دیتابیس اجرا می‌کند. تعداد زیاد Query Loop، فیلتر پیچیده، تصویر بزرگ و Pagination نادرست می‌توانند سرعت را کاهش دهند.
- Items per Page را محدود کنید.
- تصاویر شاخص را بهینه کنید.
- چند Query مشابه در یک صفحه نسازید.
- Post Template را بیش از حد تودرتو نکنید.
- افزونه‌های بلوکی غیرضروری را حذف کنید.
- کش و عملکرد دیتابیس را بررسی کنید.
دسترس‌پذیری
- Heading کارت‌ها ترتیب منطقی داشته باشند.
- Pagination با صفحه‌کلید قابل استفاده باشد.
- لینک Read More متن روشن داشته باشد.
- Focus State قابل مشاهده باشد.
- تصویر لینک‌شده Alt مناسب داشته باشد.
- No Results پیام قابل فهم ارائه کند.
- به‌روزرسانی بدون Reload کامل از نظر Focus آزمایش شود.
رفع مشکل نمایش ندادن تنظیمات فیلتر
ابتدا خود Query Loop را انتخاب کنید، نه Post Template. سپس Query Type را از Default به Custom تغییر دهید. گزینه‌های Post Type، Filters و Display Options ظاهر می‌شوند.
رفع مشکل نمایش محتوای اشتباه در آرشیو
احتمالاً Query Type روی Custom تنظیم شده است. در Archive، Category و Search باید Inherit Query فعال باشد.
رفع مشکل تکرار یک نوشته
اگر همان نوشته در Hero و Grid دیده می‌شود، از Offset استفاده کنید یا نوشته جاری را Exclude کنید. Pagination را بعد از Offset آزمایش کنید.
رفع مشکل Pagination
- Pagination داخل Query Loop باشد.
- Items per Page و تعداد نتایج کافی باشند.
- Permalinkها درست کار کنند.
- کش صفحه و CDN را پاک کنید.
- چند Query دارای Pagination در یک صفحه را بررسی کنید.
- Query ID و تداخل افزونه را روی Staging آزمایش کنید.
رفع مشکل ارتفاع نامساوی کارت‌ها
نسبت تصویر یکسان، طول Excerpt محدود و ساختار Group ثابت استفاده کنید. عنوان‌های بسیار بلند ممکن است همچنان ارتفاع کارت را تغییر دهند.
رفع مشکل کلیک‌نشدن تصویر یا عنوان
Post Title را انتخاب و Make title a link را فعال کنید. در Featured Image نیز Link to post را روشن کنید.
رفع مشکل خالی بودن Query
فیلترها، Post Type، وضعیت انتشار، نویسنده و دسته را بررسی کنید. No Results را نگه دارید تا علت برای کاربر مبهم نباشد.
اشتباهات رایج
- استفاده از Custom Query در Category Template
- حذف No Results
- قرار دادن Pagination خارج از Query
- لینک نکردن عنوان و تصویر
- تعداد نتایج بسیار زیاد
- Grid چندستونه بدون تست موبایل
- استفاده نادرست از Offset
- ساخت چند Query سنگین در یک صفحه
- نمایش Metaهای غیرضروری
- استفاده از Query Loop برای نیازهای پیچیده بدون تست
چک‌لیست نهایی
- Query Type درست انتخاب شده است.
- Post Type صحیح است.
- فیلتر دسته و نویسنده بررسی شده‌اند.
- Items per Page منطقی است.
- Offset و Sticky Posts تست شده‌اند.
- Post Template مرتب است.
- عنوان و تصویر لینک دارند.
- Grid در موبایل درست نمایش داده می‌شود.
- Pagination داخل Query قرار دارد.
- No Results پیام مناسب دارد.
- Query Total در صورت نیاز اضافه شده است.
- سرعت، سئو و دسترس‌پذیری کنترل شده‌اند.
📌 همچنین بخوانید: دسترس‌پذیری در Gutenberg و Site Editor وردپرس، طراحی ریسپانسیو در Gutenberg و Site Editor وردپرس و ساخت لندینگ پیج با Gutenberg در وردپرس
پرسش‌های متداول
Query Loop چیست؟
بلوک پیشرفته وردپرس برای دریافت و نمایش نوشته‌ها و انواع محتوا براساس Query و Layout دلخواه است.
Query Loop با Latest Posts چه تفاوتی دارد؟
Query Loop فیلتر، Post Type، Post Template، Pagination و طراحی انعطاف‌پذیرتری دارد.
چرا Filters نمایش داده نمی‌شوند؟
خود Query Loop را انتخاب و Query Type را روی Custom قرار دهید.
برای صفحه دسته Custom یا Inherit؟
Inherit Query تا دسته جاری به‌درستی نمایش داده شود.
چگونه یک دسته خاص را نمایش دهیم؟
در Query سفارشی، Filters → Taxonomies را فعال و دسته را انتخاب کنید.
چگونه کارت‌ها را سه‌ستونه کنیم؟
Post Template را انتخاب و Layout را به Grid با سه ستون تغییر دهید.
چرا Pagination کار نمی‌کند؟
باید داخل Query Loop باشد و تعداد نتایج از Items per Page بیشتر باشد.
آیا Query Loop برای محصول مناسب است؟
اگر Product Post Type و بلوک‌های لازم پشتیبانی شوند قابل استفاده است، اما برای فروشگاه پیچیده WooCommerce Blocks یا ابزار قالب ممکن است مناسب‌تر باشند.
جمع‌بندی
Query Loop در وردپرس ابزار اصلی ساخت فهرست‌های پویا با بلوک‌هاست. Query والد تعیین می‌کند چه محتواهایی انتخاب شوند و Post Template ظاهر تکرارشونده هر نتیجه را می‌سازد. Pagination، No Results و Query Total نیز فهرست را کامل می‌کنند.
در صفحات آرشیو، دسته و جست‌وجو از Inherit Query استفاده کنید. برای بخش مطالب جدید، دسته خاص یا نویسنده منتخب، Query سفارشی بسازید. عنوان و تصویر را لینک کنید، Grid را روی موبایل آزمایش کنید و تعداد Queryهای هر صفحه را محدود نگه دارید.
در سایت WoodMart می‌توان Query Loop را داخل محتوای Gutenberg استفاده کرد، اما برای فروشگاه و Layoutهای اختصاصی باید امکانات WoodMart و WooCommerce نیز مقایسه شوند.
برای ادامه مسیر، مقاله ساخت Template با Site Editor، راهنمای Patternهای وردپرس و مقاله آموزش کامل Gutenberg را مطالعه کنید.