class HistoryHooks

Hook implementations for history.

Hierarchy

Expanded class hierarchy of HistoryHooks

File

core/modules/history/src/Hook/HistoryHooks.php, line 15

Namespace

Drupal\history\Hook
View source
class HistoryHooks {
    
    /**
     * Implements hook_help().
     */
    public function help($route_name, RouteMatchInterface $route_match) {
        switch ($route_name) {
            case 'help.page.history':
                $output = '<h2>' . t('About') . '</h2>';
                $output .= '<p>' . t('The History module keeps track of which content a user has read. It marks content as <em>new</em> or <em>updated</em> depending on the last time the user viewed it. History records that are older than one month are removed during cron, which means that content older than one month is always considered <em>read</em>. The History module does not have a user interface but it provides a filter to <a href=":views-help">Views</a> to show new or updated content. For more information, see the <a href=":url">online documentation for the History module</a>.', [
                    ':views-help' => \Drupal::moduleHandler()->moduleExists('views') ? Url::fromRoute('help.page', [
                        'name' => 'views',
                    ])->toString() : '#',
                    ':url' => 'https://www.drupal.org/documentation/modules/history',
                ]) . '</p>';
                return $output;
        }
    }
    
    /**
     * Implements hook_cron().
     */
    public function cron() : void {
        \Drupal::database()->delete('history')
            ->condition('timestamp', HISTORY_READ_LIMIT, '<')
            ->execute();
    }
    
    /**
     * Implements hook_ENTITY_TYPE_view_alter() for node entities.
     */
    public function nodeViewAlter(array &$build, EntityInterface $node, EntityViewDisplayInterface $display) : void {
        if ($node->isNew() || isset($node->in_preview)) {
            return;
        }
        // Update the history table, stating that this user viewed this node.
        if ($display->getOriginalMode() === 'full') {
            $build['#cache']['contexts'][] = 'user.roles:authenticated';
            if (\Drupal::currentUser()->isAuthenticated()) {
                // When the window's "load" event is triggered, mark the node as read.
                // This still allows for Drupal behaviors (which are triggered on the
                // "DOMContentReady" event) to add "new" and "updated" indicators.
                $build['#attached']['library'][] = 'history/mark-as-read';
                $build['#attached']['drupalSettings']['history']['nodesToMarkAsRead'][$node->id()] = TRUE;
            }
        }
    }
    
    /**
     * Implements hook_ENTITY_TYPE_delete() for node entities.
     */
    public function nodeDelete(EntityInterface $node) {
        \Drupal::database()->delete('history')
            ->condition('nid', $node->id())
            ->execute();
    }
    
    /**
     * Implements hook_user_cancel().
     */
    public function userCancel($edit, UserInterface $account, $method) {
        switch ($method) {
            case 'user_cancel_reassign':
                \Drupal::database()->delete('history')
                    ->condition('uid', $account->id())
                    ->execute();
                break;
        }
    }
    
    /**
     * Implements hook_ENTITY_TYPE_delete() for user entities.
     */
    public function userDelete($account) {
        \Drupal::database()->delete('history')
            ->condition('uid', $account->id())
            ->execute();
    }

}

Members

Title Sort descending Modifiers Object type Summary
HistoryHooks::cron public function Implements hook_cron().
HistoryHooks::help public function Implements hook_help().
HistoryHooks::nodeDelete public function Implements hook_ENTITY_TYPE_delete() for node entities.
HistoryHooks::nodeViewAlter public function Implements hook_ENTITY_TYPE_view_alter() for node entities.
HistoryHooks::userCancel public function Implements hook_user_cancel().
HistoryHooks::userDelete public function Implements hook_ENTITY_TYPE_delete() for user entities.

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