Make WordPress Core

Changeset 42876


Ignore:
Timestamp:
03/25/2018 07:32:24 PM (8 years ago)
Author:
johnbillion
Message:

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

See #41756

Location:
trunk/src/wp-includes
Files:
26 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/class-wp-embed.php

    r42343 r42876  
    375375                 * @since 2.9.0
    376376                 *
    377                  * @param array $post_types Array of post types to cache oEmbed results for. Defaults to post types with `show_ui` set to true.
     377                 * @param string[] $post_types Array of post type names to cache oEmbed results for. Defaults to post types with `show_ui` set to true.
    378378                 */
    379379                if ( empty( $post->ID ) || ! in_array( $post->post_type, apply_filters( 'embed_cache_oembed_types', $post_types ) ) ) {
  • trunk/src/wp-includes/class-wp-http-ixr-client.php

    r42343 r42876  
    7373                 * @since 4.4.0
    7474                 *
    75                  * @param array $headers Array of headers to be sent.
     75                 * @param string[] $headers Associative array of headers to be sent.
    7676                 */
    7777                $args['headers'] = apply_filters( 'wp_http_ixr_client_headers', $args['headers'] );
  • trunk/src/wp-includes/class-wp-network-query.php

    r42343 r42876  
    260260                 * @since 4.6.0
    261261                 *
    262                  * @param array            $_networks An array of WP_Network objects.
     262                 * @param WP_Network[]     $_networks An array of WP_Network objects.
    263263                 * @param WP_Network_Query $this      Current instance of WP_Network_Query (passed by reference).
    264264                 */
     
    400400                 * @since 4.6.0
    401401                 *
    402                  * @param array            $pieces A compacted array of network query clauses.
     402                 * @param string[]         $pieces An associative array of network query clauses.
    403403                 * @param WP_Network_Query $this   Current instance of WP_Network_Query (passed by reference).
    404404                 */
     
    479479         * @global wpdb  $wpdb WordPress database abstraction object.
    480480         *
    481          * @param string $string  Search string.
    482          * @param array  $columns Columns to search.
     481         * @param string   $string  Search string.
     482         * @param string[] $columns Array of columns to search.
    483483         *
    484484         * @return string Search SQL.
  • trunk/src/wp-includes/class-wp-network.php

    r42746 r42876  
    404404                 * @since 3.9.0
    405405                 *
    406                  * @param null|bool|object $network  Network value to return by path.
    407                  * @param string           $domain   The requested domain.
    408                  * @param string           $path     The requested path, in full.
    409                  * @param int|null         $segments The suggested number of paths to consult.
    410                  *                                   Default null, meaning the entire path was to be consulted.
    411                  * @param array            $paths    The paths to search for, based on $path and $segments.
     406                 * @param null|bool|WP_Network $network  Network value to return by path.
     407                 * @param string               $domain   The requested domain.
     408                 * @param string               $path     The requested path, in full.
     409                 * @param int|null             $segments The suggested number of paths to consult.
     410                 *                                       Default null, meaning the entire path was to be consulted.
     411                 * @param string[]             $paths    Array of paths to search for, based on `$path` and `$segments`.
    412412                 */
    413413                $pre = apply_filters( 'pre_get_network_by_path', null, $domain, $path, $segments, $paths );
  • trunk/src/wp-includes/class-wp-query.php

    r42843 r42876  
    13801380         * @since 3.7.0
    13811381         *
    1382          * @param array $terms Terms to check.
     1382         * @param string[] $terms Array of terms to check.
    13831383         * @return array Terms that are not stopwords.
    13841384         */
     
    14481448                 * @since 3.7.0
    14491449                 *
    1450                  * @param array $stopwords Stopwords.
     1450                 * @param string[] $stopwords Array of stopwords.
    14511451                 */
    14521452                $this->stopwords = apply_filters( 'wp_search_stopwords', $stopwords );
     
    26952695                         * @since 3.1.0
    26962696                         *
    2697                          * @param array    $clauses The list of clauses for the query.
     2697                         * @param string[] $clauses Associative array of the clauses for the query.
    26982698                         * @param WP_Query $this    The WP_Query instance (passed by reference).
    26992699                         */
     
    28192819                         * @since 3.1.0
    28202820                         *
    2821                          * @param array    $pieces The pieces of the query.
     2821                         * @param string[] $pieces Associative array of the pieces of the query.
    28222822                         * @param WP_Query $this   The WP_Query instance (passed by reference).
    28232823                         */
     
    29662966                         * @since 2.3.0
    29672967                         *
    2968                          * @param array    $posts The post results array.
    2969                          * @param WP_Query $this The WP_Query instance (passed by reference).
     2968                         * @param WP_Post[] $posts Array of post objects.
     2969                         * @param WP_Query  $this The WP_Query instance (passed by reference).
    29702970                         */
    29712971                        $this->posts = apply_filters_ref_array( 'posts_results', array( $this->posts, &$this ) );
     
    31033103                         * @since 1.5.0
    31043104                         *
    3105                          * @param array    $posts The array of retrieved posts.
    3106                          * @param WP_Query $this The WP_Query instance (passed by reference).
     3105                         * @param WP_Post[] $posts Array of post objects.
     3106                         * @param WP_Query  $this The WP_Query instance (passed by reference).
    31073107                         */
    31083108                        $this->posts = apply_filters_ref_array( 'the_posts', array( $this->posts, &$this ) );
     
    41784178                 * @since 4.4.0
    41794179                 *
    4180                  * @param array   $pages Array of "pages" derived from the post content.
    4181                  *                       of `<!-- nextpage -->` tags..
    4182                  * @param WP_Post $post  Current post object.
     4180                 * @param string[] $pages Array of "pages" from the post content split by `<!-- nextpage -->` tags.
     4181                 * @param WP_Post  $post  Current post object.
    41834182                 */
    41844183                $pages = apply_filters( 'content_pagination', $pages, $post );
  • trunk/src/wp-includes/class-wp-role.php

    r42343 r42876  
    9595                 * @since 2.0.0
    9696                 *
    97                  * @param array  $capabilities Array of role capabilities.
     97                 * @param bool[] $capabilities Associative array of capabilities for the role.
    9898                 * @param string $cap          Capability name.
    9999                 * @param string $name         Role name.
  • trunk/src/wp-includes/class-wp-site-query.php

    r42836 r42876  
    308308                 * @since 4.6.0
    309309                 *
    310                  * @param array         $_sites An array of WP_Site objects.
     310                 * @param WP_Site[]     $_sites An array of WP_Site objects.
    311311                 * @param WP_Site_Query $this   Current instance of WP_Site_Query (passed by reference).
    312312                 */
     
    510510                         * @since 4.6.0
    511511                         *
    512                          * @param array         $search_columns Array of column names to be searched.
     512                         * @param string[]      $search_columns Array of column names to be searched.
    513513                         * @param string        $search         Text being searched.
    514514                         * @param WP_Site_Query $this           The current WP_Site_Query instance.
     
    536536                 * @since 4.6.0
    537537                 *
    538                  * @param array         $pieces A compacted array of site query clauses.
     538                 * @param string[]      $pieces An associative array of site query clauses.
    539539                 * @param WP_Site_Query $this   Current instance of WP_Site_Query (passed by reference).
    540540                 */
     
    615615         * @global wpdb  $wpdb WordPress database abstraction object.
    616616         *
    617          * @param string $string  Search string.
    618          * @param array  $columns Columns to search.
     617         * @param string   $string  Search string.
     618         * @param string[] $columns Array of columns to search.
    619619         * @return string Search SQL.
    620620         */
  • trunk/src/wp-includes/class-wp-taxonomy.php

    r42748 r42876  
    247247                 * @since 4.4.0
    248248                 *
    249                  * @param array  $args        Array of arguments for registering a taxonomy.
    250                  * @param string $taxonomy    Taxonomy key.
    251                  * @param array $object_type Array of names of object types for the taxonomy.
     249                 * @param array    $args        Array of arguments for registering a taxonomy.
     250                 * @param string   $taxonomy    Taxonomy key.
     251                 * @param string[] $object_type Array of names of object types for the taxonomy.
    252252                 */
    253253                $args = apply_filters( 'register_taxonomy_args', $args, $this->name, (array) $object_type );
  • trunk/src/wp-includes/class-wp-term-query.php

    r42343 r42876  
    239239                 * @since 4.4.0
    240240                 *
    241                  * @param array $defaults   An array of default get_terms() arguments.
    242                  * @param array $taxonomies An array of taxonomies.
     241                 * @param array    $defaults   An array of default get_terms() arguments.
     242                 * @param string[] $taxonomies An array of taxonomy names.
    243243                 */
    244244                $this->query_var_defaults = apply_filters( 'get_terms_defaults', $this->query_var_defaults, $taxonomies );
     
    352352                 * @since 3.1.0
    353353                 *
    354                  * @param array $args       An array of get_terms() arguments.
    355                  * @param array $taxonomies An array of taxonomies.
     354                 * @param array    $args       An array of get_terms() arguments.
     355                 * @param string[] $taxonomies An array of taxonomy names.
    356356                 */
    357357                $args = apply_filters( 'get_terms_args', $args, $taxonomies );
     
    464464                 * @since 2.3.0
    465465                 *
    466                  * @param string $exclusions `NOT IN` clause of the terms query.
    467                  * @param array  $args       An array of terms query arguments.
    468                  * @param array  $taxonomies An array of taxonomies.
     466                 * @param string   $exclusions `NOT IN` clause of the terms query.
     467                 * @param array    $args       An array of terms query arguments.
     468                 * @param string[] $taxonomies An array of taxonomy names.
    469469                 */
    470470                $exclusions = apply_filters( 'list_terms_exclusions', $exclusions, $args, $taxonomies );
     
    628628                 * @since 2.8.0
    629629                 *
    630                  * @param array $selects    An array of fields to select for the terms query.
    631                  * @param array $args       An array of term query arguments.
    632                  * @param array $taxonomies An array of taxonomies.
     630                 * @param string[] $selects    An array of fields to select for the terms query.
     631                 * @param array    $args       An array of term query arguments.
     632                 * @param string[] $taxonomies An array of taxonomy names.
    633633                 */
    634634                $fields = implode( ', ', apply_filters( 'get_terms_fields', $selects, $args, $taxonomies ) );
     
    647647                 * @since 3.1.0
    648648                 *
    649                  * @param array $pieces     Terms query SQL clauses.
    650                  * @param array $taxonomies An array of taxonomies.
    651                  * @param array $args       An array of terms query arguments.
     649                 * @param string[] $pieces     Array of query SQL clauses.
     650                 * @param string[] $taxonomies An array of taxonomy names.
     651                 * @param array    $args       An array of term query arguments.
    652652                 */
    653653                $clauses = apply_filters( 'terms_clauses', compact( 'fields', 'join', 'where', 'distinct', 'orderby', 'order', 'limits' ), $taxonomies, $args );
     
    860860                 * @since 2.8.0
    861861                 *
    862                  * @param string $orderby    `ORDERBY` clause of the terms query.
    863                  * @param array  $args       An array of terms query arguments.
    864                  * @param array  $taxonomies An array of taxonomies.
     862                 * @param string   $orderby    `ORDERBY` clause of the terms query.
     863                 * @param array    $args       An array of term query arguments.
     864                 * @param string[] $taxonomies An array of taxonomy names.
    865865                 */
    866866                $orderby = apply_filters( 'get_terms_orderby', $orderby, $this->query_vars, $this->query_vars['taxonomy'] );
  • trunk/src/wp-includes/class-wp-theme.php

    r42875 r42876  
    11921192                 * @since 4.7.0 Added the `$post_type` parameter.
    11931193                 *
    1194                  * @param array        $post_templates Array of page templates. Keys are filenames,
     1194                 * @param string[]     $post_templates Array of page templates. Keys are filenames,
    11951195                 *                                     values are translated names.
    11961196                 * @param WP_Theme     $this           The theme object.
     
    12401240                 * @since 4.7.4
    12411241                 *
    1242                  * @param array $exclusions Array of excluded directories and files.
     1242                 * @param string[] $exclusions Array of excluded directories and files.
    12431243                 */
    12441244                $exclusions = (array) apply_filters( 'theme_scandir_exclusions', array( 'CVS', 'node_modules', 'vendor', 'bower_components' ) );
     
    13571357         *
    13581358         * @param int $blog_id Optional. ID of the site. Defaults to the current site.
    1359          * @return array Array of stylesheet names.
     1359         * @return string[] Array of stylesheet names.
    13601360         */
    13611361        public static function get_allowed( $blog_id = null ) {
     
    13681368                 * @since 4.5.0
    13691369                 *
    1370                  * @param array $allowed_themes An array of theme stylesheet names.
    1371                  * @param int   $blog_id        ID of the site.
     1370                 * @param string[] $allowed_themes An array of theme stylesheet names.
     1371                 * @param int      $blog_id        ID of the site.
    13721372                 */
    13731373                $network = (array) apply_filters( 'network_allowed_themes', self::get_allowed_on_network(), $blog_id );
     
    13821382         * @staticvar array $allowed_themes
    13831383         *
    1384          * @return array Array of stylesheet names.
     1384         * @return string[] Array of stylesheet names.
    13851385         */
    13861386        public static function get_allowed_on_network() {
     
    13951395                 * @since MU (3.0.0)
    13961396                 *
    1397                  * @param array $allowed_themes An array of theme stylesheet names.
     1397                 * @param string[] $allowed_themes An array of theme stylesheet names.
    13981398                 */
    13991399                $allowed_themes = apply_filters( 'allowed_themes', $allowed_themes );
     
    14101410         *
    14111411         * @param int $blog_id Optional. ID of the site. Defaults to the current site.
    1412          * @return array Array of stylesheet names.
     1412         * @return string[] Array of stylesheet names.
    14131413         */
    14141414        public static function get_allowed_on_site( $blog_id = null ) {
     
    14251425                         * @since 4.5.0
    14261426                         *
    1427                          * @param array $allowed_themes An array of theme stylesheet names.
    1428                          * @param int   $blog_id        ID of the site. Defaults to current site.
     1427                         * @param string[] $allowed_themes An array of theme stylesheet names.
     1428                         * @param int      $blog_id        ID of the site. Defaults to current site.
    14291429                         */
    14301430                        return (array) apply_filters( 'site_allowed_themes', $allowed_themes[ $blog_id ], $blog_id );
     
    14871487         * @since 4.6.0
    14881488         *
    1489          * @param string|array $stylesheets Stylesheet name or array of stylesheet names.
     1489         * @param string|string[] $stylesheets Stylesheet name or array of stylesheet names.
    14901490         */
    14911491        public static function network_enable_theme( $stylesheets ) {
     
    15111511         * @since 4.6.0
    15121512         *
    1513          * @param string|array $stylesheets Stylesheet name or array of stylesheet names.
     1513         * @param string|string[] $stylesheets Stylesheet name or array of stylesheet names.
    15141514         */
    15151515        public static function network_disable_theme( $stylesheets ) {
  • trunk/src/wp-includes/class-wp-user-query.php

    r42343 r42876  
    542542                         * @since 3.6.0
    543543                         *
    544                          * @param array         $search_columns Array of column names to be searched.
     544                         * @param string[]      $search_columns Array of column names to be searched.
    545545                         * @param string        $search         Text being searched.
    546546                         * @param WP_User_Query $this           The current WP_User_Query instance.
  • trunk/src/wp-includes/class-wp-user.php

    r42747 r42876  
    611611                 * @since 3.6.0 Added $old_roles to include an array of the user's previous roles.
    612612                 *
    613                  * @param int    $user_id   The user ID.
    614                  * @param string $role      The new role.
    615                  * @param array $old_roles An array of the user's previous roles.
     613                 * @param int      $user_id   The user ID.
     614                 * @param string   $role      The new role.
     615                 * @param string[] $old_roles An array of the user's previous roles.
    616616                 */
    617617                do_action( 'set_user_role', $this->ID, $role, $old_roles );
     
    751751                 * @since 3.7.0 Added the user object.
    752752                 *
    753                  * @param array   $allcaps An array of all the user's capabilities.
    754                  * @param array  $caps    Actual capabilities for meta capability.
    755                  * @param array   $args    Optional parameters passed to has_cap(), typically object ID.
    756                  * @param WP_User $user    The user object.
     753                 * @param bool[]   $allcaps An array of all the user's capabilities.
     754                 * @param string[] $caps    Actual capabilities for meta capability.
     755                 * @param array    $args    Optional parameters passed to has_cap(), typically object ID.
     756                 * @param WP_User  $user    The user object.
    757757                 */
    758758                $capabilities = apply_filters( 'user_has_cap', $this->allcaps, $caps, $args, $this );
  • trunk/src/wp-includes/class-wp.php

    r42419 r42876  
    1313         *
    1414         * @since 2.0.0
    15          * @var array
     15         * @var string[]
    1616         */
    1717        public $public_query_vars = array( 'm', 'p', 'posts', 'w', 'cat', 'withcomments', 'withoutcomments', 's', 'search', 'exact', 'sentence', 'calendar', 'page', 'paged', 'more', 'tb', 'pb', 'author', 'order', 'orderby', 'year', 'monthnum', 'day', 'hour', 'minute', 'second', 'name', 'category_name', 'tag', 'feed', 'author_name', 'static', 'pagename', 'page_id', 'error', 'attachment', 'attachment_id', 'subpost', 'subpost_id', 'preview', 'robots', 'taxonomy', 'term', 'cpage', 'post_type', 'embed' );
     
    2323         *
    2424         * @since 2.0.0
    25          * @var array
     25         * @var string[]
    2626         */
    2727        public $private_query_vars = array( 'offset', 'posts_per_page', 'posts_per_archive_page', 'showposts', 'nopaging', 'post_type', 'post_status', 'category__in', 'category__not_in', 'category__and', 'tag__in', 'tag__not_in', 'tag__and', 'tag_slug__in', 'tag_slug__and', 'tag_id', 'post_mime_type', 'perm', 'comments_per_page', 'post__in', 'post__not_in', 'post_parent', 'post_parent__in', 'post_parent__not_in', 'title', 'fields' );
     
    283283                 * @since 1.5.0
    284284                 *
    285                  * @param array $public_query_vars The array of whitelisted query variables.
     285                 * @param string[] $public_query_vars The array of whitelisted query variable names.
    286286                 */
    287287                $this->public_query_vars = apply_filters( 'query_vars', $this->public_query_vars );
     
    478478                 * @since 2.8.0
    479479                 *
    480                  * @param array $headers The list of headers to be sent.
    481                  * @param WP    $this    Current WordPress environment instance.
     480                 * @param string[] $headers Associative array of headers to be sent.
     481                 * @param WP       $this    Current WordPress environment instance.
    482482                 */
    483483                $headers = apply_filters( 'wp_headers', $headers, $this );
  • trunk/src/wp-includes/class.wp-dependencies.php

    r42343 r42876  
    204204         * @param string           $handle Name of the item. Should be unique.
    205205         * @param string           $src    Full URL of the item, or path of the item relative to the WordPress root directory.
    206          * @param array            $deps   Optional. An array of registered item handles this item depends on. Default empty array.
     206         * @param string[]         $deps   Optional. An array of registered item handles this item depends on. Default empty array.
    207207         * @param string|bool|null $ver    Optional. String specifying item version number, if it has one, which is added to the URL
    208208         *                                 as a query string for cache busting purposes. If version is set to false, a version
     
    330330         * @since 4.0.0
    331331         *
    332          * @param array  $queue  An array of queued _WP_Dependency handle objects.
    333          * @param string $handle Name of the item. Should be unique.
     332         * @param string[] $queue  An array of queued _WP_Dependency handles.
     333         * @param string   $handle Name of the item. Should be unique.
    334334         * @return bool Whether the handle is found after recursively searching the dependency tree.
    335335         */
  • trunk/src/wp-includes/class.wp-scripts.php

    r42343 r42876  
    497497                         * @since 2.3.0
    498498                         *
    499                          * @param array $to_do An array of script dependencies.
     499                         * @param string[] $to_do An array of script dependency handles.
    500500                         */
    501501                        $this->to_do = apply_filters( 'print_scripts_array', $this->to_do );
  • trunk/src/wp-includes/class.wp-styles.php

    r42343 r42876  
    307307                         * @since 2.6.0
    308308                         *
    309                          * @param array $to_do The list of enqueued styles about to be processed.
     309                         * @param string[] $to_do The list of enqueued style handles about to be processed.
    310310                         */
    311311                        $this->to_do = apply_filters( 'print_styles_array', $this->to_do );
  • trunk/src/wp-includes/comment-template.php

    r42843 r42876  
    524524         * @since 2.7.0
    525525         *
    526          * @param array       $classes    An array of comment classes.
     526         * @param string[]    $classes    An array of comment classes.
    527527         * @param string      $class      A comma-separated list of additional classes added to the list.
    528528         * @param int         $comment_id The comment id.
     
    22812281         * @since 3.0.0
    22822282         *
    2283          * @param array $fields The default comment fields.
     2283         * @param string[] $fields Array of the default comment fields.
    22842284         */
    22852285        $fields   = apply_filters( 'comment_form_default_fields', $fields );
  • trunk/src/wp-includes/comment.php

    r42772 r42876  
    518518 * @since 4.5.0
    519519 *
    520  * @param array $comments Array of comment objects.
     520 * @param WP_Comment[] $comments Array of comment objects.
    521521 */
    522522function wp_queue_comments_for_comment_meta_lazyload( $comments ) {
     
    919919 * @since 2.7.0
    920920 *
    921  * @param array $comments Array of comments
    922  * @return array Array of comments keyed by comment_type.
     921 * @param WP_Comment[] $comments Array of comments
     922 * @return WP_Comment[] Array of comments keyed by comment_type.
    923923 */
    924924function separate_comments( &$comments ) {
     
    953953 * @global WP_Query $wp_query
    954954 *
    955  * @param array $comments Optional array of WP_Comment objects. Defaults to $wp_query->comments
    956  * @param int   $per_page Optional comments per page.
    957  * @param bool  $threaded Optional control over flat or threaded comments.
     955 * @param WP_Comment[] $comments Optional. Array of WP_Comment objects. Defaults to $wp_query->comments.
     956 * @param int          $per_page Optional. Comments per page.
     957 * @param bool         $threaded Optional. Control over flat or threaded comments.
    958958 * @return int Number of comment pages.
    959959 */
     
    27412741         * @since 2.0.0
    27422742         *
    2743          * @param array $post_links An array of post links to be checked (passed by reference).
    2744          * @param array $pung       Whether a link has already been pinged (passed by reference).
    2745          * @param int   $post_ID    The post ID.
     2743         * @param string[] $post_links Array of link URLs to be checked (passed by reference).
     2744         * @param string[] $pung       Array of link URLs already pinged (passed by reference).
     2745         * @param int      $post_ID    The post ID.
    27462746         */
    27472747        do_action_ref_array( 'pre_ping', array( &$post_links, &$pung, $post->ID ) );
     
    29332933 * @since 4.4.0 Introduced the `$update_meta_cache` parameter.
    29342934 *
    2935  * @param array $comments          Array of comment row objects
    2936  * @param bool  $update_meta_cache Whether to update commentmeta cache. Default true.
     2935 * @param WP_Comment[] $comments          Array of comment objects
     2936 * @param bool         $update_meta_cache Whether to update commentmeta cache. Default true.
    29372937 */
    29382938function update_comment_cache( $comments, $update_meta_cache = true ) {
     
    29602960 * @global wpdb $wpdb WordPress database abstraction object.
    29612961 *
    2962  * @param array $comment_ids       Array of comment IDs.
     2962 * @param int[] $comment_ids       Array of comment IDs.
    29632963 * @param bool  $update_meta_cache Optional. Whether to update the meta cache. Default true.
    29642964 */
     
    29982998         * @since 3.2.0
    29992999         *
    3000          * @param array $post_types An array of registered post types. Default array with 'post'.
     3000         * @param string[] $post_types An array of post type names.
    30013001         */
    30023002        $post_types = apply_filters( 'close_comments_for_post_types', array( 'post' ) );
  • trunk/src/wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

    r42746 r42876  
    469469         * @see wp_get_nav_menu_items()
    470470         *
    471          * @param array $items An array of menu item post objects.
    472          * @param object $menu  The menu object.
    473          * @param array  $args  An array of arguments used to retrieve menu item objects.
    474          * @return array Array of menu items,
     471         * @param WP_Post[] $items An array of menu item post objects.
     472         * @param WP_Term  $menu  The menu object.
     473         * @param array     $args  An array of arguments used to retrieve menu item objects.
     474         * @return WP_Post[] Array of menu item objects.
    475475         */
    476476        public function filter_wp_get_nav_menu_items( $items, $menu, $args ) {
     
    542542         * @see wp_get_nav_menu_items()
    543543         *
    544          * @param array $items An array of menu item post objects.
    545          * @param object $menu  The menu object.
    546          * @param array  $args  An array of arguments used to retrieve menu item objects.
    547          * @return array Array of menu items,
     544         * @param WP_Post[] $items An array of menu item post objects.
     545         * @param WP_Term  $menu  The menu object.
     546         * @param array     $args  An array of arguments used to retrieve menu item objects.
     547         * @return WP_Post[] Array of menu item objects.
    548548         */
    549549        public static function sort_wp_get_nav_menu_items( $items, $menu, $args ) {
  • trunk/src/wp-includes/customize/class-wp-customize-nav-menu-setting.php

    r42343 r42876  
    233233         * @see wp_get_nav_menus()
    234234         *
    235          * @param array $menus An array of menu objects.
    236          * @param array $args  An array of arguments used to retrieve menu objects.
    237          * @return array
     235         * @param WP_Term[] $menus An array of menu objects.
     236         * @param array     $args  An array of arguments used to retrieve menu objects.
     237         * @return WP_Term[] Array of menu objects.
    238238         */
    239239        public function filter_wp_get_nav_menus( $menus, $args ) {
  • trunk/src/wp-includes/customize/class-wp-customize-selective-refresh.php

    r42343 r42876  
    219219         * @see WP_Customize_Manager::add_dynamic_settings()
    220220         *
    221          * @param array $partial_ids The partial ID to add.
    222          * @return array Added WP_Customize_Partial instances.
     221         * @param string[] $partial_ids Array of the partial IDs to add.
     222         * @return WP_Customize_Partial[] Array of added WP_Customize_Partial instances.
    223223         */
    224224        public function add_dynamic_partials( $partial_ids ) {
  • trunk/src/wp-includes/date.php

    r42343 r42876  
    500500                         * @since 4.1.0 Added 'user_registered' to the default recognized columns.
    501501                         *
    502                          * @param array $valid_columns An array of valid date query columns. Defaults
    503                          *                             are 'post_date', 'post_date_gmt', 'post_modified',
    504                          *                             'post_modified_gmt', 'comment_date', 'comment_date_gmt',
    505                          *                             'user_registered'
     502                         * @param string[] $valid_columns An array of valid date query columns. Defaults
     503                         *                                are 'post_date', 'post_date_gmt', 'post_modified',
     504                         *                                'post_modified_gmt', 'comment_date', 'comment_date_gmt',
     505                         *                                'user_registered'
    506506                         */
    507507                        if ( ! in_array( $column, apply_filters( 'date_query_valid_columns', $valid_columns ) ) ) {
  • trunk/src/wp-includes/embed.php

    r42343 r42876  
    7777         * @since 2.9.0
    7878         *
    79          * @param array  $size An array of embed width and height values
     79         * @param int[]  $size An array of embed width and height values
    8080         *                     in pixels (in that order).
    8181         * @param string $url  The URL that should be embedded.
  • trunk/src/wp-includes/functions.php

    r42836 r42876  
    54585458
    54595459/**
    5460  * Retrieve ids that are not already present in the cache.
     5460 * Retrieve IDs that are not already present in the cache.
    54615461 *
    54625462 * @since 3.4.0
    54635463 * @access private
    54645464 *
    5465  * @param array  $object_ids ID list.
     5465 * @param int[]  $object_ids Array of IDs.
    54665466 * @param string $cache_key  The cache bucket to check against.
    5467  *
    5468  * @return array List of ids not present in the cache.
     5467 * @return int[] Array of IDs not present in the cache.
    54695468 */
    54705469function _get_non_cached_ids( $object_ids, $cache_key ) {
  • trunk/src/wp-includes/l10n.php

    r42843 r42876  
    550550 * @since 1.5.0
    551551 *
    552  * @global array $l10n          An array of all currently loaded text domains.
    553  * @global array $l10n_unloaded An array of all text domains that have been unloaded again.
     552 * @global MO[] $l10n          An array of all currently loaded text domains.
     553 * @global MO[] $l10n_unloaded An array of all text domains that have been unloaded again.
    554554 *
    555555 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
     
    624624 * @since 3.0.0
    625625 *
    626  * @global array $l10n          An array of all currently loaded text domains.
    627  * @global array $l10n_unloaded An array of all text domains that have been unloaded again.
     626 * @global MO[] $l10n          An array of all currently loaded text domains.
     627 * @global MO[] $l10n_unloaded An array of all text domains that have been unloaded again.
    628628 *
    629629 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
     
    857857 *
    858858 * @see get_translations_for_domain()
    859  * @global array $l10n_unloaded An array of all text domains that have been unloaded again.
     859 * @global MO[] $l10n_unloaded An array of all text domains that have been unloaded again.
    860860 *
    861861 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
     
    965965 * @since 2.8.0
    966966 *
    967  * @global array $l10n
     967 * @global MO[] $l10n
    968968 * @staticvar NOOP_Translations $noop_translations
    969969 *
     
    990990 * @since 3.0.0
    991991 *
    992  * @global array $l10n
     992 * @global MO[] $l10n
    993993 *
    994994 * @param string $domain Text domain. Unique identifier for retrieving translated strings.
  • trunk/src/wp-includes/post.php

    r42769 r42876  
    10441044 *                               element from the array needs to match; 'and' means all elements
    10451045 *                               must match; 'not' means no elements may match. Default 'and'.
    1046  * @return array A list of post type names or objects.
     1046 * @return string[]|WP_Post_Type[] An array of post type names or objects.
    10471047 */
    10481048function get_post_types( $args = array(), $output = 'names', $operator = 'and' ) {
     
    43424342 *
    43434343 * @param int|WP_Post $post_id Post ID or object.
    4344  * @return array
     4344 * @return bool|string[] Array of URLs already pinged for the given post, false if the post is not found.
    43454345 */
    43464346function get_pung( $post_id ) {
     
    43584358         * @since 2.0.0
    43594359         *
    4360          * @param array $pung Array of URLs already pinged for the given post.
     4360         * @param string[] $pung Array of URLs already pinged for the given post.
    43614361         */
    43624362        return apply_filters( 'get_pung', $pung );
Note: See TracChangeset for help on using the changeset viewer.