wp_print_scripts() – Function | Developer.WordPress.org

Prints scripts in document head that are in the $handles queue.

Description

Called by admin-header.php and ‘wp_head’ hook. Since it is called by wp_head on every page load, the function does not instantiate the WP_Scripts object unless script names are explicitly passed.
Makes use of already-instantiated $wp_scripts global if present. Use provided ‘wp_print_scripts’ hook to register/enqueue new scripts.

Parameters

$handlesstring|string[]|falseoptional: Scripts to be printed. Default 'false'.
Default:false

Return

string[] On success, an array of handles of processed WP_Dependencies items; otherwise, an empty array.

Source

function wp_print_scripts( $handles = false ) {
	global $wp_scripts;

	/**
	 * Fires before scripts in the $handles queue are printed.
	 *
	 * @since 2.1.0
	 */
	do_action( 'wp_print_scripts' );

	if ( '' === $handles ) { // For 'wp_head'.
		$handles = false;
	}

	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );

	if ( ! ( $wp_scripts instanceof WP_Scripts ) ) {
		if ( ! $handles ) {
			return array(); // No need to instantiate if nothing is there.
		}
	}

	return wp_scripts()->do_items( $handles );
}

View all references View on Trac View on GitHub

Hooks

do_action( ‘wp_print_scripts’ ): Fires before scripts in the $handles queue are printed.

Uses	Description
wp_scripts()`wp-includes/functions.wp-scripts.php`	Initializes $wp_scripts if it has not been set.
do_action()`wp-includes/plugin.php`	Calls the callback functions that have been added to an action hook.

Used by	Description
_WP_Editors::print_tinymce_scripts()`wp-includes/class-wp-editor.php`	Print (output) the main TinyMCE scripts.
wp_ajax_parse_embed()`wp-admin/includes/ajax-actions.php`	Applies Ajax handlers to a string.
wp_ajax_parse_media_shortcode()`wp-admin/includes/ajax-actions.php`
WP_Customize_Manager::wp_die()`wp-includes/class-wp-customize-manager.php`	Custom wp_die wrapper. Returns either the standard message for UI or the Ajax message.

Changelog

Version	Description
2.1.0	Introduced.

wp_print_scripts( string|string[]|false $handles = false ): string[]

In this article