function BlockPluginInterface::access

Same name in other branches
  1. 9 core/lib/Drupal/Core/Block/BlockPluginInterface.php \Drupal\Core\Block\BlockPluginInterface::access()
  2. 10 core/lib/Drupal/Core/Block/BlockPluginInterface.php \Drupal\Core\Block\BlockPluginInterface::access()
  3. 11.x core/lib/Drupal/Core/Block/BlockPluginInterface.php \Drupal\Core\Block\BlockPluginInterface::access()

Indicates whether the block should be shown.

This method allows base implementations to add general access restrictions that should apply to all extending block plugins.

Parameters

\Drupal\Core\Session\AccountInterface $account: The user session for which to check access.

bool $return_as_object: (optional) Defaults to FALSE.

Return value

bool|\Drupal\Core\Access\AccessResultInterface The access result. Returns a boolean if $return_as_object is FALSE (this is the default) and otherwise an AccessResultInterface object. When a boolean is returned, the result of AccessInterface::isAllowed() is returned, i.e. TRUE means access is explicitly allowed, FALSE means access is either explicitly forbidden or "no opinion".

See also

\Drupal\block\BlockAccessControlHandler

File

core/lib/Drupal/Core/Block/BlockPluginInterface.php, line 63

Class

BlockPluginInterface
Defines the required interface for all block plugins.

Namespace

Drupal\Core\Block

Code

public function access(AccountInterface $account, $return_as_object = FALSE);

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.