wp_enqueue_script( string $handle, string $src = '', string[] $deps = array(), string|bool|null $ver = false, bool $in_footer = false )
Enqueues a script.
Description
Registers the script if $src provided (does NOT overwrite), and enqueues it.
See also
Parameters
- $handle
-
(Required) Name of the script. Should be unique.
- $src
-
(Optional) Full URL of the script, or path of the script relative to the WordPress root directory.<br>
Default value: ''
- $deps
-
(Optional) An array of registered script handles this script depends on.
Default value: array()
- $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.<br> If set to null, no version is added.
Default value: false
- $in_footer
-
(Optional) Whether to enqueue the script before
</body>instead of in the<head>.<br> Default 'false'.Default value: false
Source
File: wp-includes/functions.wp-scripts.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 );
}
Changelog
| Version | Description |
|---|---|
| 2.1.0 | Introduced. |