Theming search page

Question

I'm customizing my search results page. I have found the two templates search-result.tpl and search-results.tpl but in addition to these there is also a collapsible fieldset for advanced search. Where is this coming from? How can I theme the page as a whole? Like do it in a page.tpl or node.tpl file.

Also Themer tells me that this whole node (the search page content) is actually a block.tpl file! How is that possible?

I'm on D7.

Here is the screenshot:

Answer 1

The collapsible fieldset comes from FAPI and is a different thing than the search results.

It's a regular form, so you have to alter it the form way, via hooks. The basics are here.

function your_module_name_form_alter (&$form, &$form_state, $form_id)) {
  if ($form_id === 'search_block_form') {  // Double check it's the correct ID
      // Your custom code goes here
      // Starting with a dpm($form) is often a good idea
  }
}

Answer 2

You can of course try the default from theme method like Theming forms in Drupal 7

$form['#theme'] = 'foo-login-form';

with hook_form_alter

Answer 3

The search module outputs a render array to $page['content'] with two parts

$page['content']['search_form']
$page['content']['search_results']

You can intercept this array in your theme before it gets rendered and make modifications to it.

i.e in your theme_preprocess_page you can do

$page['content']['search_form']['#suffix'] = 'Hello' 

To insert hello below the form. You can also modify the contents of the arrays directly if you want to change the way they behave.

You will need some logic in there to make sure it exists before making changes. But this is just an example.

Hope that makes sense, there is no single template that surrounds these that you can access directly.

Answer 4

The field set you are seeing is added from node_form_search_form_alter(), which an implementation of hook_form_FORM_ID_alter().

To theme a form, you just need to add code similar to the following one.

function mymodule_form_search_form_alter(&$form, &$form_state, $form_id) {
  if (isset($form['module']) && $form['module']['#value'] == 'node') {
    $form['#theme'] = 'mymodule_search_form';
  }
}

The theme function could be one using a template file.
The control statement is necessary to add the theme function only to the search form for nodes. If you need to alter all the search pages, then it should be removed; if you need to change another search page, then change the $form['module']['#value'] == 'node' part.

Drupal shows the "Advanced search" fieldset only when the logged-in user has the "use advanced search" permission.