You are here

function hook_search_page in Drupal 7

Override the rendering of search results.

A module that implements hook_search_info() to define a type of search may implement this hook in order to override the default theming of its search results, which is otherwise themed using theme('search_results').

Note that by default, theme('search_results') and theme('search_result') work together to create an ordered list (OL). So your hook_search_page() implementation should probably do this as well.

Parameters

$results: An array of search results.

Return value

A renderable array, which will render the formatted search results with a pager included.

See also

search-result.tpl.php

search-results.tpl.php

Related topics

1 function implements hook_search_page()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

search_extra_type_search_page in modules/search/tests/search_extra_type.module
Implements hook_search_page().
1 invocation of hook_search_page()
search_data in modules/search/search.module
Performs a search by calling hook_search_execute().

File

modules/search/search.api.php, line 248
Hooks provided by the Search module.

Code

function hook_search_page($results) {
  $output['prefix']['#markup'] = '<ol class="search-results">';
  foreach ($results as $entry) {
    $output[] = array(
      '#theme' => 'search_result',
      '#result' => $entry,
      '#module' => 'my_module_name',
    );
  }
  $output['suffix']['#markup'] = '</ol>' . theme('pager');
  return $output;
}