class TrackerController

Same name in other branches
  1. 9 core/modules/tracker/src/Controller/TrackerController.php \Drupal\tracker\Controller\TrackerController
  2. 8.9.x core/modules/tracker/src/Controller/TrackerController.php \Drupal\tracker\Controller\TrackerController
  3. 11.x core/modules/tracker/src/Controller/TrackerController.php \Drupal\tracker\Controller\TrackerController

Controller for tracker pages.

Hierarchy

Expanded class hierarchy of TrackerController

File

core/modules/tracker/src/Controller/TrackerController.php, line 20

Namespace

Drupal\tracker\Controller
View source
class TrackerController extends ControllerBase {
    
    /**
     * The database connection.
     *
     * @var \Drupal\Core\Database\Connection
     */
    protected $database;
    
    /**
     * The database replica connection.
     *
     * @var \Drupal\Core\Database\Connection
     */
    protected $databaseReplica;
    
    /**
     * The comment statistics.
     *
     * @var \Drupal\comment\CommentStatisticsInterface
     */
    protected $commentStatistics;
    
    /**
     * The date formatter.
     *
     * @var \Drupal\Core\Datetime\DateFormatterInterface
     */
    protected $dateFormatter;
    
    /**
     * The node storage.
     *
     * @var \Drupal\Core\Entity\EntityStorageInterface
     */
    protected $nodeStorage;
    
    /**
     * Constructs a TrackerController object.
     *
     * @param \Drupal\Core\Database\Connection $database
     *   The database connection.
     * @param \Drupal\Core\Database\Connection $databaseReplica
     *   The database replica connection.
     * @param \Drupal\comment\CommentStatisticsInterface $commentStatistics
     *   The comment statistics.
     * @param \Drupal\Core\Datetime\DateFormatterInterface $dateFormatter
     *   The date formatter.
     * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entityTypeManager
     *   The entity type manager.
     */
    public function __construct(Connection $database, Connection $databaseReplica, CommentStatisticsInterface $commentStatistics, DateFormatterInterface $dateFormatter, EntityTypeManagerInterface $entityTypeManager) {
        $this->database = $database;
        $this->databaseReplica = $databaseReplica;
        $this->commentStatistics = $commentStatistics;
        $this->dateFormatter = $dateFormatter;
        $this->entityTypeManager = $entityTypeManager;
        $this->nodeStorage = $entityTypeManager->getStorage('node');
    }
    
    /**
     * Title callback for the tracker.user_tab route.
     *
     * @param \Drupal\user\UserInterface $user
     *   The user.
     *
     * @return string
     *   The title.
     */
    public function getTitle(UserInterface $user) {
        return $user->getDisplayName();
    }
    
    /**
     * Checks access for the users recent content tracker page.
     *
     * @param \Drupal\user\UserInterface $user
     *   The user being viewed.
     * @param \Drupal\Core\Session\AccountInterface $account
     *   The account viewing the page.
     *
     * @return \Drupal\Core\Access\AccessResult
     *   The access result.
     */
    public function checkAccess(UserInterface $user, AccountInterface $account) {
        return AccessResult::allowedIf($account->isAuthenticated() && $user->id() == $account->id())
            ->cachePerUser();
    }
    
