چرا اسکریپت‌های سایت شما دوباره بارگذاری می‌شوند؟ راهنمای wp_enqueue_script

چرا بارگذاری ساده کافی نیست؟

تابع wp_enqueue_script چیست؟

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

function wp_enqueue_script( $handle, $src = '', $deps = array(), $ver = false, $args = array() ) {
    // ...
}

هوک صحیح فراخوانی

add_action( 'wp_enqueue_scripts', 'mytheme_enqueue_assets' );
function mytheme_enqueue_assets() {
    wp_enqueue_script(
        'mytheme-main',
        get_template_directory_uri() . '/assets/js/main.js',
        array( 'jquery' ),
        '1.0.0',
        true
    );
}

مدیریت وابستگی با deps

wp_enqueue_script(
    'mytheme-slider',
    get_template_directory_uri() . '/assets/js/slider.js',
    array( 'jquery', 'mytheme-main' ),
    '1.0.0',
    true
);

نسخه‌بندی و Cache Busting

/assets/js/main.js?ver=1.0.0

$file_path = get_template_directory() . '/assets/js/main.js';
$version = file_exists( $file_path ) ? filemtime( $file_path ) : '1.0.0';

wp_enqueue_script(
    'mytheme-main',
    get_template_directory_uri() . '/assets/js/main.js',
    array(),
    $version,
    true
);

بارگذاری در فوتر و Performance

wp_enqueue_script(
    'mytheme-analytics',
    'https://example.com/analytics.js',
    array(),
    null,
    array(
        'in_footer' => true,
        'strategy'  => 'defer',
    )
);

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

add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );
function mytheme_scripts() {
    wp_enqueue_script(
        'mytheme-main',
        get_template_directory_uri() . '/assets/js/main.js',
        array( 'jquery' ),
        filemtime( get_template_directory() . '/assets/js/main.js' ),
        true
    );

    if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
        wp_enqueue_script( 'comment-reply' );
    }
}

add_action( 'wp_enqueue_scripts', 'mytheme_shop_scripts' );
function mytheme_shop_scripts() {
    if ( function_exists( 'is_woocommerce' ) && ( is_woocommerce() || is_cart() || is_checkout() ) ) {
        wp_enqueue_script(
            'mytheme-shop',
            get_template_directory_uri() . '/assets/js/shop.js',
            array( 'jquery' ),
            '1.0.0',
            true
        );
    }
}

add_action( 'wp_enqueue_scripts', 'mytheme_dequeue_scripts', 100 );
function mytheme_dequeue_scripts() {
    if ( ! is_page_template( 'templates/contact.php' ) ) {
        wp_dequeue_script( 'contact-form-7' );
        wp_deregister_script( 'contact-form-7' );
    }
}

نقش در Child Theme

add_action( 'wp_enqueue_scripts', 'mychild_scripts' );
function mychild_scripts() {
    wp_enqueue_script(
        'mychild-custom',
        get_stylesheet_directory_uri() . '/assets/js/custom.js',
        array( 'jquery' ),
        filemtime( get_stylesheet_directory() . '/assets/js/custom.js' ),
        true
    );
}

add_action( 'wp_enqueue_scripts', 'mychild_dequeue_parent_scripts', 20 );
function mychild_dequeue_parent_scripts() {
    wp_dequeue_script( 'mytheme-old-slider' );
}

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

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

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

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