Mercurial > hg > isophonics-drupal-site
comparison 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 |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:4c8ae668cc8c |
---|---|
1 <?php | |
2 | |
3 namespace Drupal\views\Plugin\EntityReferenceSelection; | |
4 | |
5 use Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginBase; | |
6 use Drupal\Core\Entity\EntityReferenceSelection\SelectionTrait; | |
7 use Drupal\Core\Form\FormStateInterface; | |
8 use Drupal\Core\Plugin\ContainerFactoryPluginInterface; | |
9 use Drupal\Core\Url; | |
10 use Drupal\views\Views; | |
11 | |
12 /** | |
13 * Plugin implementation of the 'selection' entity_reference. | |
14 * | |
15 * @EntityReferenceSelection( | |
16 * id = "views", | |
17 * label = @Translation("Views: Filter by an entity reference view"), | |
18 * group = "views", | |
19 * weight = 0 | |
20 * ) | |
21 */ | |
22 class ViewsSelection extends SelectionPluginBase implements ContainerFactoryPluginInterface { | |
23 | |
24 use SelectionTrait; | |
25 | |
26 /** | |
27 * The loaded View object. | |
28 * | |
29 * @var \Drupal\views\ViewExecutable; | |
30 */ | |
31 protected $view; | |
32 | |
33 /** | |
34 * {@inheritdoc} | |
35 */ | |
36 public function defaultConfiguration() { | |
37 return [ | |
38 'view' => [ | |
39 'view_name' => NULL, | |
40 'display_name' => NULL, | |
41 'arguments' => [], | |
42 ], | |
43 ] + parent::defaultConfiguration(); | |
44 } | |
45 | |
46 /** | |
47 * {@inheritdoc} | |
48 */ | |
49 public function buildConfigurationForm(array $form, FormStateInterface $form_state) { | |
50 $form = parent::buildConfigurationForm($form, $form_state); | |
51 | |
52 $view_settings = $this->getConfiguration()['view']; | |
53 $displays = Views::getApplicableViews('entity_reference_display'); | |
54 // Filter views that list the entity type we want, and group the separate | |
55 // displays by view. | |
56 $entity_type = $this->entityManager->getDefinition($this->configuration['target_type']); | |
57 $view_storage = $this->entityManager->getStorage('view'); | |
58 | |
59 $options = []; | |
60 foreach ($displays as $data) { | |
61 list($view_id, $display_id) = $data; | |
62 $view = $view_storage->load($view_id); | |
63 if (in_array($view->get('base_table'), [$entity_type->getBaseTable(), $entity_type->getDataTable()])) { | |
64 $display = $view->get('display'); | |
65 $options[$view_id . ':' . $display_id] = $view_id . ' - ' . $display[$display_id]['display_title']; | |
66 } | |
67 } | |
68 | |
69 // The value of the 'view_and_display' select below will need to be split | |
70 // into 'view_name' and 'view_display' in the final submitted values, so | |
71 // we massage the data at validate time on the wrapping element (not | |
72 // ideal). | |
73 $form['view']['#element_validate'] = [[get_called_class(), 'settingsFormValidate']]; | |
74 | |
75 if ($options) { | |
76 $default = !empty($view_settings['view_name']) ? $view_settings['view_name'] . ':' . $view_settings['display_name'] : NULL; | |
77 $form['view']['view_and_display'] = [ | |
78 '#type' => 'select', | |
79 '#title' => $this->t('View used to select the entities'), | |
80 '#required' => TRUE, | |
81 '#options' => $options, | |
82 '#default_value' => $default, | |
83 '#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>', | |
84 ]; | |
85 | |
86 $default = !empty($view_settings['arguments']) ? implode(', ', $view_settings['arguments']) : ''; | |
87 $form['view']['arguments'] = [ | |
88 '#type' => 'textfield', | |
89 '#title' => $this->t('View arguments'), | |
90 '#default_value' => $default, | |
91 '#required' => FALSE, | |
92 '#description' => $this->t('Provide a comma separated list of arguments to pass to the view.'), | |
93 ]; | |
94 } | |
95 else { | |
96 if ($this->currentUser->hasPermission('administer views') && $this->moduleHandler->moduleExists('views_ui')) { | |
97 $form['view']['no_view_help'] = [ | |
98 '#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>.', [ | |
99 ':create' => Url::fromRoute('views_ui.add')->toString(), | |
100 ':existing' => Url::fromRoute('entity.view.collection')->toString(), | |
101 ]) . '</p>', | |
102 ]; | |
103 } | |
104 else { | |
105 $form['view']['no_view_help']['#markup'] = '<p>' . $this->t('No eligible views were found.') . '</p>'; | |
106 } | |
107 } | |
108 return $form; | |
109 } | |
110 | |
111 /** | |
112 * Initializes a view. | |
113 * | |
114 * @param string|null $match | |
115 * (Optional) Text to match the label against. Defaults to NULL. | |
116 * @param string $match_operator | |
117 * (Optional) The operation the matching should be done with. Defaults | |
118 * to "CONTAINS". | |
119 * @param int $limit | |
120 * Limit the query to a given number of items. Defaults to 0, which | |
121 * indicates no limiting. | |
122 * @param array|null $ids | |
123 * Array of entity IDs. Defaults to NULL. | |
124 * | |
125 * @return bool | |
126 * Return TRUE if the view was initialized, FALSE otherwise. | |
127 */ | |
128 protected function initializeView($match = NULL, $match_operator = 'CONTAINS', $limit = 0, $ids = NULL) { | |
129 $view_name = $this->getConfiguration()['view']['view_name']; | |
130 $display_name = $this->getConfiguration()['view']['display_name']; | |
131 | |
132 // Check that the view is valid and the display still exists. | |
133 $this->view = Views::getView($view_name); | |
134 if (!$this->view || !$this->view->access($display_name)) { | |
135 drupal_set_message(t('The reference view %view_name cannot be found.', ['%view_name' => $view_name]), 'warning'); | |
136 return FALSE; | |
137 } | |
138 $this->view->setDisplay($display_name); | |
139 | |
140 // Pass options to the display handler to make them available later. | |
141 $entity_reference_options = [ | |
142 'match' => $match, | |
143 'match_operator' => $match_operator, | |
144 'limit' => $limit, | |
145 'ids' => $ids, | |
146 ]; | |
147 $this->view->displayHandlers->get($display_name)->setOption('entity_reference_options', $entity_reference_options); | |
148 return TRUE; | |
149 } | |
150 | |
151 /** | |
152 * {@inheritdoc} | |
153 */ | |
154 public function getReferenceableEntities($match = NULL, $match_operator = 'CONTAINS', $limit = 0) { | |
155 $display_name = $this->getConfiguration()['view']['display_name']; | |
156 $arguments = $this->getConfiguration()['view']['arguments']; | |
157 $result = []; | |
158 if ($this->initializeView($match, $match_operator, $limit)) { | |
159 // Get the results. | |
160 $result = $this->view->executeDisplay($display_name, $arguments); | |
161 } | |
162 | |
163 $return = []; | |
164 if ($result) { | |
165 foreach ($this->view->result as $row) { | |
166 $entity = $row->_entity; | |
167 $return[$entity->bundle()][$entity->id()] = $entity->label(); | |
168 } | |
169 } | |
170 return $return; | |
171 } | |
172 | |
173 /** | |
174 * {@inheritdoc} | |
175 */ | |
176 public function countReferenceableEntities($match = NULL, $match_operator = 'CONTAINS') { | |
177 $this->getReferenceableEntities($match, $match_operator); | |
178 return $this->view->pager->getTotalItems(); | |
179 } | |
180 | |
181 /** | |
182 * {@inheritdoc} | |
183 */ | |
184 public function validateReferenceableEntities(array $ids) { | |
185 $display_name = $this->getConfiguration()['view']['display_name']; | |
186 $arguments = $this->getConfiguration()['view']['arguments']; | |
187 $result = []; | |
188 if ($this->initializeView(NULL, 'CONTAINS', 0, $ids)) { | |
189 // Get the results. | |
190 $entities = $this->view->executeDisplay($display_name, $arguments); | |
191 $result = array_keys($entities); | |
192 } | |
193 return $result; | |
194 } | |
195 | |
196 /** | |
197 * Element validate; Check View is valid. | |
198 */ | |
199 public static function settingsFormValidate($element, FormStateInterface $form_state, $form) { | |
200 // Split view name and display name from the 'view_and_display' value. | |
201 if (!empty($element['view_and_display']['#value'])) { | |
202 list($view, $display) = explode(':', $element['view_and_display']['#value']); | |
203 } | |
204 else { | |
205 $form_state->setError($element, t('The views entity selection mode requires a view.')); | |
206 return; | |
207 } | |
208 | |
209 // Explode the 'arguments' string into an actual array. Beware, explode() | |
210 // turns an empty string into an array with one empty string. We'll need an | |
211 // empty array instead. | |
212 $arguments_string = trim($element['arguments']['#value']); | |
213 if ($arguments_string === '') { | |
214 $arguments = []; | |
215 } | |
216 else { | |
217 // array_map() is called to trim whitespaces from the arguments. | |
218 $arguments = array_map('trim', explode(',', $arguments_string)); | |
219 } | |
220 | |
221 $value = ['view_name' => $view, 'display_name' => $display, 'arguments' => $arguments]; | |
222 $form_state->setValueForElement($element, $value); | |
223 } | |
224 | |
225 } |