interface ModerationInformationInterface

Same name in other branches
  1. 9 core/modules/content_moderation/src/ModerationInformationInterface.php \Drupal\content_moderation\ModerationInformationInterface
  2. 10 core/modules/content_moderation/src/ModerationInformationInterface.php \Drupal\content_moderation\ModerationInformationInterface
  3. 11.x core/modules/content_moderation/src/ModerationInformationInterface.php \Drupal\content_moderation\ModerationInformationInterface

Interface for moderation_information service.

Hierarchy

Expanded class hierarchy of ModerationInformationInterface

All classes that implement ModerationInformationInterface

14 files declare their use of ModerationInformationInterface
ContentModeration.php in core/modules/content_moderation/src/Plugin/WorkflowType/ContentModeration.php
ContentModerationConfigureEntityTypesForm.php in core/modules/content_moderation/src/Form/ContentModerationConfigureEntityTypesForm.php
ContentModerationConfigureForm.php in core/modules/content_moderation/src/Form/ContentModerationConfigureForm.php
ContentModerationStateFormatter.php in core/modules/content_moderation/src/Plugin/Field/FieldFormatter/ContentModerationStateFormatter.php
DynamicLocalTasks.php in core/modules/content_moderation/src/Plugin/Derivative/DynamicLocalTasks.php

... See full list

File

core/modules/content_moderation/src/ModerationInformationInterface.php, line 12

Namespace

Drupal\content_moderation
View source
interface ModerationInformationInterface {
    
    /**
     * Determines if an entity is moderated.
     *
     * @param \Drupal\Core\Entity\EntityInterface $entity
     *   The entity we may be moderating.
     *
     * @return bool
     *   TRUE if this entity is moderated, FALSE otherwise.
     */
    public function isModeratedEntity(EntityInterface $entity);
    
    /**
     * Determines if an entity type can have moderated entities.
     *
     * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
     *   An entity type object.
     *
     * @return bool
     *   TRUE if this entity type can have moderated entities, FALSE otherwise.
     */
    public function canModerateEntitiesOfEntityType(EntityTypeInterface $entity_type);
    
    /**
     * Determines if an entity type/bundle entities should be moderated.
     *
     * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
     *   The entity type definition to check.
     * @param string $bundle
     *   The bundle to check.
     *
     * @return bool
     *   TRUE if an entity type/bundle entities should be moderated, FALSE
     *   otherwise.
     */
    public function shouldModerateEntitiesOfBundle(EntityTypeInterface $entity_type, $bundle);
    
    /**
     * Determines if an entity type has at least one moderated bundle.
     *
     * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
     *   The entity type definition to check.
     *
     * @return bool
     *   TRUE if an entity type has a moderated bundle, FALSE otherwise.
     */
    public function isModeratedEntityType(EntityTypeInterface $entity_type);
    
    /**
     * Loads the latest revision of a specific entity.
     *
     * @param string $entity_type_id
     *   The entity type ID.
     * @param int $entity_id
     *   The entity ID.
     *
     * @return \Drupal\Core\Entity\ContentEntityInterface|null
     *   The latest entity revision or NULL, if the entity type / entity doesn't
     *   exist.
     *
     * @deprecated in drupal:8.8.0 and is removed from drupal:9.0.0. Use
     *   RevisionableStorageInterface::getLatestRevisionId and
     *   RevisionableStorageInterface::loadRevision instead.
     *
     * @see https://www.drupal.org/node/3087295
     */
    public function getLatestRevision($entity_type_id, $entity_id);
    
    /**
     * Returns the revision ID of the latest revision of the given entity.
     *
     * @param string $entity_type_id
     *   The entity type ID.
     * @param int $entity_id
     *   The entity ID.
     *
     * @return int
     *   The revision ID of the latest revision for the specified entity, or
     *   NULL if there is no such entity.
     *
     * @deprecated in drupal:8.8.0 and is removed from drupal:9.0.0. Use
     *   RevisionableStorageInterface::getLatestRevisionId instead.
     *
     * @see https://www.drupal.org/node/3087295
     */
    public function getLatestRevisionId($entity_type_id, $entity_id);
    
    /**
     * Returns the revision ID of the default revision for the specified entity.
     *
     * @param string $entity_type_id
     *   The entity type ID.
     * @param int $entity_id
     *   The entity ID.
     *
     * @return int
     *   The revision ID of the default revision, or NULL if the entity was
     *   not found.
     */
    public function getDefaultRevisionId($entity_type_id, $entity_id);
    
    /**
     * Returns the revision translation affected translation of a revision.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   The content entity.
     *
     * @return \Drupal\Core\Entity\ContentEntityInterface
     *   The revision translation affected translation.
     */
    public function getAffectedRevisionTranslation(ContentEntityInterface $entity);
    
