diff --git a/core/modules/help_topics/help_topics/block.configure.html.twig b/core/modules/help_topics/help_topics/block.configure.html.twig new file mode 100644 index 0000000000000000000000000000000000000000..6d5e832e0274db131d07dad2fd1abfd5d1cb6178 --- /dev/null +++ b/core/modules/help_topics/help_topics/block.configure.html.twig @@ -0,0 +1,25 @@ +--- +label: 'Configuring a previously-placed block' +related: + - block.overview +--- +{% set layout_url = render_var(url('block.admin_display')) %} +<h2>{% trans %}Goal{% endtrans %}</h2> +<p>{% trans %}Configure the settings of a block that was previously placed in a region of a theme.{% endtrans %}</p> +<h2>{% trans %}Steps{% endtrans %}</h2> +<ol> + <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <a href="{{ layout_url }}"><em>Block layout</em></a>.{% endtrans %}</li> + <li>{% trans %}Click the name of the theme that contains the block.{% endtrans %}</li> + <li>{% trans %}Optionally, click <em>Demonstrate block regions</em> to see the regions of the theme.{% endtrans %}</li> + <li>{% trans %}If you only want to change the region where a block is located, or the ordering of blocks within a region, drag blocks to their desired positions and click <em>Save blocks</em>.{% endtrans %}</li> +<li>{% trans %}If you want to change additional settings, find the region where the block you want to update is currently located, and click <em>Configure</em> in the line of the block description.{% endtrans %}</li> + <li>{% trans %}Edit the block's settings. The available settings vary depending on the module that provides the block, but for all blocks you can change:{% endtrans %} + <ul> + <li>{% trans %}<em>Block title</em>: The heading for the block on your site -- for some blocks, you will need to check the <em>Override title</em> checkbox in order to enter a title{% endtrans %}</li> + <li>{% trans %}<em>Display title</em>: Check the box if you want the title displayed{% endtrans %}</li> + <li>{% trans %}<em>Visibility</em>: Add conditions for when the block should be displayed{% endtrans %}</li> + <li>{% trans %}<em>Region</em>: Change the theme region the block is displayed in{% endtrans %}</li> + </ul> + </li> + <li>{% trans %}Click <em>Save block</em>.{% endtrans %}</li> +</ol> diff --git a/core/modules/help_topics/help_topics/block.overview.html.twig b/core/modules/help_topics/help_topics/block.overview.html.twig new file mode 100644 index 0000000000000000000000000000000000000000..055ee6c37497fff21b7a95caf6c9c88a068d6168 --- /dev/null +++ b/core/modules/help_topics/help_topics/block.overview.html.twig @@ -0,0 +1,18 @@ +--- +label: 'Managing blocks' +top_level: true +--- +<h2>{% trans %}What are blocks?{% endtrans %}</h2> +<p>{% trans %}Blocks are boxes of content rendered into an area, or region, of a web page of your site. Blocks are placed and configured specifically for each theme.{% endtrans %}</p> +<h2>{% trans %}What are custom blocks?{% endtrans %}</h2> +<p>{% trans %}Custom blocks are blocks whose content you can edit. You can define one or more <em>custom block types</em>, and attach fields to each custom block type. Custom blocks can be placed just like blocks provided by other modules.{% endtrans %}</p> +<h2>{% trans %}What is the block description?{% endtrans %}</h2> +<p>{% trans %}The block description is an identification name for a block, which is shown in the administrative interface. It is not displayed on the site.{% endtrans %}</p> +<h2>{% trans %}What is the block title?{% endtrans %}</h2> +<p>{% trans %}The block title is the heading that is optionally shown to site visitors when the block is placed in a region.{% endtrans %}</p> +<h2>{% trans %}Managing blocks overview{% endtrans %}</h2> +<p>{% trans %}The <em>Block</em> module allows you to place blocks in regions of your installed themes, and configure block settings. The <em>Custom Block</em> module allows you to custom block types and custom blocks. See the related topics listed below for specific tasks.{% endtrans %}</p> +<h2>{% trans %}Additional resources{% endtrans %}</h2> +<ul> + <li>{% trans %}<a href="https://www.drupal.org/docs/user_guide/en/blocks-chapter.html">Blocks chapter of the User Guide</a>{% endtrans %}</li> +</ul> diff --git a/core/modules/help_topics/help_topics/block.place.html.twig b/core/modules/help_topics/help_topics/block.place.html.twig new file mode 100644 index 0000000000000000000000000000000000000000..6349eb2990058351b4b9ea85224fe4a3c2d55806 --- /dev/null +++ b/core/modules/help_topics/help_topics/block.place.html.twig @@ -0,0 +1,18 @@ +--- +label: 'Placing a block' +related: + - block.overview + - block.configure +--- +{% set layout_url = render_var(url('block.admin_display')) %} +<h2>{% trans %}Goal{% endtrans %}</h2> +<p>{% trans %}Place a block into a theme's region. {% endtrans %}</p> +<h2>{% trans %}Steps{% endtrans %}</h2> +<ol> + <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <a href="{{ layout_url }}"><em>Block layout</em></a>.{% endtrans %}</li> + <li>{% trans %}Click the name of the theme that you want to place the block in.{% endtrans %}</li> + <li>{% trans %}Optionally, click <em>Demonstrate block regions</em> to see the regions of the theme.{% endtrans %}</li> + <li>{% trans %}Find the region where you want the block, and click <em>Place block</em> in that region. A modal dialog will pop up.{% endtrans %}</li> + <li>{% trans %}Find the block you want to place and click <em>Place block</em>. A <em>Configure block</em> modal dialog will pop up.{% endtrans %}</li> + <li>{% trans %}Configure the block and click <em>Save block</em> (see related topic for configuration details).{% endtrans %}</li> +</ol> diff --git a/core/modules/help_topics/help_topics/block_content.add.html.twig b/core/modules/help_topics/help_topics/block_content.add.html.twig new file mode 100644 index 0000000000000000000000000000000000000000..19f3133c5924adbd449085ba8d96755c4243e606 --- /dev/null +++ b/core/modules/help_topics/help_topics/block_content.add.html.twig @@ -0,0 +1,18 @@ +--- +label: 'Creating a custom block' +related: + - block.overview + - block.configure + - block.place + - block_content.type +--- +{% set content_url = render_var(url('entity.block_content.collection')) %} +<h2>{% trans %}Goal{% endtrans %}</h2> +<p>{% trans %}Create a custom block, which can later be placed on the site.{% endtrans %}</p> +<h2>{% trans %}Steps{% endtrans %}</h2> +<ol> + <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <em>Block layout</em> > <a href="{{ content_url }}"><em>Custom block library</em></a>.{% endtrans %}</li> + <li>{% trans %}Click <em>Add custom block</em>. If you have more than one custom block type defined on your site, click the name of the type you want to create.{% endtrans %}</li> + <li>{% trans %}Enter a description of your block (to be shown to administrators) and the body text for your block.{% endtrans %}</li> + <li>{% trans %}Click <em>Save</em>.{% endtrans %}</li> +</ol> diff --git a/core/modules/help_topics/help_topics/block_content.type.html.twig b/core/modules/help_topics/help_topics/block_content.type.html.twig new file mode 100644 index 0000000000000000000000000000000000000000..7ef57a1d6d031a1da25c05582030977e9443c065 --- /dev/null +++ b/core/modules/help_topics/help_topics/block_content.type.html.twig @@ -0,0 +1,20 @@ +--- +label: 'Defining a custom block type' +related: + - block.overview + - block.configure + - block.place + - block_content.add +--- +{% set types_url = render_var(url('entity.block_content_type.collection')) %} +<h2>{% trans %}Goal{% endtrans %}</h2> +<p>{% trans %}Define a custom block type and its fields.{% endtrans %}</p> +<h2>{% trans %}Steps{% endtrans %}</h2> +<ol> + <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <em>Block layout</em> > <em>Custom block library</em> > <a href="{{ types_url }}"><em>Block types</em></a>.{% endtrans %}</li> + <li>{% trans %}Click <em>Add custom block type</em>.{% endtrans %}</li> + <li>{% trans %}Enter a label for this block type (shown in the administrative interface). Optionally, edit the automatically-generated machine name or the description.{% endtrans %}</li> + <li>{% trans %}Click <em>Save</em>. You will be returned to the <em>Block types</em> page.{% endtrans %}</li> + <li>{% trans %}Click <em>Manage fields</em> in the row of your new block type, and add the desired fields to your block type.{% endtrans %}</li> + <li>{% trans %}Optionally, click <em>Manage form display</em> or <em>Manage display</em> to change the editing form or field display for your block type.{% endtrans %}</li> +</ol> diff --git a/core/modules/help_topics/help_topics/contextual.overview.html.twig b/core/modules/help_topics/help_topics/contextual.overview.html.twig index 916d193e65ee42af7ef9f7e12707178dcf8c18b5..fa76048995c12ffacbb3d9c887b1501388c903f2 100644 --- a/core/modules/help_topics/help_topics/contextual.overview.html.twig +++ b/core/modules/help_topics/help_topics/contextual.overview.html.twig @@ -2,6 +2,7 @@ label: 'Using contextual links' related: - core.ui_components + - block.overview --- <h2>{% trans %}Goal{% endtrans %}</h2> <p>{% trans %}Use contextual links to access administrative tasks without navigating the administrative menu.{% diff --git a/core/modules/help_topics/help_topics/core.ui_components.html.twig b/core/modules/help_topics/help_topics/core.ui_components.html.twig index 66b67b09763c7c33acb8d6f14e4e4297f0a43f8b..f8aab0dd46a3974f5004661cb2e7f06386ee205d 100644 --- a/core/modules/help_topics/help_topics/core.ui_components.html.twig +++ b/core/modules/help_topics/help_topics/core.ui_components.html.twig @@ -1,6 +1,8 @@ --- label: 'Using the administrative interface' top_level: true +related: + - block.overview --- <h2>{% trans %}Administrative interface overview{% endtrans %}</h2> <p>{% trans %}The administrative interface has several components:{% endtrans %}</p> diff --git a/core/modules/help_topics/help_topics/help.help_topic_search.html.twig b/core/modules/help_topics/help_topics/help.help_topic_search.html.twig index 0dd4d29bf535e3b111db391f0b859771247a1f38..48461da978c98769775abb70c3a30e7173f59256 100644 --- a/core/modules/help_topics/help_topics/help.help_topic_search.html.twig +++ b/core/modules/help_topics/help_topics/help.help_topic_search.html.twig @@ -1,6 +1,8 @@ --- label: 'Configuring help search' top_level: true +related: + - block.place --- {% set extend_url = render_var(url('system.modules_list')) %} {% set help_url = render_var(url('help.main')) %} @@ -14,9 +16,6 @@ top_level: true <li>{% trans %}Check the indexing status of the Help search page. If it is not fully indexed, run Cron until indexing is complete.{% endtrans %}</li> <li>{% trans %}In the future, you can click <em>Rebuild search index</em> on this page, or clear the site cache, in order to force help topic text to be reindexed for searching. This should be done whenever a module, theme, language, or string translation is updated.{% endtrans %}</li> <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <em>Block layout</em>.{% endtrans %}</li> - <li>{% trans %}Click the link for your administrative theme (such as the core Seven theme), near the top of the page.{% endtrans %}</li> - <li>{% trans %}See if there is already a help search block placed in the Help region of your administrative theme.{% endtrans %}</li> - <li>{% trans %}If there is not already a help search block placed, click <em>Place block</em>, and then click <em>Place block</em> in the row next to <em>Search form</em> in the dialog. Choose <em>Help</em> as the search page for the block, and in the <em>Visibility</em> > <em>Pages</em> field, enter <em>/admin/help</em> to make the search form only visible on the main <em>Help</em> page.{% endtrans %}</li> - <li>{% trans %}Fill in the rest of the form and save the block.{% endtrans %}</li> + <li>{% trans %}Click the link for your administrative theme (such as the core Seven theme), near the top of the page, and verify that there is already a search block for help located in the Help region. If not, follow the steps in the related topic to place the <em>Search form</em> block in the Help region. When configuring the block, choose <em>Help</em> as the search page, and in the <em>Pages</em> tab under <em>Visibility</em>, enter <em>/admin/help</em> to make the search form only visible on the main <em>Help</em> page.{% endtrans %}</li> <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em><a href="{{ help_url }}">Help</a></em>. Verify that the search block is visible, and try a search.{% endtrans %}</li> </ol>