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

---

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>