پرش به محتوای اصلی
وردپرس

The Loop در وردپرس چیست و چگونه کار می‌کند؟

حلقهٔ وردپرس نوشتهٔ جاری را از پرس‌وجوی اصلی گام‌به‌گام در اختیار قالب می‌گذارد. خرابی عنوان پاصفحه یا تکرار صفحهٔ اول بایگانی معمولاً از همین نقطه است، نه از خود محتوا.

تصویر مفهومی: The Loop در وردپرس چیست و چگونه کار می‌کند؟
فهرست مطالب
  1. پرس‌وجوی اصلی قبل از قالب اجرا شده است
  2. فهرست دوم را از پرس‌وجوی اصلی جدا کنید
  3. قالب‌ها کجا حلقه را صدا می‌زنند؟
  4. نشانه‌های خرابی حلقه
  5. بررسی حلقه در یک قالب
  6. اشتباه‌های کار با حلقه
  7. سوالات متداول
  8. آیا هر صفحه فقط یک حلقه دارد؟
  9. صفحه‌بندی بایگانی چرا به حلقه ربط دارد؟
  10. حلقه در قالب بلوکی هم وجود دارد؟
  11. برای نمایش یک برگهٔ ثابت حلقه لازم است؟
  12. ادامه مسیر
  13. جمع‌بندی

The Loop در وردپرس حلقه‌ای است که نوشته‌های پیدا‌شده توسط پرس‌وجوی اصلی را یکی‌یکی برای نمایش آماده می‌کند. تا وقتی این حلقه نچرخیده، برچسب‌های قالب مثل عنوان و متن، نوشتهٔ جاری ندارند که نشان دهند. قالب مناسب را سلسله‌مراتب پرونده انتخاب می‌کند و حلقه داخل همان پرونده محتوا را چاپ می‌کند. فهم این ترتیب جلوی باگ رایجی را می‌گیرد که در آن یک فهرست فرعی، عنوان بقیهٔ صفحه را عوض می‌کند.

پرس‌وجوی اصلی قبل از قالب اجرا شده است

وردپرس از روی نشانی تصمیم می‌گیرد این درخواست برگه است، نوشته است یا بایگانی. نتیجه در پرس‌وجوی اصلی می‌نشیند و بعد فایل قالب اجرا می‌شود.

حلقه روی همان نتیجه راه می‌رود. هر دور، نوشتهٔ جاری را تنظیم می‌کند تا توابع نمایش، عنوان و پیوند و محتوا را از همان نوشته بخوانند. بدون این تنظیم، توابع خروجی قابل اتکا ندارند.

صفحه نمونه وردپرس با نمایش محتوا
صفحه نمونه وردپرس با نمایش محتوا — عکس: WordPress Foundation، مجوز GPL، ویکی‌مدیا کامنز

فهرست دوم را از پرس‌وجوی اصلی جدا کنید

برای یک بلوک جدا، مثل چند نوشتهٔ مرتبط، پرس‌وجوی تازه بسازید و بعد از پایان بلوک، دادهٔ نوشته را به حالت قبل برگردانید. اگر برنگردانید، پاصفحه و ابزارک‌ها نوشتهٔ اشتباه را نشان می‌دهند.

وقتی می‌خواهید خود فهرست اصلی صفحه عوض شود، پرس‌وجوی اصلی را قبل از اجرا محدود کنید نه این که آن را با یک حلقهٔ دوم جایگزین کنید. جایگزینی خام پرس‌وجوی اصلی، صفحه‌بندی و شرط‌های دیگر را می‌شکند.

قالب‌ها کجا حلقه را صدا می‌زنند؟

پروندهٔ برگه، تک‌نوشته و بایگانی هر کدام حلقهٔ خودشان را دارند. در بایگانی، چند دور حلقه طبیعی است و در برگهٔ ثابت معمولاً یک دور کافی است.

اگر پروندهٔ فرزند، حلقه را حذف کند و فقط فیلد دلخواه را چاپ کند، هنوز باید نوشتهٔ جاری درست تنظیم شده باشد. چاپ دستی بدون این تنظیم، به دادهٔ پوچ یا به نوشتهٔ قبلی می‌چسبد.

نشانه‌های خرابی حلقه

