You are here

interface DefaultRoleEventInterface in Organic groups 8

Interface for DefaultRoleEvent classes.

This event allows implementing modules to provide their own default roles or alter existing default roles that are provided by other modules.

Hierarchy

  • interface \Drupal\og\Event\DefaultRoleEventInterface extends \Drupal\og\Event\ArrayAccess \Drupal\og\Event\IteratorAggregate

Expanded class hierarchy of DefaultRoleEventInterface

All classes that implement DefaultRoleEventInterface

3 files declare their use of DefaultRoleEventInterface
DefaultRoleEventIntegrationTest.php in tests/src/Kernel/DefaultRoleEventIntegrationTest.php
OgEventSubscriber.php in src/EventSubscriber/OgEventSubscriber.php
OgRoleManager.php in src/OgRoleManager.php

File

src/Event/DefaultRoleEventInterface.php, line 15

Namespace

Drupal\og\Event
View source
interface DefaultRoleEventInterface extends \ArrayAccess, \IteratorAggregate {

  /**
   * The event name.
   */
  const EVENT_NAME = 'og.default_role';

  /**
   * Returns a single default role.
   *
   * @param string $name
   *   The name of the role to return.
   *
   * @return \Drupal\og\OgRoleInterface
   *   The OgRole entity.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the role with the given name does not exist.
   */
  public function getRole($name);

  /**
   * Returns all the default role names.
   *
   * @return array
   *   An associative array of default role properties, keyed by role name.
   */
  public function getRoles();

  /**
   * Adds a default role.
   *
   * @param \Drupal\og\Entity\OgRole $role
   *   The OgRole entity to add. This should be an unsaved entity that doesn't
   *   have the group entity type and bundle IDs set.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the role that is added already exists.
   */
  public function addRole(OgRole $role);

  /**
   * Adds multiple default roles.
   *
   * @param \Drupal\og\Entity\OgRole[] $roles
   *   An array of OgRole entities to add. These should be unsaved entities that
   *   don't have the group entity type and bundle IDs set.
   */
  public function addRoles(array $roles);

  /**
   * Sets a default roles.
   *
   * @param \Drupal\og\Entity\OgRole $role
   *   The OgRole entity to set. This should be an unsaved entity that doesn't
   *   have the group entity type and bundle IDs set.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the role name is empty, or when the 'label' property is
   *   missing.
   */
  public function setRole(OgRole $role);

  /**
   * Sets multiple default roles.
   *
   * @param \Drupal\og\Entity\OgRole[] $roles
   *   An array of OgRole entities to set. These should be unsaved entities that
   *   don't have the group entity type and bundle IDs set.
   */
  public function setRoles(array $roles);

  /**
   * Deletes the given default role.
   *
   * @param string $name
   *   The name of the role to delete.
   */
  public function deleteRole($name);

  /**
   * Returns whether or not the given role exists.
   *
   * @param string $name
   *   The name of the role for which to verify the existence.
   *
   * @return bool
   *   TRUE if the role exists, FALSE otherwise.
   */
  public function hasRole($name);

}

Members

Namesort descending Modifiers Type Description Overrides
DefaultRoleEventInterface::addRole public function Adds a default role. 1
DefaultRoleEventInterface::addRoles public function Adds multiple default roles. 1
DefaultRoleEventInterface::deleteRole public function Deletes the given default role. 1
DefaultRoleEventInterface::EVENT_NAME constant The event name.
DefaultRoleEventInterface::getRole public function Returns a single default role. 1
DefaultRoleEventInterface::getRoles public function Returns all the default role names. 1
DefaultRoleEventInterface::hasRole public function Returns whether or not the given role exists. 1
DefaultRoleEventInterface::setRole public function Sets a default roles. 1
DefaultRoleEventInterface::setRoles public function Sets multiple default roles. 1