Issue #3094482 by jhodgdon, shetpooja04, Amber Himes Matz, andypost, pritish.kumar, ankithashetty, batigolix, catch: Convert action module hook_help() to topic(s), including views bulk operations

(cherry picked from commit f29f4a3cf9)

core/modules/help_topics/help_topics/action.creating.html.twig

@@ -0,0 +1,28 @@
+---
+label: 'Creating an advanced action'
+related:
+  - action.overview
+  - views_ui.bulk_operations
+---
+{% set actions_link_text %}
+  {% trans %}Actions{% endtrans %}
+{% endset %}
+{% set actions = render_var(help_route_link(actions_link_text, 'entity.action.collection')) %}
+{% set action_permissions_link_text %}
+  {% trans %}Administer actions{% endtrans %}
+{% endset %}
+{% set action_permissions = render_var(help_route_link(action_permissions_link_text, 'user.admin_permissions', {}, {'fragment': 'module-action'})) %}
+{% set action_overview = render_var(help_topic_link('action.overview')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Create an advanced action. You can, for example, create an action to change the author of multiple content items. See {{ action_overview }} for more about actions.{% endtrans %}</p>
+<h2>{% trans %}Who can create actions?{% endtrans %}</h2>
+<p>{% trans %}Users with the <em>{{ action_permissions }}</em> permission (typically administrators) can create actions.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>System</em> &gt; <em>{{ actions }}</em>. A list of all actions is shown.{% endtrans %}</li>
+  <li>{% trans %}Choose an advanced action from the dropdown and click <em>Create</em>.{% endtrans %}</li>
+  <li>{% trans %}Enter a name for the action in the <em>Label</em> field. This label will be visible for the user.{% endtrans %}</li>
+  <li>{% trans %}Configure any of the other available options. These will depend on the kind of action that you have chosen.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>. You will be returned to the list of actions, with your new action added to the list.{% endtrans %}</li>
+  <li>{% trans %}To edit an action you have previously created, click <em>Configure</em> in the <em>Operations</em> drop-down list. To delete an action you have previously created, click <em>Delete</em> in the <em>Operations</em> drop-down list.{% endtrans %}</li>
+</ol>

core/modules/help_topics/help_topics/action.overview.html.twig

@@ -0,0 +1,25 @@
+---
+label: 'Configuring actions'
+top_level: true
+related:
+  - views.overview
+  - views_ui.bulk_operations
+---
+{% set actions_link_text %}
+  {% trans %}Actions page{% endtrans %}
+{% endset %}
+{% set actions_page = render_var(help_route_link(actions_link_text, 'entity.action.collection')) %}
+<h2>{% trans %}What are actions?{% endtrans %}</h2>
+<p>{% trans %}Actions are module-defined tasks that can be executed on the site; for example, unpublishing content, sending an email message, or blocking a user.{% endtrans %}</p>
+<h2>{% trans %}What are simple actions?{% endtrans %}</h2>
+<p>{% trans %}Simple actions do not require configuration. They are automatically available to be executed, and are always listed as available on the {{ actions_page }}.{% endtrans %}</p>
+<h2>{% trans %}What are advanced actions?{% endtrans %}</h2>
+<p>{% trans %}Advanced actions require configuration. Before they are available for listing and execution, they need to be created and configured. For example, for an action that sends e-mail, you would need to configure the e-mail address.{% endtrans %}</p>
+<h2>{% trans %}How are actions executed?{% endtrans %}</h2>
+<p>{% trans %}In the core software, actions can be executed through a <em>bulk operations form</em> added to a view; if you have the core Views module installed, see the related topic "Managing content listings (views)" for more information about views and bulk operations.{% endtrans %}</p>
+<h2>{% trans %}Configuring actions overview{% endtrans %}</h2>
+<p>{% trans %}The core Actions module provides a user interface for listing and configuring actions. The core Views UI module provides a user interface for creating views, which may include bulk operations forms for executing actions. See the related topics listed below for specific tasks.{% endtrans %}</p>
+<h2>{% trans %}Additional resources{% endtrans %}</h2>
+<ul>
+  <li><a href="https://www.drupal.org/documentation/modules/action">{% trans %}Online documentation for the Action module{% endtrans %}</a></li>
+</ul>

core/modules/help_topics/help_topics/views.overview.html.twig

@@ -3,6 +3,9 @@ label: 'Managing content listings (views)'
 top_level: true
 related:
   - block.overview
+  - views_ui.bulk_operations
+  - action.overview
+  - user.overview
 ---
 <h2>{% trans %}What is a view?{% endtrans %}</h2>
 <p>{% trans %}A <em>view</em> is a listing of items on your site; for example, a block showing the most recent comments, a page listing news items, or a list of registered users. The listings can be formatted in a table, grid, list, calendar, RSS feed, and other formats (some output formats may require you to install additional contributed modules).{% endtrans %}</p>
@@ -14,7 +17,7 @@ related:
   <li>{% trans %}<em>Fields</em>: if the Format allows, the particular fields to display.{% endtrans %}</li>
   <li>{% trans %}<em>Filter criteria</em>: criteria to limit the data to output, such as whether the content is published, the type of content, etc. Filters can be <em>exposed</em> to let users choose how to filter the data.{% endtrans %}</li>
   <li>{% trans %}<em>Sort criteria</em>: how to order the data. Sorting can also be exposed to users.{% endtrans %}</li>
-  <li>{% trans %}<em>Page settings</em>, <em>Block settings</em>, etc.: settings specific to the display type, such as the URL for a page display.{% endtrans %}</li>
+  <li>{% trans %}<em>Page settings</em>, <em>Block settings</em>, etc.: settings specific to the display type, such as the URL for a page display. Most display types support an <em>Access</em> setting, where you can choose a Permission or Role that a user must have in order to see the view.{% endtrans %}</li>
   <li>{% trans %}<em>Header</em> and <em>Footer</em>: content to display at the top or bottom of the view display.{% endtrans %}</li>
   <li>{% trans %}<em>No results behavior</em>: what to do if the filter criteria result in having no data to display.{% endtrans %}</li>
   <li>{% trans %}<em>Pager</em>: how many items to display, and how to paginate if there are additional items to display.{% endtrans %}</li>
@@ -22,6 +25,8 @@ related:
   <li>{% trans %}<em>Advanced</em> &gt; <em>Relationships</em>: additional data to pull in and display, related in some way to the base data of the view (such as data about the user who created the content item).{% endtrans %}</li>
   <li>{% trans %}<em>Advanced</em> &gt; <em>Exposed form</em>: if you have exposed filters or sorts, how to display the form to the user.{% endtrans %}</li>
 </ul>
+<h2>{% trans %}What are bulk operations?{% endtrans %}</h2>
+<p>{% trans %}Views using a table display format can include a bulk operations form, which allows users with sufficient permission to select one or more items from the view and apply an administrative action to them. The bulk actions available are specific to the base data type of the view; for example, a view of content items could support bulk publishing and unpublishing actions. If you have the core Actions module installed, see the related topic "Configuring actions" for more about actions.{% endtrans %}</p>
 <h2>{% trans %}Managing views overview{% endtrans %}</h2>
 <p>{% trans %}The core Views module handles the display of views, and the core Views UI module allows you to create, edit, and delete views in the administrative interface. See the related topics listed below for specific tasks (if the Views UI module is installed).{% endtrans %}</p>
 <h2>{% trans %}Additional resources{% endtrans %}</h2>

core/modules/help_topics/help_topics/views_ui.bulk_operations.html.twig

@@ -0,0 +1,30 @@
+---
+label: 'Adding a bulk operations form to a view'
+related:
+  - action.overview
+  - action.creating
+  - views.overview
+  - views_ui.create
+  - user.overview
+---
+{% set views_link_text %}
+  {% trans %}Views{% endtrans %}
+{% endset %}
+{% set views = render_var(help_route_link(views_link_text, 'entity.view.collection')) %}
+{% set views_permissions_link_text %}
+  {% trans %}Administer views{% endtrans %}
+{% endset %}
+{% set views_permissions = render_var(help_route_link(views_permissions_link_text, 'user.admin_permissions', {}, {'fragment': 'module-views_ui'})) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Add one or more existing actions as bulk operations to an existing table-style view. If you have the core Actions module installed, see the related topic "Configuring actions" for more information about actions.{% endtrans %}</p>
+<h2>{% trans %}Who can edit views?{% endtrans %}</h2>
+<p>{% trans %}The core Views UI module will need to be installed and you will need <em>{{ views_permissions }}</em> permission in order to edit a view.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>{{ views }}</em>. A list of all views is shown.{% endtrans %}</li>
+  <li>{% trans %}Find the view that you would like to edit, and click <em>Edit</em> from the the dropdown button. Note that bulk operations work best in a view with a Page display, and a Table format.{% endtrans %}</li>
+  <li>{% trans %}If there is not already an <em>Operations bulk form</em> in the <em>Fields</em> list for the view, click <em>Add</em> in the <em>Fields</em> section to add it. (The exact name of the bulk form field will vary, and may contain keywords like "bulk update", "form element" or "operations" -- not to be confused with <em>operations links</em>, which are applied to each item in a row.) If the bulk operations field already exists, click the field name to edit its settings.{% endtrans %}</li>
+  <li>{% trans %}Check the action(s) you want to make available in the <em>Selected actions</em> list and click <em>Apply (all displays)</em>.{% endtrans %}</li>
+  <li>{% trans %}Verify that the <em>Access</em> settings for the view are at least as restrictive as the permissions necessary to perform the bulk operations. People with permission to see the view, but who don't have permission to do the bulk operations, will experience problems.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>. The action(s) will be available as bulk operations in the view.{% endtrans %}</li>
+</ol>