Make WordPress Core


Ignore:
Timestamp:
05/22/2016 06:34:03 PM (9 years ago)
Author:
DrewAPicture
Message:

Docs: Standardize filter docs in wp-includes/pluggable.php to use third-person singular verbs per the inline documentation standards for PHP.

See #36913.

File:
1 edited

Legend:

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

    r37315 r37508  
    175175
    176176    /**
    177      * Filter the wp_mail() arguments.
     177     * Filters the wp_mail() arguments.
    178178     *
    179179     * @since 2.2.0
     
    330330
    331331    /**
    332      * Filter the email address to send from.
     332     * Filters the email address to send from.
    333333     *
    334334     * @since 2.2.0
     
    339339
    340340    /**
    341      * Filter the name to associate with the "from" email address.
     341     * Filters the name to associate with the "from" email address.
    342342     *
    343343     * @since 2.3.0
     
    417417
    418418    /**
    419      * Filter the wp_mail() content type.
     419     * Filters the wp_mail() content type.
    420420     *
    421421     * @since 2.3.0
     
    438438
    439439    /**
    440      * Filter the default wp_mail() charset.
     440     * Filters the default wp_mail() charset.
    441441     *
    442442     * @since 2.3.0
     
    514514
    515515    /**
    516      * Filter whether a set of user login credentials are valid.
     516     * Filters whether a set of user login credentials are valid.
    517517     *
    518518     * A WP_User object is returned if the credentials authenticate a user.
     
    721721
    722722    /**
    723      * Filter the authentication cookie.
     723     * Filters the authentication cookie.
    724724     *
    725725     * @since 2.5.0
     
    803803    if ( $remember ) {
    804804        /**
    805          * Filter the duration of the authentication cookie expiration period.
     805         * Filters the duration of the authentication cookie expiration period.
    806806         *
    807807         * @since 2.8.0
     
    832832
    833833    /**
    834      * Filter whether the connection is secure.
     834     * Filters whether the connection is secure.
    835835     *
    836836     * @since 3.1.0
     
    842842
    843843    /**
    844      * Filter whether to use a secure cookie when logged-in.
     844     * Filters whether to use a secure cookie when logged-in.
    845845     *
    846846     * @since 3.1.0
     
    968968
    969969    /**
    970      * Filter whether to use a secure authentication redirect.
     970     * Filters whether to use a secure authentication redirect.
    971971     *
    972972     * @since 3.1.0
     
    991991    } else {
    992992        /**
    993          * Filter the authentication redirect scheme.
     993         * Filters the authentication redirect scheme.
    994994         *
    995995         * @since 2.9.0
     
    11441144
    11451145    /**
    1146      * Filter the redirect location.
     1146     * Filters the redirect location.
    11471147     *
    11481148     * @since 2.1.0
     
    11541154
    11551155    /**
    1156      * Filter the redirect status code.
     1156     * Filters the redirect status code.
    11571157     *
    11581158     * @since 2.3.0
     
    12481248
    12491249    /**
    1250      * Filter the redirect fallback URL for when the provided redirect is not safe (local).
     1250     * Filters the redirect fallback URL for when the provided redirect is not safe (local).
    12511251     *
    12521252     * @since 4.3.0
     
    13121312
    13131313    /**
    1314      * Filter the whitelist of hosts to redirect to.
     1314     * Filters the whitelist of hosts to redirect to.
    13151315     *
    13161316     * @since 2.3.0
     
    13571357
    13581358    /**
    1359      * Filter the list of email addresses to receive a comment notification.
     1359     * Filters the list of email addresses to receive a comment notification.
    13601360     *
    13611361     * By default, only post authors are notified of comments. This filter allows
     
    13791379
    13801380    /**
    1381      * Filter whether to notify comment authors of their comments on their own posts.
     1381     * Filters whether to notify comment authors of their comments on their own posts.
    13821382     *
    13831383     * By default, comment authors aren't notified of their comments on their own
     
    14851485
    14861486    /**
    1487      * Filter the comment notification email text.
     1487     * Filters the comment notification email text.
    14881488     *
    14891489     * @since 1.5.2
     
    14951495
    14961496    /**
    1497      * Filter the comment notification email subject.
     1497     * Filters the comment notification email subject.
    14981498     *
    14991499     * @since 1.5.2
     
    15051505
    15061506    /**
    1507      * Filter the comment notification email headers.
     1507     * Filters the comment notification email headers.
    15081508     *
    15091509     * @since 1.5.2
     
    15421542
    15431543    /**
    1544      * Filter whether to send the site moderator email notifications, overriding the site setting.
     1544     * Filters whether to send the site moderator email notifications, overriding the site setting.
    15451545     *
    15461546     * @since 4.4.0
     
    16171617
    16181618    /**
    1619      * Filter the list of recipients for comment moderation emails.
     1619     * Filters the list of recipients for comment moderation emails.
    16201620     *
    16211621     * @since 3.7.0
     
    16271627
    16281628    /**
    1629      * Filter the comment moderation email text.
     1629     * Filters the comment moderation email text.
    16301630     *
    16311631     * @since 1.5.2
     
    16371637
    16381638    /**
    1639      * Filter the comment moderation email subject.
     1639     * Filters the comment moderation email subject.
    16401640     *
    16411641     * @since 1.5.2
     
    16471647
    16481648    /**
    1649      * Filter the comment moderation email headers.
     1649     * Filters the comment moderation email headers.
    16501650     *
    16511651     * @since 2.8.0
     
    17661766function wp_nonce_tick() {
    17671767    /**
    1768      * Filter the lifespan of nonces in seconds.
     1768     * Filters the lifespan of nonces in seconds.
    17691769     *
    17701770     * @since 2.5.0
     
    17981798    if ( ! $uid ) {
    17991799        /**
    1800          * Filter whether the user who generated the nonce is logged out.
     1800         * Filters whether the user who generated the nonce is logged out.
    18011801         *
    18021802         * @since 3.5.0
     
    19101910    if ( isset( $cached_salts[ $scheme ] ) ) {
    19111911        /**
    1912          * Filter the WordPress salt.
     1912         * Filters the WordPress salt.
    19131913         *
    19141914         * @since 2.5.0
     
    20572057
    20582058        /**
    2059          * Filter whether the plaintext password matches the encrypted password.
     2059         * Filters whether the plaintext password matches the encrypted password.
    20602060         *
    20612061         * @since 2.5.0
     
    21102110
    21112111    /**
    2112      * Filter the randomly-generated password.
     2112     * Filters the randomly-generated password.
    21132113     *
    21142114     * @since 3.0.0
     
    22992299
    23002300    /**
    2301      * Filter whether to retrieve the avatar URL early.
     2301     * Filters whether to retrieve the avatar URL early.
    23022302     *
    23032303     * Passing a non-null value will effectively short-circuit get_avatar(), passing
     
    23582358
    23592359    /**
    2360      * Filter the avatar to retrieve.
     2360     * Filters the avatar to retrieve.
    23612361     *
    23622362     * @since 2.5.0
Note: See TracChangeset for help on using the changeset viewer.