WordPress.org

Make WordPress Core

Ticket #41756: 41756.patch

File 41756.patch, 10.9 KB (added by janak007, 22 months ago)

I have changed doc parameter for array types as johnbillion suggested.

  • src/wp-admin/includes/class-bulk-theme-upgrader-skin.php

     
    5555                 *
    5656                 * @since 3.0.0
    5757                 *
    58                  * @param array $update_actions Array of theme action links.
    59                  * @param array $theme_info     Array of information for the last-updated theme.
     58                 * @param string[] $update_actions Array of theme action links.
     59                 * @param string[] $theme_info     Array of information for the last-updated theme.
    6060                 */
    6161                $update_actions = apply_filters( 'update_bulk_theme_complete_actions', $update_actions, $this->theme_info );
    6262
  • src/wp-admin/includes/class-walker-nav-menu-edit.php

     
    2424         *
    2525         * @param string $output Passed by reference.
    2626         * @param int    $depth  Depth of menu item. Used for padding.
    27          * @param array  $args   Not used.
     27         * @param string[]  $args   Not used.
    2828         */
    2929        public function start_lvl( &$output, $depth = 0, $args = array() ) {}
    3030
     
    3737         *
    3838         * @param string $output Passed by reference.
    3939         * @param int    $depth  Depth of menu item. Used for padding.
    40          * @param array  $args   Not used.
     40         * @param string[]  $args   Not used.
    4141         */
    4242        public function end_lvl( &$output, $depth = 0, $args = array() ) {}
    4343
     
    5252         * @param string $output Used to append additional content (passed by reference).
    5353         * @param object $item   Menu item data object.
    5454         * @param int    $depth  Depth of menu item. Used for padding.
    55          * @param array  $args   Not used.
     55         * @param string[]  $args   Not used.
    5656         * @param int    $id     Not used.
    5757         */
    5858        public function start_el( &$output, $item, $depth = 0, $args = array(), $id = 0 ) {
  • src/wp-admin/includes/class-wp-upgrader-skin.php

     
    2929        public $options = array();
    3030
    3131        /**
    32          * @param array $args
     32         * @param string[] $args
    3333         */
    3434        public function __construct( $args = array() ) {
    3535                $defaults      = array(
  • src/wp-admin/includes/file.php

     
    124124 *
    125125 * @param string $folder Optional. Full path to folder. Default empty.
    126126 * @param int    $levels Optional. Levels of folders to follow, Default 100 (PHP Loop limit).
    127  * @param array  $exclusions Optional. List of folders and files to skip.
     127 * @param string[]  $exclusions Optional. List of folders and files to skip.
    128128 * @return bool|array False on failure, Else array of files
    129129 */
    130130function list_files( $folder = '', $levels = 100, $exclusions = array() ) {
     
    222222         * @since 4.9.0 Adds $plugin param.
    223223         *
    224224         * @param string $plugin Plugin file.
    225          * @param array $editable_extensions An array of editable plugin file extensions.
     225         * @param string[] $editable_extensions An array of editable plugin file extensions.
    226226         */
    227227        $editable_extensions = (array) apply_filters( 'editable_extensions', $editable_extensions, $plugin );
    228228
     
    277277         *
    278278         * @since 4.4.0
    279279         *
    280          * @param array    $default_types List of file types. Default types include 'php' and 'css'.
     280         * @param string[]    $default_types List of file types. Default types include 'php' and 'css'.
    281281         * @param WP_Theme $theme         The current Theme object.
    282282         */
    283283        $file_types = apply_filters( 'wp_theme_editor_filetypes', $default_types, $theme );
     
    337337 *
    338338 * @since 4.9.0
    339339 *
    340  * @param array $args {
     340 * @param string[] $args {
    341341 *     Args. Note that all of the arg values are already unslashed. They are, however,
    342342 *     coming straight from $_POST and are not validated or sanitized in any way.
    343343 *
     
    663663 * @since 1.5.0
    664664 *
    665665 * @param string $file          File the user is attempting to edit.
    666  * @param array  $allowed_files Optional. Array of allowed files to edit, $file must match an entry exactly.
     666 * @param string[]  $allowed_files Optional. Array of allowed files to edit, $file must match an entry exactly.
    667667 * @return string|null
    668668 */
    669669function validate_file_to_edit( $file, $allowed_files = array() ) {
     
    694694 *
    695695 * @see wp_handle_upload_error
    696696 *
    697  * @param array       $file      Reference to a single element of $_FILES. Call the function once for each uploaded file.
    698  * @param array|false $overrides An associative array of names => values to override default variables. Default false.
     697 * @param string[]       $file      Reference to a single element of $_FILES. Call the function once for each uploaded file.
     698 * @param string[]|false $overrides An associative array of names => values to override default variables. Default false.
    699699 * @param string      $time      Time formatted in 'yyyy/mm'.
    700700 * @param string      $action    Expected value for $_POST['action'].
    701  * @return array On success, returns an associative array of file attributes. On failure, returns
     701 * @return string[] On success, returns an associative array of file attributes. On failure, returns
    702702 *               $overrides['upload_error_handler'](&$file, $message ) or array( 'error'=>$message ).
    703703 */
    704704function _wp_handle_upload( &$file, $overrides, $time, $action ) {
     
    717717         * @since 2.9.0 as 'wp_handle_upload_prefilter'.
    718718         * @since 4.0.0 Converted to a dynamic hook with `$action`.
    719719         *
    720          * @param array $file An array of data for a single file.
     720         * @param string[] $file An array of data for a single file.
    721721         */
    722722        $file = apply_filters( "{$action}_prefilter", $file );
    723723
  • src/wp-admin/includes/nav-menu.php

     
    1818 *
    1919 * @since 3.0.0
    2020 *
    21  * @param array $request The unsanitized request values.
     21 * @param string[] $request The unsanitized request values.
    2222 */
    2323function _wp_ajax_menu_quick_search( $request = array() ) {
    2424        $args            = array();
     
    318318 * @global int|string $nav_menu_selected_id
    319319 *
    320320 * @param string $object Not used.
    321  * @param array  $box {
     321 * @param string[]  $box {
    322322 *     Post type menu item meta box arguments.
    323323 *
    324324 *     @type string       $id       Meta box 'id' attribute.
     
    435435                        </li>
    436436                </ul><!-- .posttype-tabs -->
    437437
    438                 <div id="tabs-panel-posttype-<?php echo $post_type_name; ?>-most-recent" class="tabs-panel 
     438                <div id="tabs-panel-posttype-<?php echo $post_type_name; ?>-most-recent" class="tabs-panel
    439439                                                                                                <?php
    440440                                                                                                echo ( 'most-recent' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
    441441                ?>
     
    461461                                 * @since 4.3.0
    462462                                 * @since 4.9.0 Added the `$recent_args` parameter.
    463463                                 *
    464                                  * @param array $most_recent An array of post objects being listed.
    465                                  * @param array $args        An array of WP_Query arguments for the meta box.
    466                                  * @param array $box         Arguments passed to wp_nav_menu_item_post_type_meta_box().
    467                                  * @param array $recent_args An array of WP_Query arguments for 'Most Recent' tab.
     464                                 * @param string[] $most_recent An array of post objects being listed.
     465                                 * @param string[] $args        An array of WP_Query arguments for the meta box.
     466                                 * @param string[] $box         Arguments passed to wp_nav_menu_item_post_type_meta_box().
     467                                 * @param string[] $recent_args An array of WP_Query arguments for 'Most Recent' tab.
    468468                                 */
    469469                                $most_recent = apply_filters( "nav_menu_items_{$post_type_name}_recent", $most_recent, $args, $box, $recent_args );
    470470
     
    473473                        </ul>
    474474                </div><!-- /.tabs-panel -->
    475475
    476                 <div class="tabs-panel 
     476                <div class="tabs-panel
    477477                <?php
    478478                        echo ( 'search' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
    479479                ?>
     
    515515                        </ul>
    516516                </div><!-- /.tabs-panel -->
    517517
    518                 <div id="<?php echo $post_type_name; ?>-all" class="tabs-panel tabs-panel-view-all 
     518                <div id="<?php echo $post_type_name; ?>-all" class="tabs-panel tabs-panel-view-all
    519519                                                        <?php
    520520                                                        echo ( 'all' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
    521521                ?>
     
    589589                                 *
    590590                                 * @see WP_Query::query()
    591591                                 *
    592                                  * @param array        $posts     The posts for the current post type.
    593                                  * @param array        $args      An array of WP_Query arguments.
    594                                  * @param WP_Post_Type $post_type The current post type object for this menu item meta box.
     592                                 * @param string[]        $posts     The posts for the current post type.
     593                                 * @param string[]        $args      An array of WP_Query arguments.
     594                                 * @param string[] WP_Post_Type $post_type The current post type object for this menu item meta box.
    595595                                 */
    596596                                $posts = apply_filters( "nav_menu_items_{$post_type_name}", $posts, $args, $post_type );
    597597
     
    646646 *
    647647 * @global int|string $nav_menu_selected_id
    648648 *
    649  * @param string $object Not used.
    650  * @param array  $box {
     649 * @param string[] $object Not used.
     650 * @param string[]  $box {
    651651 *     Taxonomy menu item meta box arguments.
    652652 *
    653653 *     @type string $id       Meta box 'id' attribute.
     
    770770                        </li>
    771771                </ul><!-- .taxonomy-tabs -->
    772772
    773                 <div id="tabs-panel-<?php echo $taxonomy_name; ?>-pop" class="tabs-panel 
     773                <div id="tabs-panel-<?php echo $taxonomy_name; ?>-pop" class="tabs-panel
    774774                                                                                <?php
    775775                                                                                echo ( 'most-used' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
    776776                ?>
     
    791791                        </ul>
    792792                </div><!-- /.tabs-panel -->
    793793
    794                 <div id="tabs-panel-<?php echo $taxonomy_name; ?>-all" class="tabs-panel tabs-panel-view-all 
     794                <div id="tabs-panel-<?php echo $taxonomy_name; ?>-all" class="tabs-panel tabs-panel-view-all
    795795                                                                                <?php
    796796                                                                                echo ( 'all' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
    797797                ?>
     
    814814                        <?php endif; ?>
    815815                </div><!-- /.tabs-panel -->
    816816
    817                 <div class="tabs-panel 
     817                <div class="tabs-panel
    818818                <?php
    819819                        echo ( 'search' == $current_tab ? 'tabs-panel-active' : 'tabs-panel-inactive' );
    820820                ?>
     
    890890 * @since 3.0.0
    891891 *
    892892 * @param int $menu_id The menu ID for which to save this item. $menu_id of 0 makes a draft, orphaned menu item.
    893  * @param array $menu_data The unsanitized posted menu item data.
    894  * @return array The database IDs of the items saved
     893 * @param string[] $menu_data The unsanitized posted menu item data.
     894 * @return int[] The database IDs of the items saved
    895895 */
    896896function wp_save_nav_menu_items( $menu_id = 0, $menu_data = array() ) {
    897897        $menu_id     = (int) $menu_id;