    /**
     * Builds content for the tracker controllers.
     *
     * @param \Drupal\user\UserInterface|null $user
     *   (optional) The user account.
     *
     * @return array
     *   The render array.
     */
    public function buildContent(?UserInterface $user = NULL) {
        if ($user) {
            $query = $this->database
                ->select('tracker_user', 't')
                ->extend(PagerSelectExtender::class)
                ->addMetaData('base_table', 'tracker_user')
                ->condition('t.uid', $user->id());
        }
        else {
            $query = $this->databaseReplica
                ->select('tracker_node', 't')
                ->extend(PagerSelectExtender::class)
                ->addMetaData('base_table', 'tracker_node');
        }
        // This array acts as a placeholder for the data selected later
        // while keeping the correct order.
        $tracker_data = $query->addTag('node_access')
            ->fields('t', [
            'nid',
            'changed',
        ])
            ->condition('t.published', 1)
            ->orderBy('t.changed', 'DESC')
            ->limit(25)
            ->execute()
            ->fetchAllAssoc('nid');
        $cacheable_metadata = new CacheableMetadata();
        $rows = [];
        if (!empty($tracker_data)) {
            // Load nodes into an array with the same order as $tracker_data.
            
            /** @var \Drupal\node\NodeInterface[] $nodes */
            $nodes = $this->nodeStorage
                ->loadMultiple(array_keys($tracker_data));
            // Enrich the node data.
            $result = $this->commentStatistics
                ->read($nodes, 'node', FALSE);
            foreach ($result as $statistics) {
                // The node ID may not be unique; there can be multiple comment fields.
                // Make comment_count the total of all comments.
                $nid = $statistics->entity_id;
                if (empty($nodes[$nid]->comment_count) || !is_numeric($tracker_data[$nid]->comment_count)) {
                    $tracker_data[$nid]->comment_count = $statistics->comment_count;
                }
                else {
                    $tracker_data[$nid]->comment_count += $statistics->comment_count;
                }
                // Make the last comment timestamp reflect the latest comment.
                if (!isset($tracker_data[$nid]->last_comment_timestamp)) {
                    $tracker_data[$nid]->last_comment_timestamp = $statistics->last_comment_timestamp;
                }
                else {
                    $tracker_data[$nid]->last_comment_timestamp = max($tracker_data[$nid]->last_comment_timestamp, $statistics->last_comment_timestamp);
                }
            }
            // Display the data.
            foreach ($nodes as $node) {
                // Set the last activity time from tracker data. This also takes into
                // account comment activity, so getChangedTime() is not used.
                $last_activity = $tracker_data[$node->id()]->changed;
                $owner = $node->getOwner();
                $row = [
                    'type' => node_get_type_label($node),
                    'title' => [
                        'data' => [
                            '#type' => 'link',
                            '#url' => $node->toUrl(),
                            '#title' => $node->getTitle(),
                        ],
                        'data-history-node-id' => $node->id(),
                        'data-history-node-timestamp' => $node->getChangedTime(),
                    ],
                    'author' => [
                        'data' => [
                            '#theme' => 'username',
                            '#account' => $owner,
                        ],
                    ],
                    'comments' => [
                        'class' => [
                            'comments',
                        ],
                        'data' => $tracker_data[$node->id()]->comment_count ?? 0,
                        'data-history-node-last-comment-timestamp' => $tracker_data[$node->id()]->last_comment_timestamp ?? 0,
                    ],
                    'last updated' => [
                        'data' => t('@time ago', [
                            '@time' => $this->dateFormatter
                                ->formatTimeDiffSince($last_activity),
                        ]),
                    ],
                ];
                $rows[] = $row;
                // Add node and node owner to cache tags.
                $cacheable_metadata->addCacheTags($node->getCacheTags());
                if ($owner) {
                    $cacheable_metadata->addCacheTags($owner->getCacheTags());
                }
            }
        }
        // Add the list cache tag for nodes.
        $cacheable_metadata->addCacheTags($this->nodeStorage
            ->getEntityType()
            ->getListCacheTags());
        $page['tracker'] = [
            '#rows' => $rows,
            '#header' => [
                $this->t('Type'),
                $this->t('Title'),
                $this->t('Author'),
                $this->t('Comments'),
                $this->t('Last updated'),
            ],
            '#type' => 'table',
            '#empty' => $this->t('No content available.'),
        ];
        $page['pager'] = [
            '#type' => 'pager',
            '#weight' => 10,
        ];
        $page['#sorted'] = TRUE;
        $cacheable_metadata->addCacheContexts([
            'user.node_grants:view',
        ]);
        // Display the reading history if that module is enabled.
        if ($this->moduleHandler()
            ->moduleExists('history')) {
            // Reading history is tracked for authenticated users only.
            if ($this->currentUser()
                ->isAuthenticated()) {
                $page['#attached']['library'][] = 'tracker/history';
            }
            $cacheable_metadata->addCacheContexts([
                'user.roles:authenticated',
            ]);
        }
        $cacheable_metadata->applyTo($page);
        return $page;
    }

}

Members

Title Sort descending Modifiers Object type Summary Overrides
AutowireTrait::create public static function Instantiates a new instance of the implementing class using autowiring. 33
ControllerBase::$configFactory protected property The configuration factory.
ControllerBase::$currentUser protected property The current user service. 2
ControllerBase::$entityFormBuilder protected property The entity form builder.
ControllerBase::$entityTypeManager protected property The entity type manager.
ControllerBase::$formBuilder protected property The form builder. 1
ControllerBase::$keyValue protected property The key-value storage. 1
ControllerBase::$languageManager protected property The language manager. 1
ControllerBase::$moduleHandler protected property The module handler. 1
ControllerBase::$stateService protected property The state service.
ControllerBase::cache protected function Returns the requested cache bin.
ControllerBase::config protected function Retrieves a configuration object.
ControllerBase::container private function Returns the service container.
ControllerBase::currentUser protected function Returns the current user. 2
ControllerBase::entityFormBuilder protected function Retrieves the entity form builder.
ControllerBase::entityTypeManager protected function Retrieves the entity type manager.
ControllerBase::formBuilder protected function Returns the form builder service. 1
ControllerBase::keyValue protected function Returns a key/value storage collection. 1
ControllerBase::languageManager protected function Returns the language manager service. 1
ControllerBase::moduleHandler protected function Returns the module handler. 1
ControllerBase::redirect protected function Returns a redirect response object for the specified route.
ControllerBase::state protected function Returns the state storage service.
LoggerChannelTrait::$loggerFactory protected property The logger channel factory service.
LoggerChannelTrait::getLogger protected function Gets the logger for a specific channel.
LoggerChannelTrait::setLoggerFactory public function Injects the logger channel factory.
MessengerTrait::$messenger protected property The messenger. 16
MessengerTrait::messenger public function Gets the messenger. 16
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 2
RedirectDestinationTrait::getDestinationArray protected function Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
StringTranslationTrait::$stringTranslation protected property The string translation service. 3
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.
TrackerController::$commentStatistics protected property The comment statistics.
TrackerController::$database protected property The database connection.
TrackerController::$databaseReplica protected property The database replica connection.
TrackerController::$dateFormatter protected property The date formatter.
TrackerController::$nodeStorage protected property The node storage.
TrackerController::buildContent public function Builds content for the tracker controllers.
TrackerController::checkAccess public function Checks access for the users recent content tracker page.
TrackerController::getTitle public function Title callback for the tracker.user_tab route.
TrackerController::__construct public function Constructs a TrackerController object.

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