Properly split and document the admin_post* actions into the following four hooks:

* `admin_post_nopriv` – for logged-out requests lacking a supplied action
* `admin_post_nopriv_$action – for logged-out requests with a supplied action
* `admin_post` – for logged-in requests lacking a supplied action
* `admin_post_$action` – for logged-in requests with a supplied action

See [28349], [28350], [28351].
See #26869.

Built from https://develop.svn.wordpress.org/trunk@28394


git-svn-id: http://core.svn.wordpress.org/trunk@28222 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2014-05-13 07:24:15 +00:00
parent 40a738c21c
commit a23cc5634f

View File

@ -26,31 +26,44 @@ nocache_headers();
/** This action is documented in wp-admin/admin.php */ /** This action is documented in wp-admin/admin.php */
do_action( 'admin_init' ); do_action( 'admin_init' );
$action = ''; $action = empty( $_REQUEST['action'] ) ? '' : $_REQUEST['action'];
if ( !wp_validate_auth_cookie() ) if ( ! wp_validate_auth_cookie() ) {
$action .= '_nopriv'; if ( empty( $action ) ) {
/**
if ( !empty($_REQUEST['action']) ) * Fires on a non-authenticated admin post request where no action was supplied.
$action .= '_' . $_REQUEST['action']; *
* @since 2.6.0
/** */
* Fires the requested handler action. do_action( 'admin_post_nopriv' );
* } else {
* The dynamic portion of the hook name, $action, refers to a combination /**
* of whether the user is logged-in or not, and the requested handler action. * Fires on a non-authenticated admin post request for the given action.
* *
* If the user is logged-out, '_nopriv' will be affixed to the * The dynamic portion of the hook name, $action, refers to the given
* base "admin_post" hook name. If a handler action was passed, that action * request action.
* will also be affixed. *
* * @since 2.6.0
* For example: */
* Hook combinations fired for logged-out users: do_action( "admin_post_nopriv_{$action}" );
* `admin_post_nopriv_{$action}` and `admin_post_nopriv` (no action supplied). }
* } else {
* Hook combinations fired for logged-in users: if ( empty( $action ) ) {
* `admin_post_{$action}` and `admin_post` (no action supplied). /**
* * Fires on an authenticated admin post request where no action was supplied.
* @since 2.6.0 *
*/ * @since 2.6.0
do_action( "admin_post{$action}" ); */
do_action( 'admin_post' );
} else {
/**
* Fires on an authenticated admin post request for the given action.
*
* The dynamic portion of the hook name, $action, refers to the given
* request action.
*
* @since 2.6.0
*/
do_action( "admin_post_{$action}" );
}
}