WP_Dependencies::add( string $handle, string|false $src, string[] $deps = array(), string|bool|null $ver = false, mixed $args = null ): bool
Register an item.
Description
Registers the item if no item of that name already exists.
Parameters
-
$handle
string Required -
Name of the item. Should be unique.
-
$src
string|false Required -
Full URL of the item, or path of the item relative to the WordPress root directory. If source is set to false, the item is an alias of other items it depends on.
-
$deps
string[] Optional -
An array of registered item handles this item depends on.
Default:
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:
false
-
$args
mixed Optional -
Custom property of the item. NOT the class property $args.
Examples: $media, $in_footer.Default:
null
Return
bool Whether the item has been registered. True on success, false on failure.
Source
File: wp-includes/class-wp-dependencies.php
.
View all references
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 );
// If the item was enqueued before the details were registered, enqueue it now.
if ( array_key_exists( $handle, $this->queued_before_register ) ) {
if ( ! is_null( $this->queued_before_register[ $handle ] ) ) {
$this->enqueue( $handle . '?' . $this->queued_before_register[ $handle ] );
} else {
$this->enqueue( $handle );
}
unset( $this->queued_before_register[ $handle ] );
}
return true;
}
Changelog
Version | Description |
---|---|
2.6.0 | Moved from WP_Scripts . |
2.1.0 | Introduced. |