چرا اسکریپت‌های شرطی شما کار نمی‌کنند؟ راهنمای wp_register_script

چرا جدا کردن ثبت از بارگذاری ضروری است؟

تابع wp_register_script چیست؟

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

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

هوک صحیح ثبت

add_action( 'wp_enqueue_scripts', 'mytheme_register_scripts' );
function mytheme_register_scripts() {
    wp_register_script(
        'mytheme-slider',
        get_template_directory_uri() . '/assets/js/slider.js',
        array( 'jquery' ),
        '1.0.0',
        true
    );

    wp_register_script(
        'mytheme-analytics',
        get_template_directory_uri() . '/assets/js/analytics.js',
        array(),
        '1.0.0',
        true
    );

    if ( is_front_page() ) {
        wp_enqueue_script( 'mytheme-slider' );
    }

    if ( is_singular() ) {
        wp_enqueue_script( 'mytheme-analytics' );
    }
}

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

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

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

wp_register_script(
    'mytheme-slider',
    get_template_directory_uri() . '/assets/js/slider.js',
    array( 'jquery' ),
    $version,
    true
);

بارگذاری شرطی و بهینه‌سازی

if ( is_product() ) {
    wp_enqueue_script( 'mytheme-product-zoom' );
}

if ( is_page_template( 'templates/contact.php' ) ) {
    wp_enqueue_script( 'mytheme-form-validation' );
}

if ( has_block( 'core/gallery' ) ) {
    wp_enqueue_script( 'mytheme-lightbox' );
}

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

class MyPlugin_Assets {
    public function init() {
        add_action( 'wp_enqueue_scripts', array( $this, 'register' ) );
        add_action( 'wp_enqueue_scripts', array( $this, 'enqueue' ), 20 );
    }

    public function register() {
        wp_register_script(
            'myplugin-core',
            plugin_dir_url( __FILE__ ) . 'assets/js/core.js',
            array( 'jquery' ),
            MYPLUGIN_VERSION,
            true
        );
    }

    public function enqueue() {
        if ( ! is_singular() ) {
            return;
        }

        wp_enqueue_script( 'myplugin-core' );
    }
}

wp_register_script(
    'mytheme-map',
    get_template_directory_uri() . '/assets/js/map.js',
    array(),
    '1.0.0',
    true
);

if ( is_page_template( 'templates/locations.php' ) ) {
    wp_enqueue_script( 'mytheme-map' );
    wp_localize_script(
        'mytheme-map',
        'mythemeMapData',
        array(
            'apiKey' => get_option( 'mytheme_maps_api_key' ),
            'center' => array( 'lat' => 35.6892, 'lng' => 51.3890 ),
        )
    );
}

نقش در Child Theme

add_action( 'wp_enqueue_scripts', 'mychild_override_scripts', 20 );
function mychild_override_scripts() {
    wp_dequeue_script( 'mytheme-slider' );
    wp_deregister_script( 'mytheme-slider' );

    wp_register_script(
        'mychild-slider',
        get_stylesheet_directory_uri() . '/assets/js/slider.js',
        array( 'jquery' ),
        filemtime( get_stylesheet_directory() . '/assets/js/slider.js' ),
        true
    );

    if ( is_front_page() ) {
        wp_enqueue_script( 'mychild-slider' );
    }
}

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

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

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

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