آموزش سیستم هوک و apply_filters در وردپرس

صفحه نخست » آموزش وردپرس » آموزش سیستم هوک و apply_filters در وردپرس
طراحی سایت

apply-filters-parswp

آموزش سیستم هوک و apply_filters در وردپرس

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

بهتر است قبل از اینکه با تابع apply_filters وردپرس آشنا شویم ، کمی در مورد هوک صحبت کنیم و ببینیم به چه معناست و چه کاری انجام می دهد. در واقع هوک یا hook در زبان انگلیسی به معنای قلاب است اما در به زبان وردپرس نوعی تابع است که با کمک آن می توان متن یا بخشی را فیلتر کرد. در واقع هوک به دو بخش Action و Filter تقسیم می شود. هر کدام را به اختصار معرفی می کنیم:

Action

زمانی اجرا می شود که اتفاق خاصی در وردپرس رخ داده باشد! مثلا زمانی که کاربر در سایت وردپرسی ثبت نام می کند یا پستی منتشر می شود و امثال اینها.
دو نمونه از معروف ترین اکشن ها ()wp_head و () p_footer هستد که در اکثر قالب ها دیده میشوند ()wp_head در فایل header.php قرار داره و () p_footer در فایل footer.php که البته از کد آن ها نیز می توان متوجه این موضوع شد.

Filter

در فیلتر موضوع متفاوت است و زمانی کاربرد دارد که بخواهیم قبل از نمایش یک پست در سایت تغییراتی بر روی آن اعمال کنیم یا قبل از ذخیره یک مطلب در دیتابیس آن را ادیت کنیم و ….
مهم ترین نمونه ای که در این بخش موجود است فیلتر apply_filters وردپرس می باشد که بیشتر به مبحث امروز ما بر می گردد و قرار است مورد بررسی قرار گیرد.

نکته!!! در واقع ما از اکشن استفاده می کنیم تا توابعی را به بخش دلخواهی از کد ( کد هسته یا کد قالب) نسبت دهیم.

 برای مثال بعضی از پلاگین ها برای اضافه کردن کد دلخواهشان به قسمت head وب سایت از اکشن wp_head استفاده میکنند.

جهت روشن شدن توضیحات بالا چند مثال میزنیم:

 فرض کنید شما می خواهید به انتهای تمای پست های وبسایت یک متن ثابت اضافه کنید برای این کار حتما پلاگینی وجود دارد اما شما به راحتی میتوانید از طریق فیلتر ها این کار را انجام دهید.
در وردپرس فیلتری به اسم the_content موجود است که توسط این فیلتر شما می توانید به محتوای پست های وبلاگ قبل از نمایش مطلبی را اضافه کنید.

در فایل functions.php  یک تابع دلخواه برای اضافه کردن مطلب تعریف میکنیم :

</p>
 
<pre class="brush:php">function matlab($content){
    if(is_single()){
    $content.='<p class="matlab">نوشته تازه اضافه شده توسط فیلتر</p>';
return $content;
    }
return $content;
}

پس از تعریف تابع دلخواه توسط دستور زیر تابع را به فیلتر the_content نسبت می دهیم :

add_filter('the_content','matlab');

حال نوشته “این یک متن ثابت است ” به انتهای تمامی پست ها اضافه میشود .

در انتها برای نمایش کاربرد اکشن ها با استفاده از اکشن wp_head() برای کلاس matlab که در بالا تعریف کردیم style تعریف میکنیم
در این مورد هم ابتدا یک تابع دلخواه تعریف کرده سپس به اکشن wp_head() نسبت می دهیم :

function style(){
echo '<style type="text/css">.matlab{background-color:#CCC;border:#000 3px dashed;}</style>';
 
}
add_action('wp_head','style');

apply_filters وردپرس

apply-filter-parswp

تابع apply_filters وردپرس  یکی از توابع مهم در هوک به حساب می آید که در واقع در هسته ی وردپرس و بعضی از افزونه ها وجود دارد و امکان اتصال تابع را ایجاد میکند. نمونه کدی که در زیر آورده شده می تواند مثال خوبی برای عملکرد آن در بخش محتوا باشد:

</p>
<p dir="RTL" style="text-align: justify;">$content = apply_filters( 'the_content', $content );</p>
<p dir="RTL" style="text-align: justify;">

با توجه به قطعه کد بالا یعنی می توانیم مطلب مورد نظر را که به کمک تابع apply_filters وردپرس  به قسمت ‘the_content’ وصل کرده ایم، تغییر دهیم. به صورت قطعه کد زیر:

</p>
<p dir="RTL" style="text-align: justify;">add_action( 'the_content', 'Hamyarwp_english2persian' );</p>
<p dir="RTL" style="text-align: justify;">

پس توجه کنید هر جا که خواستید امکان اتصال تابع را ایجاد کنید باید از تابع apply_filters وردپرس استفاده کنید و به صورتی که خدمت شما توضیح دادیم عمل کنید. این تابع برای افزونه نویسی مهم است و کارایی زیادی دارد.

توجه!!! شما می توانید لیست سایر اکشن ها و فیلتر ها را مشاهده کنید.

اشتراک گذاری :
مطالب زیر را حتما بخوانید

روش غیرفعال کردن REST API در وردپرس

چگونه REST API را در وردپرس غیر فعال کنیم؟ در وردپرس ۴٫۴ شاهد افزوده شدن امکانات بی ...

شیوه نامه ی وردپرس CSS در قالب های وردپرسی

شیوه نامه ی وردپرس CSS در قالب های وردپرسی وردپرس به شدت بر وجود سی اس اس متکی است. ...

محافظت از وردپرس در مقابل هکرها

یکی از راه های نفوذ به سایت های وردپرسی دسترسی به فایل wp_config_sample.php است. بعد ...

دیدگاه کاربران
نظرات کاربران برای این مطلب را دنبال کنید


برای نمایش دیدگاه کلیک کنید
    ۰ دیدگاه ثبت شده
اطلاعات پست

۳۱۶۰

بازدید

۰

دیدگاه

0

علاقه مندی

5 از 1 رای
  • تاریخ انتشار
  • ۳ شهریور ۱۳۹۵
  • آخرین بروزرسانی
  • ۳ شهریور ۱۳۹۵
  • دسته‌بندی‌
  • آموزش وردپرس
  • لینک کوتاه
  • برچسب ها
  • , , , , ,
  • + نمایش تمام جزئیات