function hook_entity_view_mode_alter

Same name in other branches
  1. 7.x modules/system/system.api.php \hook_entity_view_mode_alter()
  2. 9 core/lib/Drupal/Core/Entity/entity.api.php \hook_entity_view_mode_alter()
  3. 10 core/lib/Drupal/Core/Entity/entity.api.php \hook_entity_view_mode_alter()
  4. 11.x core/lib/Drupal/Core/Entity/entity.api.php \hook_entity_view_mode_alter()

Change the view mode of an entity that is being displayed.

Parameters

string $view_mode: The view_mode that is to be used to display the entity.

\Drupal\Core\Entity\EntityInterface $entity: The entity that is being viewed.

array $context: Array with additional context information, currently only contains the langcode the entity is viewed in.

Related topics

Entity CRUD, editing, and view hooks
Hooks used in various entity operations.
Hooks
Define functions that alter the behavior of Drupal core.
1 function implements hook_entity_view_mode_alter()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

node_test_entity_view_mode_alter in core/modules/node/tests/modules/node_test/node_test.module
Implements hook_entity_view_mode_alter().

File

core/lib/Drupal/Core/Entity/entity.api.php, line 1657

Code

function hook_entity_view_mode_alter(&$view_mode, Drupal\Core\Entity\EntityInterface $entity, $context) {
    // For nodes, change the view mode when it is teaser.
    if ($entity->getEntityTypeId() == 'node' && $view_mode == 'teaser') {
        $view_mode = 'my_custom_view_mode';
    }
}

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