Make WordPress Core

Changeset 42875


Ignore:
Timestamp:
03/25/2018 06:09:56 PM (9 years ago)
Author:
johnbillion
Message:

Docs: Document more parameters and properties using typed array notation.

See #41756

Location:
trunk/src
Files:
32 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-admin/includes/dashboard.php

    r42832 r42875  
    8080                 * @since 3.1.0
    8181                 *
    82                  * @param array $dashboard_widgets An array of dashboard widgets.
     82                 * @param string[] $dashboard_widgets An array of dashboard widget IDs.
    8383                 */
    8484                $dashboard_widgets = apply_filters( 'wp_network_dashboard_widgets', array() );
    … …  
    9797                 * @since 3.1.0
    9898                 *
    99                  * @param array $dashboard_widgets An array of dashboard widgets.
     99                 * @param string[] $dashboard_widgets An array of dashboard widget IDs.
    100100                 */
    101101                $dashboard_widgets = apply_filters( 'wp_user_dashboard_widgets', array() );
    … …  
    114114                 * @since 2.5.0
    115115                 *
    116                  * @param array $dashboard_widgets An array of dashboard widgets.
     116                 * @param string[] $dashboard_widgets An array of dashboard widget IDs.
    117117                 */
    118118                $dashboard_widgets = apply_filters( 'wp_dashboard_widgets', array() );
    … …  
    315315         * @since 3.8.0
    316316         *
    317          * @param array $items Array of extra 'At a Glance' widget items.
     317         * @param string[] $items Array of extra 'At a Glance' widget items.
    318318         */
    319319        $elements = apply_filters( 'dashboard_glance_items', array() );
    … …  
    556556 * @since 2.7.0
    557557 *
    558  * @param array $drafts
     558 * @param WP_Post[] $drafts Optional. Array of posts to display. Default false.
    559559 */
    560560function wp_dashboard_recent_drafts( $drafts = false ) {
    … …  
    672672                 * @since 2.6.0
    673673                 *
    674                  * @param array      $actions An array of comment actions. Default actions include:
     674                 * @param string[]   $actions An array of comment actions. Default actions include:
    675675                 *                            'Approve', 'Unapprove', 'Edit', 'Reply', 'Spam',
    676676                 *                            'Delete', and 'Trash'.
  • trunk/src/wp-admin/includes/export.php

    r42343 r42875  
    341341         * @global wpdb $wpdb WordPress database abstraction object.
    342342         *
    343          * @param array $post_ids Array of post IDs to filter the query by. Optional.
     343         * @param int[] $post_ids Optional. Array of post IDs to filter the query by.
    344344         */
    345345        function wxr_authors_list( array $post_ids = null ) {
  • trunk/src/wp-admin/includes/media.php

    r42827 r42875  
    26102610 * @since 3.1.0
    26112611 *
    2612  * @param array $type_links An array of list items containing mime type link HTML.
     2612 * @param string[] $type_links An array of list items containing mime type link HTML.
    26132613 */
    26142614echo implode( ' | </li>', apply_filters( 'media_upload_mime_type_links', $type_links ) ) . '</li>';
  • trunk/src/wp-admin/includes/misc.php

    r42830 r42875  
    557557         * @since 2.8.0
    558558         *
    559          * @param array $ignore_functions Functions and classes to be ignored.
     559         * @param string[] $ignore_functions Array of names of functions and classes to be ignored.
    560560         */
    561561        $ignore_functions = apply_filters( 'documentation_ignore_functions', $ignore_functions );
  • trunk/src/wp-admin/includes/ms.php

    r42836 r42875  
    127127                 * @since MU (3.0.0)
    128128                 *
    129                  * @param array $tables  The site tables to be dropped.
    130                  * @param int   $blog_id The ID of the site to drop tables for.
     129                 * @param string[] $tables  Array of names of the site tables to be dropped.
     130                 * @param int      $blog_id The ID of the site to drop tables for.
    131131                 */
    132132                $drop_tables = apply_filters( 'wpmu_drop_tables', $tables, $blog_id );
    … …  
    666666         * @since MU (3.0.0)
    667667         *
    668          * @param array  $lang_codes Key/value pair of language codes where key is the short version.
    669          * @param string $code       A two-letter designation of the language.
     668         * @param string[] $lang_codes Array of key/value pairs of language codes where key is the short version.
     669         * @param string   $code       A two-letter designation of the language.
    670670         */
    671671        $lang_codes = apply_filters( 'lang_codes', $lang_codes, $code );
    … …  
    761761 * @since 3.0.0
    762762 *
    763  * @param array $lang_files Optional. An array of the language files. Default empty array.
    764  * @param string $current    Optional. The current language code. Default empty.
     763 * @param string[] $lang_files Optional. An array of the language files. Default empty array.
     764 * @param string   $current    Optional. The current language code. Default empty.
    765765 */
    766766function mu_dropdown_languages( $lang_files = array(), $current = '' ) {
    … …  
    797797         * @since MU (3.0.0)
    798798         *
    799          * @param array $output     HTML output of the dropdown.
    800          * @param array $lang_files Available language files.
    801          * @param string $current   The current language code.
     799         * @param string[] $output     Array of HTML output for the dropdown.
     800         * @param string[] $lang_files Array of available language files.
     801         * @param string   $current    The current language code.
    802802         */
    803803        $output = apply_filters( 'mu_dropdown_languages', $output, $lang_files, $current );
  • trunk/src/wp-admin/includes/plugin.php

    r42843 r42875  
    211211                 * @since 4.9.0
    212212                 *
    213                  * @param array $exclusions Array of excluded directories and files.
     213                 * @param string[] $exclusions Array of excluded directories and files.
    214214                 */
    215215                $exclusions = (array) apply_filters( 'plugin_files_exclusions', array( 'CVS', 'node_modules', 'vendor', 'bower_components' ) );
  • trunk/src/wp-admin/includes/post.php

    r42343 r42875  
    12681268         * @since 3.2.0
    12691269         *
    1270          * @param array $classes An array of postbox classes.
     1270         * @param string[] $classes An array of postbox classes.
    12711271         */
    12721272        $classes = apply_filters( "postbox_classes_{$page}_{$id}", $classes );
  • trunk/src/wp-admin/includes/revision.php

    r42343 r42875  
    131131         * @since 4.1.0
    132132         *
    133          * @param array   $return       Revision UI fields. Each item is an array of id, name and diff.
     133         * @param array[] $return       Array of revision UI fields. Each item is an array of id, name, and diff.
    134134         * @param WP_Post $compare_from The revision post to compare from.
    135135         * @param WP_Post $compare_to   The revision post to compare to.
  • trunk/src/wp-admin/includes/taxonomy.php

    r42343 r42875  
    7171 * @since 2.0.0
    7272 *
    73  * @param array $categories List of categories to create.
    74  * @param int   $post_id    Optional. The post ID. Default empty.
     73 * @param string[] $categories Array of category names to create.
     74 * @param int      $post_id    Optional. The post ID. Default empty.
    7575 * @return array List of categories to create for the given post.
    7676 */
  • trunk/src/wp-admin/includes/template.php

    r42827 r42875  
    3030 * @param int    $descendants_and_self Optional. ID of the category to output along with its descendants.
    3131 *                                     Default 0.
    32  * @param array  $selected_cats        Optional. List of categories to mark as checked. Default false.
    33  * @param array  $popular_cats         Optional. List of categories to receive the "popular-category" class.
     32 * @param int[]  $selected_cats        Optional. Array of category IDs to mark as checked. Default false.
     33 * @param int[]  $popular_cats         Optional. Array of category IDs to receive the "popular-category" class.
    3434 *                                     Default false.
    3535 * @param object $walker               Optional. Walker object to use to build the output.
    … …  
    6565 *     @type int    $descendants_and_self ID of the category to output along with its descendants.
    6666 *                                        Default 0.
    67  *     @type array  $selected_cats        List of categories to mark as checked. Default false.
    68  *     @type array  $popular_cats         List of categories to receive the "popular-category" class.
     67 *     @type int[]  $selected_cats        Array of category IDs to mark as checked. Default false.
     68 *     @type int[]  $popular_cats         Array of category IDs to receive the "popular-category" class.
    6969 *                                        Default false.
    7070 *     @type object $walker               Walker object to use to build the output.
    … …  
    18981898         * @since 3.6.0 Added the `$post` parameter.
    18991899         *
    1900          * @param array  $post_states An array of post display states.
    1901          * @param WP_Post $post        The current post object.
     1900         * @param string[] $post_states An array of post display states.
     1901         * @param WP_Post  $post        The current post object.
    19021902         */
    19031903        $post_states = apply_filters( 'display_post_states', $post_states, $post );
    … …  
    19741974         * @since 4.8.0 Added the `$post` parameter.
    19751975         *
    1976          * @param array  $media_states An array of media states. Default 'Header Image',
    1977          *                              'Background Image', 'Site Icon', 'Logo'.
    1978          * @param WP_Post $post         The current attachment object.
     1976         * @param string[] $media_states An array of media states. Default 'Header Image',
     1977         *                               'Background Image', 'Site Icon', 'Logo'.
     1978         * @param WP_Post  $post         The current attachment object.
    19791979         */
    19801980        $media_states = apply_filters( 'display_media_states', $media_states, $post );
  • trunk/src/wp-admin/includes/theme.php

    r42778 r42875  
    570570 * @since 3.8.0
    571571 *
    572  * @param array $themes Optional. Array of WP_Theme objects to prepare.
    573  *                      Defaults to all allowed themes.
     572 * @param WP_Theme[] $themes Optional. Array of theme objects to prepare.
     573 *                           Defaults to all allowed themes.
    574574 *
    575575 * @return array An associative array of theme data, sorted by name.
    … …  
    586586         * @since 4.2.0
    587587         *
    588          * @param array      $prepared_themes An associative array of theme data. Default empty array.
    589          * @param null|array $themes          An array of WP_Theme objects to prepare, if any.
    590          * @param string     $current_theme   The current theme slug.
     588         * @param array           $prepared_themes An associative array of theme data. Default empty array.
     589         * @param WP_Theme[]|null $themes          An array of theme objects to prepare, if any.
     590         * @param string          $current_theme   The current theme slug.
    591591         */
    592592        $prepared_themes = (array) apply_filters( 'pre_prepare_themes_for_js', array(), $themes, $current_theme );
  • trunk/src/wp-admin/includes/upgrade.php

    r42836 r42875  
    23942394 * @global wpdb  $wpdb
    23952395 *
    2396  * @param string|array $queries Optional. The query to run. Can be multiple queries
    2397  *                              in an array, or a string of queries separated by
    2398  *                              semicolons. Default empty.
    2399  * @param bool         $execute Optional. Whether or not to execute the query right away.
    2400  *                              Default true.
     2396 * @param string[]|string $queries Optional. The query to run. Can be multiple queries
     2397 *                                 in an array, or a string of queries separated by
     2398 *                                 semicolons. Default empty string.
     2399 * @param bool            $execute Optional. Whether or not to execute the query right away.
     2400 *                                 Default true.
    24012401 * @return array Strings containing the results of the various update queries.
    24022402 */
    … …  
    24192419         * @since 3.3.0
    24202420         *
    2421          * @param array $queries An array of dbDelta SQL queries.
     2421         * @param string[] $queries An array of dbDelta SQL queries.
    24222422         */
    24232423        $queries = apply_filters( 'dbdelta_queries', $queries );
    … …  
    24502450         * @since 3.3.0
    24512451         *
    2452          * @param array $cqueries An array of dbDelta create SQL queries.
     2452         * @param string[] $cqueries An array of dbDelta create SQL queries.
    24532453         */
    24542454        $cqueries = apply_filters( 'dbdelta_create_queries', $cqueries );
    … …  
    24612461         * @since 3.3.0
    24622462         *
    2463          * @param array $iqueries An array of dbDelta insert or update SQL queries.
     2463         * @param string[] $iqueries An array of dbDelta insert or update SQL queries.
    24642464         */
    24652465        $iqueries = apply_filters( 'dbdelta_insert_queries', $iqueries );
  • trunk/src/wp-admin/includes/user.php

    r42855 r42875  
    255255 * @since 2.8.0
    256256 *
    257  * @return array
     257 * @return array[] Array of arrays containing role information.
    258258 */
    259259function get_editable_roles() {
    … …  
    265265         * @since 2.8.0
    266266         *
    267          * @param array $all_roles List of roles.
     267         * @param array[] $all_roles Array of arrays containing role information.
    268268         */
    269269        $editable_roles = apply_filters( 'editable_roles', $all_roles );
    … …  
    378378                 * @since 3.4.0
    379379                 *
    380                  * @param array $post_types_to_delete Post types to delete.
    381                  * @param int   $id                   User ID.
     380                 * @param string[] $post_types_to_delete Array of post types to delete.
     381                 * @param int      $id                   User ID.
    382382                 */
    383383                $post_types_to_delete = apply_filters( 'post_types_to_delete_with_user', $post_types_to_delete, $id );
  • trunk/src/wp-admin/maint/repair.php

    r42827 r42875  
    9090         * @since 3.0.0
    9191         *
    92          * @param array $tables Array of prefixed table names to be repaired.
     92         * @param string[] $tables Array of prefixed table names to be repaired.
    9393         */
    9494        $tables = array_merge( $tables, (array) apply_filters( 'tables_to_repair', array() ) );
  • trunk/src/wp-admin/network/settings.php

    r42827 r42875  
    451451                         * @since MU (3.0.0)
    452452                         *
    453                          * @param array $admin_menus The menu items available.
     453                         * @param string[] $admin_menus Associative array of the menu items available.
    454454                         */
    455455                        $menu_items   = apply_filters( 'mu_menu_items', array( 'plugins' => __( 'Plugins' ) ) );
  • trunk/src/wp-admin/options-discussion.php

    r42400 r42875  
    269269 * @since 2.6.0
    270270 *
    271  * @param array $avatar_defaults Array of default avatars.
     271 * @param string[] $avatar_defaults Associative array of default avatars.
    272272 */
    273273$avatar_defaults = apply_filters( 'avatar_defaults', $avatar_defaults );
  • trunk/src/wp-admin/options-general.php

    r42606 r42875  
    325325         * @since 4.0.0 Added ISO date standard YYYY-MM-DD format.
    326326         *
    327          * @param array $default_date_formats Array of default date formats.
     327         * @param string[] $default_date_formats Array of default date formats.
    328328         */
    329329        $date_formats = array_unique( apply_filters( 'date_formats', array( __( 'F j, Y' ), 'Y-m-d', 'm/d/Y', 'd/m/Y' ) ) );
    … …  
    362362         * @since 2.7.0
    363363         *
    364          * @param array $default_time_formats Array of default time formats.
     364         * @param string[] $default_time_formats Array of default time formats.
    365365         */
    366366        $time_formats = array_unique( apply_filters( 'time_formats', array( __( 'g:i a' ), 'g:i A', 'H:i' ) ) );
  • trunk/src/wp-admin/options-permalink.php

    r42343 r42875  
    257257                                 * @since 4.8.0
    258258                                 *
    259                                  * @param array $available_tags A key => value pair of available permalink structure tags.
     259                                 * @param string[] $available_tags An array of key => value pairs of available permalink structure tags.
    260260                                 */
    261261                                $available_tags = apply_filters( 'available_permalink_structure_tags', $available_tags );
  • trunk/src/wp-admin/plugins.php

    r42827 r42875  
    568568 * @since 3.0.0
    569569 *
    570  * @param array $plugins_all An array containing all installed plugins.
     570 * @param array[] $plugins_all An array of arrays containing information on all installed plugins.
    571571 */
    572572do_action( 'pre_current_active_plugins', $plugins['all'] );
  • trunk/src/wp-admin/theme-install.php

    r42447 r42875  
    144144         * @since 2.8.0
    145145         *
    146          * @param array $tabs The tabs shown on the Add Themes screen. Default is 'upload'.
     146         * @param string[] $tabs Associative array of the tabs shown on the Add Themes screen. Default is 'upload'.
    147147         */
    148148        $tabs = apply_filters( 'install_themes_tabs', array( 'upload' => __( 'Upload Theme' ) ) );
  • trunk/src/wp-admin/users.php

    r42719 r42875  
    318318         *
    319319         * @param WP_User $current_user WP_User object for the current user.
    320          * @param array   $userids      Array of IDs for users being deleted.
     320         * @param int[]   $userids      Array of IDs for users being deleted.
    321321         */
    322322        do_action( 'delete_user_form', $current_user, $userids );
  • trunk/src/wp-includes/capabilities.php

    r42832 r42875  
    325325                                 * @since 4.6.0
    326326                                 *
    327                                  * @param bool   $allowed   Whether the user can add the object meta. Default false.
    328                                  * @param string $meta_key  The meta key.
    329                                  * @param int    $object_id Object ID.
    330                                  * @param int    $user_id   User ID.
    331                                  * @param string $cap       Capability name.
    332                                  * @param array  $caps      User capabilities.
     327                                 * @param bool     $allowed   Whether the user can add the object meta. Default false.
     328                                 * @param string   $meta_key  The meta key.
     329                                 * @param int      $object_id Object ID.
     330                                 * @param int      $user_id   User ID.
     331                                 * @param string   $cap       Capability name.
     332                                 * @param string[] $caps      Array of the user's capabilities.
    333333                                 */
    334334                                $allowed = apply_filters( "auth_{$object_type}_meta_{$meta_key}", false, $meta_key, $object_id, $user_id, $cap, $caps );
    … …  
    346346                                 * @since 4.7.0
    347347                                 *
    348                                  * @param bool   $allowed   Whether the user can add the object meta. Default false.
    349                                  * @param string $meta_key  The meta key.
    350                                  * @param int    $object_id Object ID.
    351                                  * @param int    $user_id   User ID.
    352                                  * @param string $cap       Capability name.
    353                                  * @param array  $caps      User capabilities.
     348                                 * @param bool     $allowed   Whether the user can add the object meta. Default false.
     349                                 * @param string   $meta_key  The meta key.
     350                                 * @param int      $object_id Object ID.
     351                                 * @param int      $user_id   User ID.
     352                                 * @param string   $cap       Capability name.
     353                                 * @param string[] $caps      Array of the user's capabilities.
    354354                                 */
    355355                                $allowed = apply_filters( "auth_{$object_type}_{$sub_type}_meta_{$meta_key}", $allowed, $meta_key, $object_id, $user_id, $cap, $caps );
    … …  
    573573         * @since 2.8.0
    574574         *
    575          * @param array  $caps    Returns the user's actual capabilities.
    576          * @param string $cap     Capability name.
    577          * @param int    $user_id The user ID.
    578          * @param array  $args    Adds the context to the cap. Typically the object ID.
     575         * @param string[] $caps    Array of the user's capabilities.
     576         * @param string   $cap     Capability name.
     577         * @param int      $user_id The user ID.
     578         * @param array    $args    Adds the context to the cap. Typically the object ID.
    579579         */
    580580        return apply_filters( 'map_meta_cap', $caps, $cap, $user_id, $args );
    … …  
    913913 * @since 4.9.0
    914914 *
    915  * @param array $allcaps An array of all the user's capabilities.
    916  * @return array Filtered array of the user's capabilities.
     915 * @param bool[] $allcaps An array of all the user's capabilities.
     916 * @return bool[] Filtered array of the user's capabilities.
    917917 */
    918918function wp_maybe_grant_install_languages_cap( $allcaps ) {
  • trunk/src/wp-includes/category-template.php

    r42843 r42875  
    7272 *
    7373 * @param int $id Optional, default to current post ID. The post ID.
    74  * @return array Array of WP_Term objects, one for each category assigned to the post.
     74 * @return WP_Term[] Array of WP_Term objects, one for each category assigned to the post.
    7575 */
    7676function get_the_category( $id = false ) {
    … …  
    9292         * @since 4.4.0 Added `$id` parameter.
    9393         *
    94          * @param array $categories An array of categories to return for the post.
    95          * @param int  $id         ID of the post.
     94         * @param WP_Term[] $categories An array of categories to return for the post.
     95         * @param int|false $id         ID of the post.
    9696         */
    9797        return apply_filters( 'get_the_categories', $categories, $id );
    … …  
    142142         * @since 4.4.0
    143143         *
    144          * @param array    $categories An array of the post's categories.
    145          * @param int|bool $post_id    ID of the post we're retrieving categories for. When `false`, we assume the
    146          *                             current post in the loop.
     144         * @param WP_Term[] $categories An array of the post's categories.
     145         * @param int|bool  $post_id    ID of the post we're retrieving categories for. When `false`, we assume the
     146         *                              current post in the loop.
    147147         */
    148148        $categories = apply_filters( 'the_category_list', get_the_category( $post_id ), $post_id );
    … …  
    763763 * @since 4.8.0 Added the `show_count` argument.
    764764 *
    765  * @param array $tags Array of WP_Term objects to generate the tag cloud for.
     765 * @param WP_Term[]    $tags Array of WP_Term objects to generate the tag cloud for.
    766766 * @param string|array $args {
    767767 *     Optional. Array or string of arguments for generating a tag cloud.
    … …  
    851851         * @since 2.8.0
    852852         *
    853          * @param array $tags Ordered array of terms.
    854          * @param array $args An array of tag cloud arguments.
     853         * @param WP_Term[] $tags Ordered array of terms.
     854         * @param array     $args An array of tag cloud arguments.
    855855         */
    856856        $tags_sorted = apply_filters( 'tag_cloud_sort', $tags, $args );
    … …  
    10051005                 *                             or an array of tag links if the 'format' argument
    10061006                 *                             equals 'array'.
    1007                  * @param array        $tags   An array of terms used in the tag cloud.
     1007                 * @param WP_Term[]    $tags   An array of terms used in the tag cloud.
    10081008                 * @param array        $args   An array of wp_generate_tag_cloud() arguments.
    10091009                 */
    … …  
    11231123         * @see get_the_terms()
    11241124         *
    1125          * @param array $terms An array of tags for the given post.
     1125         * @param WP_Term[] $terms An array of tags for the given post.
    11261126         */
    11271127        return apply_filters( 'get_the_tags', get_the_terms( $id, 'post_tag' ) );
    … …  
    12141214 * @since 2.5.0
    12151215 *
    1216  * @param int|object $post Post ID or object.
    1217  * @param string $taxonomy Taxonomy name.
    1218  * @return array|false|WP_Error Array of WP_Term objects on success, false if there are no terms
    1219  *                              or the post does not exist, WP_Error on failure.
     1216 * @param int|WP_Post $post    Post ID or object.
     1217 * @param string      $taxonomy Taxonomy name.
     1218 * @return WP_Term[]|false|WP_Error Array of WP_Term objects on success, false if there are no terms
     1219 *                                  or the post does not exist, WP_Error on failure.
    12201220 */
    12211221function get_the_terms( $post, $taxonomy ) {
    … …  
    12381238         * @since 3.1.0
    12391239         *
    1240          * @param array|WP_Error $terms    List of attached terms, or WP_Error on failure.
    1241          * @param int            $post_id  Post ID.
    1242          * @param string         $taxonomy Name of the taxonomy.
     1240         * @param WP_Term[]|WP_Error $terms    Array of attached terms, or WP_Error on failure.
     1241         * @param int                $post_id  Post ID.
     1242         * @param string             $taxonomy Name of the taxonomy.
    12431243         */
    12441244        $terms = apply_filters( 'get_the_terms', $terms, $post->ID, $taxonomy );
    … …  
    12921292         * @since 2.5.0
    12931293         *
    1294          * @param array $links An array of term links.
     1294         * @param string[] $links An array of term links.
    12951295         */
    12961296        $term_links = apply_filters( "term_links-{$taxonomy}", $links );
  • trunk/src/wp-includes/category.php

    r42343 r42875  
    274274 *
    275275 * @param string|array $args Tag arguments to use when retrieving tags.
    276  * @return array List of tags.
     276 * @return WP_Term[]|int $tags Array of 'post_tag' term objects, or a count thereof.
    277277 */
    278278function get_tags( $args = '' ) {
    … …  
    289289         * @since 2.3.0
    290290         *
    291          * @param array $tags Array of 'post_tag' term objects.
    292          * @param array $args An array of arguments. @see get_terms()
     291         * @param WP_Term[]|int $tags Array of 'post_tag' term objects, or a count thereof.
     292         * @param array         $args An array of arguments. @see get_terms()
    293293         */
    294294        $tags = apply_filters( 'get_tags', $tags, $args );
  • trunk/src/wp-includes/class-oembed.php

    r42747 r42875  
    216216                 * @since 2.9.0
    217217                 *
    218                  * @param array $providers An array of popular oEmbed providers.
     218                 * @param array[] $providers An array of arrays containing data about popular oEmbed providers.
    219219                 */
    220220                $this->providers = apply_filters( 'oembed_providers', $providers );
    … …  
    447447                         * @since 2.9.0
    448448                         *
    449                          * @param array $format Array of oEmbed link types. Accepts 'application/json+oembed',
    450                          *                      'text/xml+oembed', and 'application/xml+oembed' (incorrect,
    451                          *                      used by at least Vimeo).
     449                         * @param string[] $format Array of oEmbed link types. Accepts 'application/json+oembed',
     450                         *                         'text/xml+oembed', and 'application/xml+oembed' (incorrect,
     451                         *                         used by at least Vimeo).
    452452                         */
    453453                        $linktypes = apply_filters(
  • trunk/src/wp-includes/class-walker-nav-menu.php

    r42808 r42875  
    6969                 * @since 4.8.0
    7070                 *
    71                  * @param array    $classes The CSS classes that are applied to the menu `<ul>` element.
     71                 * @param string[] $classes Array of the CSS classes that are applied to the menu `<ul>` element.
    7272                 * @param stdClass $args    An object of `wp_nav_menu()` arguments.
    7373                 * @param int      $depth   Depth of menu item. Used for padding.
    … …  
    146146                 * @since 4.1.0 The `$depth` parameter was added.
    147147                 *
    148                  * @param array    $classes The CSS classes that are applied to the menu item's `<li>` element.
     148                 * @param string[] $classes Array of the CSS classes that are applied to the menu item's `<li>` element.
    149149                 * @param WP_Post  $item    The current menu item.
    150150                 * @param stdClass $args    An object of wp_nav_menu() arguments.
  • trunk/src/wp-includes/class-walker-page.php

    r42343 r42875  
    142142                 * @see wp_list_pages()
    143143                 *
    144                  * @param array   $css_class    An array of CSS classes to be applied
    145                  *                              to each list item.
    146                  * @param WP_Post $page         Page data object.
    147                  * @param int     $depth        Depth of page, used for padding.
    148                  * @param array   $args         An array of arguments.
    149                  * @param int     $current_page ID of the current page.
     144                 * @param string[] $css_class    An array of CSS classes to be applied to each list item.
     145                 * @param WP_Post  $page         Page data object.
     146                 * @param int      $depth        Depth of page, used for padding.
     147                 * @param array    $args         An array of arguments.
     148                 * @param int      $current_page ID of the current page.
    150149                 */
    151150                $css_classes = implode( ' ', apply_filters( 'page_css_class', $css_class, $page, $depth, $args, $current_page ) );
  • trunk/src/wp-includes/class-wp-comment-query.php

    r42376 r42875  
    450450                 * @since 3.1.0
    451451                 *
    452                  * @param array            $_comments An array of comments.
    453                  * @param WP_Comment_Query $this     Current instance of WP_Comment_Query (passed by reference).
     452                 * @param WP_Comment[]     $_comments An array of comments.
     453                 * @param WP_Comment_Query $this      Current instance of WP_Comment_Query (passed by reference).
    454454                 */
    455455                $_comments = apply_filters_ref_array( 'the_comments', array( $_comments, &$this ) );
    … …  
    850850                 * @since 3.1.0
    851851                 *
    852                  * @param array            $pieces A compacted array of comment query clauses.
    853                  * @param WP_Comment_Query $this  Current instance of WP_Comment_Query (passed by reference).
     852                 * @param string[]         $pieces An associative array of comment query clauses.
     853                 * @param WP_Comment_Query $this   Current instance of WP_Comment_Query (passed by reference).
    854854                 */
    855855                $clauses = apply_filters_ref_array( 'comments_clauses', array( compact( $pieces ), &$this ) );
    … …  
    933933         * @global wpdb $wpdb WordPress database abstraction object.
    934934         *
    935          * @param array $comments Array of top-level comments whose descendants should be filled in.
     935         * @param WP_Comment[] $comments Array of top-level comments whose descendants should be filled in.
    936936         * @return array
    937937         */
  • trunk/src/wp-includes/class-wp-customize-manager.php

    r42797 r42875  
    347347                 * @see WP_Customize_Manager::__construct()
    348348                 *
    349                  * @param array                $components List of core components to load.
     349                 * @param string[]             $components Array of core components to load.
    350350                 * @param WP_Customize_Manager $this       WP_Customize_Manager instance.
    351351                 */
    … …  
    30953095         * @see _wp_translate_postdata()
    30963096         *
    3097          * @param array  $caps    Returns the user's actual capabilities.
    3098          * @param string $cap     Capability name.
    3099          * @param int    $user_id The user ID.
    3100          * @param array  $args    Adds the context to the cap. Typically the object ID.
    3101          * @return array Capabilities.
     3097         * @param string[] $caps    Array of the user's capabilities.
     3098         * @param string   $cap     Capability name.
     3099         * @param int      $user_id The user ID.
     3100         * @param array    $args    Adds the context to the cap. Typically the object ID.
     3101         * @return array   Capabilities.
    31023102         */
    31033103        public function grant_edit_post_capability_for_changeset( $caps, $cap, $user_id, $args ) {
    … …  
    45074507                 * @since 3.4.0
    45084508                 *
    4509                  * @param array $allowed_urls An array of allowed URLs.
     4509                 * @param string[] $allowed_urls An array of allowed URLs.
    45104510                 */
    45114511                $allowed_urls = array_unique( apply_filters( 'customize_allowed_urls', $allowed_urls ) );
    … …  
    46204620                 * @since 4.2.0
    46214621                 *
    4622                  * @param array                $nonces Array of refreshed nonces for save and
     4622                 * @param string[]             $nonces Array of refreshed nonces for save and
    46234623                 *                                     preview actions.
    46244624                 * @param WP_Customize_Manager $this   WP_Customize_Manager instance.
  • trunk/src/wp-includes/class-wp-customize-nav-menus.php

    r42827 r42875  
    7676         * @since 4.5.0
    7777         *
    78          * @param array $nonces Array of nonces.
    79          * @return array $nonces Modified array of nonces.
     78         * @param string[] $nonces Array of nonces.
     79         * @return string[] $nonces Modified array of nonces.
    8080         */
    8181        public function filter_nonces( $nonces ) {
  • trunk/src/wp-includes/class-wp-customize-widgets.php

    r42630 r42875  
    906906         * @since 3.9.0
    907907         *
    908          * @param array $widget_ids Array of widget IDs.
    909          * @return array Array of sanitized widget IDs.
     908         * @param string[] $widget_ids Array of widget IDs.
     909         * @return string[] Array of sanitized widget IDs.
    910910         */
    911911        public function sanitize_sidebar_widgets( $widget_ids ) {
  • trunk/src/wp-includes/class-wp-theme.php

    r42747 r42875  
    15371537         * @since 3.4.0
    15381538         *
    1539          * @param array $themes Array of themes to sort (passed by reference).
     1539         * @param WP_Theme[] $themes Array of theme objects to sort (passed by reference).
    15401540         */
    15411541        public static function sort_by_name( &$themes ) {
Note: See TracChangeset for help on using the changeset viewer.