Skip to content
Snippets Groups Projects
Unverified Commit 8fe6d250 authored by Alex Pott's avatar Alex Pott
Browse files

Issue #3067617 by jhodgdon, Gayathri J, shimpy, spitzialist, batigolix,...

Issue #3067617 by jhodgdon, Gayathri J, shimpy, spitzialist, batigolix, alonaoneill, volkswagenchick, andypost, CelSki, Amber Himes Matz, Sutharsan: Convert contact module hook_help() to topic(s)
parent e43c9190
No related branches found
No related tags found
8 merge requests!7452Issue #1797438. HTML5 validation is preventing form submit and not fully...,!1012Issue #3226887: Hreflang on non-canonical content pages,!789Issue #3210310: Adjust Database API to remove deprecated Drupal 9 code in Drupal 10,!596Issue #3046532: deleting an entity reference field, used in a contextual view, makes the whole site unrecoverable,!496Issue #2463967: Use .user.ini file for PHP settings,!144Issue #2666286: Clean up menu_ui to conform to Drupal coding standards,!16Draft: Resolve #2081585 "History storage",!13Resolve #2903456
---
label: 'Managing the fields of contact forms'
related:
- contact.overview
---
{% set contact_url = render_var(url('entity.contact_form.collection')) %}
<h2>{% trans %}Goal{% endtrans %}</h2>
<p>{% trans %}Add, remove, or rearrange the fields on personal and site-wide contact forms.{% endtrans %}</p>
<h2>{% trans %}What are the fields on contact forms?{% endtrans %}</h2>
<p>{% trans %}Both personal and site-wide contact forms will always have <em>Subject</em> and <em>Message</em> fields. You can add additional fields for users to fill out if desired. Note that if you want to display other content on a form page, such as text or images, you can use a custom block.{% endtrans %}</p>
<h2>{% trans %}Steps{% endtrans %}</h2>
<ol>
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ contact_url }}"><em>Contact forms</em></a>.{% endtrans %}</li>
<li>{% trans %}Click <em>Manage fields</em> for the form you want to change the fields of, and add or remove one or more fields on the form.{% endtrans %}</li>
<li>{% trans %}Click <em>Manage form display</em> to change the order or configuration of the fields on the form.{% endtrans %}</li>
</ol>
---
label: 'Configuring personal contact forms'
related:
- contact.overview
- contact.adding_fields
---
{% set config_url = render_var(url('entity.user.admin_form')) %}
{% set permission_url = render_var(url('user.admin_permissions')) %}
{% set add_fields = render_var(url('help.help_topic', {'id': 'contact.adding_fields'})) %}
<h2>{% trans %}Goal{% endtrans %}</h2>
<p>{% trans %}Configure personal contact forms for registered users on the website.{% endtrans %}</p>
<h2>{% trans %}Steps{% endtrans %}</h2>
<ol>
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>People</em> &gt; <a href="{{ config_url }}"><em>Account settings</em></a>.{% endtrans %}</li>
<li>{% trans %}In the <em>Contact settings</em> section, check/uncheck the box to enable/disable the contact form for new user accounts.{% endtrans %}</li>
<li>{% trans %}Click <em>Save configuration</em>.{% endtrans %}</li>
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>People</em> &gt; <a href="{{ permission_url }}"><em>Permissions</em></a>.{% endtrans %}</li>
<li>{% trans %}Verify that permissions are correct for your site's roles, including the generic <em>Anonymous user</em> and <em>Authenticated user</em>. In order to use personal contact forms, users need both <em>View user information</em> (in the <em>User</em> section, which enables them to view user profiles) and <em>Use users' personal contact forms</em> (in the <em>Contact</em> section, which enables them to use contact forms if they can view user profiles).{% endtrans %}</li>
<li>{% trans %}Click <em>Save permissions</em>.{% endtrans %}</li>
<li>{% trans %}The contact form will always have <em>Subject</em> and <em>Message</em> fields. If you want to add more fields, follow the steps in <a href="{{ add_fields }}">Managing the fields of contact forms</a>.{% endtrans %}</li>
</ol>
---
label: 'Creating a new contact form'
related:
- contact.overview
- contact.adding_fields
- contact.setting_default
---
{% set contact_url = render_var(url('entity.contact_form.collection')) %}
{% set add_fields = render_var(url('help.help_topic', {'id': 'contact.adding_fields'})) %}
<h2>{% trans %}Goal{% endtrans %}</h2>
<p>{% trans %}Create a new site-wide contact form.{% endtrans %}</p>
<h2>{% trans %}Steps{% endtrans %}</h2>
<ol>
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ contact_url }}"><em>Contact forms</em></a>.{% endtrans %}</li>
<li>{% trans %}Click <em>Add contact form</em>.{% endtrans %}</li>
<li>{% trans %}Fill in the <em>Label</em> (title) for the form, <em>Recipients</em>, and optionally the other settings.{% endtrans %}</li>
<li>{% trans %}Click <em>Save</em>. You should see your new contact form in the table, along with a link to view it.{% endtrans %}</li>
<li>{% trans %}The contact form will always have <em>Subject</em> and <em>Message</em> fields. If you want to add more fields, follow the steps in <a href="{{ add_fields }}">Managing the fields of contact forms</a>.{% endtrans %}</li>
</ol>
---
label: 'Managing contact forms'
top_level: true
---
<h2>{% trans %}What are contact forms?{% endtrans %}</h2>
<p>{% trans %}There are two different types of contact forms provided by the core Contact module: personal contact forms, which allow users to contact other users on the site, and site-wide contact forms, which allow users to contact site managers or administrators. A site can have more than one site-wide contact form; each has its own fields to fill out, recipients, and URL; you can also change the fields that are shown on personal contact forms.{% endtrans %}</p>
<h2>{% trans %}Using the personal contact form{% endtrans %}</h2>
<p>{% trans %}Site visitors can email registered users on your site by using the personal contact form, without knowing or learning the email address of the recipient. When a user with the correct permissions is viewing another user's profile, the viewer will see a <em>Contact</em> tab or link, which leads to the personal contact form if the user whose profile is being viewed has their personal contact form enabled (this is a user account setting).{% endtrans %}</p>
<h2>{% trans %}Contact form management tasks{% endtrans %}</h2>
<p>{% trans %}See the related topics below for specific tasks.{% endtrans %}</p>
---
label: 'Setting a default contact form'
related:
- contact.overview
---
{% set contact_url = render_var(url('entity.contact_form.collection')) %}
<h2>{% trans %}Goal{% endtrans %}</h2>
<p>{% trans %}Set a site-wide contact form to be the default contact form (the form that is shown on the <em>/contact</em> URL).{% endtrans %}</p>
<h2>{% trans %}Steps{% endtrans %}</h2>
<ol>
<li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ contact_url }}"><em>Contact forms</em></a>.{% endtrans %}</li>
<li>{% trans %}Click <em>Edit</em> for the site-wide form you want to be the default.{% endtrans %}</li>
<li>{% trans %}Check <em>Make this the default form</em> and click <em>Save</em>.{% endtrans %}</li>
</ol>
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment