diff --git a/core/modules/block/block.module b/core/modules/block/block.module
index 8bcce1f..c2eb390 100644
--- a/core/modules/block/block.module
+++ b/core/modules/block/block.module
@@ -37,17 +37,21 @@ function block_help($path, $arg) {
case 'admin/help#block':
$output = '';
$output .= '' . t('About') . '
';
- $output .= '' . t('The Block module allows you to create boxes of content, which are rendered into an area, or region, of one or more pages of a website. The core Seven administration theme, for example, implements the regions "Content" and "Help", and a block may appear in either of these regions. The Blocks administration page provides a drag-and-drop interface for assigning a block to a region, and for controlling the order of blocks within regions. For more information, see the online handbook entry for Block module.', array('@block' => 'http://drupal.org/documentation/modules/block', '@blocks' => url('admin/structure/block'))) . '
';
+ $output .= '' . t('The Block module allows you to place blocks in regions and to configure their settings. For more information, see the online documentation for the Blocks module.', array('!blocks-documentation' => 'https://drupal.org/documentation/modules/block/')) . '
';
$output .= '' . t('Uses') . '
';
$output .= '';
- $output .= '- ' . t('Positioning content') . '
';
- $output .= '- ' . t('When working with blocks, remember that all themes do not implement the same regions, or display regions in the same way. Blocks are positioned on a per-theme basis. Users with the Administer blocks permission can disable blocks. Disabled blocks are listed on the Blocks administration page, but are not displayed in any region.', array('@block' => 'http://drupal.org/documentation/modules/block', '@blocks' => url('admin/structure/block'))) . '
';
+ $output .= '- ' . t('Placing and moving blocks') . '
';
+ $output .= '- ' . t('You can place a block by clicking on its title in the in the Place blocks list on the Block layout page. You can then choose the appropriate region from the Region dropdown menu. Once a block has been placed, it can also be moved to a different region by chosing a region from the Region dropdown menu on the Block layout page, or by dragging and dropping it to the right posititon.', array('!blocks' => \Drupal::url('block.admin_display'))) . '
';
+ $output .= '- ' . t('Demonstrating block regions for a theme') . '
';
+ $output .= '- ' . t('You can see which region is where in a theme by clicking an the Demonstrate block regions link on the Block layout page. Regions are specific to each theme, so you need to toggle to a different theme first to demonstrate its block regions.', array('!blocks' => \Drupal::url('block.admin_display'))) . '
';
+ $output .= '- ' . t('Toggling between different themes') . '
';
+ $output .= '- ' . t('Blocks are placed and configured specifically for each theme. The Block layout page opens with the default theme, but you can toggle to other enabled themes.') . '
';
+ $output .= '- ' . t('Configuring block settings') . '
';
+ $output .= '- ' . t('To change the settings of an individual block click on the Configure link on the Block layout page. The available options vary depending on the module that provides the block. For all blocks you can change the block title and toggle whether to display it.', array('!blocks' => Drupal::url('block.admin_display'))) . '
';
$output .= '- ' . t('Controlling visibility') . '
';
- $output .= '- ' . t('Blocks can be configured to be visible only on certain pages, only to users of certain roles, or only on pages displaying certain content types. Some dynamic blocks, such as those generated by modules, will be displayed only on certain pages.', array('@content-type' => url('admin/structure/types'), '@user' => url('user'))) . '
';
- if (module_exists('custom_block')) {
- $output .= '- ' . t('Creating custom blocks') . '
';
- $output .= '- ' . t('Users with the Administer blocks permission can add custom blocks, which are then listed on the Blocks administration page. Once created, custom blocks behave just like default and module-generated blocks.', array('@blocks' => url('admin/structure/block'))) . '
';
- }
+ $output .= '- ' . t('You can control the visibility of a block by restricting it to specific pages, content types, and/or roles by setting the appropriate options under Visibility settings of the block configuration.') . '
';
+ $output .= '- ' . t('Adding custom blocks') . '
';
+ $output .= '- ' . t('You can add custom blocks, if the the Custom Block module is enabled on the Extend page. For more information, see the Custom Block help page.', array('!extend' => \Drupal::url('system.modules_list'), '!customblock-help' => \Drupal::url('help.page', array('name' => 'custom_block')))) . '
';
$output .= '
';
return $output;
}