You are here

public function CommentForm::form in Drupal 9

Same name and namespace in other branches
  1. 8 core/modules/comment/src/CommentForm.php \Drupal\comment\CommentForm::form()

Gets the actual form array to be built.

Overrides ContentEntityForm::form

See also

\Drupal\Core\Entity\EntityForm::processForm()

\Drupal\Core\Entity\EntityForm::afterBuild()

File

core/modules/comment/src/CommentForm.php, line 90

Class

CommentForm
Base handler for comment forms.

Namespace

Drupal\comment

Code

public function form(array $form, FormStateInterface $form_state) {

  /** @var \Drupal\comment\CommentInterface $comment */
  $comment = $this->entity;
  $entity = $this->entityTypeManager
    ->getStorage($comment
    ->getCommentedEntityTypeId())
    ->load($comment
    ->getCommentedEntityId());
  $field_name = $comment
    ->getFieldName();
  $field_definition = $this->entityFieldManager
    ->getFieldDefinitions($entity
    ->getEntityTypeId(), $entity
    ->bundle())[$comment
    ->getFieldName()];
  $config = $this
    ->config('user.settings');

  // In several places within this function, we vary $form on:
  // - The current user's permissions.
  // - Whether the current user is authenticated or anonymous.
  // - The 'user.settings' configuration.
  // - The comment field's definition.
  $form['#cache']['contexts'][] = 'user.permissions';
  $form['#cache']['contexts'][] = 'user.roles:authenticated';
  $this->renderer
    ->addCacheableDependency($form, $config);
  $this->renderer
    ->addCacheableDependency($form, $field_definition
    ->getConfig($entity
    ->bundle()));

  // Use #comment-form as unique jump target, regardless of entity type.
  $form['#id'] = Html::getUniqueId('comment_form');
  $form['#theme'] = [
    'comment_form__' . $entity
      ->getEntityTypeId() . '__' . $entity
      ->bundle() . '__' . $field_name,
    'comment_form',
  ];
  $anonymous_contact = $field_definition
    ->getSetting('anonymous');
  $is_admin = $comment
    ->id() && $this->currentUser
    ->hasPermission('administer comments');
  if (!$this->currentUser
    ->isAuthenticated() && $anonymous_contact != CommentInterface::ANONYMOUS_MAYNOT_CONTACT) {
    $form['#attached']['library'][] = 'core/drupal.form';
    $form['#attributes']['data-user-info-from-browser'] = TRUE;
  }

  // If not replying to a comment, use our dedicated page callback for new
  // Comments on entities.
  if (!$comment
    ->id() && !$comment
    ->hasParentComment()) {
    $form['#action'] = Url::fromRoute('comment.reply', [
      'entity_type' => $entity
        ->getEntityTypeId(),
      'entity' => $entity
        ->id(),
      'field_name' => $field_name,
    ])
      ->toString();
  }
  $comment_preview = $form_state
    ->get('comment_preview');
  if (isset($comment_preview)) {
    $form += $comment_preview;
  }
  $form['author'] = [];

  // Display author information in a details element for comment moderators.
  if ($is_admin) {
    $form['author'] += [
      '#type' => 'details',
      '#title' => $this
        ->t('Administration'),
    ];
  }

  // Prepare default values for form elements.
  $author = '';
  if ($is_admin) {
    if (!$comment
      ->getOwnerId()) {
      $author = $comment
        ->getAuthorName();
    }
    $status = $comment
      ->isPublished() ? CommentInterface::PUBLISHED : CommentInterface::NOT_PUBLISHED;
    if (empty($comment_preview)) {
      $form['#title'] = $this
        ->t('Edit comment %title', [
        '%title' => $comment
          ->getSubject(),
      ]);
    }
  }
  else {
    $status = $this->currentUser
      ->hasPermission('skip comment approval') ? CommentInterface::PUBLISHED : CommentInterface::NOT_PUBLISHED;
  }
  $date = '';
  if ($comment
    ->id()) {
    $date = !empty($comment->date) ? $comment->date : DrupalDateTime::createFromTimestamp($comment
      ->getCreatedTime());
  }

  // The uid field is only displayed when a user with the permission
  // 'administer comments' is editing an existing comment from an
  // authenticated user.
  $owner = $comment
    ->getOwner();
  $form['author']['uid'] = [
    '#type' => 'entity_autocomplete',
    '#target_type' => 'user',
    '#default_value' => $owner
      ->isAnonymous() ? NULL : $owner,
    // A comment can be made anonymous by leaving this field empty therefore
    // there is no need to list them in the autocomplete.
    '#selection_settings' => [
      'include_anonymous' => FALSE,
    ],
    '#title' => $this
      ->t('Authored by'),
    '#description' => $this
      ->t('Leave blank for %anonymous.', [
      '%anonymous' => $config
        ->get('anonymous'),
    ]),
    '#access' => $is_admin,
  ];

  // The name field is displayed when an anonymous user is adding a comment or
  // when a user with the permission 'administer comments' is editing an
  // existing comment from an anonymous user.
  $form['author']['name'] = [
    '#type' => 'textfield',
    '#title' => $is_admin ? $this
      ->t('Name for @anonymous', [
      '@anonymous' => $config
        ->get('anonymous'),
    ]) : $this
      ->t('Your name'),
    '#default_value' => $author,
    '#required' => $this->currentUser
      ->isAnonymous() && $anonymous_contact == CommentInterface::ANONYMOUS_MUST_CONTACT,
    '#maxlength' => 60,
    '#access' => $this->currentUser
      ->isAnonymous() || $is_admin,
    '#size' => 30,
    '#attributes' => [
      'data-drupal-default-value' => $config
        ->get('anonymous'),
    ],
  ];
  if ($is_admin) {

    // When editing a comment only display the name textfield if the uid field
    // is empty.
    $form['author']['name']['#states'] = [
      'visible' => [
        ':input[name="uid"]' => [
          'empty' => TRUE,
        ],
      ],
    ];
  }

  // Add author email and homepage fields depending on the current user.
  $form['author']['mail'] = [
    '#type' => 'email',
    '#title' => $this
      ->t('Email'),
    '#default_value' => $comment
      ->getAuthorEmail(),
    '#required' => $this->currentUser
      ->isAnonymous() && $anonymous_contact == CommentInterface::ANONYMOUS_MUST_CONTACT,
    '#maxlength' => 64,
    '#size' => 30,
    '#description' => $this
      ->t('The content of this field is kept private and will not be shown publicly.'),
    '#access' => $comment
      ->getOwner()
      ->isAnonymous() && $is_admin || $this->currentUser
      ->isAnonymous() && $anonymous_contact != CommentInterface::ANONYMOUS_MAYNOT_CONTACT,
  ];
  $form['author']['homepage'] = [
    '#type' => 'url',
    '#title' => $this
      ->t('Homepage'),
    '#default_value' => $comment
      ->getHomepage(),
    '#maxlength' => 255,
    '#size' => 30,
    '#access' => $is_admin || $this->currentUser
      ->isAnonymous() && $anonymous_contact != CommentInterface::ANONYMOUS_MAYNOT_CONTACT,
  ];

  // Add administrative comment publishing options.
  $form['author']['date'] = [
    '#type' => 'datetime',
    '#title' => $this
      ->t('Authored on'),
    '#default_value' => $date,
    '#size' => 20,
    '#access' => $is_admin,
  ];
  $form['author']['status'] = [
    '#type' => 'radios',
    '#title' => $this
      ->t('Status'),
    '#default_value' => $status,
    '#options' => [
      CommentInterface::PUBLISHED => $this
        ->t('Published'),
      CommentInterface::NOT_PUBLISHED => $this
        ->t('Not published'),
    ],
    '#access' => $is_admin,
  ];
  return parent::form($form, $form_state, $comment);
}