interface SynonymsFindProviderInterface in Synonyms 8

Interface to look up entities by synonyms they have.

Hierarchy

• interface \Drupal\synonyms\SynonymsProviderInterface\SynonymsProviderInterface
  • interface \Drupal\synonyms\SynonymsProviderInterface\SynonymsFindProviderInterface

6 files declare their use of SynonymsFindProviderInterface

AutocompleteService.php in src/SynonymsService/Behavior/AutocompleteService.php

BaseField.php in src/Plugin/Synonyms/Provider/BaseField.php

EntityGetBySynonym.php in src/SynonymsService/EntityGetBySynonym.php

EntityReferenceField.php in src/Plugin/Synonyms/Provider/EntityReferenceField.php

Field.php in src/Plugin/Synonyms/Provider/Field.php

... See full list

File

src/SynonymsProviderInterface/SynonymsFindProviderInterface.php, line 10

Namespace

Drupal\synonyms\SynonymsProviderInterface

interface SynonymsFindProviderInterface extends SynonymsProviderInterface {

  /**
   * Constant which denotes placeholder of a synonym column.
   *
   * @var string
   */
  const COLUMN_SYNONYM_PLACEHOLDER = '***SYNONYM_COLUMN***';

  /**
   * Constant which denotes placeholder of an entity ID column.
   *
   * @var string
   */
  const COLUMN_ENTITY_ID_PLACEHOLDER = '***ENTITY_ID***';

  /**
   * Look up entities by their synonyms within a behavior implementation.
   *
   * You are provided with a SQL condition that you should apply to the storage
   * of synonyms within the provided behavior implementation. And then return
   * result: what entities are matched by the provided condition through what
   * synonyms.
   *
   * @param \Drupal\Core\Database\Query\ConditionInterface $condition
   *   Condition that defines what to search for. Apart from normal SQL
   *   conditions as known in Drupal, it may contain the following placeholders:
   *   - SynonymsFindProviderInterface::COLUMN_SYNONYM_PLACEHOLDER: to denote
   *     synonyms column which you should replace with the actual column name
   *     where the synonyms data for your provider is stored in plain text.
   *   - SynonymsFindProviderInterface::COLUMN_ENTITY_ID_PLACEHOLDER: to denote
   *     column that holds entity ID. You are supposed to replace this
   *     placeholder with actual column name that holds entity ID in your case.
   *   For ease of work with these placeholders, you may use the
   *   SynonymsFindTrait and then just invoke the
   *   $this->synonymsFindProcessCondition() method, so you won't have to worry
   *   much about it.
   *
   * @return \Traversable
   *   Traversable result set of found synonyms and entity IDs to which those
   *   belong. Each element in the result set should be an object and should
   *   have the following structure:
   *   - synonym: (string) Synonym that was found and which satisfies the
   *     provided condition
   *   - entity_id: (int) ID of the entity to which the found synonym belongs
   */
  public function synonymsFind(ConditionInterface $condition);

}

Members

Name	Modifiers	Type	Description	Overrides
SynonymsFindProviderInterface::COLUMN_ENTITY_ID_PLACEHOLDER		constant	Constant which denotes placeholder of an entity ID column.
SynonymsFindProviderInterface::COLUMN_SYNONYM_PLACEHOLDER		constant	Constant which denotes placeholder of a synonym column.
SynonymsFindProviderInterface::synonymsFind	public	function	Look up entities by their synonyms within a behavior implementation.	3
SynonymsProviderInterface::getBehaviorService	public	function	Fetch behavior service which corresponds to this provider.	1
SynonymsProviderInterface::getBehaviorServiceInstance	public	function	Fetch behavior service instance which corresponds to this provider.	1