WordPress at a glance

wp_enqueue_script() WP 1.0

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

Notes:

  • See: WP_Dependencies::add()
  • See: WP_Dependencies::add_data()
  • See: WP_Dependencies::enqueue()

No Hooks.

Return

Nothing (null).

Usage

wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer );
$handle(string) (required)
Name of the script. Should be unique.
$src(string)
Full URL of the script, or path of the script relative to the WordPress root directory.
Default: ''
$deps(array)
An array of registered script handles this script depends on.
Default: empty array
$ver(string/true/false/null)
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.
Default: false
$in_footer(true/false)
Whether to enqueue the script before </body> instead of in the <head>.
Default: 'false'

Code of wp_enqueue_script: wp-includes/functions.wp-scripts.php VER 4.9.8

<?php
function wp_enqueue_script( $handle, $src = '', $deps = array(), $ver = false, $in_footer = false ) {
	$wp_scripts = wp_scripts();

	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );


	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 );
}

Related Functions

From tag: script

More from category: Scripts and Styles

More from Template Tags: Main Functions

No comments
    Hello, !     Log In . Register