interface CommentStatisticsInterface in Zircon Profile 8.0

Provides an interface for storing and retrieving comment statistics.

Hierarchy

• interface \Drupal\comment\CommentStatisticsInterface

File

core/modules/comment/src/CommentStatisticsInterface.php, line 15

Contains \Drupal\comment\CommentStatisticsInterface.

Namespace

Drupal\comment

interface CommentStatisticsInterface {

  /**
   * Returns an array of ranking information for hook_ranking().
   *
   * @return array
   *   Array of ranking information as expected by hook_ranking().
   *
   * @see hook_ranking()
   * @see comment_ranking()
   */
  public function getRankingInfo();

  /**
   * Read comment statistics records for an array of entities.
   *
   * @param \Drupal\Core\Entity\EntityInterface[] $entities
   *   Array of entities on which commenting is enabled, keyed by id
   * @param string $entity_type
   *   The entity type of the passed entities.
   * @param bool $accurate
   *   (optional) Indicates if results must be completely up to date. If set to
   *   FALSE, a replica database will used if available. Defaults to TRUE.
   *
   * @return object[]
   *   Array of statistics records.
   */
  public function read($entities, $entity_type, $accurate = TRUE);

  /**
   * Delete comment statistics records for an entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The entity for which comment statistics should be deleted.
   */
  public function delete(EntityInterface $entity);

  /**
   * Update or insert comment statistics records after a comment is added.
   *
   * @param \Drupal\comment\CommentInterface $comment
   *   The comment added or updated.
   */
  public function update(CommentInterface $comment);

  /**
   * Find the maximum number of comments for the given entity type.
   *
   * Used to influence search rankings.
   *
   * @param string $entity_type
   *   The entity type to consider when fetching the maximum comment count for.
   *
   * @return int
   *   The maximum number of comments for and entity of the given type.
   *
   * @see comment_update_index()
   */
  public function getMaximumCount($entity_type);

  /**
   * Insert an empty record for the given entity.
   *
   * @param \Drupal\Core\Entity\FieldableEntityInterface $entity
   *   The created entity for which a statistics record is to be initialized.
   * @param array $fields
   *   Array of comment field definitions for the given entity.
   */
  public function create(FieldableEntityInterface $entity, $fields);

}

Members

Name	Modifiers	Type	Description	Overrides
CommentStatisticsInterface::create	public	function	Insert an empty record for the given entity.	1
CommentStatisticsInterface::delete	public	function	Delete comment statistics records for an entity.	1
CommentStatisticsInterface::getMaximumCount	public	function	Find the maximum number of comments for the given entity type.	1
CommentStatisticsInterface::getRankingInfo	public	function	Returns an array of ranking information for hook_ranking().	1
CommentStatisticsInterface::read	public	function	Read comment statistics records for an array of entities.	1
CommentStatisticsInterface::update	public	function	Update or insert comment statistics records after a comment is added.	1