mirror of
https://github.com/WordPress/WordPress.git
synced 2024-12-23 09:37:42 +01:00
70f3a062db
The `$path` parameter of some script translation functions had a default value of `null`, even though the parameter is documented as a string. This commit corrects the default value for `$path` in: * `WP_Dependency::set_translations()` * `WP_Scripts::set_translations()` * `wp_set_script_translations()` Additionally, this commit removes an `is_string()` check for `$path` in `load_script_textdomain()`. Now that the default value for `$path` in that function has also been corrected to an empty string instead of `null`, that check is no longer necessary, as it would ''hide'' an error which should be ''fixed'' (at the source of the problem) instead. Follow-up to [54349]. Props jrf, johnjamesjacoby. See #55967, #55656. Built from https://develop.svn.wordpress.org/trunk@54351 git-svn-id: http://core.svn.wordpress.org/trunk@53910 1a063a9b-81f0-0310-95a4-ce76da25c4cd
138 lines
2.5 KiB
PHP
138 lines
2.5 KiB
PHP
<?php
|
|
/**
|
|
* Dependencies API: _WP_Dependency class
|
|
*
|
|
* @since 4.7.0
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Dependencies
|
|
*/
|
|
|
|
/**
|
|
* Class _WP_Dependency
|
|
*
|
|
* Helper class to register a handle and associated data.
|
|
*
|
|
* @access private
|
|
* @since 2.6.0
|
|
*/
|
|
#[AllowDynamicProperties]
|
|
class _WP_Dependency {
|
|
/**
|
|
* The handle name.
|
|
*
|
|
* @since 2.6.0
|
|
* @var string
|
|
*/
|
|
public $handle;
|
|
|
|
/**
|
|
* The handle source.
|
|
*
|
|
* @since 2.6.0
|
|
* @var string
|
|
*/
|
|
public $src;
|
|
|
|
/**
|
|
* An array of handle dependencies.
|
|
*
|
|
* @since 2.6.0
|
|
* @var string[]
|
|
*/
|
|
public $deps = array();
|
|
|
|
/**
|
|
* The handle version.
|
|
*
|
|
* Used for cache-busting.
|
|
*
|
|
* @since 2.6.0
|
|
* @var bool|string
|
|
*/
|
|
public $ver = false;
|
|
|
|
/**
|
|
* Additional arguments for the handle.
|
|
*
|
|
* @since 2.6.0
|
|
* @var array
|
|
*/
|
|
public $args = null; // Custom property, such as $in_footer or $media.
|
|
|
|
/**
|
|
* Extra data to supply to the handle.
|
|
*
|
|
* @since 2.6.0
|
|
* @var array
|
|
*/
|
|
public $extra = array();
|
|
|
|
/**
|
|
* Translation textdomain set for this dependency.
|
|
*
|
|
* @since 5.0.0
|
|
* @var string
|
|
*/
|
|
public $textdomain;
|
|
|
|
/**
|
|
* Translation path set for this dependency.
|
|
*
|
|
* @since 5.0.0
|
|
* @var string
|
|
*/
|
|
public $translations_path;
|
|
|
|
/**
|
|
* Setup dependencies.
|
|
*
|
|
* @since 2.6.0
|
|
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it
|
|
* to the function signature.
|
|
*
|
|
* @param mixed ...$args Dependency information.
|
|
*/
|
|
public function __construct( ...$args ) {
|
|
list( $this->handle, $this->src, $this->deps, $this->ver, $this->args ) = $args;
|
|
if ( ! is_array( $this->deps ) ) {
|
|
$this->deps = array();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add handle data.
|
|
*
|
|
* @since 2.6.0
|
|
*
|
|
* @param string $name The data key to add.
|
|
* @param mixed $data The data value to add.
|
|
* @return bool False if not scalar, true otherwise.
|
|
*/
|
|
public function add_data( $name, $data ) {
|
|
if ( ! is_scalar( $name ) ) {
|
|
return false;
|
|
}
|
|
$this->extra[ $name ] = $data;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Sets the translation domain for this dependency.
|
|
*
|
|
* @since 5.0.0
|
|
*
|
|
* @param string $domain The translation textdomain.
|
|
* @param string $path Optional. The full file path to the directory containing translation files.
|
|
* @return bool False if $domain is not a string, true otherwise.
|
|
*/
|
|
public function set_translations( $domain, $path = '' ) {
|
|
if ( ! is_string( $domain ) ) {
|
|
return false;
|
|
}
|
|
$this->textdomain = $domain;
|
|
$this->translations_path = $path;
|
|
return true;
|
|
}
|
|
}
|