function hook_views_post_render

7 views.api.php hook_views_post_render(&$view, &$output, &$cache)
6 docs.php hook_views_post_render(&$view, &$output, &$cache)

Post process any rendered data.

This can be valuable to be able to cache a view and still have some level of dynamic output. In an ideal world, the actual output will include HTML comment based tokens, and then the post process can replace those tokens.

Example usage. If it is known that the view is a node view and that the primary field will be a nid, you can do something like this:

<!--post-FIELD-NID-->

And then in the post render, create an array with the text that should go there:

strtr($output, array('<!--post-FIELD-1-->' => 'output for FIELD of nid 1');

All of the cached result data will be available in $view->result, as well, so all ids used in the query should be discoverable.

This hook can be utilized by themes.

Parameters

$view: The view object about to be processed.

$output: A flat string with the rendered output of the view.

$cache: The cache settings.

Related topics

1 invocation of hook_views_post_render()
view::render in includes/view.inc
Render this view for a certain display.

File

./views.api.php, line 973
Describe hooks provided by the Views module.

Code

function hook_views_post_render(&$view, &$output, &$cache) {
  // When using full pager, disable any time-based caching if there are less
  // then 10 results.
  if ($view->query->pager instanceof views_plugin_pager_full && $cache->options['type'] == 'time' && count($view->result) < 10) {
    $cache['options']['results_lifespan'] = 0;
    $cache['options']['output_lifespan'] = 0;
  }
}

Comments

Hello-

I am trying to use this hook to place text above my view. For some reason, this hook is being run twice, resulting in the same text being output twice. Can anyone help me figure out why this is happening?

Thanks!

Jetson Davis
Los Angeles, CA

Each display is handled separately by Views, so those hooks would each execute once per display.

The subject is the only question...

Yep. It says it can be used in themes so therefore it can be used in template.php. Just replace "hook" with your theme's machine name, as always.