چرا خروجی تابع شما قابل تغییر نیست؟ راهنمای کامل apply_filters

چرا افزونه‌پذیری یک اصل معماری است؟

تابع apply_filters چیست؟

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

function apply_filters( $hook_name, $value, ...$args ) {
    global $wp_filter, $wp_current_filter;

    if ( ! isset( $wp_filter[ $hook_name ] ) ) {
        return $value;
    }

    $wp_current_filter[] = $hook_name;
    $value = $wp_filter[ $hook_name ]->apply_filters( $value, $args );
    array_pop( $wp_current_filter );

    return $value;
}

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

نقش حیاتی return در callback

// اشتباه
add_filter( 'mytheme_title', 'mytheme_modify_title' );
function mytheme_modify_title( $title ) {
    $title = strtoupper( $title );
    // بدون return — مقدار null برمی‌گردد
}

// صحیح
add_filter( 'mytheme_title', 'mytheme_modify_title' );
function mytheme_modify_title( $title ) {
    return strtoupper( $title );
}

نام‌گذاری و prefix فیلترها

$title = apply_filters( 'mytheme_post_title', $title );
$items = apply_filters( 'mytheme_menu_items', $items );
$options = apply_filters( 'mytheme_customizer_options', $options );

کاربردهای عملی در قالب و افزونه

function mytheme_get_title( $post_id ) {
    $title = get_the_title( $post_id );

    $title = apply_filters( 'mytheme_post_title', $title, $post_id );

    return $title;
}

function mytheme_get_menu_items() {
    $items = array(
        'home' => home_url( '/' ),
        'about' => home_url( '/about/' ),
        'contact' => home_url( '/contact/' ),
    );

    $items = apply_filters( 'mytheme_menu_items', $items );

    return $items;
}

add_filter( 'mytheme_menu_items', 'myplugin_add_menu_item', 10, 1 );
function myplugin_add_menu_item( $items ) {
    $items['shop'] = home_url( '/shop/' );
    return $items;
}

تفاوت با do_action

نقش در Child Theme و افزونه‌پذیری

add_filter( 'mytheme_post_title', 'mychild_format_title' );
function mychild_format_title( $title ) {
    return '<span class="child-title">' . $title . '</span>';
}

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

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

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

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