Make WordPress Core

Changeset 49672


Ignore:
Timestamp:
11/19/2020 06:22:02 PM (4 years ago)
Author:
johnbillion
Message:

Docs: Document parameters that accept an array of integers using typed array notation.

While many of these parameters also technically accept an array of numerical strings, they are all ultimately cast to an array of integers. Documenting them as such assists developers in understanding the expected types.

See #51800, #41756

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

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/author-template.php

    r48576 r49672  
    406406 *                                       will be separated by commas.
    407407 *     @type bool         $html          Whether to list the items in HTML form or plaintext. Default true.
    408  *     @type array|string $exclude       Array or comma/space-separated list of author IDs to exclude. Default empty.
    409  *     @type array|string $include       Array or comma/space-separated list of author IDs to include. Default empty.
     408 *     @type int[]|string $exclude       Array or comma/space-separated list of author IDs to exclude. Default empty.
     409 *     @type int[]|string $include       Array or comma/space-separated list of author IDs to include. Default empty.
    410410 * }
    411411 * @return void|string Void if 'echo' argument is true, list of authors if 'echo' is false.
  • trunk/src/wp-includes/category-template.php

    r49669 r49672  
    487487 *     for information on additional accepted arguments.
    488488 *
    489  *     @type int|array    $current_category      ID of category, or array of IDs of categories, that should get the
     489 *     @type int|int[]    $current_category      ID of category, or array of IDs of categories, that should get the
    490490 *                                               'current-cat' class. Default 0.
    491491 *     @type int          $depth                 Category depth. Used for tab indentation. Default 0.
    492492 *     @type bool|int     $echo                  Whether to echo or return the generated markup. Accepts 0, 1, or their
    493493 *                                               bool equivalents. Default 1.
    494  *     @type array|string $exclude               Array or comma/space-separated string of term IDs to exclude.
     494 *     @type int[]|string $exclude               Array or comma/space-separated string of term IDs to exclude.
    495495 *                                               If `$hierarchical` is true, descendants of `$exclude` terms will also
    496496 *                                               be excluded; see `$exclude_tree`. See get_terms().
    497497 *                                               Default empty string.
    498  *     @type array|string $exclude_tree          Array or comma/space-separated string of term IDs to exclude, along
     498 *     @type int[]|string $exclude_tree          Array or comma/space-separated string of term IDs to exclude, along
    499499 *                                               with their descendants. See get_terms(). Default empty string.
    500500 *     @type string       $feed                  Text to use for the feed link. Default 'Feed for all posts filed
  • trunk/src/wp-includes/class-wp-comment-query.php

    r49472 r49672  
    148148     *     @type string       $author_email              Comment author email address. Default empty.
    149149     *     @type string       $author_url                Comment author URL. Default empty.
    150      *     @type array        $author__in                Array of author IDs to include comments for. Default empty.
    151      *     @type array        $author__not_in            Array of author IDs to exclude comments for. Default empty.
    152      *     @type array        $comment__in               Array of comment IDs to include. Default empty.
    153      *     @type array        $comment__not_in           Array of comment IDs to exclude. Default empty.
     150     *     @type int[]        $author__in                Array of author IDs to include comments for. Default empty.
     151     *     @type int[]        $author__not_in            Array of author IDs to exclude comments for. Default empty.
     152     *     @type int[]        $comment__in               Array of comment IDs to include. Default empty.
     153     *     @type int[]        $comment__not_in           Array of comment IDs to exclude. Default empty.
    154154     *     @type bool         $count                     Whether to return a comment count (true) or array of
    155155     *                                                   comment objects (false). Default false.
     
    196196     *     @type int          $parent                    Parent ID of comment to retrieve children of.
    197197     *                                                   Default empty.
    198      *     @type array        $parent__in                Array of parent IDs of comments to retrieve children for.
    199      *                                                   Default empty.
    200      *     @type array        $parent__not_in            Array of parent IDs of comments *not* to retrieve
     198     *     @type int[]        $parent__in                Array of parent IDs of comments to retrieve children for.
     199     *                                                   Default empty.
     200     *     @type int[]        $parent__not_in            Array of parent IDs of comments *not* to retrieve
    201201     *                                                   children for. Default empty.
    202      *     @type array        $post_author__in           Array of author IDs to retrieve comments for.
    203      *                                                   Default empty.
    204      *     @type array        $post_author__not_in       Array of author IDs *not* to retrieve comments for.
     202     *     @type int[]        $post_author__in           Array of author IDs to retrieve comments for.
     203     *                                                   Default empty.
     204     *     @type int[]        $post_author__not_in       Array of author IDs *not* to retrieve comments for.
    205205     *                                                   Default empty.
    206206     *     @type int          $post_ID                   Currently unused.
    207207     *     @type int          $post_id                   Limit results to those affiliated with a given post ID.
    208208     *                                                   Default 0.
    209      *     @type array        $post__in                  Array of post IDs to include affiliated comments for.
    210      *                                                   Default empty.
    211      *     @type array        $post__not_in              Array of post IDs to exclude affiliated comments for.
     209     *     @type int[]        $post__in                  Array of post IDs to include affiliated comments for.
     210     *                                                   Default empty.
     211     *     @type int[]        $post__not_in              Array of post IDs to exclude affiliated comments for.
    212212     *                                                   Default empty.
    213213     *     @type int          $post_author               Post author ID to limit results by. Default empty.
  • trunk/src/wp-includes/class-wp-date-query.php

    r49108 r49672  
    116116     *             @type bool         $inclusive     Optional. Include results from dates specified in 'before' or
    117117     *                                               'after'. Default false.
    118      *             @type int|array    $year          Optional. The four-digit year number. Accepts any four-digit year
     118     *             @type int|int[]    $year          Optional. The four-digit year number. Accepts any four-digit year
    119119     *                                               or an array of years if `$compare` supports it. Default empty.
    120      *             @type int|array    $month         Optional. The two-digit month number. Accepts numbers 1-12 or an
     120     *             @type int|int[]    $month         Optional. The two-digit month number. Accepts numbers 1-12 or an
    121121     *                                               array of valid numbers if `$compare` supports it. Default empty.
    122      *             @type int|array    $week          Optional. The week number of the year. Accepts numbers 0-53 or an
     122     *             @type int|int[]    $week          Optional. The week number of the year. Accepts numbers 0-53 or an
    123123     *                                               array of valid numbers if `$compare` supports it. Default empty.
    124      *             @type int|array    $dayofyear     Optional. The day number of the year. Accepts numbers 1-366 or an
     124     *             @type int|int[]    $dayofyear     Optional. The day number of the year. Accepts numbers 1-366 or an
    125125     *                                               array of valid numbers if `$compare` supports it.
    126      *             @type int|array    $day           Optional. The day of the month. Accepts numbers 1-31 or an array
     126     *             @type int|int[]    $day           Optional. The day of the month. Accepts numbers 1-31 or an array
    127127     *                                               of valid numbers if `$compare` supports it. Default empty.
    128      *             @type int|array    $dayofweek     Optional. The day number of the week. Accepts numbers 1-7 (1 is
     128     *             @type int|int[]    $dayofweek     Optional. The day number of the week. Accepts numbers 1-7 (1 is
    129129     *                                               Sunday) or an array of valid numbers if `$compare` supports it.
    130130     *                                               Default empty.
    131      *             @type int|array    $dayofweek_iso Optional. The day number of the week (ISO). Accepts numbers 1-7
     131     *             @type int|int[]    $dayofweek_iso Optional. The day number of the week (ISO). Accepts numbers 1-7
    132132     *                                               (1 is Monday) or an array of valid numbers if `$compare` supports it.
    133133     *                                               Default empty.
    134      *             @type int|array    $hour          Optional. The hour of the day. Accepts numbers 0-23 or an array
     134     *             @type int|int[]    $hour          Optional. The hour of the day. Accepts numbers 0-23 or an array
    135135     *                                               of valid numbers if `$compare` supports it. Default empty.
    136      *             @type int|array    $minute        Optional. The minute of the hour. Accepts numbers 0-60 or an array
     136     *             @type int|int[]    $minute        Optional. The minute of the hour. Accepts numbers 0-60 or an array
    137137     *                                               of valid numbers if `$compare` supports it. Default empty.
    138      *             @type int|array    $second        Optional. The second of the minute. Accepts numbers 0-60 or an
     138     *             @type int|int[]    $second        Optional. The second of the minute. Accepts numbers 0-60 or an
    139139     *                                               array of valid numbers if `$compare` supports it. Default empty.
    140140     *         }
  • trunk/src/wp-includes/class-wp-network-query.php

    r49538 r49672  
    9090     *     Optional. Array or query string of network query parameters. Default empty.
    9191     *
    92      *     @type array        $network__in          Array of network IDs to include. Default empty.
    93      *     @type array        $network__not_in      Array of network IDs to exclude. Default empty.
     92     *     @type int[]        $network__in          Array of network IDs to include. Default empty.
     93     *     @type int[]        $network__not_in      Array of network IDs to exclude. Default empty.
    9494     *     @type bool         $count                Whether to return a network count (true) or array of network objects.
    9595     *                                              Default false.
  • trunk/src/wp-includes/class-wp-query.php

    r49506 r49672  
    631631     *     @type int|string   $author                  Author ID, or comma-separated list of IDs.
    632632     *     @type string       $author_name             User 'user_nicename'.
    633      *     @type array        $author__in              An array of author IDs to query from.
    634      *     @type array        $author__not_in          An array of author IDs not to query from.
     633     *     @type int[]        $author__in              An array of author IDs to query from.
     634     *     @type int[]        $author__not_in          An array of author IDs not to query from.
    635635     *     @type bool         $cache_results           Whether to cache post information. Default true.
    636636     *     @type int|string   $cat                     Category ID or comma-separated list of IDs (this or any children).
    637      *     @type array        $category__and           An array of category IDs (AND in).
    638      *     @type array        $category__in            An array of category IDs (OR in, no children).
    639      *     @type array        $category__not_in        An array of category IDs (NOT in).
     637     *     @type int[]        $category__and           An array of category IDs (AND in).
     638     *     @type int[]        $category__in            An array of category IDs (OR in, no children).
     639     *     @type int[]        $category__not_in        An array of category IDs (NOT in).
    640640     *     @type string       $category_name           Use category slug (not name, this or any children).
    641641     *     @type array|int    $comment_count           Filter results by comment count. Provide an integer to match
     
    697697     *     @type string       $perm                    Show posts if user has the appropriate capability.
    698698     *     @type string       $ping_status             Ping status.
    699      *     @type array        $post__in                An array of post IDs to retrieve, sticky posts will be included.
    700      *     @type array        $post__not_in            An array of post IDs not to retrieve. Note: a string of comma-
     699     *     @type int[]        $post__in                An array of post IDs to retrieve, sticky posts will be included.
     700     *     @type int[]        $post__not_in            An array of post IDs not to retrieve. Note: a string of comma-
    701701     *                                                 separated IDs will NOT work.
    702702     *     @type string       $post_mime_type          The mime type of the post. Used for 'attachment' post_type.
     
    704704     *     @type int          $post_parent             Page ID to retrieve child pages for. Use 0 to only retrieve
    705705     *                                                 top-level pages.
    706      *     @type array        $post_parent__in         An array containing parent page IDs to query child pages from.
    707      *     @type array        $post_parent__not_in     An array containing parent page IDs not to query child pages from.
     706     *     @type int[]        $post_parent__in         An array containing parent page IDs to query child pages from.
     707     *     @type int[]        $post_parent__not_in     An array containing parent page IDs not to query child pages from.
    708708     *     @type string|array $post_type               A post type slug (string) or array of post type slugs.
    709709     *                                                 Default 'any' if using 'tax_query'.
     
    721721     *     @type bool         $suppress_filters        Whether to suppress filters. Default false.
    722722     *     @type string       $tag                     Tag slug. Comma-separated (either), Plus-separated (all).
    723      *     @type array        $tag__and                An array of tag IDs (AND in).
    724      *     @type array        $tag__in                 An array of tag IDs (OR in).
    725      *     @type array        $tag__not_in             An array of tag IDs (NOT in).
     723     *     @type int[]        $tag__and                An array of tag IDs (AND in).
     724     *     @type int[]        $tag__in                 An array of tag IDs (OR in).
     725     *     @type int[]        $tag__not_in             An array of tag IDs (NOT in).
    726726     *     @type int          $tag_id                  Tag id or comma-separated list of IDs.
    727727     *     @type array        $tag_slug__and           An array of tag slugs (AND in).
     
    729729     *                                                 true. Note: a string of comma-separated IDs will NOT work.
    730730     *     @type array        $tax_query               An associative array of WP_Tax_Query arguments.
    731      *                                                 See WP_Tax_Query->queries.
     731     *                                                 See WP_Tax_Query->__construct().
    732732     *     @type string       $title                   Post title.
    733733     *     @type bool         $update_post_meta_cache  Whether to update the post meta cache. Default true.
  • trunk/src/wp-includes/class-wp-site-query.php

    r49538 r49672  
    115115     *     Optional. Array or query string of site query parameters. Default empty.
    116116     *
    117      *     @type array        $site__in               Array of site IDs to include. Default empty.
    118      *     @type array        $site__not_in           Array of site IDs to exclude. Default empty.
     117     *     @type int[]        $site__in               Array of site IDs to include. Default empty.
     118     *     @type int[]        $site__not_in           Array of site IDs to exclude. Default empty.
    119119     *     @type bool         $count                  Whether to return a site count (true) or array of site objects.
    120120     *                                                Default false.
     
    136136     *     @type int          $network_id             Limit results to those affiliated with a given network ID. If 0,
    137137     *                                                include all networks. Default 0.
    138      *     @type array        $network__in            Array of network IDs to include affiliated sites for. Default empty.
    139      *     @type array        $network__not_in        Array of network IDs to exclude affiliated sites for. Default empty.
     138     *     @type int[]        $network__in            Array of network IDs to include affiliated sites for. Default empty.
     139     *     @type int[]        $network__not_in        Array of network IDs to exclude affiliated sites for. Default empty.
    140140     *     @type string       $domain                 Limit results to those affiliated with a given domain. Default empty.
    141141     *     @type array        $domain__in             Array of domains to include affiliated sites for. Default empty.
  • trunk/src/wp-includes/class-wp-term-query.php

    r49637 r49672  
    9595     *     @type string|array $taxonomy               Taxonomy name, or array of taxonomies, to which results should
    9696     *                                                be limited.
    97      *     @type int|array    $object_ids             Optional. Object ID, or array of object IDs. Results will be
     97     *     @type int|int[]    $object_ids             Optional. Object ID, or array of object IDs. Results will be
    9898     *                                                limited to terms associated with these objects.
    9999     *     @type string       $orderby                Field(s) to order terms by. Accepts:
     
    114114     *     @type bool|int     $hide_empty             Whether to hide terms not assigned to any posts. Accepts
    115115     *                                                1|true or 0|false. Default 1|true.
    116      *     @type array|string $include                Array or comma/space-separated string of term IDs to include.
     116     *     @type int[]|string $include                Array or comma/space-separated string of term IDs to include.
    117117     *                                                Default empty array.
    118      *     @type array|string $exclude                Array or comma/space-separated string of term IDs to exclude.
     118     *     @type int[]|string $exclude                Array or comma/space-separated string of term IDs to exclude.
    119119     *                                                If $include is non-empty, $exclude is ignored.
    120120     *                                                Default empty array.
    121      *     @type array|string $exclude_tree           Array or comma/space-separated string of term IDs to exclude
     121     *     @type int[]|string $exclude_tree           Array or comma/space-separated string of term IDs to exclude
    122122     *                                                along with all of their descendant terms. If $include is
    123123     *                                                non-empty, $exclude_tree is ignored. Default empty array.
     
    150150     *     @type string|array $slug                   Optional. Slug or array of slugs to return term(s) for.
    151151     *                                                Default empty.
    152      *     @type int|array    $term_taxonomy_id       Optional. Term taxonomy ID, or array of term taxonomy IDs,
     152     *     @type int|int[]    $term_taxonomy_id       Optional. Term taxonomy ID, or array of term taxonomy IDs,
    153153     *                                                to match when querying terms.
    154154     *     @type bool         $hierarchical           Whether to include terms that have non-empty descendants
  • trunk/src/wp-includes/class-wp-user-query.php

    r49637 r49672  
    155155     *                                             'BETWEEN', 'NOT BETWEEN', 'EXISTS', 'NOT EXISTS', 'REGEXP',
    156156     *                                             'NOT REGEXP', or 'RLIKE'. Default '='.
    157      *     @type array        $include             An array of user IDs to include. Default empty array.
    158      *     @type array        $exclude             An array of user IDs to exclude. Default empty array.
     157     *     @type int[]        $include             An array of user IDs to include. Default empty array.
     158     *     @type int[]        $exclude             An array of user IDs to exclude. Default empty array.
    159159     *     @type string       $search              Search keyword. Searches for possible string matches on columns.
    160160     *                                             When `$search_columns` is left empty, it tries to determine which
  • trunk/src/wp-includes/link-template.php

    r49622 r49672  
    16671667 *
    16681668 * @param bool         $in_same_term   Optional. Whether post should be in a same taxonomy term. Default false.
    1669  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     1669 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    16701670 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    16711671 * @return null|string|WP_Post Post object if successful. Null if global $post is not set. Empty string if no
     
    16821682 *
    16831683 * @param bool         $in_same_term   Optional. Whether post should be in a same taxonomy term. Default false.
    1684  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     1684 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    16851685 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    16861686 * @return null|string|WP_Post Post object if successful. Null if global $post is not set. Empty string if no
     
    17011701 *
    17021702 * @param bool         $in_same_term   Optional. Whether post should be in a same taxonomy term. Default false.
    1703  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     1703 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    17041704 * @param bool         $previous       Optional. Whether to retrieve previous post. Default true
    17051705 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
     
    18951895 * @param string       $title          Optional. Link title format. Default '%title'.
    18961896 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    1897  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     1897 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    18981898 * @param bool         $previous       Optional. Whether to display link to previous or next post. Default true.
    18991899 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
     
    19541954 * @param string       $title          Optional. Link title format. Default '%title'.
    19551955 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    1956  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     1956 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    19571957 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    19581958 */
     
    19891989 * @param string       $title          Optional. Link title format. Default '%title'.
    19901990 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    1991  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     1991 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    19921992 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    19931993 */
     
    20052005 * @param string       $title          Optional. Link title format. Default '%title'.
    20062006 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2007  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default true.
     2007 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default true.
    20082008 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    20092009 */
     
    20222022 * @param bool         $in_same_term   Optional. Whether returned post should be in a same taxonomy term.
    20232023 *                                     Default false.
    2024  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
     2024 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs.
    20252025 *                                     Default empty.
    20262026 * @param bool         $start          Optional. Whether to retrieve first or last post. Default true
     
    20862086 * @param string       $link           Optional. Link permalink format. Default '%title'.
    20872087 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2088  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     2088 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    20892089 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    20902090 * @return string The link URL of the previous post in relation to the current post.
     
    21042104 * @param string       $link           Optional. Link permalink format. Default '%title'.
    21052105 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2106  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     2106 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    21072107 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    21082108 */
     
    21192119 * @param string       $link           Optional. Link permalink format. Default '%title'.
    21202120 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2121  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     2121 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    21222122 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    21232123 * @return string The link URL of the next post in relation to the current post.
     
    21372137 * @param string       $link           Optional. Link permalink format. Default '%title'
    21382138 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2139  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
     2139 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded term IDs. Default empty.
    21402140 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
    21412141 */
     
    21542154 * @param string       $link           Link permalink format.
    21552155 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2156  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded terms IDs. Default empty.
     2156 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded terms IDs. Default empty.
    21572157 * @param bool         $previous       Optional. Whether to display link to previous or next post. Default true.
    21582158 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
     
    22192219 * @param string       $link           Link permalink format.
    22202220 * @param bool         $in_same_term   Optional. Whether link should be in a same taxonomy term. Default false.
    2221  * @param array|string $excluded_terms Optional. Array or comma-separated list of excluded category IDs. Default empty.
     2221 * @param int[]|string $excluded_terms Optional. Array or comma-separated list of excluded category IDs. Default empty.
    22222222 * @param bool         $previous       Optional. Whether to display link to previous or next post. Default true.
    22232223 * @param string       $taxonomy       Optional. Taxonomy, if $in_same_term is true. Default 'category'.
     
    25682568 *     @type string       $next_text          Anchor text to display in the next post link. Default '%title'.
    25692569 *     @type bool         $in_same_term       Whether link should be in a same taxonomy term. Default false.
    2570  *     @type array|string $excluded_terms     Array or comma-separated list of excluded term IDs. Default empty.
     2570 *     @type int[]|string $excluded_terms     Array or comma-separated list of excluded term IDs. Default empty.
    25712571 *     @type string       $taxonomy           Taxonomy, if `$in_same_term` is true. Default 'category'.
    25722572 *     @type string       $screen_reader_text Screen reader text for the nav element. Default 'Post navigation'.
  • trunk/src/wp-includes/ms-deprecated.php

    r48126 r49672  
    465465 *     Array of default arguments. Optional.
    466466 *
    467  *     @type int|array $network_id A network ID or array of network IDs. Set to null to retrieve sites
     467 *     @type int|int[] $network_id A network ID or array of network IDs. Set to null to retrieve sites
    468468 *                                 from all networks. Defaults to current network ID.
    469469 *     @type int       $public     Retrieve public or non-public sites. Default null, for any.
  • trunk/src/wp-includes/ms-site.php

    r49597 r49672  
    414414 *     Optional. Array or query string of site query parameters. Default empty.
    415415 *
    416  *     @type array        $site__in          Array of site IDs to include. Default empty.
    417  *     @type array        $site__not_in      Array of site IDs to exclude. Default empty.
     416 *     @type int[]        $site__in          Array of site IDs to include. Default empty.
     417 *     @type int[]        $site__not_in      Array of site IDs to exclude. Default empty.
    418418 *     @type bool         $count             Whether to return a site count (true) or array of site objects.
    419419 *                                           Default false.
     
    435435 *     @type int          $network_id        Limit results to those affiliated with a given network ID. If 0,
    436436 *                                           include all networks. Default 0.
    437  *     @type array        $network__in       Array of network IDs to include affiliated sites for. Default empty.
    438  *     @type array        $network__not_in   Array of network IDs to exclude affiliated sites for. Default empty.
     437 *     @type int[]        $network__in       Array of network IDs to include affiliated sites for. Default empty.
     438 *     @type int[]        $network__not_in   Array of network IDs to exclude affiliated sites for. Default empty.
    439439 *     @type string       $domain            Limit results to those affiliated with a given domain. Default empty.
    440440 *     @type array        $domain__in        Array of domains to include affiliated sites for. Default empty.
  • trunk/src/wp-includes/post.php

    r49616 r49672  
    20162016 *     available arguments.
    20172017 *
    2018  *     @type int        $numberposts      Total number of posts to retrieve. Is an alias of $posts_per_page
     2018 *     @type int        $numberposts      Total number of posts to retrieve. Is an alias of `$posts_per_page`
    20192019 *                                        in WP_Query. Accepts -1 for all. Default 5.
    20202020 *     @type int|string $category         Category ID or comma-separated list of IDs (this or any children).
    2021  *                                        Is an alias of $cat in WP_Query. Default 0.
    2022  *     @type array      $include          An array of post IDs to retrieve, sticky posts will be included.
    2023  *                                        Is an alias of $post__in in WP_Query. Default empty array.
    2024  *     @type array      $exclude          An array of post IDs not to retrieve. Default empty array.
     2021 *                                        Is an alias of `$cat` in WP_Query. Default 0.
     2022 *     @type int[]      $include          An array of post IDs to retrieve, sticky posts will be included.
     2023 *                                        Is an alias of `$post__in` in WP_Query. Default empty array.
     2024 *     @type int[]      $exclude          An array of post IDs not to retrieve. Default empty array.
    20252025 *     @type bool       $suppress_filters Whether to suppress filters. Default true.
    20262026 * }
     
    36513651 *     @type string $post_mime_type        The mime type of the post. Default empty.
    36523652 *     @type string $guid                  Global Unique ID for referencing the post. Default empty.
    3653  *     @type array  $post_category         Array of category IDs.
     3653 *     @type int[]  $post_category         Array of category IDs.
    36543654 *                                         Defaults to value of the 'default_category' option.
    36553655 *     @type array  $tags_input            Array of tag names, slugs, or IDs. Default empty.
     
    48234823 * @param int       $post_ID         Optional. The Post ID. Does not default to the ID
    48244824 *                                   of the global $post. Default 0.
    4825  * @param array|int $post_categories Optional. List of category IDs, or the ID of a single category.
     4825 * @param int[]|int $post_categories Optional. List of category IDs, or the ID of a single category.
    48264826 *                                   Default empty array.
    48274827 * @param bool      $append          If true, don't delete existing categories, just add on.
     
    54855485 *                                      `$child_of` also being false, both arguments will be disregarded.
    54865486 *                                      Default true.
    5487  *     @type array        $exclude      Array of page IDs to exclude. Default empty array.
    5488  *     @type array        $include      Array of page IDs to include. Cannot be used with `$child_of`,
     5487 *     @type int[]        $exclude      Array of page IDs to exclude. Default empty array.
     5488 *     @type int[]        $include      Array of page IDs to include. Cannot be used with `$child_of`,
    54895489 *                                      `$parent`, `$exclude`, `$meta_key`, `$meta_value`, or `$hierarchical`.
    54905490 *                                      Default empty array.
     
    54945494 *     @type string       $authors      A comma-separated list of author IDs. Default empty.
    54955495 *     @type int          $parent       Page ID to return direct children of. Default -1, or no restriction.
    5496  *     @type string|array $exclude_tree Comma-separated string or array of page IDs to exclude.
     5496 *     @type string|int[] $exclude_tree Comma-separated string or array of page IDs to exclude.
    54975497 *                                      Default empty array.
    54985498 *     @type int          $number       The number of pages to return. Default 0, or all pages.
  • trunk/src/wp-includes/user.php

    r49627 r49672  
    12551255 *                                                 order. Accepts 'ASC' (ascending) or 'DESC' (descending).
    12561256 *                                                 Default 'ASC'.
    1257  *     @type array|string $include                 Array or comma-separated list of user IDs to include.
     1257 *     @type int[]|string $include                 Array or comma-separated list of user IDs to include.
    12581258 *                                                 Default empty.
    1259  *     @type array|string $exclude                 Array or comma-separated list of user IDs to exclude.
     1259 *     @type int[]|string $exclude                 Array or comma-separated list of user IDs to exclude.
    12601260 *                                                 Default empty.
    12611261 *     @type bool|int     $multi                   Whether to skip the ID attribute on the 'select' element.
Note: See TracChangeset for help on using the changeset viewer.