View.php

Same filename in this branch
  1. 10 core/modules/views/src/Element/View.php
  2. 10 core/modules/views/src/Entity/View.php
Same filename and directory in other branches
  1. 9 core/modules/views/src/Element/View.php
  2. 9 core/modules/views/src/Entity/View.php
  3. 9 core/modules/views/src/Plugin/views/area/View.php
  4. 8.9.x core/modules/views/src/Element/View.php
  5. 8.9.x core/modules/views/src/Entity/View.php
  6. 8.9.x core/modules/views/src/Plugin/views/area/View.php
  7. 11.x core/modules/views/src/Element/View.php
  8. 11.x core/modules/views/src/Entity/View.php
  9. 11.x core/modules/views/src/Plugin/views/area/View.php

Namespace

Drupal\views\Plugin\views\area

File

core/modules/views/src/Plugin/views/area/View.php

View source
<?php

namespace Drupal\views\Plugin\views\area;

use Drupal\Core\Entity\EntityStorageInterface;
use Drupal\Core\Form\FormStateInterface;
use Drupal\views\Attribute\ViewsArea;
use Drupal\views\Views;
use Symfony\Component\DependencyInjection\ContainerInterface;

/**
 * Views area handlers. Insert a view inside of an area.
 *
 * @ingroup views_area_handlers
 */
class View extends AreaPluginBase {
  
  /**
   * Stores whether the embedded view is actually empty.
   *
   * @var bool
   */
  protected $isEmpty;
  
  /**
   * The view storage.
   *
   * @var \Drupal\Core\Entity\EntityStorageInterface
   */
  protected $viewStorage;
  
  /**
   * Constructs a View object.
   *
   * @param array $configuration
   *   A configuration array containing information about the plugin instance.
   * @param string $plugin_id
   *   The plugin ID for the plugin instance.
   * @param mixed $plugin_definition
   *   The plugin implementation definition.
   * @param \Drupal\Core\Entity\EntityStorageInterface $view_storage
   *   The view storage.
   */
  public function __construct(array $configuration, $plugin_id, $plugin_definition, EntityStorageInterface $view_storage) {
    parent::__construct($configuration, $plugin_id, $plugin_definition);
    $this->viewStorage = $view_storage;
  }
  
  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
    return new static($configuration, $plugin_id, $plugin_definition, $container->get('entity_type.manager')
      ->getStorage('view'));
  }
  
  /**
   * {@inheritdoc}
   */
  protected function defineOptions() {
    $options = parent::defineOptions();
    $options['view_to_insert'] = [
      'default' => '',
    ];
    $options['inherit_arguments'] = [
      'default' => FALSE,
    ];
    return $options;
  }
  
  /**
   * {@inheritdoc}
   */
  public function buildOptionsForm(&$form, FormStateInterface $form_state) {
    parent::buildOptionsForm($form, $form_state);
    $view_display = $this->view->storage
      ->id() . ':' . $this->view->current_display;
    $options = [
      '' => $this->t('-Select-'),
    ];
    $options += Views::getViewsAsOptions(FALSE, 'all', $view_display, FALSE, TRUE);
    $form['view_to_insert'] = [
      '#type' => 'select',
      '#title' => $this->t('View to insert'),
      '#default_value' => $this->options['view_to_insert'],
      '#description' => $this->t('The view to insert into this area.'),
      '#options' => $options,
    ];
    $form['inherit_arguments'] = [
      '#type' => 'checkbox',
      '#title' => $this->t('Inherit contextual filters'),
      '#default_value' => $this->options['inherit_arguments'],
      '#description' => $this->t('If checked, this view will receive the same contextual filters as its parent.'),
    ];
  }
  
  /**
   * {@inheritdoc}
   */
  public function render($empty = FALSE) {
    if (!empty($this->options['view_to_insert'])) {
      [
        $view_name,
        $display_id,
      ] = explode(':', $this->options['view_to_insert']);
      $view = $this->viewStorage
        ->load($view_name)
        ->getExecutable();
      if (empty($view) || !$view->access($display_id)) {
        return [];
      }
      $view->setDisplay($display_id);
      // Avoid recursion
      $view->parent_views += $this->view->parent_views;
      $view->parent_views[] = "{$view_name}:{$display_id}";
      // Check if the view is part of the parent views of this view
      $search = "{$view_name}:{$display_id}";
      if (in_array($search, $this->view->parent_views)) {
        \Drupal::messenger()->addError($this->t("Recursion detected in view @view display @display.", [
          '@view' => $view_name,
          '@display' => $display_id,
        ]));
      }
      else {
        if (!empty($this->options['inherit_arguments']) && !empty($this->view->args)) {
          $output = $view->preview($display_id, $this->view->args);
        }
        else {
          $output = $view->preview($display_id);
        }
        $this->isEmpty = $view->display_handler
          ->outputIsEmpty();
        return $output;
      }
    }
    return [];
  }
  
  /**
   * {@inheritdoc}
   */
  public function isEmpty() {
    if (isset($this->isEmpty)) {
      return $this->isEmpty;
    }
    else {
      return parent::isEmpty();
    }
  }
  
  /**
   * {@inheritdoc}
   */
  public function calculateDependencies() {
    $dependencies = parent::calculateDependencies();
    [
      $view_id,
    ] = explode(':', $this->options['view_to_insert'], 2);
    // Don't call the current view, as it would result into an infinite recursion.
    if ($view_id && $this->view->storage
      ->id() != $view_id) {
      $view = $this->viewStorage
        ->load($view_id);
      $dependencies[$view->getConfigDependencyKey()][] = $view->getConfigDependencyName();
    }
    return $dependencies;
  }

}

Classes

Title Deprecated Summary
View Views area handlers. Insert a view inside of an area.

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