Mercurial > hg > isophonics-drupal-site
view core/lib/Drupal/Core/Entity/EntityAutocompleteMatcher.php @ 19:fa3358dc1485 tip
Add ndrum files
author | Chris Cannam |
---|---|
date | Wed, 28 Aug 2019 13:14:47 +0100 |
parents | 4c8ae668cc8c |
children |
line wrap: on
line source
<?php namespace Drupal\Core\Entity; use Drupal\Component\Utility\Html; use Drupal\Component\Utility\Tags; use Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManagerInterface; /** * Matcher class to get autocompletion results for entity reference. */ class EntityAutocompleteMatcher { /** * The entity reference selection handler plugin manager. * * @var \Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManagerInterface */ protected $selectionManager; /** * Constructs a EntityAutocompleteMatcher object. * * @param \Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManagerInterface $selection_manager * The entity reference selection handler plugin manager. */ public function __construct(SelectionPluginManagerInterface $selection_manager) { $this->selectionManager = $selection_manager; } /** * Gets matched labels based on a given search string. * * @param string $target_type * The ID of the target entity type. * @param string $selection_handler * The plugin ID of the entity reference selection handler. * @param array $selection_settings * An array of settings that will be passed to the selection handler. * @param string $string * (optional) The label of the entity to query by. * * @return array * An array of matched entity labels, in the format required by the AJAX * autocomplete API (e.g. array('value' => $value, 'label' => $label)). * * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException * Thrown when the current user doesn't have access to the specified entity. * * @see \Drupal\system\Controller\EntityAutocompleteController */ public function getMatches($target_type, $selection_handler, $selection_settings, $string = '') { $matches = []; $options = $selection_settings + [ 'target_type' => $target_type, 'handler' => $selection_handler, ]; $handler = $this->selectionManager->getInstance($options); if (isset($string)) { // Get an array of matching entities. $match_operator = !empty($selection_settings['match_operator']) ? $selection_settings['match_operator'] : 'CONTAINS'; $entity_labels = $handler->getReferenceableEntities($string, $match_operator, 10); // Loop through the entities and convert them into autocomplete output. foreach ($entity_labels as $values) { foreach ($values as $entity_id => $label) { $key = "$label ($entity_id)"; // Strip things like starting/trailing white spaces, line breaks and // tags. $key = preg_replace('/\s\s+/', ' ', str_replace("\n", '', trim(Html::decodeEntities(strip_tags($key))))); // Names containing commas or quotes must be wrapped in quotes. $key = Tags::encode($key); $matches[] = ['value' => $key, 'label' => $label]; } } } return $matches; } }