function hook_views_preview_info_alter

Alter the information box that (optionally) appears with a view preview.

Includes query and performance statistics.

This hook should be placed in MODULENAME.views.inc and it will be auto-loaded. MODULENAME.views.inc must be in the directory specified by the 'path' key returned by MODULENAME_views_api(), or the same directory as the .module file, if 'path' is unspecified.

Warning: $view is not a reference in PHP4 and cannot be modified here. But it IS a reference in PHP5, and can be modified. Please be careful with it.

Parameters

array $rows: An associative array with two keys:

  • query: An array of rows suitable for theme('table'), containing information about the query and the display title and path.
  • statistics: An array of rows suitable for theme('table'), containing performance statistics.

object $view: The view object.

See also

theme_table()

Related topics

Views hooks
Hooks that can be implemented by other modules in order to implement the
Views API.
1 invocation of hook_views_preview_info_alter()
views_ui_preview in includes/admin.inc
Returns the results of the live preview.

File

./views.api.php, line 1215

Code

function hook_views_preview_info_alter(&$rows, $view) {
    // Adds information about the tables being queried by the view to the query
    // part of the info box.
    $rows['query'][] = array(
        t('<strong>Table queue</strong>'),
        count($view->query->table_queue) . ': (' . implode(', ', array_keys($view->query->table_queue)) . ')',
    );
}