Make WordPress Core

Ticket #28885: 28885.diff

File 28885.diff, 45.0 KB (added by DrewAPicture, 11 years ago)
  • src/wp-admin/custom-background.php

     
    5959        }
    6060
    6161        /**
    62          * Make private properties readable for backwards compatibility
     62         * Make private properties readable for backwards compatibility.
    6363         *
    6464         * @since 4.0.0
    65          * @param string $name
    66          * @return mixed
     65         * @access public
     66         *
     67         * @param string $name Property name.
     68         * @return mixed Property.
    6769         */
    6870        public function __get( $name ) {
    6971                return $this->$name;
    7072        }
    7173
    7274        /**
    73          * Make private properties setable for backwards compatibility
     75         * Make private properties setable for backwards compatibility.
    7476         *
    7577         * @since 4.0.0
    76          * @param string $name
    77          * @param string $value
    78          * @return mixed
     78         * @access public
     79         *
     80         * @param string $name  Property to set.
     81         * @param mixed  $value Property value.
     82         * @return mixed Newly-set property.
    7983         */
    8084        public function __set( $name, $value ) {
    8185                return $this->$name = $value;
    8286        }
    8387
    8488        /**
    85          * Make private properties checkable for backwards compatibility
     89         * Make private properties checkable for backwards compatibility.
    8690         *
    8791         * @since 4.0.0
    88          * @param string $name
    89          * @return mixed
     92         * @access public
     93         *
     94         * @param string $name Property to check if set.
     95         * @return bool Whether the property is set.
    9096         */
    9197        public function __isset( $name ) {
    9298                return isset( $this->$name );
     
    96102         * Make private properties unsetable for backwards compatibility
    97103         *
    98104         * @since 4.0.0
    99          * @param string $name
    100          * @return mixed
     105         * @access public
     106         *
     107         * @param string $name Property to unset.
    101108         */
    102109        public function __unset( $name ) {
    103110                unset( $this->$name );
  • src/wp-admin/custom-header.php

     
    8484         * Make private properties readable for backwards compatibility
    8585         *
    8686         * @since 4.0.0
    87          * @param string $name
    88          * @return mixed
     87         * @access public
     88         *
     89         * @param string $name Property to get.
     90         * @return mixed Property.
    8991         */
    9092        public function __get( $name ) {
    9193                return $this->$name;
     
    9597         * Make private properties setable for backwards compatibility
    9698         *
    9799         * @since 4.0.0
    98          * @param string $name
    99          * @param string $value
    100          * @return mixed
     100         * @access public
     101         *
     102         * @param string $name  Property to set.
     103         * @param mixed  $value Property value.
     104         * @return mixed Newly-set property.
    101105         */
    102106        public function __set( $name, $value ) {
    103107                return $this->$name = $value;
     
    107111         * Make private properties checkable for backwards compatibility
    108112         *
    109113         * @since 4.0.0
    110          * @param string $name
    111          * @return mixed
     114         * @access public
     115         *
     116         * @param string $name Property to check if set.
     117         * @return bool Whether the property is set.
    112118         */
    113119        public function __isset( $name ) {
    114120                return isset( $this->$name );
     
    118124         * Make private properties unsetable for backwards compatibility
    119125         *
    120126         * @since 4.0.0
    121          * @param string $name
    122          * @return mixed
     127         * @access public
     128         *
     129         * @param string $name Property to unset.
    123130         */
    124131        public function __unset( $name ) {
    125132                unset( $this->$name );
  • src/wp-admin/includes/ajax-actions.php

     
    130130         *
    131131         * @since 4.0.0
    132132         *
    133          * @param int $characters The minimum number of characters required. Default 2.
    134          * @param object $tax The taxonomy object.
    135          * @param string $s The search term.
     133         * @param int    $characters The minimum number of characters required. Default 2.
     134         * @param object $tax        The taxonomy object.
     135         * @param string The search term.
    136136         */
    137137        $term_search_min_chars = (int) apply_filters( 'term_search_min_chars', 2, $tax, $s );
    138138
     
    26082608 * Apply [embed] handlers to a string.
    26092609 *
    26102610 * @since 4.0.0
     2611 *
     2612 * @global WP_Post  $post     Global $post.
     2613 * @global WP_Embed $wp_embed Embed API instance.
    26112614 */
    26122615function wp_ajax_parse_embed() {
    26132616        global $post, $wp_embed;
  • src/wp-admin/includes/class-wp-filesystem-base.php

     
    4040        public $method = '';
    4141
    4242        /**
    43          * Make private properties readable for backwards compatibility
     43         * Make private properties readable for backwards compatibility.
    4444         *
    4545         * @since 4.0.0
     46         * @access public
     47         *
    4648         * @param string $name
    4749         * @return mixed
    4850         */
     
    5153        }
    5254
    5355        /**
    54          * Make private properties setable for backwards compatibility
     56         * Make private properties setable for backwards compatibility.
    5557         *
    5658         * @since 4.0.0
    57          * @param string $name
    58          * @param string $value
    59          * @return mixed
     59         * @access public
     60         *
     61         * @param string $name  Property to set.
     62         * @param mixed  $value Property value.
     63         * @return mixed Newly-set property.
    6064         */
    6165        public function __set( $name, $value ) {
    6266                return $this->$name = $value;
    6367        }
    6468
    6569        /**
    66          * Make private properties checkable for backwards compatibility
     70         * Make private properties checkable for backwards compatibility.
    6771         *
    6872         * @since 4.0.0
    69          * @param string $name
    70          * @return mixed
     73         * @access public
     74         *
     75         * @param string $name Property to check if set.
     76         * @return bool Whether the property is set.
    7177         */
    7278        public function __isset( $name ) {
    7379                return isset( $this->$name );
     
    7783         * Make private properties unsetable for backwards compatibility
    7884         *
    7985         * @since 4.0.0
    80          * @param string $name
    81          * @return mixed
     86         * @access public
     87         *
     88         * @param string $name Property to unset.
    8289         */
    8390        public function __unset( $name ) {
    8491                unset( $this->$name );
  • src/wp-admin/includes/class-wp-list-table.php

     
    9696        }
    9797
    9898        /**
    99          * Make private properties readable for backwards compatibility
     99         * Make private properties readable for backwards compatibility.
    100100         *
    101101         * @since 4.0.0
    102          * @param string $name
    103          * @return mixed
     102         * @access publc
     103         *
     104         * @param string $name Property to get.
     105         * @return mixed Property.
    104106         */
    105107        public function __get( $name ) {
    106108                return $this->$name;
    107109        }
    108110
    109111        /**
    110          * Make private properties setable for backwards compatibility
     112         * Make private properties setable for backwards compatibility.
    111113         *
    112114         * @since 4.0.0
    113          * @param string $name
    114          * @param string $value
    115          * @return mixed
     115         * @access public
     116         *
     117         * @param string $name  Propert to set.
     118         * @param mixed  $value Property value.
     119         * @return mixed Newly-set property.
    116120         */
    117121        public function __set( $name, $value ) {
    118122                return $this->$name = $value;
    119123        }
    120124
    121125        /**
    122          * Make private properties checkable for backwards compatibility
     126         * Make private properties checkable for backwards compatibility.
    123127         *
    124128         * @since 4.0.0
    125          * @param string $name
    126          * @return mixed
     129         * @access public
     130         *
     131         * @param string $name Property to check if set.
     132         * @return bool Whether the property is set.
    127133         */
    128134        public function __isset( $name ) {
    129135                return isset( $this->$name );
    130136        }
    131137
    132138        /**
    133          * Make private properties unsetable for backwards compatibility
     139         * Make private properties unsetable for backwards compatibility.
    134140         *
    135141         * @since 4.0.0
    136          * @param string $name
    137          * @return mixed
     142         * @access public
     143         *
     144         * @param string $name Property to unset.
    138145         */
    139146        public function __unset( $name ) {
    140147                unset( $this->$name );
    141148        }
    142149
    143150        /**
    144          * Make private/protected methods readable for backwards compatibility
     151         * Make private/protected methods readable for backwards compatibility.
    145152         *
    146153         * @since 4.0.0
    147          * @param string $name
    148          * @param array $arguments
    149          * @return mixed
     154         * @access public
     155         *
     156         * @param callable $name      Method to call.
     157         * @param array    $arguments Arguments to pass when calling.
     158         * @return mixed|bool Return value of the callback, false otherwise.
    150159         */
    151160        public function __call( $name, $arguments ) {
    152161                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-admin/includes/class-wp-plugin-install-list-table.php

     
    282282                        /**
    283283                         * Filter the details link for a plugin.
    284284                         *
    285                          * @since 4.0
     285                         * @since 4.0.0
    286286                         *
    287287                         * @param array $details_link Link to view the current plugin's details.
    288288                         * @param array $plugin       The plugin currently being listed.
  • src/wp-admin/includes/meta-boxes.php

     
    4242        $preview_button = __( 'Preview Changes' );
    4343} else {
    4444        $preview_link = set_url_scheme( get_permalink( $post->ID ) );
     45
    4546        /**
    4647         * Filter the URI of a post preview in the post submit box.
    4748         *
  • src/wp-admin/includes/upgrade.php

     
    21832183}
    21842184
    21852185/**
    2186  * Gets available translations from the WordPress.org API.
     2186 * Get available translations from the WordPress.org API.
    21872187 *
    21882188 * @since 4.0.0
    21892189 *
     2190 * @see wp_remote_post()
     2191 *
    21902192 * @return array Array of translations, each an array of data.
    21912193 */
    21922194function wp_get_available_translations_from_api() {
     
    22142216}
    22152217
    22162218/**
    2217  * Downloads a language pack.
     2219 * Download a language pack.
    22182220 *
    22192221 * @since 4.0.0
    22202222 *
     2223 * @see wp_get_available_translations_from_api()
     2224 *
    22212225 * @param string $download Language code to download.
    2222  * @return string|false Returns the language code if successfully downloaded
    2223  *                      (or already installed), or false on failure.
     2226 * @return string|bool Returns the language code if successfully downloaded
     2227 *                     (or already installed), or false on failure.
    22242228 */
    22252229function wp_install_download_language_pack( $download ) {
    22262230        // Check if the translation is already installed.
     
    22612265 *
    22622266 * @since 4.0.0
    22632267 *
     2268 * @see load_textdomain()
     2269 *
    22642270 * @param string $translation Translation to load.
    2265  * @return string|false Returns the language code if successfully loaded,
    2266  *                      or false on failure.
     2271 * @return string|bool Returns the language code if successfully loaded,
     2272 *                     or false on failure.
    22672273 */
    22682274function wp_install_load_language( $translation ) {
    22692275        if ( ! empty( $translation ) ) {
  • src/wp-includes/cache.php

     
    310310         * Make private properties readable for backwards compatibility
    311311         *
    312312         * @since 4.0.0
    313          * @param string $name
    314          * @return mixed
     313         * @access public
     314         *
     315         * @param string $name Property to get.
     316         * @return mixed Property.
    315317         */
    316318        public function __get( $name ) {
    317319                return $this->$name;
     
    321323         * Make private properties setable for backwards compatibility
    322324         *
    323325         * @since 4.0.0
    324          * @param string $name
    325          * @param string $value
    326          * @return mixed
     326         * @access public
     327         *
     328         * @param string $name  Property to set.
     329         * @param mixed  $value Property value.
     330         * @return mixed Newly-set property.
    327331         */
    328332        public function __set( $name, $value ) {
    329333                return $this->$name = $value;
     
    333337         * Make private properties checkable for backwards compatibility
    334338         *
    335339         * @since 4.0.0
    336          * @param string $name
    337          * @return mixed
     340         * @access public
     341         *
     342         * @param string $name Property to check if set.
     343         * @return bool Whether the property is set.
    338344         */
    339345        public function __isset( $name ) {
    340346                return isset( $this->$name );
     
    344350         * Make private properties unsetable for backwards compatibility
    345351         *
    346352         * @since 4.0.0
    347          * @param string $name
    348          * @return mixed
     353         * @access public
     354         *
     355         * @param string $name Property to unset.
    349356         */
    350357        public function __unset( $name ) {
    351358                unset( $this->$name );
  • src/wp-includes/capabilities.php

     
    8282        }
    8383
    8484        /**
    85          * Make private/protected methods readable for backwards compatibility
     85         * Make private/protected methods readable for backwards compatibility.
    8686         *
    8787         * @since 4.0.0
    88          * @param string $name
    89          * @param array $arguments
    90          * @return mixed
     88         * @access public
     89         *
     90         * @param callable $name      Method to call.
     91         * @param array    $arguments Arguments to pass when calling.
     92         * @return mixed|bool Return value of the callback, false otherwise.
    9193         */
    9294        public function __call( $name, $arguments ) {
    9395                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-includes/class-oembed.php

     
    160160         * Make private/protected methods readable for backwards compatibility
    161161         *
    162162         * @since 4.0.0
    163          * @param string $name
    164          * @param array $arguments
    165          * @return mixed
     163         * @access public
     164         *
     165         * @param callable $name      Method to call.
     166         * @param array    $arguments Arguments to pass when calling.
     167         * @return mixed|bool Return value of the callback, false otherwise.
    166168         */
    167169        public function __call( $name, $arguments ) {
    168170                return call_user_func_array( array( $this, $name ), $arguments );
     
    171173        /**
    172174         * Takes a URL and returns the corresponding oEmbed provider's URL, if there is one.
    173175         *
     176         * @since 4.0.0
     177         * @access public
     178         *
    174179         * @see WP_oEmbed::discover()
    175180         *
    176          * @param string $url  The URL to the content.
    177          * @param array  $args Optional arguments.
     181         * @param string        $url  The URL to the content.
     182         * @param string|array  $args Optional provider arguments.
    178183         * @return bool|string False on failure, otherwise the oEmbed provider URL.
    179          * @since 4.0.0
    180184         */
    181185        public function get_provider( $url, $args = '' ) {
    182186
     
    213217         * The just-in-time addition is for the benefit of the 'oembed_providers' filter.
    214218         *
    215219         * @since 4.0.0
     220         * @access public
    216221         * @static
    217222         *
    218223         * @see wp_oembed_add_provider()
    219224         *
    220          * @param string $format   The format of URL that this provider can handle. You can use
     225         * @param string $format   Format of URL that this provider can handle. You can use
    221226         *                         asterisks as wildcards.
    222227         * @param string $provider The URL to the oEmbed provider..
    223228         * @param bool   $regex    Optional. Whether the $format parameter is in a regex format.
     
    238243         * The just-in-time removal is for the benefit of the 'oembed_providers' filter.
    239244         *
    240245         * @since 4.0.0
     246         * @access public
    241247         * @static
    242248         *
    243249         * @see wp_oembed_remove_provider()
  • src/wp-includes/class-wp-ajax-response.php

     
    3030        }
    3131
    3232        /**
    33          * Make private properties readable for backwards compatibility
     33         * Make private properties readable for backwards compatibility.
    3434         *
    3535         * @since 4.0.0
    36          * @param string $name
    37          * @return mixed
     36         * @access public
     37         *
     38         * @param string $name Property to get.
     39         * @return mixed Property.
    3840         */
    3941        public function __get( $name ) {
    4042                return $this->$name;
    4143        }
    4244
    4345        /**
    44          * Make private properties setable for backwards compatibility
     46         * Make private properties setable for backwards compatibility.
    4547         *
    4648         * @since 4.0.0
    47          * @param string $name
    48          * @param string $value
    49          * @return mixed
     49         * @access public
     50         *
     51         * @param string $name  Property to set.
     52         * @param mixed  $value Property value.
     53         * @return mixed Newly-set property.
    5054         */
    5155        public function __set( $name, $value ) {
    5256                return $this->$name = $value;
    5357        }
    5458
    5559        /**
    56          * Make private properties checkable for backwards compatibility
     60         * Make private properties checkable for backwards compatibility.
    5761         *
    5862         * @since 4.0.0
    59          * @param string $name
    60          * @return mixed
     63         * @access public
     64         *
     65         * @param string $name Property to check if set.
     66         * @return bool Whether the property is set.
    6167         */
    6268        public function __isset( $name ) {
    6369                return isset( $this->$name );
    6470        }
    6571
    6672        /**
    67          * Make private properties unsetable for backwards compatibility
     73         * Make private properties unsetable for backwards compatibility.
    6874         *
    6975         * @since 4.0.0
    70          * @param string $name
    71          * @return mixed
     76         * @access public
     77         *
     78         * @param string $name Property to unset.
    7279         */
    7380        public function __unset( $name ) {
    7481                unset( $this->$name );
  • src/wp-includes/class-wp-customize-control.php

     
    8686        public $type = 'text';
    8787
    8888        /**
    89          * Callback
     89         * Callback.
    9090         *
    9191         * @since 4.0.0
     92         * @access public
    9293         *
    93          * @access public
    9494         * @see WP_Customize_Control::active()
    95          * @var callable  Callback is called with one argument, the instance of
    96          *                WP_Customize_Control, and returns bool to indicate whether
    97          *                the control is active (such as it relates to the URL
    98          *                currently being previewed).
     95         *
     96         * @var callable Callback is called with one argument, the instance of
     97         *               WP_Customize_Control, and returns bool to indicate whether
     98         *               the control is active (such as it relates to the URL
     99         *               currently being previewed).
    99100         */
    100101        public $active_callback = '';
    101102
     
    154155         * Check whether control is active to current customizer preview.
    155156         *
    156157         * @since 4.0.0
     158         * @access public
    157159         *
    158          * @return bool
     160         * @return bool Whether the control is active to the current preview.
    159161         */
    160162        public final function active() {
    161163                $control = $this;
     
    166168                 *
    167169                 * @since 4.0.0
    168170                 *
    169                  * @param bool $active
    170                  * @param WP_Customize_Control $control
     171                 * @param bool                 $active  Whether the Customizer control is active.
     172                 * @param WP_Customize_Control $control WP_Customize_Control instance.
    171173                 */
    172174                $active = apply_filters( 'customize_control_active', $active, $control );
    173175
     
    180182         * Subclasses can override this with their specific logic, or they may
    181183         * provide an 'active_callback' argument to the constructor.
    182184         *
    183          * @return bool
     185         * @since 4.0.0
     186         * @access public
     187         *
     188         * @return bool Always true.
    184189         */
    185190        public function active_callback() {
    186191                return true;
     
    315320         * Render the custom attributes for the control's input element.
    316321         *
    317322         * @since 4.0.0
     323         * @access public
    318324         */
    319325        public function input_attrs() {
    320326                foreach( $this->input_attrs as $attr => $value ) {
     
    10521058        }
    10531059
    10541060        /**
    1055          * @return bool
     1061         * Whether the current sidebar is rendered on the page.
     1062         *
     1063         * @since 4.0.0
     1064         * @access public
     1065         *
     1066         * @return bool Whether sidebar is rendered.
    10561067         */
    1057         function active_callback() {
     1068        public function active_callback() {
    10581069                return $this->manager->widgets->is_sidebar_rendered( $this->sidebar_id );
    10591070        }
    10601071}
     
    10991110        }
    11001111
    11011112        /**
    1102          * @return bool
     1113         * Whether the current widget is rendered on the page.
     1114         *
     1115         * @since 4.0.0
     1116         * @access public
     1117         *
     1118         * @return bool Whether the widget is rendered.
    11031119         */
    11041120        function active_callback() {
    11051121                return $this->manager->widgets->is_widget_rendered( $this->widget_id );
  • src/wp-includes/class-wp-customize-manager.php

     
    319319         * Get the registered panels.
    320320         *
    321321         * @since 4.0.0
     322         * @access public
    322323         *
    323          * @return array
     324         * @return array Panels.
    324325         */
    325326        public function panels() {
    326327                return $this->panels;
     
    433434         * preview, since it causes the jQuery Ajax to fail. Send 200 instead.
    434435         *
    435436         * @since 4.0.0
     437         * @access public
    436438         */
    437439        public function customize_preview_override_404_status() {
    438440                if ( is_404() ) {
     
    680682         * Add a customize panel.
    681683         *
    682684         * @since 4.0.0
     685         * @access public
    683686         *
    684687         * @param WP_Customize_Panel|string $id   Customize Panel object, or Panel ID.
    685          * @param array                     $args Panel arguments.
     688         * @param array                     $args Optional. Panel arguments. Default empty array.
    686689         */
    687690        public function add_panel( $id, $args = array() ) {
    688691                if ( is_a( $id, 'WP_Customize_Panel' ) ) {
     
    699702         * Retrieve a customize panel.
    700703         *
    701704         * @since 4.0.0
     705         * @access public
    702706         *
    703          * @param string $id Panel ID.
    704          * @return WP_Customize_Panel
     707         * @param string $id Panel ID to get.
     708         * @return WP_Customize_Panel Requested panel instance.
    705709         */
    706710        public function get_panel( $id ) {
    707711                if ( isset( $this->panels[ $id ] ) ) {
     
    713717         * Remove a customize panel.
    714718         *
    715719         * @since 4.0.0
     720         * @access public
    716721         *
    717          * @param string $id Panel ID.
     722         * @param string $id Panel ID to remove.
    718723         */
    719724        public function remove_panel( $id ) {
    720725                unset( $this->panels[ $id ] );
  • src/wp-includes/class-wp-customize-section.php

     
    218218         * Any supplied $args override class property defaults.
    219219         *
    220220         * @since 4.0.0
     221         * @access public
    221222         *
    222223         * @param WP_Customize_Manager $manager Customizer bootstrap instance.
    223224         * @param string               $id      An specific ID of the section.
    224          * @param array                $args    Section arguments.
     225         * @param array                $args    Optional. Section arguments. Default empty array.
    225226         */
    226227        public function __construct( $manager, $id, $args = array() ) {
    227228                parent::__construct( $manager, $id, $args );
     
    235236         * Render the panel, and the sections that have been added to it.
    236237         *
    237238         * @since 4.0.0
     239         * @access protected
    238240         */
    239241        protected function render() {
    240242                ?>
  • src/wp-includes/class-wp-customize-widgets.php

     
    10771077         * @since 4.0.0
    10781078         * @access public
    10791079         *
    1080          * @param string $widget_id
    1081          * @return bool
     1080         * @param string $widget_id Widget ID to check.
     1081         * @return bool Whether the widget is rendered.
    10821082         */
    10831083        public function is_widget_rendered( $widget_id ) {
    10841084                return in_array( $widget_id, $this->rendered_widgets );
     
    10901090         * @since 4.0.0
    10911091         * @access public
    10921092         *
    1093          * @param string $sidebar_id
    1094          * @return bool
     1093         * @param string $sidebar_id Sidebar ID to check.
     1094         * @return bool Whether the sidebar is rendered.
    10951095         */
    10961096        public function is_sidebar_rendered( $sidebar_id ) {
    10971097                return in_array( $sidebar_id, $this->rendered_sidebars );
     
    11081108         * @since 3.9.0
    11091109         * @access public
    11101110         *
    1111          * @param bool    $is_active  Whether the sidebar is active.
    1112          * @pasram string $sidebar_id Sidebar ID.
     1111         * @param bool   $is_active  Whether the sidebar is active.
     1112         * @param string $sidebar_id Sidebar ID.
    11131113         */
    11141114        public function tally_sidebars_via_is_active_sidebar_calls( $is_active, $sidebar_id ) {
    11151115                if ( isset( $GLOBALS['wp_registered_sidebars'][$sidebar_id] ) ) {
  • src/wp-includes/class-wp-embed.php

     
    198198                         *
    199199                         * @since 4.0.0
    200200                         *
     201                         * @param int    $time    Time to live (in seconds).
    201202                         * @param string $url     The attempted embed URL.
    202203                         * @param array  $attr    An array of shortcode attributes.
    203204                         * @param int    $post_ID Post ID.
  • src/wp-includes/class-wp-error.php

     
    6666        }
    6767
    6868        /**
    69          * Make private properties readable for backwards compatibility
     69         * Make private properties readable for backwards compatibility.
    7070         *
    7171         * @since 4.0.0
    72          * @param string $name
    73          * @return mixed
     72         * @access public
     73         *
     74         * @param string $name Property to get.
     75         * @return mixed Property.
    7476         */
    7577        public function __get( $name ) {
    7678                return $this->$name;
    7779        }
    7880
    7981        /**
    80          * Make private properties setable for backwards compatibility
     82         * Make private properties setable for backwards compatibility.
    8183         *
    8284         * @since 4.0.0
    83          * @param string $name
    84          * @param string $value
    85          * @return mixed
     85         * @access public
     86         *
     87         * @param string $name  Property to set.
     88         * @param mixed  $value Property value.
     89         * @return mixed Newly-set property.
    8690         */
    8791        public function __set( $name, $value ) {
    8892                return $this->$name = $value;
    8993        }
    9094
    9195        /**
    92          * Make private properties checkable for backwards compatibility
     96         * Make private properties checkable for backwards compatibility.
    9397         *
    9498         * @since 4.0.0
    95          * @param string $name
    96          * @return mixed
     99         * @access public
     100         *
     101         * @param string $name Property to check if set.
     102         * @return bool Whether the property is set.
    97103         */
    98104        public function __isset( $name ) {
    99105                return isset( $this->$name );
    100106        }
    101107
    102108        /**
    103          * Make private properties unsetable for backwards compatibility
     109         * Make private properties unsetable for backwards compatibility.
    104110         *
    105111         * @since 4.0.0
    106          * @param string $name
    107          * @return mixed
     112         * @access public
     113         *
     114         * @param string $name Property to unset.
    108115         */
    109116        public function __unset( $name ) {
    110117                unset( $this->$name );
  • src/wp-includes/class-wp-walker.php

     
    1616         * What the class handles.
    1717         *
    1818         * @since 2.1.0
     19         * @access public
    1920         * @var string
    20          * @access public
    2121         */
    2222        public $tree_type;
    2323
     
    2525         * DB fields to use.
    2626         *
    2727         * @since 2.1.0
     28         * @access protected
    2829         * @var array
    29          * @access protected
    3030         */
    3131        protected $db_fields;
    3232
     
    3434         * Max number of pages walked by the paged walker
    3535         *
    3636         * @since 2.7.0
     37         * @access protected
    3738         * @var int
    38          * @access protected
    3939         */
    4040        protected $max_pages = 1;
    4141
     
    4343         * Wether the current element has children or not. To be used in start_el()
    4444         *
    4545         * @since 4.0.0
     46         * @access protected
    4647         * @var bool
    47          * @access protected
    4848         */
    4949        protected $has_children;
    5050
     
    5252         * Make private properties readable for backwards compatibility
    5353         *
    5454         * @since 4.0.0
    55          * @param string $name
    56          * @return mixed
     55         * @access public
     56         *
     57         * @param string $name Property to get.
     58         * @return mixed Property.
    5759         */
    5860        public function __get( $name ) {
    5961                return $this->$name;
     
    6365         * Make private properties setable for backwards compatibility
    6466         *
    6567         * @since 4.0.0
    66          * @param string $name
    67          * @param string $value
    68          * @return mixed
     68         * @access public
     69         *
     70         * @param string $name  Property to set.
     71         * @param mixed  $value Property value.
     72         * @return mixed Newly-set property.
    6973         */
    7074        public function __set( $name, $value ) {
    7175                return $this->$name = $value;
     
    7579         * Make private properties checkable for backwards compatibility
    7680         *
    7781         * @since 4.0.0
    78          * @param string $name
    79          * @return mixed
     82         * @access public
     83         *
     84         * @param string $name Property to check if set.
     85         * @return bool Whether the property is set.
    8086         */
    8187        public function __isset( $name ) {
    8288                return isset( $this->$name );
     
    8692         * Make private properties unsetable for backwards compatibility
    8793         *
    8894         * @since 4.0.0
    89          * @param string $name
    90          * @return mixed
     95         * @access public
     96         *
     97         * @param string $name Property to unset.
    9198         */
    9299        public function __unset( $name ) {
    93100                unset( $this->$name );
  • src/wp-includes/class-wp-xmlrpc-server.php

     
    145145         * Make private/protected methods readable for backwards compatibility
    146146         *
    147147         * @since 4.0.0
    148          * @param string $name
    149          * @param array $arguments
    150          * @return mixed
     148         * @access public
     149         *
     150         * @param callable $name      Method to call.
     151         * @param array    $arguments Arguments to pass when calling.
     152         * @return mixed|bool Return value of the callback, false otherwise.
    151153         */
    152154        public function __call( $name, $arguments ) {
    153155                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-includes/class-wp.php

     
    663663        public $_pattern = '(\$matches\[[1-9]+[0-9]*\])'; // magic number
    664664
    665665        /**
    666          * Make private properties readable for backwards compatibility
     666         * Make private properties readable for backwards compatibility.
    667667         *
    668668         * @since 4.0.0
    669          * @param string $name
    670          * @return mixed
     669         * @access public
     670         *
     671         * @param string $name Property to get.
     672         * @return mixed Property.
    671673         */
    672674        public function __get( $name ) {
    673675                return $this->$name;
    674676        }
    675677
    676678        /**
    677          * Make private properties setable for backwards compatibility
     679         * Make private properties setable for backwards compatibility.
    678680         *
    679681         * @since 4.0.0
    680          * @param string $name
    681          * @param string $value
    682          * @return mixed
     682         * @access public
     683         *
     684         * @param string $name  Property to set.
     685         * @param mixed  $value Property value.
     686         * @return mixed Newly-set property.
    683687         */
    684688        public function __set( $name, $value ) {
    685689                return $this->$name = $value;
    686690        }
    687691
    688692        /**
    689          * Make private properties checkable for backwards compatibility
     693         * Make private properties checkable for backwards compatibility.
    690694         *
    691695         * @since 4.0.0
    692          * @param string $name
    693          * @return mixed
     696         * @access public
     697         *
     698         * @param string $name Property to check if set.
     699         * @return bool Whether the property is set.
    694700         */
    695701        public function __isset( $name ) {
    696702                return isset( $this->$name );
    697703        }
    698704
    699705        /**
    700          * Make private properties unsetable for backwards compatibility
     706         * Make private properties unsetable for backwards compatibility.
    701707         *
    702708         * @since 4.0.0
    703          * @param string $name
    704          * @return mixed
     709         * @access public
     710         *
     711         * @param string $name Property to unset.
    705712         */
    706713        public function __unset( $name ) {
    707714                unset( $this->$name );
    708715        }
    709716
    710717        /**
    711          * Make private/protected methods readable for backwards compatibility
     718         * Make private/protected methods readable for backwards compatibility.
    712719         *
    713720         * @since 4.0.0
    714          * @param string $name
    715          * @param array $arguments
    716          * @return mixed
     721         * @access public
     722         *
     723         * @param callable $name      Method to call.
     724         * @param array    $arguments Arguments to pass when calling.
     725         * @return mixed|bool Return value of the callback, false otherwise.
    717726         */
    718727        public function __call( $name, $arguments ) {
    719728                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-includes/comment-template.php

     
    19401940         *
    19411941         * @since 4.0.0
    19421942         *
     1943         * @see wp_list_comments()
     1944         *
    19431945         * @param array $r An array of arguments for displaying comments.
    19441946         */
    19451947        $r = apply_filters( 'wp_list_comments_args', $r );
  • src/wp-includes/comment.php

     
    224224         * Make private/protected methods readable for backwards compatibility
    225225         *
    226226         * @since 4.0.0
    227          * @param string $name
    228          * @param array $arguments
    229          * @return mixed
     227         * @access public
     228         *
     229         * @param callable $name      Method to call.
     230         * @param array    $arguments Arguments to pass when calling.
     231         * @return mixed|bool Return value of the callback, false otherwise.
    230232         */
    231233        public function __call( $name, $arguments ) {
    232234                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-includes/formatting.php

     
    4040        // Set up static variables. Run once only.
    4141        if ( $reset || ! isset( $static_characters ) ) {
    4242                /**
    43                  * Filter whether to skip running `wptexturize()`.
     43                 * Filter whether to skip running wptexturize().
    4444                 *
    45                  * Passing false to the filter will effectively short-circuit `wptexturize()`.
     45                 * Passing false to the filter will effectively short-circuit wptexturize().
    4646                 * returning the original text passed to the function instead.
    4747                 *
    48                  * The filter runs only once, the first time `wptexturize()` is called.
     48                 * The filter runs only once, the first time wptexturize() is called.
    4949                 *
    5050                 * @since 4.0.0
    5151                 *
    52                  * @param bool $run_texturize Whether to short-circuit `wptexturize()`.
     52                 * @see wptexturize()
     53                 *
     54                 * @param bool $run_texturize Whether to short-circuit wptexturize().
    5355                 */
    5456                $run_texturize = apply_filters( 'run_wptexturize', $run_texturize );
    5557                if ( false === $run_texturize ) {
  • src/wp-includes/functions.php

     
    35063506 *
    35073507 * @since 4.0.0
    35083508 *
    3509  * @param  string  $url The URL
    3510  * @return bool True if the given URL uses https, false if not (or if the URL is not valid).
     3509 * @param string $url The URL.
     3510 * @return bool True if the given URL uses https, false if not (or if the URL
     3511 *              is not valid).
    35113512 */
    35123513function is_https_url( $url ) {
    35133514        return ( 'https' === parse_url( $url, PHP_URL_SCHEME ) );
  • src/wp-includes/l10n.php

     
    821821 * Language selector. More to come.
    822822 *
    823823 * @since 4.0.0
     824 *
     825 * @see get_available_languages()
     826 *
     827 * @param array $args Optional arguments. Default empty array.
    824828 */
    825829function wp_dropdown_languages( $args = array() ) {
    826830        if ( isset( $args['languages'] ) ) {
  • src/wp-includes/media.php

     
    22812281}
    22822282
    22832283/**
    2284  * The YouTube embed handler callback. Catches URLs that can be parsed but aren't supported by oEmbed.
     2284 * YouTube embed handler callback.
    22852285 *
     2286 * Catches URLs that can be parsed but aren't supported by oEmbed.
     2287 *
    22862288 * @since 4.0.0
    22872289 *
    2288  * @param array $matches The regex matches from the provided regex when calling {@link wp_embed_register_handler()}.
    2289  * @param array $attr Embed attributes.
    2290  * @param string $url The original URL that was matched by the regex.
    2291  * @param array $rawattr The original unmodified attributes.
     2290 * @param array  $matches The regex matches from the provided regex when calling {@link wp_embed_register_handler()}.
     2291 * @param array  $attr    Embed attributes.
     2292 * @param string $url     The original URL that was matched by the regex.
     2293 * @param array  $rawattr The original unmodified attributes.
    22922294 * @return string The embed HTML.
    22932295 */
    22942296function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
     
    22992301         *
    23002302         * @since 4.0.0
    23012303         *
     2304         * @see wp_embed_handler_youtube()
     2305         *
    23022306         * @param string $embed   YouTube embed output.
    23032307         * @param array  $attr    An array of embed attributes.
    23042308         * @param string $url     The original URL that was matched by the regex.
     
    32323236 * @since 4.0.0
    32333237 *
    32343238 * @global wpdb $wpdb WordPress database access abstraction object.
     3239 *
    32353240 * @param string $url The URL to resolve.
    3236  * @return int The found post_id.
     3241 * @return int The found post ID.
    32373242 */
    32383243function attachment_url_to_postid( $url ) {
    32393244        global $wpdb;
  • src/wp-includes/ms-blogs.php

     
    910910 *
    911911 * @since 4.0
    912912 *
    913  * @param int $post_id Post ID
     913 * @param int $post_id Post ID.
    914914 */
    915915function _update_posts_count_on_delete( $post_id ) {
    916916        if ( 'publish' !== get_post_field( 'post_status', $post_id ) ) {
  • src/wp-includes/query.php

     
    39323932        }
    39333933
    39343934        /**
    3935          * Make private properties readable for backwards compatibility
     3935         * Make private properties readable for backwards compatibility.
    39363936         *
    39373937         * @since 4.0.0
    3938          * @param string $name
    3939          * @return mixed
     3938         * @access public
     3939         *
     3940         * @param string $name Property to get
     3941         * @return mixed Property.
    39403942         */
    39413943        public function __get( $name ) {
    39423944                return $this->$name;
    39433945        }
    39443946
    39453947        /**
    3946          * Make private properties setable for backwards compatibility
     3948         * Make private properties setable for backwards compatibility.
    39473949         *
    39483950         * @since 4.0.0
    3949          * @param string $name
    3950          * @return mixed
     3951         * @access public
     3952         *
     3953         * @param string $name Property to check if set.
     3954         * @return bool Whether the property is set.
    39513955         */
    39523956        public function __isset( $name ) {
    39533957                return isset( $this->$name );
    39543958        }
    39553959
    39563960        /**
    3957          * Make private properties setable for backwards compatibility
     3961         * Make private properties setable for backwards compatibility.
    39583962         *
    39593963         * @since 4.0.0
    3960          * @param string $name
    3961          * @return mixed
     3964         * @access public
     3965         *
     3966         * @param string $name Property to unset.
    39623967         */
    39633968        public function __unset( $name ) {
    39643969                unset( $this->$name );
    39653970        }
    39663971
    39673972        /**
    3968          * Make private/protected methods readable for backwards compatibility
     3973         * Make private/protected methods readable for backwards compatibility.
    39693974         *
    39703975         * @since 4.0.0
    3971          * @param string $name
    3972          * @param array $arguments
    3973          * @return mixed
     3976         * @access public
     3977         *
     3978         * @param callable $name      Method to call.
     3979         * @param array    $arguments Arguments to pass when calling.
     3980         * @return mixed|bool Return value of the callback, otherwise false.
    39743981         */
    39753982        public function __call( $name, $arguments ) {
    39763983                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-includes/theme.php

     
    19471947 *
    19481948 * @since 4.0.0
    19491949 *
     1950 * @global WP_Customize_Manager $wp_customize Customizer instance.
     1951 *
    19501952 * @return bool True if the site is being previewed in the Customizer, false otherwise.
    19511953 */
    19521954function is_customize_preview() {
  • src/wp-includes/user.php

     
    840840        }
    841841
    842842        /**
    843          * Make private properties readable for backwards compatibility
     843         * Make private properties readable for backwards compatibility.
    844844         *
    845845         * @since 4.0.0
    846          * @param string $name
    847          * @return mixed
     846         * @access public
     847         *
     848         * @param string $name Property to get
     849         * @return mixed Property.
    848850         */
    849851        public function __get( $name ) {
    850852                return $this->$name;
    851853        }
    852854
    853855        /**
    854          * Make private properties setable for backwards compatibility
     856         * Make private properties setable for backwards compatibility.
    855857         *
    856858         * @since 4.0.0
    857          * @param string $name
    858          * @param string $value
    859          * @return mixed
     859         * @access public
     860         *
     861         * @param string $name  Property to set.
     862         * @param mixed  $value Property value.
     863         * @return mixed Newly-set property.
    860864         */
    861865        public function __set( $name, $value ) {
    862866                return $this->$name = $value;
    863867        }
    864868
    865869        /**
    866          * Make private properties checkable for backwards compatibility
     870         * Make private properties checkable for backwards compatibility.
    867871         *
    868872         * @since 4.0.0
    869          * @param string $name
    870          * @return mixed
     873         * @access public
     874         *
     875         * @param string $name Property to check if set.
     876         * @return bool Whether the property is set.
    871877         */
    872878        public function __isset( $name ) {
    873879                return isset( $this->$name );
    874880        }
    875881
    876882        /**
    877          * Make private properties unsetable for backwards compatibility
     883         * Make private properties unsetable for backwards compatibility.
    878884         *
    879885         * @since 4.0.0
    880          * @param string $name
    881          * @return mixed
     886         * @access public
     887         *
     888         * @param string $name Property to unset.
    882889         */
    883890        public function __unset( $name ) {
    884891                unset( $this->$name );
     
    888895         * Make private/protected methods readable for backwards compatibility
    889896         *
    890897         * @since 4.0.0
    891          * @param string $name
    892          * @param array $arguments
    893          * @return mixed
     898         * @access public
     899         *
     900         * @param callable $name      Method to call.
     901         * @param array    $arguments Arguments to pass when calling.
     902         * @return mixed|bool Return value of the callback, false otherwise.
    894903         */
    895904        public function __call( $name, $arguments ) {
    896905                return call_user_func_array( array( $this, $name ), $arguments );
  • src/wp-includes/wp-db.php

     
    11881188         *  $sql  = esc_sql( $wpdb->esc_like( $input ) );
    11891189         *
    11901190         * @since 4.0.0
     1191         * @access public
    11911192         *
    1192          * @param string $text The raw text to be escaped. The input typed by the user should have no extra or deleted slashes.
    1193          * @return string Text in the form of a LIKE phrase. The output is not SQL safe. Call prepare or real_escape next.
     1193         * @param string $text The raw text to be escaped. The input typed by the user should have no
     1194         *                     extra or deleted slashes.
     1195         * @return string Text in the form of a LIKE phrase. The output is not SQL safe. Call $wpdb::prepare()
     1196         *                or real_escape next.
    11941197         */
    1195         function esc_like( $text ) {
     1198        public function esc_like( $text ) {
    11961199                return addcslashes( $text, '_%\\' );
    11971200        }
    11981201
  • src/wp-includes/wp-diff.php

     
    431431        }
    432432
    433433        /**
    434          * Make private properties readable for backwards compatibility
     434         * Make private properties readable for backwards compatibility.
    435435         *
    436436         * @since 4.0.0
    437          * @param string $name
    438          * @return mixed
     437         * @access public
     438         *
     439         * @param string $name Property to get.
     440         * @return mixed Property.
    439441         */
    440442        public function __get( $name ) {
    441443                return $this->$name;
    442444        }
    443445
    444446        /**
    445          * Make private properties setable for backwards compatibility
     447         * Make private properties setable for backwards compatibility.
    446448         *
    447449         * @since 4.0.0
    448          * @param string $name
    449          * @param string $value
    450          * @return mixed
     450         * @access public
     451         *
     452         * @param string $name  Property to check if set.
     453         * @param mixed  $value Property value.
     454         * @return mixed Newly-set property.
    451455         */
    452456        public function __set( $name, $value ) {
    453457                return $this->$name = $value;
    454458        }
    455459
    456460        /**
    457          * Make private properties checkable for backwards compatibility
     461         * Make private properties checkable for backwards compatibility.
    458462         *
    459463         * @since 4.0.0
    460          * @param string $name
    461          * @return mixed
     464         * @access public
     465         *
     466         * @param string $name Property to check if set.
     467         * @return bool Whether the property is set.
    462468         */
    463469        public function __isset( $name ) {
    464470                return isset( $this->$name );
    465471        }
    466472
    467473        /**
    468          * Make private properties unsetable for backwards compatibility
     474         * Make private properties unsetable for backwards compatibility.
    469475         *
    470476         * @since 4.0.0
    471          * @param string $name
    472          * @return mixed
     477         * @access public
     478         *
     479         * @param string $name Property to unset.
    473480         */
    474481        public function __unset( $name ) {
    475482                unset( $this->$name );
    476483        }
    477484
    478485        /**
    479          * Make private/protected methods readable for backwards compatibility
     486         * Make private/protected methods readable for backwards compatibility.
    480487         *
    481488         * @since 4.0.0
    482          * @param string $name
    483          * @param array $arguments
    484          * @return mixed
     489         * @access public
     490         *
     491         * @param callable $name      Method to call.
     492         * @param array    $arguments Arguments to pass when calling.
     493         * @return mixed|bool Return value of the callback, false otherwise.
    485494         */
    486495        public function __call( $name, $arguments ) {
    487496                return call_user_func_array( array( $this, $name ), $arguments );