class EntityRenderController

Base class for entity view controllers.

Hierarchy

Expanded class hierarchy of EntityRenderController

4 files declare their use of EntityRenderController
CommentRenderController.php in drupal/core/modules/comment/lib/Drupal/comment/CommentRenderController.php
Definition of Drupal\comment\CommentRenderController.
NodeRenderController.php in drupal/core/modules/node/lib/Drupal/node/NodeRenderController.php
Definition of Drupal\node\NodeRenderController.
TermRenderController.php in drupal/core/modules/taxonomy/lib/Drupal/taxonomy/TermRenderController.php
Definition of Drupal\taxonomy\TermRenderController.
UserRenderController.php in drupal/core/modules/user/lib/Drupal/user/UserRenderController.php
Definition of Drupal\user\UserRenderController.

File

drupal/core/lib/Drupal/Core/Entity/EntityRenderController.php, line 13
Definition of Drupal\Core\Entity\EntityRenderController.

Namespace

Drupal\Core\Entity
View source
class EntityRenderController implements EntityRenderControllerInterface {

  /**
   * The type of entities for which this controller is instantiated.
   *
   * @var string
   */
  protected $entityType;
  public function __construct($entity_type) {
    $this->entityType = $entity_type;
  }

  /**
   * Implements Drupal\Core\Entity\EntityRenderControllerInterface::buildContent().
   */
  public function buildContent(array $entities = array(), $view_mode = 'full', $langcode = NULL) {

    // Allow modules to change the view mode.
    $context = array(
      'langcode' => $langcode,
    );
    $prepare = array();
    foreach ($entities as $key => $entity) {

      // Remove previously built content, if exists.
      $entity->content = array();
      drupal_alter('entity_view_mode', $view_mode, $entity, $context);
      $entity->content['#view_mode'] = $view_mode;
      $prepare[$view_mode][$key] = $entity;
    }

    // Prepare and build field content, grouped by view mode.
    foreach ($prepare as $view_mode => $prepare_entities) {
      $call = array();

      // To ensure hooks are only run once per entity, check for an
      // entity_view_prepared flag and only process items without it.
      foreach ($prepare_entities as $entity) {
        if (empty($entity->entity_view_prepared)) {

          // Add this entity to the items to be prepared.
          $call[$entity
            ->id()] = $entity;

          // Mark this item as prepared.
          $entity->entity_view_prepared = TRUE;
        }
      }
      if (!empty($call)) {
        field_attach_prepare_view($this->entityType, $call, $view_mode, $langcode);
        module_invoke_all('entity_prepare_view', $call, $this->entityType);
      }
      foreach ($entities as $entity) {
        $entity->content += field_attach_view($this->entityType, $entity, $view_mode, $langcode);
      }
    }
  }

  /**
   * Provides entity-specific defaults to the build process.
   *
   * @param Drupal\Core\Entity\EntityInterface $entity
   *   The entity for which the defaults should be provided.
   * @param string $view_mode
   *   The view mode that should be used.
   * @param string $langcode
   *   (optional) For which language the entity should be prepared, defaults to
   *   the current content language.
   *
   * @return array
   */
  protected function getBuildDefaults(EntityInterface $entity, $view_mode, $langcode) {
    $return = array(
      '#theme' => $this->entityType,
      "#{$this->entityType}" => $entity,
      '#view_mode' => $view_mode,
      '#langcode' => $langcode,
    );
    return $return;
  }

  /**
   * Specific per-entity building.
   *
   * @param array $build
   *   The render array that is being created.
   * @param Drupal\Core\Entity\EntityInterface $entity
   *   The entity to be prepared.
   * @param string $view_mode
   *   The view mode that should be used to prepare the entity.
   * @param string $langcode
   *   (optional) For which language the entity should be prepared, defaults to
   *   the current content language.
   */
  protected function alterBuild(array &$build, EntityInterface $entity, $view_mode, $langcode = NULL) {
  }

  /**
   * Implements Drupal\Core\Entity\EntityRenderControllerInterface::view().
   */
  public function view(EntityInterface $entity, $view_mode = 'full', $langcode = NULL) {
    $buildList = $this
      ->viewMultiple(array(
      $entity,
    ), $view_mode, $langcode);
    return $buildList[0];
  }

  /**
   * Implements Drupal\Core\Entity\EntityRenderControllerInterface::viewMultiple().
   */
  public function viewMultiple(array $entities = array(), $view_mode = 'full', $langcode = NULL) {
    if (!isset($langcode)) {
      $langcode = language(LANGUAGE_TYPE_CONTENT)->langcode;
    }
    $this
      ->buildContent($entities, $view_mode, $langcode);
    $view_hook = "{$this->entityType}_view";
    $build = array(
      '#sorted' => TRUE,
    );
    $weight = 0;
    foreach ($entities as $key => $entity) {
      $entity_view_mode = isset($entity->content['#view_mode']) ? $entity->content['#view_mode'] : $view_mode;
      module_invoke_all($view_hook, $entity, $entity_view_mode, $langcode);
      module_invoke_all('entity_view', $entity, $entity_view_mode, $langcode);
      $build[$key] = $entity->content;

      // We don't need duplicate rendering info in $entity->content.
      unset($entity->content);
      $build[$key] += $this
        ->getBuildDefaults($entity, $entity_view_mode, $langcode);
      $this
        ->alterBuild($build[$key], $entity, $entity_view_mode, $langcode);
      $build[$key]['#weight'] = $weight++;

      // Allow modules to modify the structured entity.
      drupal_alter(array(
        $view_hook,
        'entity_view',
      ), $build[$key], $entity);
    }
    return $build;
  }

}

Members