Functions that perform an action on a certain system object.
Action functions are declared by modules by implementing hook_action_info(). Modules can cause action functions to run by calling actions_do(), and trigger.module provides a user interface that lets administrators define events that cause action functions to run.
Each action function takes two to four arguments:
- $entity: The object that the action acts on, such as a node, comment, or user.
- $context: Array of additional information about what triggered the action.
- $a1, $a2: Optional additional information, which can be passed into actions_do() and will be passed along to the action function.
Functions & methods
| Name | Description |
|---|---|
| actions_do | Performs a given list of actions by executing their callback functions. |
| comment_publish_action | Publishes a comment. |
| comment_save_action | Saves a comment. |
| comment_unpublish_action | Unpublishes a comment. |
| comment_unpublish_by_keyword_action | Unpublishes a comment if it contains certain keywords. |
| hook_action_info | Declares information about actions. |
| node_assign_owner_action | Assigns ownership of a node to a user. |
| node_make_sticky_action | Sets the sticky-at-top-of-list property of a node to 1. |
| node_make_unsticky_action | Sets the sticky-at-top-of-list property of a node to 0. |
| node_promote_action | Sets the promote property of a node to 1. |
| node_publish_action | Sets the status of a node to 1 (published). |
| node_save_action | Saves a node. |
| node_unpromote_action | Sets the promote property of a node to 0. |
| node_unpublish_action | Sets the status of a node to 0 (unpublished). |
| node_unpublish_by_keyword_action | Unpublishes a node containing certain keywords. |
| system_block_ip_action | Blocks the current user's IP address. |
| system_goto_action | Redirects to a different URL. |
| system_message_action | Sends a message to the current user's screen. |
| system_send_email_action | Sends an e-mail message. |
| user_block_user_action | Blocks the current user. |
File
- includes/
actions.inc, line 8 - This is the actions engine for executing stored actions.