WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
07/10/2020 08:21:01 PM (6 years ago)
Author:
SergeyBiryukov
Message:

Docs: Improve @return tags for various conditional tags.

Props stevenlinx, SergeyBiryukov.
Fixes #50626.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-includes/class-wp-query.php

    r48406 r48426  
    36063606     * @since 3.1.0
    36073607     *
    3608      * @return bool
     3608     * @return bool Whether the query is for an existing archive page.
    36093609     */
    36103610    public function is_archive() {
    … …  
    36193619     * @param string|string[] $post_types Optional. Post type or array of posts types
    36203620     *                                    to check against. Default empty.
    3621      * @return bool
     3621     * @return bool Whether the query is for an existing post type archive page.
    36223622     */
    36233623    public function is_post_type_archive( $post_types = '' ) {
    … …  
    36423642     * @param int|string|int[]|string[] $attachment Optional. Attachment ID, title, slug, or array of such
    36433643     *                                              to check against. Default empty.
    3644      * @return bool
     3644     * @return bool Whether the query is for an existing attachment page.
    36453645     */
    36463646    public function is_attachment( $attachment = '' ) {
    … …  
    36773677     * @param int|string|int[]|string[] $author Optional. User ID, nickname, nicename, or array of such
    36783678     *                                          to check against. Default empty.
    3679      * @return bool
     3679     * @return bool Whether the query is for an existing author archive page.
    36803680     */
    36813681    public function is_author( $author = '' ) {
    … …  
    37133713     * @param int|string|int[]|string[] $category Optional. Category ID, name, slug, or array of such
    37143714     *                                            to check against. Default empty.
    3715      * @return bool
     3715     * @return bool Whether the query is for an existing category archive page.
    37163716     */
    37173717    public function is_category( $category = '' ) {
    … …  
    37493749     * @param int|string|int[]|string[] $tag Optional. Tag ID, name, slug, or array of such
    37503750     *                                       to check against. Default empty.
    3751      * @return bool
     3751     * @return bool Whether the query is for an existing tag archive page.
    37523752     */
    37533753    public function is_tag( $tag = '' ) {
    … …  
    37933793     * @param int|string|int[]|string[] $term     Optional. Term ID, name, slug, or array of such
    37943794     *                                            to check against. Default empty.
    3795      * @return bool True for custom taxonomy archive pages, false for built-in taxonomies
     3795     * @return bool Whether the query is for an existing custom taxonomy archive page.
     3796     *              True for custom taxonomy archive pages, false for built-in taxonomies
    37963797     *              (category and tag archives).
    37973798     */
    … …  
    38363837     * @deprecated 4.5.0
    38373838     *
    3838      * @return bool
     3839     * @return false Always returns false.
    38393840     */
    38403841    public function is_comments_popup() {
    … …  
    38493850     * @since 3.1.0
    38503851     *
    3851      * @return bool
     3852     * @return bool Whether the query is for an existing date archive.
    38523853     */
    38533854    public function is_date() {
    … …  
    38603861     * @since 3.1.0
    38613862     *
    3862      * @return bool
     3863     * @return bool Whether the query is for an existing day archive.
    38633864     */
    38643865    public function is_day() {
    … …  
    38733874     * @param string|string[] $feeds Optional. Feed type or array of feed types
    38743875     *                                         to check against. Default empty.
    3875      * @return bool
     3876     * @return bool Whether the query is for a feed.
    38763877     */
    38773878    public function is_feed( $feeds = '' ) {
    … …  
    38793880            return (bool) $this->is_feed;
    38803881        }
     3882
    38813883        $qv = $this->get( 'feed' );
    38823884        if ( 'feed' === $qv ) {
    38833885            $qv = get_default_feed();
    38843886        }
     3887
    38853888        return in_array( $qv, (array) $feeds, true );
    38863889    }
    … …  
    38913894     * @since 3.1.0
    38923895     *
    3893      * @return bool
     3896     * @return bool Whether the query is for a comments feed.
    38943897     */
    38953898    public function is_comment_feed() {
    … …  
    39113914     * @since 3.1.0
    39123915     *
    3913      * @return bool True, if front of site.
     3916     * @return bool Whether the query is for the front page of the site.
    39143917     */
    39153918    public function is_front_page() {
    … …  
    39403943     * @since 3.1.0
    39413944     *
    3942      * @return bool True if blog view homepage.
     3945     * @return bool Whether the query is for the blog homepage.
    39433946     */
    39443947    public function is_home() {
    … …  
    39573960     * @since 5.2.0
    39583961     *
    3959      * @return bool True, if Privacy Policy page.
     3962     * @return bool Whether the query is for the Privacy Policy page.
    39603963     */
    39613964    public function is_privacy_policy() {
    … …  
    39743977     * @since 3.1.0
    39753978     *
    3976      * @return bool
     3979     * @return bool Whether the query is for an existing month archive.
    39773980     */
    39783981    public function is_month() {
    … …  
    40314034
    40324035    /**
    4033      * Is the query for paged result and not for the first page?
     4036     * Is the query for a paged result and not for the first page?
    40344037     *
    40354038     * @since 3.1.0
    40364039     *
    4037      * @return bool
     4040     * @return bool Whether the query is for a paged result.
    40384041     */
    40394042    public function is_paged() {
    … …  
    40464049     * @since 3.1.0
    40474050     *
    4048      * @return bool
     4051     * @return bool Whether the query is for a post or page preview.
    40494052     */
    40504053    public function is_preview() {
    … …  
    40574060     * @since 3.1.0
    40584061     *
    4059      * @return bool
     4062     * @return bool Whether the query is for the robots.txt file.
    40604063     */
    40614064    public function is_robots() {
    … …  
    40684071     * @since 5.4.0
    40694072     *
    4070      * @return bool
     4073     * @return bool Whether the query is for the favicon.ico file.
    40714074     */
    40724075    public function is_favicon() {
    … …  
    40794082     * @since 3.1.0
    40804083     *
    4081      * @return bool
     4084     * @return bool Whether the query is for a search.
    40824085     */
    40834086    public function is_search() {
    … …  
    41684171     * @since 3.1.0
    41694172     *
    4170      * @return bool
     4173     * @return bool Whether the query is for a specific time.
    41714174     */
    41724175    public function is_time() {
    … …  
    41794182     * @since 3.1.0
    41804183     *
    4181      * @return bool
     4184     * @return bool Whether the query is for a trackback endpoint call.
    41824185     */
    41834186    public function is_trackback() {
    … …  
    41904193     * @since 3.1.0
    41914194     *
    4192      * @return bool
     4195     * @return bool Whether the query is for an existing year archive.
    41934196     */
    41944197    public function is_year() {
    … …  
    42014204     * @since 3.1.0
    42024205     *
    4203      * @return bool
     4206     * @return bool Whether the query is a 404 error.
    42044207     */
    42054208    public function is_404() {
    … …  
    42124215     * @since 4.4.0
    42134216     *
    4214      * @return bool
     4217     * @return bool Whether the query is for an embedded post.
    42154218     */
    42164219    public function is_embed() {
    … …  
    42254228     * @global WP_Query $wp_query WordPress Query object.
    42264229     *
    4227      * @return bool
     4230     * @return bool Whether the query is the main query.
    42284231     */
    42294232    public function is_main_query() {
Note: See TracChangeset for help on using the changeset viewer.