ContactController.php

Same filename 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.