Hooks وردپرس

دسته‌بندی‌ها

🧠 Hook چیست؟

در وردپرس، Hook (قلاب) به شما اجازه می‌دهد کد خودتان را به هسته‌ی وردپرس یا افزونه‌ها/قالب‌ها متصل کنید بدون اینکه هسته اصلی را تغییر دهید.
این مفهوم باعث توسعه‌پذیری، سفارشی‌سازی و نگهداری بهتر کد می‌شود.

وردپرس دو نوع Hook دارد:

🛠 انواع Hook در وردپرس

1. 🔧 Action Hooks

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

php
add_action('wp_footer', 'my_custom_footer');
function my_custom_footer() {
  echo '<p style="text-align:center;">این یک متن سفارشی در فوتر است.</p>';
}

📌 مثال‌های رایج Action:

wp_head – افزودن کد در <head>
wp_footer – افزودن کد در انتهای صفحه
init – قبل از بارگذاری سایت
save_post – هنگام ذخیره یک پست

2. 🎛 Filter Hooks

اجازه می‌دهند مقداری را قبل از نمایش، تغییر دهید.

php
add_filter('the_content', 'add_custom_message');
function add_custom_message($content) {
  return $content . '<p>🚀 ممنون از مطالعه این پست!</p>';
}

📌 مثال‌های رایج Filter:

the_content – محتوای پست
excerpt_length – طول خلاصه مطلب
upload_mimes – نوع فایل‌های مجاز آپلود

🧩 چرا Hookها مهم هستند؟

✅ بدون تغییر در فایل‌های اصلی قالب یا افزونه
✅ سازگاری با به‌روزرسانی‌ها
✅ توسعه افزونه‌های حرفه‌ای
✅ شخصی‌سازی کامل رفتار وردپرس

💡 نکات حرفه‌ای

همیشه تابع خودتان را با prefix بنویسید تا با توابع دیگر تداخل نداشته باشد.
اگر لازم شد Hook حذف کنید، از remove_action() یا remove_filter() استفاده کن.
در توسعه افزونه و قالب، بهترین روش برای افزودن قابلیت‌هاست.

🧪 نمونه حرفه‌ای ترکیب Action و Filter:

php
// فیلتر برای تغییر عنوان
add_filter('the_title', 'prefix_change_title');
function prefix_change_title($title) {
  return '🔥 ' . $title;
}

// اکشن برای اضافه کردن CSS سفارشی
add_action('wp_head', 'prefix_custom_css');
function prefix_custom_css() {
  echo '<style>body { background-color: #fefefe; }</style>';
}

🏁 نتیجه‌گیری

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