Changeset 51837 for trunk/src/wp-includes/comment.php

Timestamp:

09/21/2021 06:19:19 PM (5 years ago)

Author:

johnbillion

Message:

Docs: Document some more common names for dynamic hooks and standardise the phrasing used.

Fixes #53581

File:

• trunk/src/wp-includes/comment.php (modified) (2 diffs)

trunk/src/wp-includes/comment.php

@@ -1827 +1827 @@
                  * refer to the old and new comment statuses, respectively.
                  *
+                 * Possible hook names include:
+                 *
+                 *  - `comment_unapproved_to_approved`
+                 *  - `comment_spam_to_approved`
+                 *  - `comment_approved_to_unapproved`
+                 *  - `comment_spam_to_unapproved`
+                 *  - `comment_unapproved_to_spam`
+                 *  - `comment_approved_to_spam`
+                 *
                  * @since 2.7.0
                  *
@@ -1839 +1848 @@
          * refer to the new comment status, and the type of comment, respectively.
          *
-         * Typical comment types include an empty string (standard comment), 'pingback',
-         * or 'trackback'.
+         * Typical comment types include 'comment', 'pingback', or 'trackback'.
+         *
+         * Possible hook names include:
+         *
+         *  - `comment_approved_comment`
+         *  - `comment_approved_pingback`
+         *  - `comment_approved_trackback`
+         *  - `comment_unapproved_comment`
+         *  - `comment_unapproved_pingback`
+         *  - `comment_unapproved_trackback`
+         *  - `comment_spam_comment`
+         *  - `comment_spam_pingback`
+         *  - `comment_spam_trackback`
          *
          * @since 2.7.0