WP_Dependencies::add( string $handle, string $src, array $deps = array(), string|bool|null $ver = false, mixed $args = null )

Register an item.


Description Description

Registers the item if no item of that name already exists.


Parameters Parameters

$handle

(string) (Required) Name of the item. Should be unique.

$src

(string) (Required) Full URL of the item, or path of the item relative to the WordPress root directory.

$deps

(array) (Optional) An array of registered item handles this item depends on.

Default value: array()

$ver

(string|bool|null) (Optional) String specifying item 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 value: false

$args

(mixed) (Optional) Custom property of the item. NOT the class property $args. Examples: $media, $in_footer.

Default value: null


Top ↑

Return Return

(bool) Whether the item has been registered. True on success, false on failure.


Top ↑

Source Source

File: wp-includes/class.wp-dependencies.php

	public function add( $handle, $src, $deps = array(), $ver = false, $args = null ) {
		if ( isset($this->registered[$handle]) )
			return false;
		$this->registered[$handle] = new _WP_Dependency( $handle, $src, $deps, $ver, $args );
		return true;
	}

Top ↑

Changelog Changelog

Changelog
Version Description
2.6.0 Moved from WP_Scripts.
2.1.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.