Issue #3072312 by jhodgdon, Amber Himes Matz, andypost, webchick:...

---

label: 'Using contextual links'

related:

  - core.ui_components

---

<h2>{% trans %}Goal{% endtrans %}</h2>

<p>{% trans %}Use contextual links to access administrative tasks without navigating the administrative menu.{%

  endtrans %}</p>

<h2>{% trans %}What are contextual links?{% endtrans %}</h2>

<p>{% trans %}<em>Contextual links</em> give users with the <em>Use contextual links</em> permission quick access to administrative tasks related to areas of non-administrative pages. For example, if a page on your site displays a block, the block would have a contextual link that would allow users with permission to configure the block. If the block contains a menu or a view, it would also have a contextual link for editing the menu links or the view. Clicking a contextual link takes you to the related administrative page directly, without needing to navigate through the administrative menu system.{% endtrans %}</p>

<h2>{% trans %}Steps{% endtrans %}</h2>

<ol>

  <li>{% trans %}Make sure that the core Contextual Links module is installed, and that you have a role with the <em>Use contextual links</em> permission. Optionally, make sure that a toolbar module is installed (either the core Toolbar module or a contributed module replacement).{% endtrans %}</li>

  <li>{% trans %}Visit a non-administrative page on your site, such as the home page.{% endtrans %}</li>

  <li>{% trans %}Locate a block or another area on the page that you want to edit or configure.{% endtrans %}</li>

  <li>{% trans %}Make the contextual links button visible by hovering your mouse over that area in the page. In most themes, this button looks like a pencil and is placed in the upper right corner of the page area (upper left for right-to-left languages), and hovering will also temporarily outline the affected area. Alternatively, click the contextual links toggle button on the right end of the toolbar (left end for right-to-left languages), which will make all contextual link buttons on the page visible until it is clicked again.{% endtrans %}</li>

  <li>{% trans %}While the contextual links button for the area of interest is visible, click the button to display the list of links for that area. Click a link in the list to visit the corresponding administrative page.{% endtrans %}</li>

  <li>{% trans %}Complete your administrative task and save your settings, or cancel the action. You should be returned to the page you started from.{% endtrans %}</li>

</ol>

---

label: 'Changing basic site settings'

top_level: true

related:

  - user.security_account_settings

---

{% set regional_url = render_var(url('system.regional_settings')) %}

{% set information_url = render_var(url('system.site_information_settings')) %}

{% set datetime_url = render_var(url('entity.date_format.collection')) %}

<p>{% trans %}The settings for your site are configured on various administrative pages, as follows:{% endtrans %}</p>

<dl>

  <dt>{% trans %}Site name, slogan, and email address{% endtrans %}</dt>

  <dd>{% trans %}On the <a href="{{ information_url }}"><em>Basic site settings</em></a> page, which you can reach in the main <em>Manage</em> administrative menu, by navigating to <em>Configuration</em> &gt; <em>System</em> &gt; <em>Basic site settings</em>.{% endtrans %}</dd>

  <dt>{% trans %}Time zone and country{% endtrans %}</dt>

  <dd>{% trans %}On the <a href="{{ regional_url }}"><em>Regional settings</em></a> page, which you can reach in the main <em>Manage</em> administrative menu, by navigating to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <em>Regional settings</em>.{% endtrans %}</dd>

  <dt>{% trans %}Date and time formats{% endtrans %}</dt>

  <dd>{% trans %}On the <a href="{{ datetime_url }}"><em>Date and time formats</em></a> page, which you can reach in the main <em>Manage</em> administrative menu, by navigating to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <em>Date and time formats</em>.{% endtrans %}</dd>

</dl>

---

label: 'Configuring error responses, including 403/404 pages'

related:

  - core.config_basic

  - core.maintenance

---

{% set log_settings_url = render_var(url('system.logging_settings')) %}

{% set site_settings_url = render_var(url('system.site_information_settings')) %}

<h2>{% trans %}Configuring 403/404 pages{% endtrans %}</h2>

<p>{% trans %}The core software provides default responses for 403 response (Not Authorized: when someone tries to visit a page they do not have permission to see) and 404 response (Not Found: when someone tries to visit a page that does not exist). You can change what page is displayed for these responses on the <a href="{{ site_settings_url }}"><em>Basic site settings</em></a> page, which you can reach in the main <em>Manage</em> administrative menu, by navigating to <em>Configuration</em> &gt; <em>System</em> &gt; <em>Basic site settings</em>. Note that the pages you want to use must already exist as either system-provided pages or content that you have created.{% endtrans %}</p>

<h2>{% trans %}Responding to software errors{% endtrans %}</h2>

<p>{% trans %}Software errors on your site are logged, if you have a logging module installed (such as the core Database Logging module or the core Syslog module). You can configure whether or not error messages are also shown (to both administrators and other site visitors) on the <a href="{{ log_settings_url }}"><em>Logging and errors</em></a> configuration page, which you can reach in the main <em>Manage</em> administrative menu, by navigating to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Logging and errors</em>.{% endtrans %}</p>

<h2>{% trans %}Viewing the site log{% endtrans %}</h2>

<p>{% trans %}If you have the core Database Logging module installed, you can view recent error and informational messages by navigating in the main <em>Manage</em> administrative menu to <em>Reports</em> &gt; <em>Recent log messages</em>. If you are using the core Syslog module for logging, error messages will be logged in your web server''s log files.{% endtrans %}</p>

---

label: 'Maintaining and troubleshooting your site'

top_level: true

---

<p>{% trans %}The related topics listed here will help you keep your site running and troubleshoot problems.{% endtrans %}</p>

---

label: 'Defining navigation and URLs'

top_level: true

---

<p>{% trans %}The related topics listed here describe how to set up various aspects of site navigation and URLs.{% endtrans %}</p>