wp_enqueue_script( string $handle, string $src = '', array $deps = array(), string|bool|null $ver = false, bool $in_footer = false )

Enqueue 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 ClassicPress root directory.

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 ClassicPress version. 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>. 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 );
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/functions.wp-scripts.php: wp_scripts()

Initialize $wp_scripts if it has not been set.

Used By

Used By
Used By Description
wp-includes/customize/class-wp-customize-cropped-image-control.php: WP_Customize_Cropped_Image_Control::enqueue()

Enqueue control related scripts/styles.
wp-includes/customize/class-wp-customize-color-control.php: WP_Customize_Color_Control::enqueue()

Enqueue scripts/styles for the color picker.
wp-includes/customize/class-wp-customize-selective-refresh.php: WP_Customize_Selective_Refresh::enqueue_preview_scripts()

Enqueues preview scripts.
wp-includes/customize/class-wp-customize-header-image-control.php: WP_Customize_Header_Image_Control::enqueue()
wp-includes/general-template.php: add_thickbox()

Enqueues the default ThickBox js and css.
wp-includes/general-template.php: wp_enqueue_code_editor()

Enqueue assets needed by the code editor for the given settings.
wp-includes/widgets/class-wp-widget-text.php: WP_Widget_Text::enqueue_admin_scripts()

Loads the required scripts and styles for the widget control.
wp-includes/widgets/class-wp-widget-media-video.php: WP_Widget_Media_Video::enqueue_preview_scripts()

Enqueue preview scripts.
wp-includes/widgets/class-wp-widget-media-video.php: WP_Widget_Media_Video::enqueue_admin_scripts()

Loads the required scripts and styles for the widget control.
wp-includes/widgets/class-wp-widget-media-audio.php: WP_Widget_Media_Audio::enqueue_preview_scripts()

Enqueue preview scripts.
wp-includes/widgets/class-wp-widget-media-audio.php: WP_Widget_Media_Audio::enqueue_admin_scripts()

Loads the required media files for the media manager and scripts for media widgets.
wp-includes/widgets/class-wp-widget-custom-html.php: WP_Widget_Custom_HTML::enqueue_admin_scripts()

Loads the required scripts and styles for the widget control.
wp-includes/widgets/class-wp-widget-media-gallery.php: WP_Widget_Media_Gallery::enqueue_admin_scripts()

Loads the required media files for the media manager and scripts for media widgets.
wp-includes/widgets/class-wp-widget-media-image.php: WP_Widget_Media_Image::enqueue_admin_scripts()

Loads the required media files for the media manager and scripts for media widgets.
wp-includes/widgets/class-wp-widget-media.php: WP_Widget_Media::enqueue_admin_scripts()

Loads the required scripts and styles for the widget control.
wp-includes/class-wp-customize-widgets.php: WP_Customize_Widgets::enqueue_scripts()

Enqueues scripts and styles for Customizer panel and export data to JavaScript.
wp-includes/class-wp-customize-widgets.php: WP_Customize_Widgets::customize_preview_enqueue()

Enqueues scripts for the Customizer preview.
wp-includes/media.php: wp_enqueue_media()

Enqueues all scripts, styles, settings, and templates necessary to use all media JS APIs.
wp-includes/media.php: wp_playlist_scripts()

Outputs and enqueue default scripts and styles for playlists.
wp-includes/media.php: wp_audio_shortcode()

Builds the Audio shortcode output.
wp-includes/media.php: wp_video_shortcode()

Builds the Video shortcode output.
wp-includes/embed.php: wp_oembed_add_host_js()

Adds the necessary JavaScript to communicate with the embedded iframes.
wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::initialize()
wp-includes/theme.php: the_custom_header_markup()

Print the markup for a custom header.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::enqueue_control_scripts()

Enqueue scripts for customize controls.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::customize_preview_init()

Print JavaScript settings.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::customize_preview_enqueue_deps()

Enqueue scripts for the Customizer preview.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::enqueue_scripts()

Enqueue scripts and styles for Customizer pane.
wp-includes/class-wp-editor.php: _WP_Editors::enqueue_scripts()
wp-includes/functions.php: wp_auth_check_load()

Load the auth check for monitoring whether the user is still logged in.
wp-admin/custom-background.php: Custom_Background::admin_load()

Set up the enqueue for the CSS & JavaScript files.
wp-admin/custom-header.php: Custom_Image_Header::js_includes()

Set up the enqueue for the JavaScript files.
wp-admin/includes/media.php: wp_media_upload_handler()

Handles the process of uploading media.
wp-admin/includes/media.php: media_upload_gallery()

Retrieves the legacy media uploader form in an iframe.
wp-admin/includes/template.php: do_accordion_sections()

Meta Box Accordion Template Function
wp-admin/includes/comment.php: enqueue_comment_hotkeys_js()
wp-admin/includes/class-wp-internal-pointers.php: WP_Internal_Pointers::enqueue_scripts()

Initializes the new feature pointers.
wp-admin/includes/user.php: _wp_personal_data_export_page()

Personal data export.
wp-admin/includes/user.php: _wp_personal_data_removal_page()

Personal data anonymization.
Show 34 more used by Hide more used by

Changelog

Changelog
Version Description
WP-2.1.0 Introduced.