This is an old revision of the document!
Table of Contents
PARSER_CACHE_USE
- Description:
- manipulate the cache validity
- DefaultAction:
- determine whether or not cached data should be used
- Preventable:
- yes
- Added:
- 2006-09-16
Signalled by cache versions of parser wrapper functions inc/parserutils.php. Syntax plugins can use this event to provide their own assistance to DokuWiki's cache validity logic when the syntax extension adds other dependencies to the rendered page.
Passed Data and Result in event handler
The passed Doku_Event has the fields $data
and $result
.
$data
is a cache object (cache_parser or extended on that object) – refer inc/cache.php.
For handling the event, key properties of the cache object are:
page
, if present the wiki page id, may not always be present, e.g. when called for locale XHTML filesfile
, source filemode
, renderer mode (e.g. 'xhtml') or 'i' for instructionsdepends
, array of dependencies used to determine cache validity
In the AFTER event handler the $result
field is set with the result of the _useCache() method. The AFTER event handler can modify this.
Plugins handling this event
The following plugins are known to handle this event and their source code may be a good start for understanding and implementing a handler yourself.