X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/11be8dc178e77d0b46189bbd8e33a216a9b90942..888fa4ed68091f3314f711c5f6fe75858bf5410b:/wp-includes/class.wp-scripts.php diff --git a/wp-includes/class.wp-scripts.php b/wp-includes/class.wp-scripts.php index 9b098aba..1ceb51d8 100644 --- a/wp-includes/class.wp-scripts.php +++ b/wp-includes/class.wp-scripts.php @@ -18,69 +18,130 @@ */ class WP_Scripts extends WP_Dependencies { var $base_url; // Full URL with trailing slash + var $content_url; var $default_version; + var $in_footer = array(); + var $concat = ''; + var $concat_version = ''; + var $do_concat = false; + var $print_html = ''; + var $print_code = ''; + var $ext_handles = ''; + var $ext_version = ''; + var $default_dirs; function __construct() { + $this->init(); + add_action( 'init', array( $this, 'init' ), 0 ); + } + + function init() { + /** + * Fires when the WP_Scripts instance is initialized. + * + * @since 2.6.0 + * + * @param WP_Scripts &$this WP_Scripts instance, passed by reference. + */ do_action_ref_array( 'wp_default_scripts', array(&$this) ); } /** * Prints scripts * - * Prints the scripts passed to it or the print queue. Also prints all necessary dependencies. + * Prints the scripts passed to it or the print queue. Also prints all necessary dependencies. * - * @param mixed handles (optional) Scripts to be printed. (void) prints queue, (string) prints that script, (array of strings) prints those scripts. + * @param mixed $handles (optional) Scripts to be printed. (void) prints queue, (string) prints that script, (array of strings) prints those scripts. + * @param int $group (optional) If scripts were queued in groups prints this group number. * @return array Scripts that have been printed */ - function print_scripts( $handles = false ) { - return $this->do_items( $handles ); + function print_scripts( $handles = false, $group = false ) { + return $this->do_items( $handles, $group ); } - function print_scripts_l10n( $handle ) { - if ( empty($this->registered[$handle]->extra['l10n']) || empty($this->registered[$handle]->extra['l10n'][0]) || !is_array($this->registered[$handle]->extra['l10n'][1]) ) - return false; + // Deprecated since 3.3, see print_extra_script() + function print_scripts_l10n( $handle, $echo = true ) { + _deprecated_function( __FUNCTION__, '3.3', 'print_extra_script()' ); + return $this->print_extra_script( $handle, $echo ); + } - $object_name = $this->registered[$handle]->extra['l10n'][0]; + function print_extra_script( $handle, $echo = true ) { + if ( !$output = $this->get_data( $handle, 'data' ) ) + return; - echo "\n"; return true; } - function do_item( $handle ) { + function do_item( $handle, $group = false ) { if ( !parent::do_item($handle) ) return false; - $ver = $this->registered[$handle]->ver ? $this->registered[$handle]->ver : $this->default_version; + if ( 0 === $group && $this->groups[$handle] > 0 ) { + $this->in_footer[] = $handle; + return false; + } + + if ( false === $group && in_array($handle, $this->in_footer, true) ) + $this->in_footer = array_diff( $this->in_footer, (array) $handle ); + + if ( null === $this->registered[$handle]->ver ) + $ver = ''; + else + $ver = $this->registered[$handle]->ver ? $this->registered[$handle]->ver : $this->default_version; + if ( isset($this->args[$handle]) ) - $ver .= '&' . $this->args[$handle]; + $ver = $ver ? $ver . '&' . $this->args[$handle] : $this->args[$handle]; $src = $this->registered[$handle]->src; - if ( !preg_match('|^https?://|', $src) && !preg_match('|^' . preg_quote(WP_CONTENT_URL) . '|', $src) ) { + + if ( $this->do_concat ) { + /** + * Filter the script loader source. + * + * @since 2.2.0 + * + * @param string $src Script loader source path. + * @param string $handle Script handle. + */ + $srce = apply_filters( 'script_loader_src', $src, $handle ); + if ( $this->in_default_dir($srce) ) { + $this->print_code .= $this->print_extra_script( $handle, false ); + $this->concat .= "$handle,"; + $this->concat_version .= "$handle$ver"; + return true; + } else { + $this->ext_handles .= "$handle,"; + $this->ext_version .= "$handle$ver"; + } + } + + $this->print_extra_script( $handle ); + if ( !preg_match('|^(https?:)?//|', $src) && ! ( $this->content_url && 0 === strpos($src, $this->content_url) ) ) { $src = $this->base_url . $src; } - $src = add_query_arg('ver', $ver, $src); - $src = clean_url(apply_filters( 'script_loader_src', $src, $handle )); + if ( !empty($ver) ) + $src = add_query_arg('ver', $ver, $src); + + /** This filter is documented in wp-includes/class.wp-scripts.php */ + $src = esc_url( apply_filters( 'script_loader_src', $src, $handle ) ); - $this->print_scripts_l10n( $handle ); + if ( ! $src ) + return true; - echo "\n"; + if ( $this->do_concat ) + $this->print_html .= "\n"; + else + echo "\n"; return true; } @@ -88,23 +149,96 @@ class WP_Scripts extends WP_Dependencies { /** * Localizes a script * - * Localizes only if script has already been added - * - * @param string handle Script name - * @param string object_name Name of JS object to hold l10n info - * @param array l10n Array of JS var name => localized string - * @return bool Successful localization + * Localizes only if the script has already been added */ function localize( $handle, $object_name, $l10n ) { - if ( !$object_name || !$l10n ) - return false; - return $this->add_data( $handle, 'l10n', array( $object_name, $l10n ) ); + if ( $handle === 'jquery' ) + $handle = 'jquery-core'; + + if ( is_array($l10n) && isset($l10n['l10n_print_after']) ) { // back compat, preserve the code in 'l10n_print_after' if present + $after = $l10n['l10n_print_after']; + unset($l10n['l10n_print_after']); + } + + foreach ( (array) $l10n as $key => $value ) { + if ( !is_scalar($value) ) + continue; + + $l10n[$key] = html_entity_decode( (string) $value, ENT_QUOTES, 'UTF-8'); + } + + $script = "var $object_name = " . json_encode($l10n) . ';'; + + if ( !empty($after) ) + $script .= "\n$after;"; + + $data = $this->get_data( $handle, 'data' ); + + if ( !empty( $data ) ) + $script = "$data\n$script"; + + return $this->add_data( $handle, 'data', $script ); } - function all_deps( $handles, $recursion = false ) { + function set_group( $handle, $recursion, $group = false ) { + + if ( $this->registered[$handle]->args === 1 ) + $grp = 1; + else + $grp = (int) $this->get_data( $handle, 'group' ); + + if ( false !== $group && $grp > $group ) + $grp = $group; + + return parent::set_group( $handle, $recursion, $grp ); + } + + function all_deps( $handles, $recursion = false, $group = false ) { $r = parent::all_deps( $handles, $recursion ); - if ( !$recursion ) + if ( ! $recursion ) { + /** + * Filter the list of script dependencies left to print. + * + * @since 2.3.0 + * + * @param array $to_do An array of script dependencies. + */ $this->to_do = apply_filters( 'print_scripts_array', $this->to_do ); + } return $r; } + + function do_head_items() { + $this->do_items(false, 0); + return $this->done; + } + + function do_footer_items() { + $this->do_items(false, 1); + return $this->done; + } + + function in_default_dir($src) { + if ( ! $this->default_dirs ) + return true; + + if ( 0 === strpos( $src, '/wp-includes/js/l10n' ) ) + return false; + + foreach ( (array) $this->default_dirs as $test ) { + if ( 0 === strpos($src, $test) ) + return true; + } + return false; + } + + function reset() { + $this->do_concat = false; + $this->print_code = ''; + $this->concat = ''; + $this->concat_version = ''; + $this->print_html = ''; + $this->ext_version = ''; + $this->ext_handles = ''; + } }