interface WebformAccessRulesManagerInterface in Webform 6.x

Interface of webform access rules manager.

Hierarchy

• interface \Drupal\webform\WebformAccessRulesManagerInterface

2 files declare their use of WebformAccessRulesManagerInterface

WebformEntityAccessControlHandlerTest.php in tests/src/Unit/WebformEntityAccessControlHandlerTest.php

WebformGroupManager.php in modules/webform_group/src/WebformGroupManager.php

File

src/WebformAccessRulesManagerInterface.php, line 10

Namespace

Drupal\webform

interface WebformAccessRulesManagerInterface {

  /**
   * Check if operation is allowed through access rules for a given webform.
   *
   * @param string $operation
   *   Operation to check.
   * @param \Drupal\Core\Session\AccountInterface $account
   *   Account who is requesting the operation.
   * @param \Drupal\webform\WebformInterface $webform
   *   Webform on which the operation is requested.
   *
   * @return \Drupal\Core\Access\AccessResultInterface
   *   Access result.
   */
  public function checkWebformAccess($operation, AccountInterface $account, WebformInterface $webform);

  /**
   * Check if operation is allowed through access rules for a submission.
   *
   * @param string $operation
   *   Operation to check.
   * @param \Drupal\Core\Session\AccountInterface $account
   *   Account who is requesting the operation.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   Webform submission on which the operation is requested.
   *
   * @return \Drupal\Core\Access\AccessResultInterface
   *   Access result.
   */
  public function checkWebformSubmissionAccess($operation, AccountInterface $account, WebformSubmissionInterface $webform_submission);

  /****************************************************************************/

  // Get access rules methods.

  /****************************************************************************/

  /**
   * Returns the webform default access rules.
   *
   * @return array
   *   A structured array containing all the webform default access rules.
   */
  public function getDefaultAccessRules();

  /**
   * Retrieve a list of access rules from a webform.
   *
   * @param \Drupal\webform\WebformInterface $webform
   *   Webform whose access rules to retrieve.
   *
   * @return array
   *   Associative array of access rules contained in the provided webform. Keys
   *   are operation names whereas values are sub arrays with the following
   *   structure:
   *   - roles: (array) Array of roles that should have access to this operation
   *   - users: (array) Array of UIDs that should have access to this operation
   *   - permissions: (array) Array of permissions that should grant access to
   *     this operation
   */
  public function getAccessRules(WebformInterface $webform);

  /****************************************************************************/

  // Check access rules methods.

  /****************************************************************************/

  /**
   * Check access for a given operation and set of access rules.
   *
   * @param string $operation
   *   Operation that is being requested.
   * @param \Drupal\Core\Session\AccountInterface $account
   *   Account that is requesting access to the operation.
   * @param array $access_rules
   *   A set of access rules to check against.
   *
   * @return bool
   *   TRUE if access is allowed and FALSE is access is denied.
   */
  public function checkAccessRules($operation, AccountInterface $account, array $access_rules);

  /**
   * Collect metadata on known access rules.
   *
   * @return array
   *   Array that describes all known access rules. It will be keyed by access
   *   rule machine-name and will contain sub arrays with the following
   *   structure:
   *   - title: (string) Human-friendly translated string that describes the
   *     meaning of this access rule.
   *   - description: (array) Renderable array that explains what this access rule
   *     stands for. Defaults to an empty array.
   *   - roles: (string[]) Array of role IDs that should be granted this access
   *     rule by default. Defaults to an empty array.
   *   - permissions: (string[]) Array of permissions that should be granted this
   *     access rule by default. Defaults to an empty array.
   */
  public function getAccessRulesInfo();

  /**
   * Determine if access rules should be cached per user.
   *
   * @param array $access_rules
   *   A set of access rules.
   *
   * @return bool
   *   TRUE if access rules should be cached per user.
   */
  public function cachePerUser(array $access_rules);

}

Members

Name	Modifiers	Type	Description	Overrides
WebformAccessRulesManagerInterface::cachePerUser	public	function	Determine if access rules should be cached per user.	1
WebformAccessRulesManagerInterface::checkAccessRules	public	function	Check access for a given operation and set of access rules.	1
WebformAccessRulesManagerInterface::checkWebformAccess	public	function	Check if operation is allowed through access rules for a given webform.	1
WebformAccessRulesManagerInterface::checkWebformSubmissionAccess	public	function	Check if operation is allowed through access rules for a submission.	1
WebformAccessRulesManagerInterface::getAccessRules	public	function	Retrieve a list of access rules from a webform.	1
WebformAccessRulesManagerInterface::getAccessRulesInfo	public	function	Collect metadata on known access rules.	1
WebformAccessRulesManagerInterface::getDefaultAccessRules	public	function	Returns the webform default access rules.	1