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

Hook در وردپرس چیست؟ تفاوت Action و Filter

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

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

Hook در وردپرس نقطهٔ ازپیش‌تعریف‌شده‌ای است که کد شما به آن وصل می‌شود تا رفتار هسته، قالب یا افزونه را بدون ویرایش فایل اصلی عوض کند. Action در آن نقطه کاری انجام می‌دهد و لازم نیست مقداری برگرداند، مثل فرستادن نامه بعد از ثبت سفارش یا بارگذاری پروندهٔ سبک. Filter مقداری را می‌گیرد، تغییر می‌دهد و همان مقدار را برمی‌گرداند، مثل کوتاه کردن خلاصه یا افزودن کلاس به بدنه. اگر فیلتر چیزی برنگرداند، مقدار اصلی خراب می‌شود.

اکشن برای اتفاق است

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

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

کدهای PHP در ویرایشگر برنامه‌نویسی
کدهای PHP در ویرایشگر برنامه‌نویسی — عکس: Yuri Samoilov، مجوز CC BY 2.0، ویکی‌مدیا کامنز

فیلتر برای تغییر داده است

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

خطای رایج این است که تابع فیلتر را مثل اکشن بنویسید و فقط کار جانبی کنید و مقدار را برنگردانید. نتیجه، عنوان خالی یا متن حذف‌شده در سایت است، نه یک قابلیت اضافه.

اتصال و جدا کردن باید هم‌شکل باشد

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

نام تابع را با پیشوند مخصوص پروژه بنویسید. نام عمومی در دو افزونه، یکی را ناخواسته عوض می‌کند و خطا فقط گاهی ظاهر می‌شود.

کجا از هوک استفاده شود و کجا نه

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

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

اضافه کردن یک رفتار بدون دست زدن به هسته

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

خطاهای اتصال به هوک

  • برنگرداندن مقدار در فیلتر و خالی شدن عنوان یا متن.
  • استفاده از نام تابع عمومی که افزونهٔ دیگر هم همان را تعریف کرده است.
  • جدا کردن اکشن والد با اولویتی غیر از اولویتی که وصل شده بود.
  • ویرایش فایل هسته چون پیدا کردن هوک مناسب چند دقیقه بیشتر طول می‌کشد.
ویدیوی مرتبط: هوک(hook)، اکشن(action) و فیلتر(filter) در وردپرس (منبع: آپارات)

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

اگر فیلتر را خالی برگردانم چه می‌شود؟

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

اولویت پیش‌فرض چیست؟

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

چند آرگومان را می‌شود گرفت؟

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

تفاوت این کار با ویرایش قالب والد چیست؟

هوک با به‌روزرسانی والد از بین نمی‌رود، به شرطی که نام هوک پایدار باشد. کپی کردن پروندهٔ والد در فرزند، همان تغییر را منجمد می‌کند و به‌روزرسانی والد را بی‌اثر می‌کند.

ادامه مسیر

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

جمع‌بندی

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

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

ایلیا محمدی

ایلیا محمدی

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

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

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