عنوان پاصفحه شبیه عنوان آخرین کارت فهرست شده، یا صفحهٔ دوم بایگانی که همان آیتم‌های صفحهٔ اول را تکرار می‌کند، معمولاً از بازنشانی‌نشدن پرس‌وجو یا از دستکاری پرس‌وجوی اصلی می‌آید.

حلقهٔ تو در تو بدون حفظ وضعیت، همین نشانه‌ها را شدیدتر می‌کند. هر پرس‌وجوی فرعی باید آغاز و پایان مشخص در همان بلوک داشته باشد.

بررسی حلقه در یک قالب

  1. پروندهٔ قالب صفحهٔ اصلی، تک‌نوشته و بایگانی را پیدا کنید و محل حلقهٔ اصلی را مشخص کنید.
  2. هر فهرست فرعی را علامت بزنید و ببینید بعد از آن وضعیت نوشته برمی‌گردد یا نه.
  3. صفحهٔ دوم یک بایگانی را باز کنید و تکرار آیتم‌های صفحهٔ اول را چک کنید.
  4. پاصفحه را بعد از یک بلوک مرتبط ببینید و عنوان اشتباه را به پرس‌وجوی فرعی نسبت دهید.
  5. اگر خود فهرست اصلی باید فیلتر شود، همان را قبل از اجرا محدود کنید نه با جایگزینی داخل قالب.

اشتباه‌های کار با حلقه

  • ساخت فهرست فرعی بدون برگرداندن وضعیت، و قبول کردن عنوان غلط در بقیهٔ صفحه.
  • عوض کردن پرس‌وجوی اصلی داخل قالب برای یک ویجت ساده.
  • فرض این که چاپ عنوان بدون تنظیم نوشتهٔ جاری همیشه به برگهٔ همان نشانی وصل است.
  • نادیده گرفتن شمارهٔ صفحه وقتی فهرست بایگانی با پرس‌وجوی تازه ساخته می‌شود.

سوالات متداول

آیا هر صفحه فقط یک حلقه دارد؟

پرس‌وجوی اصلی یکی است، ولی قالب می‌تواند چند پرس‌وجوی فرعی برای بلوک‌های جدا داشته باشد. هر فرعی باید بعد از استفاده، وضعیت را برگرداند.

صفحه‌بندی بایگانی چرا به حلقه ربط دارد؟

شمارهٔ صفحه روی پرس‌وجوی اصلی اعمال می‌شود. اگر فهرست اصلی را دور بزنید و یک پرس‌وجوی جدا بدون توجه به شمارهٔ صفحه بسازید، صفحهٔ دوم همان نتایج اول را نشان می‌دهد.

حلقه در قالب بلوکی هم وجود دارد؟

مفهوم پرس‌وجو و نوشتهٔ جاری باقی است، حتی اگر به‌جای پروندهٔ کلاسیک، قالب از بلوک تکرار نوشته استفاده کند. فهرست فرعی هنوز نباید وضعیت بقیهٔ صفحه را عوض کند.

برای نمایش یک برگهٔ ثابت حلقه لازم است؟

بله به شکل تنظیم نوشتهٔ جاری، حتی اگر فقط یک نتیجه باشد. توابع نمایش قالب به همین تنظیم وابسته‌اند و خواندن دستی شناسه، در ادامهٔ صفحه ناسازگاری می‌سازد.

ادامه مسیر

این موضوع به صفحات و مقاله‌های زیر وصل است. لینک‌ها برای تصمیم بعدی است، نه فهرست تزئینی.

جمع‌بندی

The Loop پل بین نتیجه‌ای است که وردپرس برای یک نشانی پیدا کرده و برچسب‌هایی که قالب چاپ می‌کند. فهرست فرعی مجاز است، به شرطی که وضعیت نوشتهٔ جاری را به پرس‌وجوی اصلی برگرداند.

برای بررسی همین موضوع روی پروژهٔ خودتان، از مشاوره و برآورد پروژه در ایلیاوب استفاده کنید. برآورد بعد از دیدن محدودهٔ کار، محتوا و یکپارچه‌سازی انجام می‌شود.

ایلیا محمدی

ایلیا محمدی

معمار وب و بنیان‌گذار ایلیاوب

معمار وب و مشاور فنی پروژه‌های دیجیتال.

مشاوره رایگان واتساپ