node_test.module

Same filename and directory in other branches
  1. 7.x modules/node/tests/node_test.module
  2. 9 core/modules/node/tests/modules/node_test/node_test.module
  3. 8.9.x core/modules/node/tests/modules/node_test/node_test.module
  4. 10 core/modules/node/tests/modules/node_test/node_test.module

A dummy module for testing node related hooks.

This is a dummy module that implements node related hooks to test API interaction with the Node module.

File

core/modules/node/tests/modules/node_test/node_test.module

View source
<?php


/**
 * @file
 * A dummy module for testing node related hooks.
 *
 * This is a dummy module that implements node related hooks to test API
 * interaction with the Node module.
 */
use Drupal\Core\Entity\EntityInterface;
use Drupal\Core\Entity\Display\EntityViewDisplayInterface;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Session\AccountInterface;
use Drupal\node\NodeInterface;

/**
 * Implements hook_ENTITY_TYPE_view() for node entities.
 */
function node_test_node_view(array &$build, NodeInterface $node, EntityViewDisplayInterface $display, $view_mode) {
    if ($node->isNew()) {
        return;
    }
    if ($view_mode == 'rss') {
        // Add RSS elements and namespaces when building the RSS feed.
        $node->rss_elements[] = [
            'key' => 'testElement',
            'value' => t('Value of testElement RSS element for node @nid.', [
                '@nid' => $node->id(),
            ]),
        ];
        // Add content that should be displayed only in the RSS feed.
        $build['extra_feed_content'] = [
            '#markup' => '<p>' . t('Extra data that should appear only in the RSS feed for node @nid.', [
                '@nid' => $node->id(),
            ]) . '</p>',
            '#weight' => 10,
        ];
    }
    if ($view_mode != 'rss') {
        // Add content that should NOT be displayed in the RSS feed.
        $build['extra_non_feed_content'] = [
            '#markup' => '<p>' . t('Extra data that should appear everywhere except the RSS feed for node @nid.', [
                '@nid' => $node->id(),
            ]) . '</p>',
        ];
    }
}

/**
 * Implements hook_ENTITY_TYPE_build_defaults_alter() for node entities.
 */
function node_test_node_build_defaults_alter(array &$build, NodeInterface &$node, $view_mode = 'full') {
    if ($view_mode == 'rss') {
        $node->rss_namespaces['xmlns:test'] = 'http://example.com/test-namespace';
    }
}

/**
 * Implements hook_node_grants().
 */
function node_test_node_grants(AccountInterface $account, $operation) {
    // Give everyone full grants so we don't break other node tests.
    // Our node access tests asserts three realms of access.
    // See testGrantAlter().
    return [
        'test_article_realm' => [
            1,
        ],
        'test_page_realm' => [
            1,
        ],
        'test_alter_realm' => [
            2,
        ],
    ];
}

/**
 * Implements hook_node_access_records().
 */
function node_test_node_access_records(NodeInterface $node) {
    // Return nothing when testing for empty responses.
    if (!empty($node->disable_node_access)) {
        return;
    }
    $grants = [];
    if ($node->getType() == 'article') {
        // Create grant in arbitrary article_realm for article nodes.
        $grants[] = [
            'realm' => 'test_article_realm',
            'gid' => 1,
            'grant_view' => 1,
            'grant_update' => 0,
            'grant_delete' => 0,
            'priority' => 0,
        ];
    }
    elseif ($node->getType() == 'page') {
        // Create grant in arbitrary page_realm for page nodes.
        $grants[] = [
            'realm' => 'test_page_realm',
            'gid' => 1,
            'grant_view' => 1,
            'grant_update' => 0,
            'grant_delete' => 0,
            'priority' => 0,
        ];
    }
    return $grants;
}

/**
 * Implements hook_node_access_records_alter().
 */
function node_test_node_access_records_alter(&$grants, NodeInterface $node) {
    if (!empty($grants)) {
        foreach ($grants as $key => $grant) {
            // Alter grant from test_page_realm to test_alter_realm and modify the gid.
            if ($grant['realm'] == 'test_page_realm' && $node->isPromoted()) {
                $grants[$key]['realm'] = 'test_alter_realm';
                $grants[$key]['gid'] = 2;
            }
        }
    }
}

/**
 * Implements hook_node_grants_alter().
 */
function node_test_node_grants_alter(&$grants, AccountInterface $account, $operation) {
    // Return an empty array of grants to prove that we can alter by reference.
    $grants = [];
}

/**
 * Implements hook_ENTITY_TYPE_presave() for node entities.
 */
function node_test_node_presave(NodeInterface $node) {
    if ($node->getTitle() == 'testing_node_presave') {
        // Sun, 19 Nov 1978 05:00:00 GMT
        $node->setCreatedTime(280299600);
        // Drupal 1.0 release.
        $node->changed = 979534800;
    }
    // Determine changes.
    if (!empty($node->original) && $node->original
        ->getTitle() == 'test_changes') {
        if ($node->original
            ->getTitle() != $node->getTitle()) {
            $node->title->value .= '_presave';
        }
    }
}

/**
 * Implements hook_ENTITY_TYPE_update() for node entities.
 */
function node_test_node_update(NodeInterface $node) {
    // Determine changes on update.
    if (!empty($node->original) && $node->original
        ->getTitle() == 'test_changes') {
        if ($node->original
            ->getTitle() != $node->getTitle()) {
            $node->title->value .= '_update';
        }
    }
}

/**
 * Implements hook_entity_view_mode_alter().
 */
function node_test_entity_view_mode_alter(&$view_mode, EntityInterface $entity) {
    // Only alter the view mode if we are on the test callback.
    $change_view_mode = \Drupal::state()->get('node_test_change_view_mode', '');
    if ($change_view_mode) {
        $view_mode = $change_view_mode;
    }
}

/**
 * Implements hook_ENTITY_TYPE_insert() for node entities.
 *
 * This tests saving a node on node insert.
 *
 * @see \Drupal\node\Tests\NodeSaveTest::testNodeSaveOnInsert()
 */
function node_test_node_insert(NodeInterface $node) {
    // Set the node title to the node ID and save.
    if ($node->getTitle() == 'new') {
        $node->setTitle('Node ' . $node->id());
        $node->setNewRevision(FALSE);
        $node->save();
    }
}

/**
 * Implements hook_form_alter().
 */
function node_test_form_alter(&$form, FormStateInterface $form_state, $form_id) {
    if (!$form_state->get('node_test_form_alter')) {
        \Drupal::messenger()->addStatus('Storage is not set');
        $form_state->set('node_test_form_alter', TRUE);
    }
    else {
        \Drupal::messenger()->addStatus('Storage is set');
    }
}

Functions

Title Deprecated Summary
node_test_entity_view_mode_alter Implements hook_entity_view_mode_alter().
node_test_form_alter Implements hook_form_alter().
node_test_node_access_records Implements hook_node_access_records().
node_test_node_access_records_alter Implements hook_node_access_records_alter().
node_test_node_build_defaults_alter Implements hook_ENTITY_TYPE_build_defaults_alter() for node entities.
node_test_node_grants Implements hook_node_grants().
node_test_node_grants_alter Implements hook_node_grants_alter().
node_test_node_insert Implements hook_ENTITY_TYPE_insert() for node entities.
node_test_node_presave Implements hook_ENTITY_TYPE_presave() for node entities.
node_test_node_update Implements hook_ENTITY_TYPE_update() for node entities.
node_test_node_view Implements hook_ENTITY_TYPE_view() for node entities.

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