WordPress.org

Make WordPress Core

Ticket #35964: 35964.2.patch

File 35964.2.patch, 16.8 KB (added by ocean90, 5 years ago)
  • src/wp-includes/class.wp-dependencies.php

     
    11<?php
    22/**
    3  * BackPress Scripts enqueue
     3 * Dependencies API: WP_Dependencies base class
    44 *
    5  * Classes were refactored from the WP_Scripts and WordPress script enqueue API.
     5 * @since 2.6.0
    66 *
    7  * @since BackPress r74
     7 * @package WordPress
     8 * @subpackage Dependencies
     9 */
     10
     11/**
     12 * Core base class extended to register items.
    813 *
    9  * @package BackPress
     14 * @package WordPress
     15 * @since 2.6.0
    1016 * @uses _WP_Dependency
    11  * @since r74
    1217 */
    1318class WP_Dependencies {
    1419        /**
     
    7782        public $group = 0;
    7883
    7984        /**
    80          * Process the items and dependencies.
     85         * Processes the items and dependencies.
    8186         *
    8287         * Processes the items passed to it or the queue, and their dependencies.
    8388         *
     
    116121        }
    117122
    118123        /**
    119          * Process a dependency.
     124         * Processes a dependency.
    120125         *
    121126         * @access public
    122127         * @since 2.6.0
     
    129134        }
    130135
    131136        /**
    132          * Determine dependencies.
     137         * Determines dependencies.
    133138         *
    134139         * Recursively builds an array of items to process taking
    135140         * dependencies into account. Does NOT catch infinite loops.
     
    139144         * @since 2.6.0 Moved from `WP_Scripts`.
    140145         * @since 2.8.0 Added the `$group` parameter.
    141146         *
    142          * @param mixed $handles   Item handle and argument (string) or item handles and arguments (array of strings).
    143          * @param bool  $recursion Internal flag that function is calling itself.
    144          * @param mixed $group     Group level: (int) level, (false) no groups.
     147         * @param mixed     $handles   Item handle and argument (string) or item handles and arguments (array of strings).
     148         * @param bool      $recursion Internal flag that function is calling itself.
     149         * @param int|false $group     Group level: (int) level, (false) no groups.
    145150         * @return bool True on success, false on failure.
    146151         */
    147152        public function all_deps( $handles, $recursion = false, $group = false ) {
  • src/wp-includes/class.wp-scripts.php

     
    11<?php
    22/**
    3  * BackPress Scripts enqueue.
     3 * Dependencies API: WP_Scripts class
    44 *
    5  * These classes were refactored from the WordPress WP_Scripts and WordPress
    6  * script enqueue API.
     5 * @since 2.6.0
    76 *
    8  * @package BackPress
    9  * @since r16
     7 * @package WordPress
     8 * @subpackage Dependencies
    109 */
    1110
    1211/**
    13  * BackPress Scripts enqueue class.
     12 * Core class used to register scripts.
    1413 *
    15  * @package BackPress
     14 * @package WordPress
    1615 * @uses WP_Dependencies
    17  * @since r16
     16 * @since 2.1.0
    1817 */
    1918class WP_Scripts extends WP_Dependencies {
    2019        /**
     
    2928        public $base_url;
    3029
    3130        /**
     31         * URL of the content directory.
    3232         *
     33         * Usually the value of `WP_CONTENT_URL`.
     34         *
    3335         * @since 2.8.0
    3436         * @access public
    3537         * @var string
     
    3739        public $content_url;
    3840
    3941        /**
     42         * Default version string for stylesheets.
    4043         *
     44         * Usually the value of `get_bloginfo( 'version' )`.
     45         *
    4146         * @since 2.6.0
    4247         * @access public
    4348         * @var string
     
    4550        public $default_version;
    4651
    4752        /**
     53         * Holds handles of scripts which are enqueued in footer.
    4854         *
    4955         * @since 2.8.0
    5056         * @access public
     
    5359        public $in_footer = array();
    5460
    5561        /**
     62         * Holds list of script handles which will be concatenated.
    5663         *
    5764         * @since 2.8.0
    5865         * @access public
     
    6168        public $concat = '';
    6269
    6370        /**
     71         * Holds a string which contains script handles and their version.
    6472         *
    6573         * @since 2.8.0
     74         * @deprecated 3.4.0
    6675         * @access public
    6776         * @var string
    6877         */
    6978        public $concat_version = '';
    7079
    7180        /**
     81         * Whether to perform concatenation.
    7282         *
    7383         * @since 2.8.0
    7484         * @access public
     
    7787        public $do_concat = false;
    7888
    7989        /**
     90         * Holds HTML markup of scripts and additional data if concatenation
     91         * is enabled.
    8092         *
    8193         * @since 2.8.0
    8294         * @access public
     
    93105        public $print_html_before = '';
    94106
    95107        /**
     108         * Holds inline code if concatenation is enabled.
    96109         *
    97110         * @since 2.8.0
    98111         * @access public
     
    101114        public $print_code = '';
    102115
    103116        /**
     117         * Holds list of script handles which are not in the default directory
     118         * if concatenation is enabled.
    104119         *
    105120         * @since 2.8.0
    106121         * @access public
     
    109124        public $ext_handles = '';
    110125
    111126        /**
     127         * Holds a string which contains handles and versions of scripts which
     128         * are not in the default directory if concatenation is enabled.
    112129         *
    113130         * @since 2.8.0
    114131         * @access public
     
    117134        public $ext_version = '';
    118135
    119136        /**
     137         * List of default directories.
    120138         *
    121139         * @since 2.8.0
    122140         * @access public
     
    172190        }
    173191
    174192        /**
     193         * Prints extra scripts of a registered script.
    175194         *
    176195         * @since 2.1.0
    177196         * @since 2.8.0 Added the `$echo` parameter.
     
    180199         *
    181200         * @see print_extra_script()
    182201         *
    183          * @param string $handle
    184          * @param bool   $echo
    185          * @return bool|string|void
     202         * @param string $handle The script's registered handle.
     203         * @param bool   $echo   Optional. Whether to echo the extra script instead of just returning it.
     204         *                       Default true.
     205         * @return bool|string|void Void if no data exists, extra scripts if `$echo` is true, true otherwise.
    186206         */
    187207        public function print_scripts_l10n( $handle, $echo = true ) {
    188208                _deprecated_function( __FUNCTION__, '3.3', 'print_extra_script()' );
     
    190210        }
    191211
    192212        /**
     213         * Prints extra scripts of a registered script.
    193214         *
    194215         * @since 3.3.0
    195216         * @access public
    196217         *
    197          * @param string $handle
    198          * @param bool   $echo
    199          * @return bool|string|void
     218         * @param string $handle The script's registered handle.
     219         * @param bool   $echo   Optional. Whether to echo the extra script instead of just returning it.
     220         *                       Default true.
     221         * @return bool|string|void Void if no data exists, extra scripts if `$echo` is true, true otherwise.
    200222         */
    201223        public function print_extra_script( $handle, $echo = true ) {
    202224                if ( !$output = $this->get_data( $handle, 'data' ) )
     
    215237        }
    216238
    217239        /**
     240         * Processes a script dependency.
    218241         *
    219242         * @since 2.6.0
    220243         * @since 2.8.0 Added the `$group` parameter.
    221244         * @access public
    222245         *
    223          * @param string   $handle Name of the item. Should be unique.
    224          * @param int|bool $group
    225          * @return bool True on success, false if not set.
     246         * @see WP_Dependencies::do_item()
     247         *
     248         * @param string $handle    The script's registered handle.
     249         * @param int|false $group  Optional. Group level: (int) level, (false) no groups. Default false.
     250         * @return bool True on success, false on failure.
    226251         */
    227252        public function do_item( $handle, $group = false ) {
    228253                if ( !parent::do_item($handle) )
     
    446471        }
    447472
    448473        /**
     474         * Sets handle group.
    449475         *
    450476         * @since 2.8.0
    451477         * @access public
    452478         *
    453          * @param string $handle    Name of the item. Should be unique.
    454          * @param bool   $recursion Internal flag that calling function was called recursively.
    455          * @param mixed  $group     Group level.
     479         * @see WP_Dependencies::set_group()
     480         *
     481         * @param string    $handle    Name of the item. Should be unique.
     482         * @param bool      $recursion Internal flag that calling function was called recursively.
     483         * @param int|false $group     Optional. Group level: (int) level, (false) no groups. Default false.
    456484         * @return bool Not already in the group or a lower group
    457485         */
    458486        public function set_group( $handle, $recursion, $group = false ) {
     
    468496        }
    469497
    470498        /**
    471          *
     499         * Determines script dependencies.
     500     *
    472501         * @since 2.1.0
    473502         * @access public
    474503         *
    475          * @param mixed $handles   Item handle and argument (string) or item handles and arguments (array of strings).
    476          * @param bool  $recursion Internal flag that function is calling itself.
    477          * @param mixed $group     Group level: (int) level, (false) no groups.
     504         * @see WP_Dependencies::all_deps()
     505         *
     506         * @param mixed     $handles   Item handle and argument (string) or item handles and arguments (array of strings).
     507         * @param bool      $recursion Internal flag that function is calling itself.
     508         * @param int|false $group     Optional. Group level: (int) level, (false) no groups. Default false.
    478509         * @return bool True on success, false on failure.
    479510         */
    480511        public function all_deps( $handles, $recursion = false, $group = false ) {
     
    493524        }
    494525
    495526        /**
     527         * Processes items and dependencies for the head group.
    496528         *
    497529         * @since 2.8.0
    498530         * @access public
    499531         *
    500          * @return array
     532         * @see WP_Dependencies::do_items()
     533         *
     534         * @return array Handles of items that have been processed.
    501535         */
    502536        public function do_head_items() {
    503537                $this->do_items(false, 0);
     
    505539        }
    506540
    507541        /**
     542         * Processes items and dependencies for the footer group.
    508543         *
    509544         * @since 2.8.0
    510545         * @access public
    511546         *
    512          * @return array
     547         * @see WP_Dependencies::do_items()
     548         *
     549         * @return array Handles of items that have been processed.
    513550         */
    514551        public function do_footer_items() {
    515552                $this->do_items(false, 1);
     
    517554        }
    518555
    519556        /**
     557         * Whether a handle's source is in a default directory.
    520558         *
    521559         * @since 2.8.0
    522560         * @access public
    523561         *
    524          * @param string $src
    525          * @return bool
     562         * @param string $src The source of the enqueued script.
     563         * @return bool True if found, false if not.
    526564         */
    527565        public function in_default_dir( $src ) {
    528566                if ( ! $this->default_dirs ) {
     
    542580        }
    543581
    544582        /**
     583         * Resets class properties.
    545584         *
    546585         * @since 2.8.0
    547586         * @access public
  • src/wp-includes/class.wp-styles.php

     
    11<?php
    22/**
    3  * BackPress Styles enqueue.
     3 * Dependencies API: WP_Styles class
    44 *
    5  * These classes were refactored from the WordPress WP_Scripts and WordPress
    6  * script enqueue API.
     5 * @since 2.6.0
    76 *
    8  * @package BackPress
    9  * @since r74
     7 * @package WordPress
     8 * @subpackage Dependencies
    109 */
    1110
    1211/**
    13  * BackPress Styles enqueue class.
     12 * Core class used to register styles.
    1413 *
    15  * @package BackPress
     14 * @package WordPress
    1615 * @uses WP_Dependencies
    17  * @since r74
     16 * @since 2.6.0
    1817 */
    1918class WP_Styles extends WP_Dependencies {
    2019        /**
     
    2928        public $base_url;
    3029
    3130        /**
     31         * URL of the content directory.
    3232         *
     33         * Usually the value of `WP_CONTENT_URL`.
     34         *
    3335         * @since 2.8.0
    3436         * @access public
    3537         * @var string
     
    3739        public $content_url;
    3840
    3941        /**
     42         * Default version string for stylesheets.
    4043         *
     44         * Usually the value of `get_bloginfo( 'version' )`.
     45         *
    4146         * @since 2.6.0
    4247         * @access public
    4348         * @var string
     
    4550        public $default_version;
    4651
    4752        /**
     53         * The current text direction.
    4854         *
    4955         * @since 2.6.0
    5056         * @access public
     
    5359        public $text_direction = 'ltr';
    5460
    5561        /**
     62         * Holds list of style handles which will be concatenated.
    5663         *
    5764         * @since 2.8.0
    5865         * @access public
     
    6168        public $concat = '';
    6269
    6370        /**
     71         * Holds a string which contains style handles and their version.
    6472         *
    6573         * @since 2.8.0
     74         * @deprecated 3.4.0
    6675         * @access public
    6776         * @var string
    6877         */
    6978        public $concat_version = '';
    7079
    7180        /**
     81         * Whether to perform concatenation.
    7282         *
    7383         * @since 2.8.0
    7484         * @access public
     
    7787        public $do_concat = false;
    7888
    7989        /**
     90         * Holds HTML markup of scripts and additional data if concatenation
     91         * is enabled.
    8092         *
    8193         * @since 2.8.0
    8294         * @access public
     
    8597        public $print_html = '';
    8698
    8799        /**
     100         * Holds inline styles if concatenation is enabled.
    88101         *
    89102         * @since 3.3.0
    90103         * @access public
     
    93106        public $print_code = '';
    94107
    95108        /**
     109         * List of default directories.
    96110         *
    97111         * @since 2.8.0
    98112         * @access public
     
    118132        }
    119133
    120134        /**
     135         * Processes a style dependency.
    121136         *
    122137         * @since 2.6.0
    123138         * @access public
    124139         *
    125          * @param string $handle
    126          * @return bool
     140         * @see WP_Dependencies::do_item()
     141         *
     142         * @param string $handle The style's registered handle.
     143         * @return bool True on success, false on failure.
    127144         */
    128145        public function do_item( $handle ) {
    129146                if ( !parent::do_item($handle) )
     
    230247        }
    231248
    232249        /**
     250         * Add extra CSS styles to a registered stylesheet.
    233251         *
    234252         * @since 3.3.0
    235253         * @access public
    236254         *
    237          * @param string $handle
    238          * @param string $code
     255         * @param string $handle The style's registered handle.
     256         * @param string $code   String containing the CSS styles to be added.
     257         * @return bool True on success, false on failure.
    239258         */
    240259        public function add_inline_style( $handle, $code ) {
    241260                if ( ! $code ) {
     
    253272        }
    254273
    255274        /**
     275         * Prints extra CSS styles of a registered stylesheet.
    256276         *
    257277         * @since 3.3.0
    258278         * @access public
    259279         *
    260          * @param string $handle
    261          * @param bool $echo
    262          * @return bool
     280         * @param string $handle The style's registered handle.
     281         * @param bool   $echo   Optional. Whether to echo the inline style instead of just returning it.
     282         *                       Default true.
     283         * @return string|bool   False if no data exists, inline styles if `$echo` is true, true otherwise.
    263284         */
    264285        public function print_inline_style( $handle, $echo = true ) {
    265286                $output = $this->get_data( $handle, 'after' );
     
    280301        }
    281302
    282303        /**
     304         * Determines style dependencies.
    283305         *
    284306         * @since 2.6.0
    285307         * @access public
    286308         *
    287          * @param mixed $handles
    288          * @param bool $recursion
    289          * @param mixed $group
    290          * @return bool
     309         * @see WP_Dependencies::all_deps()
     310         *
     311         * @param mixed     $handles   Item handle and argument (string) or item handles and arguments (array of strings).
     312         * @param bool      $recursion Internal flag that function is calling itself.
     313         * @param int|false $group     Group level: (int) level, (false) no groups.
     314         * @return bool True on success, false on failure.
    291315         */
    292316        public function all_deps( $handles, $recursion = false, $group = false ) {
    293317                $r = parent::all_deps( $handles, $recursion );
    294                 if ( !$recursion ) {
     318                if ( ! $recursion ) {
    295319                        /**
    296320                         * Filter the array of enqueued styles before processing for output.
    297321                         *
     
    305329        }
    306330
    307331        /**
     332         * Generates an enqueued style's fully-qualified URL.
    308333         *
    309334         * @since 2.6.0
    310335         * @access public
    311336         *
    312          * @param string $src
    313          * @param string $ver
    314          * @param string $handle
     337         * @param string $src The source of the enqueued style.
     338         * @param string $ver The version of the enqueued style.
     339         * @param string $handle The style's registered handle.
    315340         * @return string
    316341         */
    317342        public function _css_href( $src, $ver, $handle ) {
     
    335360        }
    336361
    337362        /**
     363         * Whether a handle's source is in a default directory.
    338364         *
    339365         * @since 2.8.0
    340366         * @access public
    341367         *
    342          * @param string $src
    343          * @return bool
     368         * @param string $src The source of the enqueued style.
     369         * @return bool True if found, false if not.
    344370         */
    345371        public function in_default_dir( $src ) {
    346372                if ( ! $this->default_dirs )
     
    354380        }
    355381
    356382        /**
     383         * Processes items and dependencies for the footer group.
    357384         *
    358385         * HTML 5 allows styles in the body, grab late enqueued items and output them in the footer.
    359386         *
    360387         * @since 3.3.0
    361388         * @access public
    362389         *
    363          * @return array
     390         * @see WP_Dependencies::do_items()
     391         *
     392         * @return array Handles of items that have been processed.
    364393         */
    365394        public function do_footer_items() {
    366395                $this->do_items(false, 1);
     
    368397        }
    369398
    370399        /**
     400         * Resets class properties.
    371401         *
    372402         * @since 3.3.0
    373403         * @access public
  • src/wp-includes/functions.wp-scripts.php

     
    11<?php
    22/**
    3  * BackPress Scripts Procedural API
     3 * Dependencies API: Scripts
    44 *
    55 * @since 2.6.0
    66 *
    77 * @package WordPress
    8  * @subpackage BackPress
     8 * @subpackage Dependencies
    99 */
    1010
    1111/**
  • src/wp-includes/functions.wp-styles.php

     
    11<?php
    22/**
    3  * BackPress Styles Procedural API
     3 * Dependencies API: Styles
    44 *
    55 * @since 2.6.0
    66 *
    77 * @package WordPress
    8  * @subpackage BackPress
     8 * @subpackage Dependencies
    99 */
    1010
    1111/**
  • src/wp-includes/script-loader.php

     
    33 * WordPress scripts and styles default loader.
    44 *
    55 * Most of the functionality that existed here was moved to
    6  * {@link http://backpress.automattic.com/ BackPress}. WordPress themes and
     6 * {@link http://backpress.org/ BackPress}. WordPress themes and
    77 * plugins will only be concerned about the filters and actions set in this
    88 * file.
    99 *