====== TPL_ACT_RENDER ======

---- dataentry event ----
Description:    Output XHTML before and/or after a page
DefaultAction:  Outputs XHTML for the choosen $ACT command
Preventable:    yes
Added_dt:       2006-04-25
----

The event is signalled by [[xref>tpl_content()]] in [[xref>inc/template.php]]. You can use this event to output XHTML before and/or after the main Dokuwiki page output and can prevent the default dokuwiki page generation taking place. Output buffering is active during this event, the captured output is passed to the event [[devel:event:TPL_CONTENT_DISPLAY]].

===== Passed Data =====
The passed [[xref>Doku_Event]] object has the fields: ''$data'' and ''$result''.

The ''$data'' field contains the contents of the [[devel:environment#$ACT]] variable. The ''$ACT'' variable is assigned by reference, so updating ''$data'' will update ''$ACT'' as well.

The BEFORE event handler can modify the ''$data'' field to change the action command and the default action [[xref>tpl_content_core()]] can be prevented. This function handles all default content XHTML generation actions or the registered [[devel:event:TPL_ACT_UNKNOWN]] ones.
The ''$result'' field is set to true by the default action if a defined $ACT was handled, false otherwise. The AFTER handler is finally called.


===== See also =====

  * [[codesearch>TPL_ACT_RENDER|Code related to this event]] used in any DokuWiki's files, plugins and templates
  * [[devel:Action Plugins]]
  * [[devel:Events]]
  * [[devel:event:TPL_CONTENT_DISPLAY]]