    /**
     * Determines if an entity is a latest revision.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   A revisionable content entity.
     *
     * @return bool
     *   TRUE if the specified object is the latest revision of its entity,
     *   FALSE otherwise.
     *
     * @deprecated in drupal:8.8.0 and is removed from drupal:9.0.0. Use
     *   RevisionableInterface::isLatestRevision instead.
     *
     * @see https://www.drupal.org/node/3087295
     */
    public function isLatestRevision(ContentEntityInterface $entity);
    
    /**
     * Determines if a pending revision exists for the specified entity.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   The entity which may or may not have a pending revision.
     *
     * @return bool
     *   TRUE if this entity has pending revisions available, FALSE otherwise.
     */
    public function hasPendingRevision(ContentEntityInterface $entity);
    
    /**
     * Determines if an entity is "live".
     *
     * A "live" entity revision is one whose latest revision is also the default,
     * and whose moderation state, if any, is a published state.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   The entity to check.
     *
     * @return bool
     *   TRUE if the specified entity is a live revision, FALSE otherwise.
     */
    public function isLiveRevision(ContentEntityInterface $entity);
    
    /**
     * Determines if the default revision for the given entity is published.
     *
     * The default revision is the same as the entity retrieved by "default" from
     * the storage handler. If the entity is translated, check if any of the
     * translations are published.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   The entity being saved.
     *
     * @return bool
     *   TRUE if the default revision is published. FALSE otherwise.
     */
    public function isDefaultRevisionPublished(ContentEntityInterface $entity);
    
    /**
     * Gets the workflow for the given content entity.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   The content entity to get the workflow for.
     *
     * @return \Drupal\workflows\WorkflowInterface|null
     *   The workflow entity. NULL if there is no workflow.
     */
    public function getWorkflowForEntity(ContentEntityInterface $entity);
    
    /**
     * Gets the workflow for the given entity type and bundle.
     *
     * @param string $entity_type_id
     *   The entity type ID.
     * @param string $bundle_id
     *   The entity bundle ID.
     *
     * @return \Drupal\workflows\WorkflowInterface|null
     *   The associated workflow. NULL if there is no workflow.
     */
    public function getWorkflowForEntityTypeAndBundle($entity_type_id, $bundle_id);
    
    /**
     * Gets unsupported features for a given entity type.
     *
     * @param \Drupal\Core\Entity\EntityTypeInterface $entity_type
     *   The entity type to get the unsupported features for.
     *
     * @return array
     *   An array of unsupported features for this entity type.
     */
    public function getUnsupportedFeatures(EntityTypeInterface $entity_type);
    
    /**
     * Gets the original or initial state of the given entity.
     *
     * When a state is being validated, the original state is used to validate
     * that a valid transition exists for target state and the user has access
     * to the transition between those two states. If the entity has been
     * moderated before, we can load the original unmodified revision and
     * translation for this state.
     *
     * If the entity is new we need to load the initial state from the workflow.
     * Even if a value was assigned to the moderation_state field, the initial
     * state is used to compute an appropriate transition for the purposes of
     * validation.
     *
     * @param \Drupal\Core\Entity\ContentEntityInterface $entity
     *   The content entity to get the workflow for.
     *
     * @return \Drupal\content_moderation\ContentModerationState
     *   The original or default moderation state.
     */
    public function getOriginalState(ContentEntityInterface $entity);

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overrides
ModerationInformationInterface::canModerateEntitiesOfEntityType public function Determines if an entity type can have moderated entities. 1
ModerationInformationInterface::getAffectedRevisionTranslation public function Returns the revision translation affected translation of a revision. 1
ModerationInformationInterface::getDefaultRevisionId public function Returns the revision ID of the default revision for the specified entity. 1
ModerationInformationInterface::getLatestRevision Deprecated public function Loads the latest revision of a specific entity. 1
ModerationInformationInterface::getLatestRevisionId Deprecated public function Returns the revision ID of the latest revision of the given entity. 1
ModerationInformationInterface::getOriginalState public function Gets the original or initial state of the given entity. 1
ModerationInformationInterface::getUnsupportedFeatures public function Gets unsupported features for a given entity type. 1
ModerationInformationInterface::getWorkflowForEntity public function Gets the workflow for the given content entity. 1
ModerationInformationInterface::getWorkflowForEntityTypeAndBundle public function Gets the workflow for the given entity type and bundle. 1
ModerationInformationInterface::hasPendingRevision public function Determines if a pending revision exists for the specified entity. 1
ModerationInformationInterface::isDefaultRevisionPublished public function Determines if the default revision for the given entity is published. 1
ModerationInformationInterface::isLatestRevision Deprecated public function Determines if an entity is a latest revision. 1
ModerationInformationInterface::isLiveRevision public function Determines if an entity is "live". 1
ModerationInformationInterface::isModeratedEntity public function Determines if an entity is moderated. 1
ModerationInformationInterface::isModeratedEntityType public function Determines if an entity type has at least one moderated bundle. 1
ModerationInformationInterface::shouldModerateEntitiesOfBundle public function Determines if an entity type/bundle entities should be moderated. 1

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