====== ACTION_ACT_PREPROCESS ======

---- dataentry event ----
Description:    Handling ?do= actions
DefaultAction:  Dokuwiki's own processing of the $ACT value
Preventable:    yes
Added_dt:       2006-04-25
----

This event allows you to catch any action mode passed to the DokuWiki dispatcher [[xref>act_dispatch()]] in [[xref>inc/actions.php]] before it begins to process the $ACT variable itself.

The ''AFTER'' action is never performed on a successful ''save''.

===== Passed Data =====
The passed [[xref>Doku_Event]] has the field ''$data''.

''$data'' is a string or array containing the $ACT value (the ''do'' variable in the query string - uncleaned). See [[xref>act_clean()]] for an example of cleaning.

Add a BEFORE event handler to process your action. Check the ''$data'' field for the correct action name. Also use an unique action name to avoid collisions.

Use ''preventDefault()'' to skip DokuWiki's processing of the action. ''$data'' is a reference to the [[xref>$ACT]] variable, so assigning another action string to the ''$data'' field will be noticed outside your event handler.

The AFTER event handler lets you handle actions after performing DokuWiki's default action handling (attention: can be eventually skipped by ''preventDefault()''). Due to handling of actions by plugins and DokuWiki itself the AFTER event handler can be reached with another action than you expect at first sight. Please be aware it.


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

  * [[codesearch>ACTION_ACT_PREPROCESS|Code related to this event]] used in any DokuWiki's files, plugins and templates
  * [[devel:Action Plugins]]
  * [[devel:Events]]
  * This event prepares for use of [[TPL_ACT_UNKNOWN]]