Differences

This shows you the differences between two versions of the page.

--- devel:event:action_act_preprocess [2013-02-12 16:50] – [Plugins handling this event] change sioc to dokusioc 87.194.159.222
+++ devel:event:action_act_preprocess [2022-08-31 18:46] (current) – [See also] Klap-in
@@ Line 13: / Line 13: @@
 ===== Passed Data =====
+The passed [[xref>Doku_Event]] has the field ''$data''.
-$data is a scalar containing the $ACT value (the ''do'' variable in the query string - uncleaned).
+''$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.
-===== Plugins handling this event =====
+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.
-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.
+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.
-  * [[plugin:404manager]], [[plugin:adminhomepage]], [[plugin:akismet]], [[plugin:autostart]], [[plugin:blog]], [[plugin:captcha]], [[plugin:cite]], [[plugin:discussion]], [[plugin:dokubookmark]], [[plugin:favoris]], [[plugin:googlesearch]], [[plugin:linkback]], [[plugin:linkback]], [[plugin:login_redirector]], [[plugin:loglog]], [[plugin:logoutconvenience]], [[plugin:message]], [[plugin:multilingual]], [[plugin:new_page_dialog]], [[plugin:openid]], [[plugin:pxxo]], [[plugin:searchformgoto]], [[plugin:dokusioc]], [[plugin:siteexport]], [[plugin:tag]], [[plugin:task]], [[plugin:userhomepage]], [[plugin:userspagecreate]], [[plugin:projects]]
 ===== 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]]
-  * [[TPL_ACT_UNKNOWN]]
+  * This event prepares for use of [[TPL_ACT_UNKNOWN]]