قلاب فیلتر (Filter hook) وردپرس چیست؟

قلاب فیلتر (Filter hook) وردپرس چیست؟

Filter تابعی است که می تواند در یک رویداد در وردپرس متصل شود (قلاب نامیده می شود). در حین اجرا هنگامی که رویداد فعال می شود ، فیلتر به خروجی داده های تولید شده توسط قلاب رویداد اعمال می شود.

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

برای اطمینان از خروجی داده ها در مرورگر ، فیلترها همیشه باید داده وارد کرده و داده ها خارج شوند (ممکن است قبل از خروج از مرورگر ، محتوای شما از فیلترهای دیگر عبور کند). برای مقایسه ، عملکردهایی که مشابه فیلترها هستند ، نیازی به بازگشت چیزی ندارند ، اگرچه داده ها را می توان از طریق عملکردها نیز بازگرداند.

مثال: بگذارید بگوییم وقتی یک پست متعلق به یک دسته خاص است نمایش داده می شود می خواهیم یک نماد تصویر نمایش دهیم. در این سناریو ، تابعی ایجاد می کنیم که بررسی می کند پستی در آن رده خاص باشد. اگر چنین است ، تصویر را نمایش دهید.

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

// First we hook our own function with the_content event
add_filter( 'the_content', 'wpb_content_filter' );
 
// Now we define what our function would do.
// In this example it displays an image if a post is in news category.
function wpb_content_filter( $content ) {
    if ( in_category('news') )
        $content = sprintf('<img class="news-icon" src="%s/images/news_icon.png" alt="News icon" title="" />%s', get_bloginfo( 'stylesheet_directory' ), $content);
 
    // Returns the content.
    return $content;
}

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

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

فیلترها با Actions متفاوت هستند. اقدامات وردپرس در رویدادهایی مانند فعال شدن موضوع یا پلاگین یا انتشار پستی اجرا می شوند. فیلترها برای فیلتر کردن خروجی هنگامی که به پایگاه داده یا به مرورگر کاربر ارسال می شود ، استفاده می شوند.

مثال دیگر استفاده از فیلتر وردپرس:

function wpb_custom_excerpt( $output ) {
  if ( has_excerpt() && ! is_attachment() ) {
    $output .= wpb_continue_reading_link();
  }
  return $output;
}
add_filter( 'get_the_excerpt', 'wpb_custom_excerpt' );

کد نمونه بالا تابع wpb_custom_excerpt را به فیلتر get_the_excerpt اضافه می کند.

WordPress plugin API دارای لیست گسترده ای از قلاب های فیلتر موجود در وردپرس است.

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

دیدگاهتان را بنویسید