Make WordPress Core

Changeset 42875


Ignore:
Timestamp:
03/25/2018 06:09:56 PM (6 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.