1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283 |
- <?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;
- }
- }
|