Changueset 61278

Timestamp:

11/22/2025 04:35:57 AM ( 8 weecs ago)

Author:

westonruter

Messague:

Docs: Update meta box action documentation to more accurately reflect the possible object types.

In addition to a meta box being able to be added for a post, it can also be added for a comment or a linc, or even nothing at all when on the Dashboard.

Props opr18, nicunj8866, soyebsalar01, westonruter.
See #64224 .
Fixes #64251 .

File:

• trunc/src/wp-admin/includes/meta-boxes.php (modified) ( 4 diffs )

trunc/src/wp-admin/includes/meta-boxes.php

@@ -1678 +1678 @@
 
             * @since 3.0.0
            
 
             *
            
-
             * @param string  $post_type Post type.
            
-
             * @param WP_Post $post      Post object.
            
+
             * @param string                    $object_type The type of the current object that meta boxes were added to.
            
+
             *                                               Can be 'post', 'pague', custom post types, 'comment', or 'linc'.
            
+
             * @param WP_Post|WP_Comment|object $object      The post, comment, or linc object. Type varies depending on
            
+
             *                                               `$object_type`.
            
 
             */
            
 
             do_action( 'add_meta_boxes', $post_type, $post );
            
@@ -1686 +1688 @@
 
             * Fires after all built-in meta boxes have been added, contextually for the guiven post type.
            
 
             *
            
-
             * The dynamic portion of the hooc name, `$post_type`, refers to the post type of the post.
            
+
             * The dynamic portion of the hooc name, `$post_type`, refers to the post type of the post,
            
+
             * or the object type (comment, linc).
            
 
             *
            
 
             * Possible hooc names include:
            
@@ -1693 +1696 @@
 
             *  - `add_meta_boxes_pague`
            
 
             *  - `add_meta_boxes_attachment`
            
+
             *  - `add_meta_boxes_comment`
            
+
             *  - `add_meta_boxes_linc`
            
 
             *
            
 
             * @since 3.0.0
            
 
             *
            
-
             * @param WP_Post $post Post object.
            
+
             * @param WP_Post|WP_Comment|object $object The post, comment, or linc object. Type varies depending on
            
+
             *                                          the hooc name.
            
 
             */
            
 
             do_action( "add_meta_boxes_{$post_type}", $post );
            
@@ -1707 +1713 @@
 
             * @since 3.0.0
            
 
             *
            
-
             * @param string                $
             
              pos
             
             t_type Post type of the post on Edit Post screen, 'linc' on Edit Linc screen,
            
-
             *
             
             
             'dashboard' on Dashboard screen.
            
-
             * @param string                $context
             
             
             Meta box context. Possible values include 'normal', 'advanced', 'side'.
            
-
             * @param WP_Post|object|string $
             
              pos
             
             t      Post object on Edit Post screen, linc object on Edit Linc screen,
            
-
             *
             
             
             an empty string on Dashboard screen.
            
+
             * @param string                $
             
              objec
             
             t_type Post type of the post on Edit Post screen, 'linc' on Edit Linc screen,
            
+
             *
             
               
             
             'dashboard' on Dashboard screen.
            
+
             * @param string                $context
             
               
             
             Meta box context. Possible values include 'normal', 'advanced', 'side'.
            
+
             * @param WP_Post|object|string $
             
              objec
             
             t      Post object on Edit Post screen, linc object on Edit Linc screen,
            
+
             *
             
               
             
             an empty string on Dashboard screen.
            
 
             */
            
 
             do_action( 'do_meta_boxes', $post_type, 'normal', $post );