wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_enqueue_script › WordPress Function

Since2.1.0
Deprecatedn/a
› wp_enqueue_script ( $handle, $src = '', $deps = array(), $ver = false, $in_footer = false )
Parameters: (5)
  • (string) $handle Name of the script. Should be unique.
    Required: Yes
  • (string) $src Full URL of the script, or path of the script relative to the WordPress root directory. Default empty.
    Required: No
    Default: (empty)
  • (string[]) $deps Optional. An array of registered script handles this script depends on. Default empty array.
    Required: No
    Default: array()
  • (string|bool|null) $ver Optional. String specifying script version number, if it has one, which is added to the URL as a query string for cache busting purposes. If version is set to false, a version number is automatically added equal to current installed WordPress version. If set to null, no version is added.
    Required: No
    Default: false
  • (bool) $in_footer Optional. Whether to enqueue the script before `</body>` instead of in the `<head>`. Default 'false'.
    Required: No
    Default: false
See:
  • WP_Dependencies::add()
  • WP_Dependencies::add_data()
  • WP_Dependencies::enqueue()
Defined at:
Codex:

Enqueues a script.

Registers the script if $src provided (does NOT overwrite), and enqueues it.


Related Functions: wp_enqueue_scripts, wp_dequeue_script, wp_enqueue_style, wp_enqueue_editor, enqueue_embed_scripts

Source 

function wp_enqueue_script( $handle, $src = '', $deps = array(), $ver = false, $in_footer = false ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

	$wp_scripts = wp_scripts();

	if ( $src || $in_footer ) {
		$_handle = explode( '?', $handle );

		if ( $src ) {
			$wp_scripts->add( $_handle[0], $src, $deps, $ver );
		}

		if ( $in_footer ) {
			$wp_scripts->add_data( $_handle[0], 'group', 1 );
		}
	}

	$wp_scripts->enqueue( $handle );
}