map_meta_cap filter-hook . WP 2.8.0

Filters a user's capabilities depending on specific context and/or privilege.

Usage

add_filter( 'map_meta_cap', 'filter_function_name_1018', 10, 4 );
function filter_function_name_1018( $caps, $cap, $user_id, $args ){
	// filter...

	return $caps;
}

$caps(array)

Returns the user's actual capabilities.

$cap(string)

Capability name.

$user_id(int)

The user ID.

$args(array)

Adds the context to the cap. Typically the object ID.

Where the hook is called

return apply_filters( 'map_meta_cap', $caps, $cap, $user_id, $args );

Where the hook is used (in WP core)

add_filter( 'map_meta_cap', array( $this, 'grant_edit_post_capability_for_changeset' ), 10, 4 );

remove_filter( 'map_meta_cap', array( $this, 'grant_edit_post_capability_for_changeset' ), 10 );