云策 WordPress 开发者社区

钩子文档

admin_print_scripts

查看官方原文 ↗
💡 云策文档标注

概述

admin_print_scripts 是一个 WordPress 动作钩子，在管理后台所有页面的脚本打印时触发。主要用于在管理页面头部输出内联 JavaScript 代码，但不应用于排队样式或脚本。

关键要点

  • admin_print_scripts 钩子在管理后台所有页面的脚本打印时触发，用于输出内联 JavaScript。
  • 不应使用此钩子来排队样式或脚本，应使用 admin_enqueue_scripts 钩子代替。
  • admin_print_scripts 用于在管理页面头部插入内联脚本，而 admin_print_footer_scripts 用于在页脚插入。
  • 从 PHP 向 JavaScript 传递值时，应使用 wp_json_encode() 以避免 XSS 安全漏洞。

代码示例

function admin_inline_js(){
   echo "";
}
add_action( 'admin_print_scripts', 'admin_inline_js' );

注意事项

使用 wp_json_encode() 准备传递给 JavaScript 的值，确保安全性。

📄 原文内容

Fires when scripts are printed for all admin pages.

More Information

  • admin_print_scripts mainly used to echo inline javascript in admin pages header.
  • admin_print_scripts should not be used to enqueue styles or scripts on the admin pages. Use <a title="Plugin API/Action Reference/admin enqueue scripts" href="https://codex.wordpress.org/Plugin_API/Action_Reference/admin_enqueue_scripts">admin_enqueue_scripts</a> instead.
  • admin_print_scripts could be used to insert inline script in admin pages header while admin_print_footer_scripts could be used to insert inline script in admin pages footer.

Source

do_action( 'admin_print_scripts' );

View all references View on Trac View on GitHub

Used by Description
iframe_header()wp-admin/includes/template.php

Generic Iframe header for use with Thickbox.
wp_iframe()wp-admin/includes/media.php

Outputs the iframe to display the media upload page.
WP_Customize_Widgets::print_scripts()wp-includes/class-wp-customize-widgets.php

Calls admin_print_scripts-widgets.php and admin_print_scripts hooks to allow custom scripts from plugins.

Changelog

Version Description
2.1.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content


    Steven Lin


    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

    Migrate from Codex:

    Basic Examples:

    function admin_inline_js(){ 
   echo "<script type='text/javascript'>n";
   echo 'var pluginUrl = ' . wp_json_encode( WP_PLUGIN_URL . '/my_plugin/' ) . ';'; 
   echo "n</script>"; 
} 
add_action( 'admin_print_scripts', 'admin_inline_js' );

    Result:

    var pluginUrl = “http://website.com/wp-content/plugins/my_plugin/”;

    Note that we use wp_json_encode() to prepare the value for pluginURL before embedding it in the JavaScript code. It is important to always use wp_json_encode() when passing values from PHP to JavaScript, to avoid the possibility of XSS security vulnerabilities.