interface WorkflowManagerInterface in Workflow 8

Provides an interface for workflow manager.

Contains lost of functions from D7 workflow.module file.

Hierarchy

• interface \Drupal\workflow\Entity\WorkflowManagerInterface

File

src/Entity/WorkflowManagerInterface.php, line 13

Namespace

Drupal\workflow\Entity

interface WorkflowManagerInterface {

  /**
   * Given a time frame, execute all scheduled transitions.
   *
   * Implements hook_cron().
   *
   * @param int $start
   * @param int $end
   */
  public static function executeScheduledTransitionsBetween($start = 0, $end = 0);

  /**
   * Execute a single transition for the given entity.
   *
   * Implements hook_entity insert(), hook_entity_update().
   *
   * When inserting an entity with workflow field, the initial Transition is
   * saved without reference to the proper entity, since Id is not yet known.
   * So, we cannot save Transition in the Widget, but only(?) in a hook.
   * To keep things simple, this is done for both insert() and update().
   *
   * This is referenced in from WorkflowDefaultWidget::massageFormValues().
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   */
  public static function executeTransitionsOfEntity(EntityInterface $entity);

  /********************************************************************
   * Hook-implementing functions.
   */

  /**
   * Implements hook_WORKFLOW_insert().
   *
   * Make sure some roles are allowed to participate in a Workflow by default.
   *
   * @param \Drupal\Core\Entity\EntityInterface $workflow
   */
  public static function participateUserRoles(EntityInterface $workflow);

  /**
   * Implements hook_user_delete().
   *
   * @param \Drupal\Core\Session\AccountInterface $account
   */
  public static function deleteUser(AccountInterface $account);

  /**
   * Implements hook_user_cancel().
   *
   * Implements deprecated workflow_update_workflow_transition_history_uid().
   *
   * " When cancelling the account
   * " - Disable the account and keep its content.
   * " - Disable the account and unpublish its content.
   * " - Delete the account and make its content belong to the Anonymous user.
   * " - Delete the account and its content.
   * "This action cannot be undone.
   *
   * @param $edit
   * @param \Drupal\Core\Session\AccountInterface $account
   * @param string $method
   */
  public static function cancelUser($edit, AccountInterface $account, $method);

  /********************************************************************
   * Helper functions.
   */

  /**
   * Utility function to return an array of workflow fields.
   *
   * @param string $entity_type_id
   *   The content entity type to which the workflow fields are attached.
   *
   * @return array
   *   An array of workflow field map definitions, keyed by field name. Each
   *   value is an array with two entries:
   *   - type: The field type.
   *   - bundles: The bundles in which the field appears, as array with entity
   *     types as keys and the array of bundle names as values.
   *
   * @see \Drupal\Core\Entity\EntityManagerInterface::getFieldMap()
   * @see \Drupal\comment\CommentManagerInterface::getFields()
   */
  public function getFields($entity_type_id);

  /**
   * Gets the TransitionWidget in a form (for e.g., Workflow History Tab)
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   * @param string $field_name
   * @param array $form_state_additions
   *
   * @return array
   *   The form.
   */
  public static function getWorkflowTransitionForm(EntityInterface $entity, $field_name, array $form_state_additions = []);

  /**
   * Returns the attached fields (via Field UI)
   *
   * @param string $entity_type_id
   * @param string $bundle
   *
   * @return array
   */
  public static function getAttachedFields($entity_type_id, $bundle);

  /**
   * Gets the current state ID of a given entity.
   *
   * There is no need to use a page cache.
   * The performance is OK, and the cache gives problems when using Rules.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The entity to check.
   * @param string $field_name
   *   The name of the field of the entity to check.
   *   If empty, the field_name is determined on the spot. This must be avoided,
   *   since it makes having multiple workflow per entity unpredictable.
   *   The found field_name will be returned in the param.
   *
   * @return string
   *   The ID of the current state.
   */
  public static function getCurrentStateId(EntityInterface $entity, $field_name = '');

  /**
   * Gets the previous state ID of a given entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   * @param string $field_name
   *
   * @return string
   *   The ID of the previous state.
   */
  public static function getPreviousStateId(EntityInterface $entity, $field_name = '');

  /**
   * Determine if User is owner/author of the entity.
   *
   * @param \Drupal\Core\Session\AccountInterface $account
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *
   * @return bool
   */
  public static function isOwner(AccountInterface $account, EntityInterface $entity = NULL);

  /**
   * Determine if the entity is Workflow* entity type.
   *
   * @param string $entity_type_id
   *
   * @return bool
   *
   * @usage Use it when a function should not operate on Workflow objects.
   */
  public static function isWorkflowEntityType($entity_type_id);

}

Members

Name	Modifiers	Type	Description	Overrides
WorkflowManagerInterface::cancelUser	public static	function	Implements hook_user_cancel().	1
WorkflowManagerInterface::deleteUser	public static	function	Implements hook_user_delete().	1
WorkflowManagerInterface::executeScheduledTransitionsBetween	public static	function	Given a time frame, execute all scheduled transitions.	1
WorkflowManagerInterface::executeTransitionsOfEntity	public static	function	Execute a single transition for the given entity.	1
WorkflowManagerInterface::getAttachedFields	public static	function	Returns the attached fields (via Field UI)	1
WorkflowManagerInterface::getCurrentStateId	public static	function	Gets the current state ID of a given entity.	1
WorkflowManagerInterface::getFields	public	function	Utility function to return an array of workflow fields.	1
WorkflowManagerInterface::getPreviousStateId	public static	function	Gets the previous state ID of a given entity.	1
WorkflowManagerInterface::getWorkflowTransitionForm	public static	function	Gets the TransitionWidget in a form (for e.g., Workflow History Tab)	1
WorkflowManagerInterface::isOwner	public static	function	Determine if User is owner/author of the entity.	1
WorkflowManagerInterface::isWorkflowEntityType	public static	function	Determine if the entity is Workflow* entity type.	1
WorkflowManagerInterface::participateUserRoles	public static	function	Implements hook_WORKFLOW_insert().	1