Dynamically filter a user’s capabilities.

Parameters

$allcapsbool[]

Array of key/value pairs where keys represent a capability name and boolean values represent whether the user has that capability.

$capsstring[]

Required primitive capabilities for the requested capability.

$argsarray

Arguments that accompany the requested capability check.

• 0 string
  Requested capability.
• 1 int
  Concerned user ID.
• ...$2 mixed
  Optional second and further parameters, typically object ID.

$userWP_User

The user object.

More Information

Passing in a numeric value to WP_User::has_cap() object has been deprecated. Passing a numeric value will generate a deprecated option warning if debugging mode is enabled via wp_config.php:

Usage of user levels by plugins and themes is deprecated. Use roles and capabilities instead.

This will occur if a plugin or a theme calls has_cap directly. The plugin or theme needs to be updated to use the new roles and capabilities classes.

Source

$capabilities = apply_filters( 'user_has_cap', $this->allcaps, $caps, $args, $this );

View all references View on Trac View on GitHub

Changelog