' . t('Triggers are events on your site, such as new content being added or a user logging in. The Trigger module associates these triggers with actions (functional tasks), such as unpublishing content containing certain keywords or e-mailing an administrator. The Actions settings page contains a list of existing actions and provides the ability to create and configure advanced actions (actions requiring configuration, such as an e-mail address or a list of banned words).', array('@url' => url('admin/config/system/actions'))) . '
'; - switch ($path) { - case 'admin/structure/trigger/comment': - return $explanation . '' . t('Below you can assign actions to run when certain comment-related triggers happen. For example, you could promote a post to the front page when a comment is added.') . '
'; - case 'admin/structure/trigger/node': - return $explanation . '' . t('Below you can assign actions to run when certain content-related triggers happen. For example, you could send an e-mail to an administrator when content is created or updated.') . '
'; - case 'admin/structure/trigger/system': - return $explanation . '' . t('Below you can assign actions to run during each pass of a cron maintenance task.', array('@cron' => url('admin/reports/status'))) . '
'; - case 'admin/structure/trigger/taxonomy': - return $explanation . '' . t('Below you can assign actions to run when certain taxonomy-related triggers happen. For example, you could send an e-mail to an administrator when a term is deleted.') . '
'; - case 'admin/structure/trigger/user': - return $explanation . '' . t("Below you can assign actions to run when certain user-related triggers happen. For example, you could send an e-mail to an administrator when a user account is deleted.") . '
'; + // Generate help text for admin/structure/trigger/(module) tabs. + $matches = array(); + if (preg_match('|^admin/structure/trigger/(.*)$|', $path, $matches)) { + $explanation = '' . t('Triggers are events on your site, such as new content being added or a user logging in. The Trigger module associates these triggers with actions (functional tasks), such as unpublishing content containing certain keywords or e-mailing an administrator. The Actions settings page contains a list of existing actions and provides the ability to create and configure advanced actions (actions requiring configuration, such as an e-mail address or a list of banned words).', array('@url' => url('admin/config/system/actions'))) . '
'; + + $module = $matches[1]; + $trigger_info = _trigger_tab_information(); + if ($trigger_info[$module]) { + $explanation .= '' . t('There is a tab on this page for each module that defines triggers. On this tab you can assign actions to run when triggers from the @module-name module happen.', array('@module-help' => url('admin/help/' . $module), '@module-name' => $trigger_info[$module])) . '
'; + } + + return $explanation; + } - case 'admin/help#trigger': + if ($path == 'admin/help#trigger') { $output = ''; $output .= '' . t('The Trigger module provides the ability to cause actions to run when certain triggers take place on your site. Triggers are events, such as new content being added to your site or a user logging in, and actions are tasks, such as unpublishing content or e-mailing an administrator. For more information, see the online handbook entry for Trigger module.', array('@trigger' => 'http://drupal.org/handbook/modules/trigger/')) . '
'; @@ -49,31 +50,18 @@ 'file' => 'trigger.admin.inc', ); - // We want contributed modules to be able to describe - // their hooks and have actions assignable to them. - $trigger_info = module_invoke_all('trigger_info'); - drupal_alter('trigger_info', $trigger_info); - - foreach ($trigger_info as $module => $hooks) { - $info = db_select('system') - ->fields('system', array('info')) - ->condition('name', $module) - ->condition('status', 1) - ->execute() - ->fetchField(); - if ($info) { - $info = unserialize($info); - $nice_name = $info['name']; - $items["admin/structure/trigger/$module"] = array( - 'title' => $nice_name, - 'page callback' => 'trigger_assign', - 'page arguments' => array($module), - 'access arguments' => array('administer actions'), - 'type' => MENU_LOCAL_TASK, - 'file' => 'trigger.admin.inc', - ); - } + $trigger_info = _trigger_tab_information(); + foreach ($trigger_info as $module => $nice_name) { + $items["admin/structure/trigger/$module"] = array( + 'title' => $nice_name, + 'page callback' => 'trigger_assign', + 'page arguments' => array($module), + 'access arguments' => array('administer actions'), + 'type' => MENU_LOCAL_TASK, + 'file' => 'trigger.admin.inc', + ); } + $items['admin/structure/trigger/unassign'] = array( 'title' => 'Unassign', 'description' => 'Unassign an action from a trigger.', @@ -619,3 +607,33 @@ return $triggers; } +/** + * Gathers information about tabs on the triggers administration screen. + * + * @return + * Array of modules that have triggers, with the keys being the + * machine-readable name of the module, and the values being the + * human-readable name of the module. + */ +function _trigger_tab_information() { + + // Gather the trigger information. + $trigger_info = module_invoke_all('trigger_info'); + drupal_alter('trigger_info', $trigger_info); + + $return_info = array(); + foreach ($trigger_info as $module => $hooks) { + $info = db_select('system') + ->fields('system', array('info')) + ->condition('name', $module) + ->condition('status', 1) + ->execute() + ->fetchField(); + if ($info) { + $info = unserialize($info); + $return_info[$module] = $info['name']; + } + } + + return $return_info; +}