ContactController.php

Same filename and directory in other branches
  1. 9 core/modules/contact/src/Controller/ContactController.php
  2. 8.9.x core/modules/contact/src/Controller/ContactController.php
  3. 10 core/modules/contact/src/Controller/ContactController.php

Namespace

Drupal\contact\Controller

File

core/modules/contact/src/Controller/ContactController.php

View source
<?php

namespace Drupal\contact\Controller;

use Drupal\Core\Controller\ControllerBase;
use Drupal\contact\ContactFormInterface;
use Drupal\Core\Render\RendererInterface;
use Drupal\Core\Url;
use Drupal\user\UserInterface;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

/**
 * Controller routines for contact routes.
 */
class ContactController extends ControllerBase {
  
  /**
   * The renderer.
   *
   * @var \Drupal\Core\Render\RendererInterface
   */
  protected $renderer;
  
  /**
   * Constructs a ContactController object.
   *
   * @param \Drupal\Core\Render\RendererInterface $renderer
   *   The renderer.
   */
  public function __construct(RendererInterface $renderer) {
    $this->renderer = $renderer;
  }
  
  /**
   * Presents the site-wide contact form.
   *
   * @param \Drupal\contact\ContactFormInterface $contact_form
   *   The contact form to use.
   *
   * @return array
   *   The form as render array as expected by
   *   \Drupal\Core\Render\RendererInterface::render().
   *
   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
   *   Exception is thrown when user tries to access non existing default
   *   contact form.
   */
  public function contactSitePage(?ContactFormInterface $contact_form = NULL) {
    $config = $this->config('contact.settings');
    // Use the default form if no form has been passed.
    if (empty($contact_form)) {
      $default_form = $config->get('default_form');
      // Load the default form, if configured.
      if (!is_null($default_form)) {
        $contact_form = $this->entityTypeManager()
          ->getStorage('contact_form')
          ->load($default_form);
      }
      // If there are no forms, do not display the form.
      if (empty($contact_form)) {
        if ($this->currentUser()
          ->hasPermission('administer contact forms')) {
          $this->messenger()
            ->addError($this->t('The contact form has not been configured. <a href=":add">Add one or more forms</a> .', [
            ':add' => Url::fromRoute('contact.form_add')->toString(),
          ]));
          return [];
        }
        else {
          throw new NotFoundHttpException();
        }
      }
    }
    $message = $this->entityTypeManager()
      ->getStorage('contact_message')
      ->create([
      'contact_form' => $contact_form->id(),
    ]);
    $form = $this->entityFormBuilder()
      ->getForm($message);
    $form['#title'] = $contact_form->label();
    $form['#cache']['contexts'][] = 'user.permissions';
    $this->renderer
      ->addCacheableDependency($form, $config);
    // The form might not have the correct cacheability metadata, so make it
    // uncacheable by default.
    // @todo Remove this in https://www.drupal.org/node/3395506.
    $form['#cache']['max-age'] = 0;
    return $form;
  }
  
  /**
   * Form constructor for the personal contact form.
   *
   * @param \Drupal\user\UserInterface $user
   *   The account for which a personal contact form should be generated.
   *
   * @return array
   *   The personal contact form as render array as expected by
   *   \Drupal\Core\Render\RendererInterface::render().
   *
   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
   *   Exception is thrown when user tries to access a contact form for a
   *   user who does not have an email address configured.
   */
  public function contactPersonalPage(UserInterface $user) {
    // Do not continue if the user does not have an email address configured.
    if (!$user->getEmail()) {
      throw new NotFoundHttpException();
    }
    $message = $this->entityTypeManager()
      ->getStorage('contact_message')
      ->create([
      'contact_form' => 'personal',
      'recipient' => $user->id(),
    ]);
    $form = $this->entityFormBuilder()
      ->getForm($message);
    $form['#title'] = $this->t('Contact @username', [
      '@username' => $user->getDisplayName(),
    ]);
    $form['#cache']['contexts'][] = 'user.permissions';
    return $form;
  }

}

Classes

Title Deprecated Summary
ContactController Controller routines for contact routes.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.