interface AgreementHandlerInterface in Agreement 3.0.x

Agreement handler interface.

Hierarchy

• interface \Drupal\agreement\AgreementHandlerInterface

2 files declare their use of AgreementHandlerInterface

AgreementForm.php in src/Form/AgreementForm.php

AgreementSubscriber.php in src/EventSubscriber/AgreementSubscriber.php

File

src/AgreementHandlerInterface.php, line 12

Namespace

Drupal\agreement

interface AgreementHandlerInterface {

  /**
   * Check the status of an user account for a particular agreement.
   *
   * @param \Drupal\agreement\Entity\Agreement $agreement
   *   The agreement to check if a user has agreed.
   * @param \Drupal\Core\Session\AccountProxyInterface $account
   *   The user account to check.
   *
   * @return bool
   *   TRUE if the user account has agreed to this agreement.
   */
  public function hasAgreed(Agreement $agreement, AccountProxyInterface $account);

  /**
   * Get the last agreement for the user for the agreement.
   *
   * @param \Drupal\agreement\Entity\Agreement $agreement
   *   The agreement to check if a user has agreed.
   * @param \Drupal\user\UserInterface $account
   *   The user account to check.
   *
   * @return int
   *   The timestamp that the user last agreed or -1 if never agreed.
   */
  public function lastAgreed(Agreement $agreement, UserInterface $account);

  /**
   * Check if an user can bypass the agreement or if the agreement applies.
   *
   * @param \Drupal\agreement\Entity\Agreement $agreement
   *   The agreement to check roles.
   * @param \Drupal\Core\Session\AccountProxyInterface $account
   *   The user account to check bypass permission.
   */
  public function canAgree(Agreement $agreement, AccountProxyInterface $account);

  /**
   * Accept the agreement for an user account.
   *
   * @param \Drupal\agreement\Entity\Agreement $agreement
   *   The agreement that the user is agreeing to.
   * @param \Drupal\Core\Session\AccountProxyInterface $account
   *   The user account to agree.
   * @param int $agreed
   *   An optional integer to set the agreement status to. Defaults to 1.
   *
   * @return bool|\Symfony\Component\HttpFoundation\Cookie
   *   TRUE if the operation was successful and the user is authenticated,
   *   a cookie if the operation was successful and the user is anonymous,
   *   otherwise FALSE.
   */
  public function agree(Agreement $agreement, AccountProxyInterface $account, $agreed = 1);

  /**
   * Find the agreement by user account and path.
   *
   * @param \Drupal\Core\Session\AccountProxyInterface $account
   *   The user account to check.
   * @param string $path
   *   The path to check.
   *
   * @return \Drupal\agreement\Entity\Agreement|false
   *   The agreement entity to use or FALSE if none found.
   */
  public function getAgreementByUserAndPath(AccountProxyInterface $account, $path);

  /**
   * Checks if we're processing an anonymous agreement.
   *
   * @param \Drupal\agreement\Entity\Agreement $agreement
   *   The agreement to check for anonymous support.
   * @param \Drupal\Core\Session\AccountProxyInterface $account
   *   The user account to check.
   *
   * @return bool
   *   TRUE if the user is anonymous and the current agreement applies to
   *   anonymous users. Otherwise FALSE.
   */
  public function isAnonymousAgreement(Agreement $agreement, AccountProxyInterface $account);

  /**
   * Adds leading slash to a path string.
   *
   * @param string $value
   *   The value.
   *
   * @return string
   *   The new value.
   */
  public static function prefixPath($value);

}

Members

Name	Modifiers	Type	Description	Overrides
AgreementHandlerInterface::agree	public	function	Accept the agreement for an user account.	1
AgreementHandlerInterface::canAgree	public	function	Check if an user can bypass the agreement or if the agreement applies.	1
AgreementHandlerInterface::getAgreementByUserAndPath	public	function	Find the agreement by user account and path.	1
AgreementHandlerInterface::hasAgreed	public	function	Check the status of an user account for a particular agreement.	1
AgreementHandlerInterface::isAnonymousAgreement	public	function	Checks if we're processing an anonymous agreement.	1
AgreementHandlerInterface::lastAgreed	public	function	Get the last agreement for the user for the agreement.	1
AgreementHandlerInterface::prefixPath	public static	function	Adds leading slash to a path string.	1