function action_help

Same name in other branches
  1. 9 core/modules/action/action.module \action_help()
  2. 8.9.x core/modules/action/action.module \action_help()
  3. 10 core/modules/action/action.module \action_help()

Implements hook_help().

File

core/modules/action/action.module, line 16

Code

function action_help($route_name, RouteMatchInterface $route_match) {
    switch ($route_name) {
        case 'help.page.action':
            $output = '';
            $output .= '<h2>' . t('About') . '</h2>';
            $output .= '<p>' . t('The Actions UI module provides tasks that can be executed by the site such as unpublishing content, sending email messages, or blocking a user. Other modules can trigger these actions when specific system events happen; for example, when new content is posted or when a user logs in. Modules can also provide additional actions. For more information, see the <a href=":documentation">online documentation for the Actions UI module</a>.', [
                ':documentation' => 'https://www.drupal.org/documentation/modules/action',
            ]) . '</p>';
            $output .= '<h2>' . t('Uses') . '</h2>';
            $output .= '<dl>';
            $output .= '<dt>' . t('Using simple actions') . '</dt>';
            $output .= '<dd>' . t('<em>Simple actions</em> do not require configuration and are listed automatically as available on the <a href=":actions">Actions administration page</a>.', [
                ':actions' => Url::fromRoute('entity.action.collection')->toString(),
            ]) . '</dd>';
            $output .= '<dt>' . t('Creating and configuring advanced actions') . '</dt>';
            $output .= '<dd>' . t('<em>Advanced actions</em> are user-created and have to be configured individually. Create an advanced action on the <a href=":actions">Actions administration page</a> by selecting an action type from the drop-down list. Then configure your action, for example by specifying the recipient of an automated email message.', [
                ':actions' => Url::fromRoute('entity.action.collection')->toString(),
            ]) . '</dd>';
            $output .= '</dl>';
            return $output;
        case 'entity.action.collection':
            $output = '<p>' . t('There are two types of actions: simple and advanced. Simple actions do not require any additional configuration and are listed here automatically. Advanced actions need to be created and configured before they can be used because they have options that need to be specified; for example, sending an email to a specified address or unpublishing content containing certain words. To create an advanced action, select the action from the drop-down list in the advanced action section below and click the <em>Create</em> button.') . '</p>';
            return $output;
        case 'action.admin_add':
        case 'entity.action.edit_form':
            return '<p>' . t('An advanced action offers additional configuration options which may be filled out below. Changing the <em>Label</em> field is recommended in order to better identify the precise action taking place.') . '</p>';
    }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.