Code Coverage |
||||||||||
Classes and Traits |
Functions and Methods |
Lines |
||||||||
Total | |
0.00% |
0 / 1 |
|
0.00% |
0 / 12 |
CRAP | |
0.00% |
0 / 190 |
DefaultSelection | |
0.00% |
0 / 1 |
|
20.00% |
3 / 15 |
1482 | |
0.00% |
0 / 190 |
__construct | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 5 |
|||
create | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 9 |
|||
buildConfigurationForm | |
0.00% |
0 / 1 |
90 | |
0.00% |
0 / 83 |
|||
anonymous function | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 5 |
|||
validateConfigurationForm | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 4 |
|||
submitConfigurationForm | |
100.00% |
1 / 1 |
1 | |
100.00% |
0 / 0 |
|||
elementValidateFilter | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 3 |
|||
getReferenceableEntities | |
0.00% |
0 / 1 |
20 | |
0.00% |
0 / 17 |
|||
countReferenceableEntities | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 5 |
|||
validateReferenceableEntities | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 11 |
|||
createNewEntity | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 12 |
|||
validateReferenceableNewEntities | |
100.00% |
1 / 1 |
2 | |
100.00% |
0 / 0 |
|||
buildEntityQuery | |
0.00% |
0 / 1 |
72 | |
0.00% |
0 / 27 |
|||
entityQueryAlter | |
100.00% |
1 / 1 |
1 | |
100.00% |
0 / 0 |
|||
reAlterQuery | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 8 |
<?php | |
/** | |
* @file | |
* Contains \Drupal\Core\Entity\Plugin\EntityReferenceSelection\DefaultSelection. | |
*/ | |
namespace Drupal\Core\Entity\Plugin\EntityReferenceSelection; | |
use Drupal\Component\Utility\Html; | |
use Drupal\Core\Database\Query\AlterableInterface; | |
use Drupal\Core\Database\Query\SelectInterface; | |
use Drupal\Core\Entity\EntityManagerInterface; | |
use Drupal\Core\Entity\EntityReferenceSelection\SelectionWithAutocreateInterface; | |
use Drupal\Core\Extension\ModuleHandlerInterface; | |
use Drupal\Core\Field\Plugin\Field\FieldType\EntityReferenceItem; | |
use Drupal\Core\Form\FormStateInterface; | |
use Drupal\Core\Entity\EntityReferenceSelection\SelectionInterface; | |
use Drupal\Core\Plugin\ContainerFactoryPluginInterface; | |
use Drupal\Core\Plugin\PluginBase; | |
use Drupal\Core\Session\AccountInterface; | |
use Drupal\user\EntityOwnerInterface; | |
use Symfony\Component\DependencyInjection\ContainerInterface; | |
/** | |
* Default plugin implementation of the Entity Reference Selection plugin. | |
* | |
* Also serves as a base class for specific types of Entity Reference | |
* Selection plugins. | |
* | |
* @see \Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManager | |
* @see \Drupal\Core\Entity\Annotation\EntityReferenceSelection | |
* @see \Drupal\Core\Entity\EntityReferenceSelection\SelectionInterface | |
* @see \Drupal\Core\Entity\Plugin\Derivative\DefaultSelectionDeriver | |
* @see plugin_api | |
* | |
* @EntityReferenceSelection( | |
* id = "default", | |
* label = @Translation("Default"), | |
* group = "default", | |
* weight = 0, | |
* deriver = "Drupal\Core\Entity\Plugin\Derivative\DefaultSelectionDeriver" | |
* ) | |
*/ | |
class DefaultSelection extends PluginBase implements SelectionInterface, SelectionWithAutocreateInterface, ContainerFactoryPluginInterface { | |
/** | |
* The entity manager. | |
* | |
* @var \Drupal\Core\Entity\EntityManagerInterface | |
*/ | |
protected $entityManager; | |
/** | |
* The module handler service. | |
* | |
* @var \Drupal\Core\Extension\ModuleHandlerInterface | |
*/ | |
protected $moduleHandler; | |
/** | |
* The current user. | |
* | |
* @var \Drupal\Core\Session\AccountInterface | |
*/ | |
protected $currentUser; | |
/** | |
* Constructs a new SelectionBase 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\EntityManagerInterface $entity_manager | |
* The entity manager service. | |
* @param \Drupal\Core\Extension\ModuleHandlerInterface $module_handler | |
* The module handler service. | |
* @param \Drupal\Core\Session\AccountInterface $current_user | |
* The current user. | |
*/ | |
public function __construct(array $configuration, $plugin_id, $plugin_definition, EntityManagerInterface $entity_manager, ModuleHandlerInterface $module_handler, AccountInterface $current_user) { | |
parent::__construct($configuration, $plugin_id, $plugin_definition); | |
$this->entityManager = $entity_manager; | |
$this->moduleHandler = $module_handler; | |
$this->currentUser = $current_user; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) { | |
return new static( | |
$configuration, | |
$plugin_id, | |
$plugin_definition, | |
$container->get('entity.manager'), | |
$container->get('module_handler'), | |
$container->get('current_user') | |
); | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function buildConfigurationForm(array $form, FormStateInterface $form_state) { | |
$entity_type_id = $this->configuration['target_type']; | |
$selection_handler_settings = $this->configuration['handler_settings']; | |
$entity_type = $this->entityManager->getDefinition($entity_type_id); | |
$bundles = $this->entityManager->getBundleInfo($entity_type_id); | |
// Merge-in default values. | |
$selection_handler_settings += array( | |
// For the 'target_bundles' setting, a NULL value is equivalent to "allow | |
// entities from any bundle to be referenced" and an empty array value is | |
// equivalent to "no entities from any bundle can be referenced". | |
'target_bundles' => NULL, | |
'sort' => array( | |
'field' => '_none', | |
), | |
'auto_create' => FALSE, | |
); | |
if ($entity_type->hasKey('bundle')) { | |
$bundle_options = array(); | |
foreach ($bundles as $bundle_name => $bundle_info) { | |
$bundle_options[$bundle_name] = $bundle_info['label']; | |
} | |
$form['target_bundles'] = array( | |
'#type' => 'checkboxes', | |
'#title' => $this->t('Bundles'), | |
'#options' => $bundle_options, | |
'#default_value' => (array) $selection_handler_settings['target_bundles'], | |
'#required' => TRUE, | |
'#size' => 6, | |
'#multiple' => TRUE, | |
'#element_validate' => [[get_class($this), 'elementValidateFilter']], | |
); | |
} | |
else { | |
$form['target_bundles'] = array( | |
'#type' => 'value', | |
'#value' => array(), | |
); | |
} | |
if ($entity_type->isSubclassOf('\Drupal\Core\Entity\FieldableEntityInterface')) { | |
$fields = array(); | |
foreach (array_keys($bundles) as $bundle) { | |
$bundle_fields = array_filter($this->entityManager->getFieldDefinitions($entity_type_id, $bundle), function ($field_definition) { | |
return !$field_definition->isComputed(); | |
}); | |
foreach ($bundle_fields as $field_name => $field_definition) { | |
/* @var \Drupal\Core\Field\FieldDefinitionInterface $field_definition */ | |
$columns = $field_definition->getFieldStorageDefinition()->getColumns(); | |
// If there is more than one column, display them all, otherwise just | |
// display the field label. | |
// @todo: Use property labels instead of the column name. | |
if (count($columns) > 1) { | |
foreach ($columns as $column_name => $column_info) { | |
$fields[$field_name . '.' . $column_name] = $this->t('@label (@column)', array('@label' => $field_definition->getLabel(), '@column' => $column_name)); | |
} | |
} | |
else { | |
$fields[$field_name] = $this->t('@label', array('@label' => $field_definition->getLabel())); | |
} | |
} | |
} | |
$form['sort']['field'] = array( | |
'#type' => 'select', | |
'#title' => $this->t('Sort by'), | |
'#options' => array( | |
'_none' => $this->t('- None -'), | |
) + $fields, | |
'#ajax' => TRUE, | |
'#limit_validation_errors' => array(), | |
'#default_value' => $selection_handler_settings['sort']['field'], | |
); | |
$form['sort']['settings'] = array( | |
'#type' => 'container', | |
'#attributes' => array('class' => array('entity_reference-settings')), | |
'#process' => [[EntityReferenceItem::class, 'formProcessMergeParent']], | |
); | |
if ($selection_handler_settings['sort']['field'] != '_none') { | |
// Merge-in default values. | |
$selection_handler_settings['sort'] += array( | |
'direction' => 'ASC', | |
); | |
$form['sort']['settings']['direction'] = array( | |
'#type' => 'select', | |
'#title' => $this->t('Sort direction'), | |
'#required' => TRUE, | |
'#options' => array( | |
'ASC' => $this->t('Ascending'), | |
'DESC' => $this->t('Descending'), | |
), | |
'#default_value' => $selection_handler_settings['sort']['direction'], | |
); | |
} | |
} | |
return $form; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function validateConfigurationForm(array &$form, FormStateInterface $form_state) { | |
// If no checkboxes were checked for 'target_bundles', store NULL ("all | |
// bundles are referenceable") rather than empty array ("no bundle is | |
// referenceable" - typically happens when all referenceable bundles have | |
// been deleted). | |
if ($form_state->getValue(['settings', 'handler_settings', 'target_bundles']) === []) { | |
$form_state->setValue(['settings', 'handler_settings', 'target_bundles'], NULL); | |
} | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function submitConfigurationForm(array &$form, FormStateInterface $form_state) { } | |
/** | |
* Form element validation handler; Filters the #value property of an element. | |
*/ | |
public static function elementValidateFilter(&$element, FormStateInterface $form_state) { | |
$element['#value'] = array_filter($element['#value']); | |
$form_state->setValueForElement($element, $element['#value']); | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function getReferenceableEntities($match = NULL, $match_operator = 'CONTAINS', $limit = 0) { | |
$target_type = $this->configuration['target_type']; | |
$query = $this->buildEntityQuery($match, $match_operator); | |
if ($limit > 0) { | |
$query->range(0, $limit); | |
} | |
$result = $query->execute(); | |
if (empty($result)) { | |
return array(); | |
} | |
$options = array(); | |
$entities = $this->entityManager->getStorage($target_type)->loadMultiple($result); | |
foreach ($entities as $entity_id => $entity) { | |
$bundle = $entity->bundle(); | |
$options[$bundle][$entity_id] = Html::escape($this->entityManager->getTranslationFromContext($entity)->label()); | |
} | |
return $options; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function countReferenceableEntities($match = NULL, $match_operator = 'CONTAINS') { | |
$query = $this->buildEntityQuery($match, $match_operator); | |
return $query | |
->count() | |
->execute(); | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function validateReferenceableEntities(array $ids) { | |
$result = array(); | |
if ($ids) { | |
$target_type = $this->configuration['target_type']; | |
$entity_type = $this->entityManager->getDefinition($target_type); | |
$query = $this->buildEntityQuery(); | |
$result = $query | |
->condition($entity_type->getKey('id'), $ids, 'IN') | |
->execute(); | |
} | |
return $result; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function createNewEntity($entity_type_id, $bundle, $label, $uid) { | |
$entity_type = $this->entityManager->getDefinition($entity_type_id); | |
$bundle_key = $entity_type->getKey('bundle'); | |
$label_key = $entity_type->getKey('label'); | |
$entity = $this->entityManager->getStorage($entity_type_id)->create(array( | |
$bundle_key => $bundle, | |
$label_key => $label, | |
)); | |
if ($entity instanceof EntityOwnerInterface) { | |
$entity->setOwnerId($uid); | |
} | |
return $entity; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function validateReferenceableNewEntities(array $entities) { | |
return array_filter($entities, function ($entity) { | |
if (isset($this->configuration['handler_settings']['target_bundles'])) { | |
return in_array($entity->bundle(), $this->configuration['handler_settings']['target_bundles']); | |
} | |
return TRUE; | |
}); | |
} | |
/** | |
* Builds an EntityQuery to get referenceable entities. | |
* | |
* @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". | |
* | |
* @return \Drupal\Core\Entity\Query\QueryInterface | |
* The EntityQuery object with the basic conditions and sorting applied to | |
* it. | |
*/ | |
protected function buildEntityQuery($match = NULL, $match_operator = 'CONTAINS') { | |
$target_type = $this->configuration['target_type']; | |
$handler_settings = $this->configuration['handler_settings']; | |
$entity_type = $this->entityManager->getDefinition($target_type); | |
$query = $this->entityManager->getStorage($target_type)->getQuery(); | |
// If 'target_bundles' is NULL, all bundles are referenceable, no further | |
// conditions are needed. | |
if (isset($handler_settings['target_bundles']) && is_array($handler_settings['target_bundles'])) { | |
// If 'target_bundles' is an empty array, no bundle is referenceable, | |
// force the query to never return anything and bail out early. | |
if ($handler_settings['target_bundles'] === []) { | |
$query->condition($entity_type->getKey('id'), NULL, '='); | |
return $query; | |
} | |
else { | |
$query->condition($entity_type->getKey('bundle'), $handler_settings['target_bundles'], 'IN'); | |
} | |
} | |
if (isset($match) && $label_key = $entity_type->getKey('label')) { | |
$query->condition($label_key, $match, $match_operator); | |
} | |
// Add entity-access tag. | |
$query->addTag($target_type . '_access'); | |
// Add the Selection handler for system_query_entity_reference_alter(). | |
$query->addTag('entity_reference'); | |
$query->addMetaData('entity_reference_selection_handler', $this); | |
// Add the sort option. | |
if (!empty($handler_settings['sort'])) { | |
$sort_settings = $handler_settings['sort']; | |
if ($sort_settings['field'] != '_none') { | |
$query->sort($sort_settings['field'], $sort_settings['direction']); | |
} | |
} | |
return $query; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function entityQueryAlter(SelectInterface $query) { } | |
/** | |
* Helper method: Passes a query to the alteration system again. | |
* | |
* This allows Entity Reference to add a tag to an existing query so it can | |
* ask access control mechanisms to alter it again. | |
*/ | |
protected function reAlterQuery(AlterableInterface $query, $tag, $base_table) { | |
// Save the old tags and metadata. | |
// For some reason, those are public. | |
$old_tags = $query->alterTags; | |
$old_metadata = $query->alterMetaData; | |
$query->alterTags = array($tag => TRUE); | |
$query->alterMetaData['base_table'] = $base_table; | |
$this->moduleHandler->alter(array('query', 'query_' . $tag), $query); | |
// Restore the tags and metadata. | |
$query->alterTags = $old_tags; | |
$query->alterMetaData = $old_metadata; | |
} | |
} |