function actions_list
7.x actions.inc | actions_list($reset = FALSE) |
6.x actions.inc | actions_list($reset = FALSE) |
Discover all action functions by invoking hook_action_info().
mymodule_action_info() {
return array(
'mymodule_functiondescription_action' => array(
'type' => 'node',
'description' => t('Save node'),
'configurable' => FALSE,
'hooks' => array(
'nodeapi' => array('delete', 'insert', 'update', 'view'),
'comment' => array('delete', 'insert', 'update', 'view'),
)
)
);
}
The description is used in presenting possible actions to the user for configuration. The type is used to present these actions in a logical grouping and to denote context. Some types are 'node', 'user', 'comment', and 'system'. If an action is configurable it will provide form, validation and submission functions. The hooks the action supports are declared in the 'hooks' array.
Parameters
$reset: Reset the action info static cache.
Return value
An associative array keyed on function name. The value of each key is an array containing information about the action, such as type of action and description of the action, e.g.,
$actions['node_publish_action'] = array(
'type' => 'node',
'description' => t('Publish post'),
'configurable' => FALSE,
'hooks' => array(
'nodeapi' => array('presave', 'insert', 'update', 'view'),
'comment' => array('delete', 'insert', 'update', 'view'),
),
);
9 calls to actions_list()
- actions_do in drupal-6.x/
includes/ actions.inc - Perform a given list of actions by executing their callback functions.
- actions_function_lookup in drupal-6.x/
includes/ actions.inc - Given an md5 hash of a function name, return the function name.
- actions_synchronize in drupal-6.x/
includes/ actions.inc - Synchronize actions that are provided by modules.
- system_actions_configure in drupal-6.x/
modules/ system/ system.module - Menu callback. Create the form for configuration of a single action.
- system_actions_manage in drupal-6.x/
modules/ system/ system.module - Menu callback. Display an overview of available and configured actions.
File
- drupal-6.x/
includes/ actions.inc, line 186 - This is the actions engine for executing stored actions.
Code
function actions_list($reset = FALSE) {
static $actions;
if (!isset($actions) || $reset) {
$actions = module_invoke_all('action_info');
drupal_alter('action_info', $actions);
}
// See module_implements for explanations of this cast.
return (array) $actions;
}