Mercurial > hg > isophonics-drupal-site
diff core/modules/views/src/Plugin/EntityReferenceSelection/ViewsSelection.php @ 0:4c8ae668cc8c
Initial import (non-working)
author | Chris Cannam |
---|---|
date | Wed, 29 Nov 2017 16:09:58 +0000 |
parents | |
children | 129ea1e6d783 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/modules/views/src/Plugin/EntityReferenceSelection/ViewsSelection.php Wed Nov 29 16:09:58 2017 +0000 @@ -0,0 +1,225 @@ +<?php + +namespace Drupal\views\Plugin\EntityReferenceSelection; + +use Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginBase; +use Drupal\Core\Entity\EntityReferenceSelection\SelectionTrait; +use Drupal\Core\Form\FormStateInterface; +use Drupal\Core\Plugin\ContainerFactoryPluginInterface; +use Drupal\Core\Url; +use Drupal\views\Views; + +/** + * Plugin implementation of the 'selection' entity_reference. + * + * @EntityReferenceSelection( + * id = "views", + * label = @Translation("Views: Filter by an entity reference view"), + * group = "views", + * weight = 0 + * ) + */ +class ViewsSelection extends SelectionPluginBase implements ContainerFactoryPluginInterface { + + use SelectionTrait; + + /** + * The loaded View object. + * + * @var \Drupal\views\ViewExecutable; + */ + protected $view; + + /** + * {@inheritdoc} + */ + public function defaultConfiguration() { + return [ + 'view' => [ + 'view_name' => NULL, + 'display_name' => NULL, + 'arguments' => [], + ], + ] + parent::defaultConfiguration(); + } + + /** + * {@inheritdoc} + */ + public function buildConfigurationForm(array $form, FormStateInterface $form_state) { + $form = parent::buildConfigurationForm($form, $form_state); + + $view_settings = $this->getConfiguration()['view']; + $displays = Views::getApplicableViews('entity_reference_display'); + // Filter views that list the entity type we want, and group the separate + // displays by view. + $entity_type = $this->entityManager->getDefinition($this->configuration['target_type']); + $view_storage = $this->entityManager->getStorage('view'); + + $options = []; + foreach ($displays as $data) { + list($view_id, $display_id) = $data; + $view = $view_storage->load($view_id); + if (in_array($view->get('base_table'), [$entity_type->getBaseTable(), $entity_type->getDataTable()])) { + $display = $view->get('display'); + $options[$view_id . ':' . $display_id] = $view_id . ' - ' . $display[$display_id]['display_title']; + } + } + + // The value of the 'view_and_display' select below will need to be split + // into 'view_name' and 'view_display' in the final submitted values, so + // we massage the data at validate time on the wrapping element (not + // ideal). + $form['view']['#element_validate'] = [[get_called_class(), 'settingsFormValidate']]; + + if ($options) { + $default = !empty($view_settings['view_name']) ? $view_settings['view_name'] . ':' . $view_settings['display_name'] : NULL; + $form['view']['view_and_display'] = [ + '#type' => 'select', + '#title' => $this->t('View used to select the entities'), + '#required' => TRUE, + '#options' => $options, + '#default_value' => $default, + '#description' => '<p>' . $this->t('Choose the view and display that select the entities that can be referenced.<br />Only views with a display of type "Entity Reference" are eligible.') . '</p>', + ]; + + $default = !empty($view_settings['arguments']) ? implode(', ', $view_settings['arguments']) : ''; + $form['view']['arguments'] = [ + '#type' => 'textfield', + '#title' => $this->t('View arguments'), + '#default_value' => $default, + '#required' => FALSE, + '#description' => $this->t('Provide a comma separated list of arguments to pass to the view.'), + ]; + } + else { + if ($this->currentUser->hasPermission('administer views') && $this->moduleHandler->moduleExists('views_ui')) { + $form['view']['no_view_help'] = [ + '#markup' => '<p>' . $this->t('No eligible views were found. <a href=":create">Create a view</a> with an <em>Entity Reference</em> display, or add such a display to an <a href=":existing">existing view</a>.', [ + ':create' => Url::fromRoute('views_ui.add')->toString(), + ':existing' => Url::fromRoute('entity.view.collection')->toString(), + ]) . '</p>', + ]; + } + else { + $form['view']['no_view_help']['#markup'] = '<p>' . $this->t('No eligible views were found.') . '</p>'; + } + } + return $form; + } + + /** + * Initializes a view. + * + * @param string|null $match + * (Optional) Text to match the label against. Defaults to NULL. + * @param string $match_operator + * (Optional) The operation the matching should be done with. Defaults + * to "CONTAINS". + * @param int $limit + * Limit the query to a given number of items. Defaults to 0, which + * indicates no limiting. + * @param array|null $ids + * Array of entity IDs. Defaults to NULL. + * + * @return bool + * Return TRUE if the view was initialized, FALSE otherwise. + */ + protected function initializeView($match = NULL, $match_operator = 'CONTAINS', $limit = 0, $ids = NULL) { + $view_name = $this->getConfiguration()['view']['view_name']; + $display_name = $this->getConfiguration()['view']['display_name']; + + // Check that the view is valid and the display still exists. + $this->view = Views::getView($view_name); + if (!$this->view || !$this->view->access($display_name)) { + drupal_set_message(t('The reference view %view_name cannot be found.', ['%view_name' => $view_name]), 'warning'); + return FALSE; + } + $this->view->setDisplay($display_name); + + // Pass options to the display handler to make them available later. + $entity_reference_options = [ + 'match' => $match, + 'match_operator' => $match_operator, + 'limit' => $limit, + 'ids' => $ids, + ]; + $this->view->displayHandlers->get($display_name)->setOption('entity_reference_options', $entity_reference_options); + return TRUE; + } + + /** + * {@inheritdoc} + */ + public function getReferenceableEntities($match = NULL, $match_operator = 'CONTAINS', $limit = 0) { + $display_name = $this->getConfiguration()['view']['display_name']; + $arguments = $this->getConfiguration()['view']['arguments']; + $result = []; + if ($this->initializeView($match, $match_operator, $limit)) { + // Get the results. + $result = $this->view->executeDisplay($display_name, $arguments); + } + + $return = []; + if ($result) { + foreach ($this->view->result as $row) { + $entity = $row->_entity; + $return[$entity->bundle()][$entity->id()] = $entity->label(); + } + } + return $return; + } + + /** + * {@inheritdoc} + */ + public function countReferenceableEntities($match = NULL, $match_operator = 'CONTAINS') { + $this->getReferenceableEntities($match, $match_operator); + return $this->view->pager->getTotalItems(); + } + + /** + * {@inheritdoc} + */ + public function validateReferenceableEntities(array $ids) { + $display_name = $this->getConfiguration()['view']['display_name']; + $arguments = $this->getConfiguration()['view']['arguments']; + $result = []; + if ($this->initializeView(NULL, 'CONTAINS', 0, $ids)) { + // Get the results. + $entities = $this->view->executeDisplay($display_name, $arguments); + $result = array_keys($entities); + } + return $result; + } + + /** + * Element validate; Check View is valid. + */ + public static function settingsFormValidate($element, FormStateInterface $form_state, $form) { + // Split view name and display name from the 'view_and_display' value. + if (!empty($element['view_and_display']['#value'])) { + list($view, $display) = explode(':', $element['view_and_display']['#value']); + } + else { + $form_state->setError($element, t('The views entity selection mode requires a view.')); + return; + } + + // Explode the 'arguments' string into an actual array. Beware, explode() + // turns an empty string into an array with one empty string. We'll need an + // empty array instead. + $arguments_string = trim($element['arguments']['#value']); + if ($arguments_string === '') { + $arguments = []; + } + else { + // array_map() is called to trim whitespaces from the arguments. + $arguments = array_map('trim', explode(',', $arguments_string)); + } + + $value = ['view_name' => $view, 'display_name' => $display, 'arguments' => $arguments]; + $form_state->setValueForElement($element, $value); + } + +}