| 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
- 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
hook_views_post_render runs twice
PermalinkHello-
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
Are you using an attachment display?
PermalinkEach display is handled separately by Views, so those hooks would each execute once per display.
Can I use it with template.php?
PermalinkThe subject is the only question...
Yep. It says it can be used
PermalinkYep. 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.