interface CommentStatisticsInterface

Same name in other branches
  1. 9 core/modules/comment/src/CommentStatisticsInterface.php \Drupal\comment\CommentStatisticsInterface
  2. 8.9.x core/modules/comment/src/CommentStatisticsInterface.php \Drupal\comment\CommentStatisticsInterface
  3. 10 core/modules/comment/src/CommentStatisticsInterface.php \Drupal\comment\CommentStatisticsInterface

Provides an interface for storing and retrieving comment statistics.

Hierarchy

Expanded class hierarchy of CommentStatisticsInterface

All classes that implement CommentStatisticsInterface

1 file declares its use of CommentStatisticsInterface
TrackerController.php in core/modules/tracker/src/Controller/TrackerController.php

File

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

Namespace

Drupal\comment
View source
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

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

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