چرا پنل مدیریت شما اینقدر کند است؟ راهنمای هوک admin_enqueue_scripts

چرا پنل مدیریت به بهینه‌سازی نیاز دارد؟

هوک admin_enqueue_scripts چیست؟

ساختار و پارامترها

add_action( 'admin_enqueue_scripts', 'myplugin_admin_assets' );
function myplugin_admin_assets( $hook_suffix ) {
    // $hook_suffix نام صفحه فعلی است
}

نقش hook_suffix در شرط‌گذاری

add_action( 'admin_enqueue_scripts', 'myplugin_admin_assets' );
function myplugin_admin_assets( $hook_suffix ) {
    if ( 'toplevel_page_myplugin' !== $hook_suffix ) {
        return;
    }

    wp_enqueue_style( 'myplugin-admin', plugin_dir_url( __FILE__ ) . 'assets/css/admin.css', array(), '1.0.0' );
    wp_enqueue_script( 'myplugin-admin', plugin_dir_url( __FILE__ ) . 'assets/js/admin.js', array( 'jquery' ), '1.0.0', true );
}

اولویت و ترتیب اجرا

add_action( 'admin_enqueue_scripts', 'myplugin_admin_assets', 20 );

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

class MyPlugin_Admin_Assets {
    public function init() {
        add_action( 'admin_enqueue_scripts', array( $this, 'enqueue' ) );
    }

    public function enqueue( $hook_suffix ) {
        $allowed_hooks = array(
            'toplevel_page_myplugin',
            'myplugin_page_settings',
            'myplugin_page_reports',
        );

        if ( ! in_array( $hook_suffix, $allowed_hooks, true ) ) {
            return;
        }

        $version = MYPLUGIN_VERSION;

        wp_enqueue_style(
            'myplugin-admin',
            plugin_dir_url( __FILE__ ) . 'assets/css/admin.css',
            array(),
            $version
        );

        wp_enqueue_script(
            'myplugin-admin',
            plugin_dir_url( __FILE__ ) . 'assets/js/admin.js',
            array( 'jquery', 'wp-util' ),
            $version,
            true
        );

        wp_localize_script(
            'myplugin-admin',
            'mypluginAdmin',
            array(
                'ajaxUrl' => admin_url( 'admin-ajax.php' ),
                'nonce'   => wp_create_nonce( 'myplugin_admin_nonce' ),
            )
        );
    }
}

بارگذاری شرطی بر اساس صفحه

function myplugin_editor_assets( $hook_suffix ) {
    if ( ! in_array( $hook_suffix, array( 'post.php', 'post-new.php' ), true ) ) {
        return;
    }

    wp_enqueue_style( 'myplugin-editor', plugin_dir_url( __FILE__ ) . 'assets/css/editor.css', array(), '1.0.0' );
    wp_enqueue_script( 'myplugin-editor', plugin_dir_url( __FILE__ ) . 'assets/js/editor.js', array( 'jquery' ), '1.0.0', true );
}
add_action( 'admin_enqueue_scripts', 'myplugin_editor_assets' );

function myplugin_cpt_assets( $hook_suffix ) {
    $screen = get_current_screen();

    if ( 'book' !== $screen->post_type ) {
        return;
    }

    wp_enqueue_script( 'myplugin-book-admin', plugin_dir_url( __FILE__ ) . 'assets/js/book.js', array( 'jquery' ), '1.0.0', true );
}
add_action( 'admin_enqueue_scripts', 'myplugin_cpt_assets' );

جایگزین مدرن: get_current_screen

function myplugin_screen_assets( $hook_suffix ) {
    $screen = get_current_screen();

    if ( 'book' !== $screen->post_type ) {
        return;
    }

    if ( 'edit' !== $screen->base ) {
        return;
    }

    wp_enqueue_style( 'myplugin-book-list', plugin_dir_url( __FILE__ ) . 'assets/css/book-list.css', array(), '1.0.0' );
}
add_action( 'admin_enqueue_scripts', 'myplugin_screen_assets' );

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

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

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

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