danielebarchiesi@0: <?php
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @file
danielebarchiesi@0:  * Hooks provided by the Trigger module.
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @addtogroup hooks
danielebarchiesi@0:  * @{
danielebarchiesi@0:  */
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Declare triggers (events) for users to assign actions to.
danielebarchiesi@0:  *
danielebarchiesi@0:  * This hook is used by the trigger module to create a list of triggers (events)
danielebarchiesi@0:  * that users can assign actions to. Your module is responsible for detecting
danielebarchiesi@0:  * that the events have occurred, calling trigger_get_assigned_actions() to find
danielebarchiesi@0:  * out which actions the user has associated with your trigger, and then calling
danielebarchiesi@0:  * actions_do() to fire off the actions.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @return
danielebarchiesi@0:  *   A nested associative array.
danielebarchiesi@0:  *   - The outermost key is the name of the module that is defining the triggers.
danielebarchiesi@0:  *     This will be used to create a local task (tab) in the trigger module's
danielebarchiesi@0:  *     user interface. A contrib module may supply a trigger for a core module by
danielebarchiesi@0:  *     giving the core module's name as the key. For example, you could use the
danielebarchiesi@0:  *     'node' key to add a node-related trigger.
danielebarchiesi@0:  *     - Within each module, each individual trigger is keyed by a hook name
danielebarchiesi@0:  *       describing the particular trigger (this is not visible to the user, but
danielebarchiesi@0:  *       can be used by your module for identification).
danielebarchiesi@0:  *       - Each trigger is described by an associative array. Currently, the only
danielebarchiesi@0:  *         key-value pair is 'label', which contains a translated human-readable
danielebarchiesi@0:  *         description of the triggering event.
danielebarchiesi@0:  *   For example, the trigger set for the 'node' module has 'node' as the
danielebarchiesi@0:  *   outermost key and defines triggers for 'node_insert', 'node_update',
danielebarchiesi@0:  *   'node_delete' etc. that fire when a node is saved, updated, etc.
danielebarchiesi@0:  *
danielebarchiesi@0:  * @see hook_action_info()
danielebarchiesi@0:  * @see hook_trigger_info_alter()
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_trigger_info() {
danielebarchiesi@0:   return array(
danielebarchiesi@0:     'node' => array(
danielebarchiesi@0:       'node_presave' => array(
danielebarchiesi@0:         'label' => t('When either saving new content or updating existing content'),
danielebarchiesi@0:       ),
danielebarchiesi@0:       'node_insert' => array(
danielebarchiesi@0:         'label' => t('After saving new content'),
danielebarchiesi@0:       ),
danielebarchiesi@0:       'node_update' => array(
danielebarchiesi@0:         'label' => t('After saving updated content'),
danielebarchiesi@0:       ),
danielebarchiesi@0:       'node_delete' => array(
danielebarchiesi@0:         'label' => t('After deleting content'),
danielebarchiesi@0:       ),
danielebarchiesi@0:       'node_view' => array(
danielebarchiesi@0:         'label' => t('When content is viewed by an authenticated user'),
danielebarchiesi@0:       ),
danielebarchiesi@0:     ),
danielebarchiesi@0:   );
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * Alter triggers declared by hook_trigger_info().
danielebarchiesi@0:  *
danielebarchiesi@0:  * @param $triggers
danielebarchiesi@0:  *   Array of trigger information returned by hook_trigger_info()
danielebarchiesi@0:  *   implementations. Modify this array in place. See hook_trigger_info()
danielebarchiesi@0:  *   for information on what this might contain.
danielebarchiesi@0:  */
danielebarchiesi@0: function hook_trigger_info_alter(&$triggers) {
danielebarchiesi@0:   $triggers['node']['node_insert']['label'] = t('When content is saved');
danielebarchiesi@0: }
danielebarchiesi@0: 
danielebarchiesi@0: /**
danielebarchiesi@0:  * @} End of "addtogroup hooks".
danielebarchiesi@0:  */