چرا یک callback در چند فیلتر رفتار متفاوتی می‌خواهد؟ راهنمای current_filter

چرا دانستن نام فیلتر فعلی اهمیت دارد؟

تابع current_filter چیست؟

امضای تابع و پارامترها

function current_filter() {
    global $wp_current_filter;
    return end( $wp_current_filter );
}

سازوکار داخلی تابع

تفاوت با current_action

اشتراک callback بین چند فیلتر

function mytheme_format_title( $title ) {
    $current = current_filter();

    switch ( $current ) {
        case 'the_title':
            return '<span class="post-title">' . esc_html( $title ) . '</span>';
        case 'widget_title':
            return '<span class="widget-title">' . esc_html( $title ) . '</span>';
        case 'nav_menu_item_title':
            return esc_html( $title );
        default:
            return $title;
    }
}
add_filter( 'the_title', 'mytheme_format_title' );
add_filter( 'widget_title', 'mytheme_format_title' );
add_filter( 'nav_menu_item_title', 'mytheme_format_title' );

کاربردهای پیشرفته

function mytheme_shared_filter( $value ) {
    $current = current_filter();

    if ( 'the_content' === $current ) {
        return mytheme_process_content( $value );
    }

    if ( 'the_excerpt' === $current ) {
        return mytheme_process_excerpt( $value );
    }

    return $value;
}
add_filter( 'the_content', 'mytheme_shared_filter' );
add_filter( 'the_excerpt', 'mytheme_shared_filter' );

function mytheme_safe_filter( $value ) {
    $excluded_filters = array( 'the_content_feed', 'the_excerpt_rss' );

    if ( in_array( current_filter(), $excluded_filters, true ) ) {
        return $value;
    }

    // اعمال تغییرات
    return mytheme_modify( $value );
}
add_filter( 'the_content', 'mytheme_safe_filter' );

کاربرد در اشکال‌زدایی

function myplugin_debug_filter() {
    $current = current_filter();

    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( sprintf(
            'Filter executed: %s at %s',
            $current,
            gmdate( 'c' )
        ) );
    }
}
add_filter( 'the_content', 'myplugin_debug_filter' );
add_filter( 'the_excerpt', 'myplugin_debug_filter' );

نکات امنیتی و اشتباهات رایج

تحلیل فنی پیشرفته

پرسش‌های پرتکرار

نتیجه و مسیر ادامه