The admin_head-(plugin_page) hook is triggered within the <head></head> section of a specific plugin-generated page.
This hook provides no parameters. You use this hook by having your function echo output to the browser, or by having it perform background tasks. Your functions shouldn't return, and shouldn't take any parameters.
None.
<?php
add_action('admin_head-HOOK_SUFFIX', 'myplugin_adminhead');
function myplugin_adminhead() {
// Output <head> content here, e.g.:
}
Where HOOK_SUFFIX is the plugin's hook suffix as returned by add_submenu_page or one of its siblings add_options_page or add_management_page.
To add <head></head> content to a management page, the suffix for this hook should be in the following form:
add_action('admin_head-tools_page_myplugin/myplugin', 'myplugin_adminhead');
function myplugin_adminhead() {
// Output <head> content here, e.g.:
echo '<style type="text/css">'
.'/* ... */'
.'</style>';
}
This hook is an action which means that it primarily acts as an event trigger, instead of a content filter. This is a semantic difference, but it will help you to remember what this hook does if you use it like this:
add_action( 'admin_menu', 'myplugin_setup_options' );
function myplugin_setup_options(){
$plugin_page=add_options_page( 'My Plugin', 'myplugin', 8, basename(__FILE__), 'myplugin_main' );
add_action( 'admin_head-'. $plugin_page, 'myplugin_admin_header' );
}
function myplugin_admin_header(){
echo '<p>Only executes when the myplugin options page is displayed.</p>';
}
admin_headwp_enqueue_style and wp_enqueue_script