WordPress at a glance
filter is not described

auth_(object_type)_meta_(meta_key) filter-hook . WP 4.6.0

Filters whether the user is allowed to edit a specific meta key of a specific object type.

Return true to have the mapped meta caps from edit_{$object_type} apply.

The dynamic portion of the hook name, $object_type refers to the object type being filtered. The dynamic portion of the hook name, $meta_key, refers to the meta key passed to map_meta_cap().

Usage

add_filter( 'auth_(object_type)_meta_(meta_key)', 'filter_function_name_7381', 10, 6 );
function filter_function_name_7381( $allowed, $meta_key, $object_id, $user_id, $cap, $caps ){
	// filter...

	return $allowed;
}
$allowed(true/false)
Whether the user can add the object meta.
Default: false
$meta_key(string)
The meta key.
$object_id(int)
Object ID.
$user_id(int)
User ID.
$cap(string)
Capability name.
$caps(string[])
Array of the user's capabilities.

Notes

  • Since 3.3.0 As auth_post_meta_{$meta_key}.

Where the hook is called

map_meta_cap()
wp-includes/capabilities.php 332
$allowed = apply_filters( "auth_{$object_type}_meta_{$meta_key}", $allowed, $meta_key, $object_id, $user_id, $cap, $caps );

Where the hook is used (in WP core)

wp-includes/meta.php 1167
add_filter( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['auth_callback'], 10, 6 );
wp-includes/meta.php 1169
add_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'], 10, 6 );
wp-includes/meta.php 1234
remove_filter( "auth_{$object_type}_meta_{$meta_key}_for_{$object_subtype}", $args['auth_callback'] );
wp-includes/meta.php 1236
remove_filter( "auth_{$object_type}_meta_{$meta_key}", $args['auth_callback'] );