[wp-meta] [Making WordPress.org] #7889: Incorrect Code Example in admin_action_{action} Hook Documentation

Making WordPress.org noreply at wordpress.org
Mon Jan 20 09:01:51 UTC 2025


#7889: Incorrect Code Example in admin_action_{action} Hook Documentation
---------------------------+--------------------
 Reporter:  jdahir0789     |      Owner:  (none)
     Type:  defect (bug)   |     Status:  new
 Priority:  normal         |  Milestone:
Component:  Developer Hub  |   Keywords:
---------------------------+--------------------
 **Issue Description**
 The code example provided in the admin_action_{action} hook documentation
 does not match the actual implementation found in the WordPress core
 files.

 **URL of the Page with the Issue**
 https://developer.wordpress.org/reference/hooks/admin_action__requestaction

 **Section of Page with the issue**
 https://developer.wordpress.org/reference/hooks/admin_action__requestaction/#source

 **Why is this a problem?**
 The inaccurate code example can mislead developers into implementing the
 hook incorrectly, potentially causing issues in their WordPress sites or
 plugins. Clear and accurate examples are essential for helping developers
 understand how to use hooks properly.

 **Suggested Fix**
 Replace the current code example with the accurate implementation as found
 in wp-admin/admin.php between lines 408-420. Below is the correct code:


 {{{
 if ( ! empty( $_REQUEST['action'] ) ) {
         $action = $_REQUEST['action'];

         /**
          * Fires when an 'action' request variable is sent.
          *
          * The dynamic portion of the hook name, `$action`, refers to
          * the action derived from the `GET` or `POST` request.
          *
          * @since 2.6.0
          */
         do_action( "admin_action_{$action}" );
 }
 }}}

-- 
Ticket URL: <https://meta.trac.wordpress.org/ticket/7889>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org


More information about the wp-meta mailing list