function hook_search_page

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

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

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.