function PhpSelection::getReferenceableEntities

Overrides DefaultSelection::getReferenceableEntities

File

core/lib/Drupal/Core/Entity/Plugin/EntityReferenceSelection/PhpSelection.php, line 21

Class

PhpSelection

Defines an alternative to the default Entity Reference Selection plugin.

Namespace

Code

public function getReferenceableEntities($match = NULL, $match_operator = 'CONTAINS', $limit = 0) {
    // No input, return everything from the entity query.
    if ($match === NULL || $match === '') {
        return parent::getReferenceableEntities($match, $match_operator, $limit);
    }
    // Start with the selection results returned by the entity query. Don't use
    // any limit because we have to apply a limit after filtering the items.
    $options = parent::getReferenceableEntities($match, $match_operator);
    // Always use a case-insensitive, escaped match. Entity labels returned by
    // SelectionInterface::getReferenceableEntities() are already escaped, so
    // the incoming $match needs to be escaped as well, making the comparison
    // possible.
    // @see \Drupal\Core\Entity\EntityReferenceSelection\SelectionInterface::getReferenceableEntities()
    if (is_string($match)) {
        $match = Html::escape(mb_strtolower($match));
    }
    elseif (is_array($match)) {
        array_walk($match, function (&$item) {
            $item = Html::escape(mb_strtolower($item));
        });
    }
    $filtered = [];
    $count = 0;
    // Filter target entities by the output of their label() method.
    foreach ($options as $bundle => &$items) {
        foreach ($items as $entity_id => $label) {
            if ($this->matchLabel($match, $match_operator, $label)) {
                $filtered[$bundle][$entity_id] = $label;
                $count++;
                if ($limit && $count >= $limit) {
                    break 2;
                }
            }
        }
    }
    return $filtered;
}