mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-13 22:26:06 +01:00
f46fbae857
Adds the `wp_set_script_translations()` function which registers translations for a JavaScript file. This function takes a handle, domain and optionally a path and ensures JavaScript translation files are loaded if they exist. Merges [43825,43828,43859,43898] from the 5.0 branch to trunk. Props herregroen, atimmer, omarreiss, nerrad, swissspidy, ocean90, georgestephanis. Fixes #45103, #45256. Built from https://develop.svn.wordpress.org/trunk@44169 git-svn-id: http://core.svn.wordpress.org/trunk@43999 1a063a9b-81f0-0310-95a4-ce76da25c4cd
124 lines
2.0 KiB
PHP
124 lines
2.0 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
|
|
*/
|
|
class _WP_Dependency {
|
|
/**
|
|
* The handle name.
|
|
*
|
|
* @since 2.6.0
|
|
* @var null
|
|
*/
|
|
public $handle;
|
|
|
|
/**
|
|
* The handle source.
|
|
*
|
|
* @since 2.6.0
|
|
* @var null
|
|
*/
|
|
public $src;
|
|
|
|
/**
|
|
* An array of handle dependencies.
|
|
*
|
|
* @since 2.6.0
|
|
* @var array
|
|
*/
|
|
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 null
|
|
*/
|
|
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
|
|
*/
|
|
public function __construct() {
|
|
@list( $this->handle, $this->src, $this->deps, $this->ver, $this->args ) = func_get_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;
|
|
}
|
|
|
|
public function set_translations( $domain, $path = null ) {
|
|
if ( ! is_string( $domain ) ) {
|
|
return false;
|
|
}
|
|
$this->textdomain = $domain;
|
|
$this->translations_path = $path;
|
|
return true;
|
|
}
|
|
}
|