Make WordPress Core

Changeset 42876


Ignore:
Timestamp:
03/25/2018 07:32:24 PM (7 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.