interface SearchableHelpInterface in Drupal 10

Provides an interface for a HelpSection plugin that also supports search.

@internal Help Topics is currently experimental and should only be leveraged by experimental modules and development releases of contributed modules. See https://www.drupal.org/core/experimental for more information.

Hierarchy

• interface \Drupal\help_topics\SearchableHelpInterface

See also

\Drupal\help\HelpSectionPluginInterface

3 files declare their use of SearchableHelpInterface

HelpSearch.php in core/modules/help_topics/src/Plugin/Search/HelpSearch.php

HelpTopicSection.php in core/modules/help_topics/src/Plugin/HelpSection/HelpTopicSection.php

TestHelpSection.php in core/modules/help_topics/tests/modules/help_topics_test/src/Plugin/HelpSection/TestHelpSection.php

File

core/modules/help_topics/src/SearchableHelpInterface.php, line 17

Namespace

Drupal\help_topics

interface SearchableHelpInterface {

  /**
   * Returns the IDs of topics that should be indexed for searching.
   *
   * @return string[]
   *   An array of topic IDs that should be searchable. IDs need to be
   *   unique within this HelpSection plugin.
   */
  public function listSearchableTopics();

  /**
   * Renders one topic for search indexing or search results.
   *
   * @param string $topic_id
   *   The ID of the topic to be indexed.
   * @param \Drupal\Core\Language\LanguageInterface $language
   *   The language to render the topic in.
   *
   * @return array
   *   An array of information about the topic, with elements:
   *   - title: The title of the topic in this language.
   *   - text: The text of the topic in this language.
   *   - url: The URL of the topic as a \Drupal\Core\Url object.
   *   - cacheable_metadata: (optional) An object to add as a cache dependency
   *     if this topic is shown in search results.
   */
  public function renderTopicForSearch($topic_id, LanguageInterface $language);

}