function AccountForm::form

Same name in other branches
  1. 9 core/modules/user/src/AccountForm.php \Drupal\user\AccountForm::form()
  2. 8.9.x core/modules/user/src/AccountForm.php \Drupal\user\AccountForm::form()
  3. 11.x core/modules/user/src/AccountForm.php \Drupal\user\AccountForm::form()

Overrides ContentEntityForm::form

1 call to AccountForm::form()
RegisterForm::form in core/modules/user/src/RegisterForm.php
Gets the actual form array to be built.
1 method overrides AccountForm::form()
RegisterForm::form in core/modules/user/src/RegisterForm.php
Gets the actual form array to be built.

File

core/modules/user/src/AccountForm.php, line 67

Class

AccountForm
Form controller for the user account forms.

Namespace

Drupal\user

Code

public function form(array $form, FormStateInterface $form_state) {
    
    /** @var \Drupal\user\UserInterface $account */
    $account = $this->entity;
    $user = $this->currentUser();
    $config = \Drupal::config('user.settings');
    $form['#cache']['tags'] = $config->getCacheTags();
    $language_interface = \Drupal::languageManager()->getCurrentLanguage();
    // Check for new account.
    $register = $account->isNew();
    // For a new account, there are 2 sub-cases:
    // $self_register: A user creates their own, new, account
    // (path '/user/register')
    // $admin_create: An administrator creates a new account for another user
    // (path '/admin/people/create')
    // If the current user is logged in and has permission to create users
    // then it must be the second case.
    $admin_create = $register && $account->access('create');
    $self_register = $register && !$admin_create;
    // Account information.
    $form['account'] = [
        '#type' => 'container',
        '#weight' => -10,
    ];
    // The mail field is NOT required if account originally had no mail set
    // and the user performing the edit has 'administer users' permission.
    // This allows users without email address to be edited and deleted.
    // Also see \Drupal\user\Plugin\Validation\Constraint\UserMailRequired.
    $form['account']['mail'] = [
        '#type' => 'email',
        '#title' => $this->t('Email address'),
        '#description' => $this->t('The email address is not made public. It will only be used if you need to be contacted about your account or for opted-in notifications.'),
        '#required' => !(!$account->getEmail() && $user->hasPermission('administer users')),
        '#default_value' => !$register ? $account->getEmail() : '',
        '#access' => $account->mail
            ->access('edit'),
    ];
    // Only show name field on registration form or user can change own username.
    $form['account']['name'] = [
        '#type' => 'textfield',
        '#title' => $this->t('Username'),
        '#maxlength' => UserInterface::USERNAME_MAX_LENGTH,
        '#description' => $this->t("Several special characters are allowed, including space, period (.), hyphen (-), apostrophe ('), underscore (_), and the @ sign."),
        '#required' => TRUE,
        '#attributes' => [
            'class' => [
                'username',
            ],
            'autocorrect' => 'off',
            'autocapitalize' => 'off',
            'spellcheck' => 'false',
        ],
        '#default_value' => !$register ? $account->getAccountName() : '',
        '#access' => $account->name
            ->access('edit'),
    ];
    // Display password field only for existing users or when user is allowed to
    // assign a password during registration.
    if (!$register) {
        $form['account']['pass'] = [
            '#type' => 'password_confirm',
            '#size' => 25,
            '#description' => $this->t('To change the current user password, enter the new password in both fields.'),
        ];
        // To skip the current password field, the user must have logged in via a
        // one-time link and have the token in the URL. Store this in $form_state
        // so it persists even on subsequent Ajax requests.
        $request = $this->getRequest();
        if (!$form_state->get('user_pass_reset') && ($token = $request->query
            ->get('pass-reset-token'))) {
            $session_key = 'pass_reset_' . $account->id();
            $session_value = $request->getSession()
                ->get($session_key);
            $user_pass_reset = isset($session_value) && hash_equals($session_value, $token);
            $form_state->set('user_pass_reset', $user_pass_reset);
        }
        // The user must enter their current password to change to a new one.
        if ($user->id() == $account->id()) {
            $form['account']['current_pass'] = [
                '#type' => 'password',
                '#title' => $this->t('Current password'),
                '#size' => 25,
                '#access' => !$form_state->get('user_pass_reset'),
                '#weight' => -5,
                // Do not let web browsers remember this password, since we are
                // trying to confirm that the person submitting the form actually
                // knows the current one.
'#attributes' => [
                    'autocomplete' => 'off',
                ],
            ];
            $form_state->set('user', $account);
            // The user may only change their own password without their current
            // password if they logged in via a one-time login link.
            if (!$form_state->get('user_pass_reset')) {
                $form['account']['current_pass']['#description'] = $this->t('Required if you want to change the %mail or %pass below. <a href=":request_new_url" title="Send password reset instructions via email.">Reset your password</a>.', [
                    '%mail' => $form['account']['mail']['#title'],
                    '%pass' => $this->t('Password'),
                    ':request_new_url' => Url::fromRoute('user.pass')->toString(),
                ]);
            }
        }
    }
    elseif (!$config->get('verify_mail') || $admin_create) {
        $form['account']['pass'] = [
            '#type' => 'password_confirm',
            '#size' => 25,
            '#description' => $this->t('Provide a password for the new account in both fields.'),
            '#required' => TRUE,
        ];
    }
    // When not building the user registration form, prevent web browsers from
    // auto-filling/prefilling the email, username, and password fields.
    if (!$register) {
        foreach ([
            'mail',
            'name',
            'pass',
        ] as $key) {
            if (isset($form['account'][$key])) {
                $form['account'][$key]['#attributes']['autocomplete'] = 'off';
            }
        }
    }
    if (!$self_register) {
        $status = $account->get('status')->value;
    }
    else {
        $status = $config->get('register') == UserInterface::REGISTER_VISITORS ? 1 : 0;
    }
    $form['account']['status'] = [
        '#type' => 'radios',
        '#title' => $this->t('Status'),
        '#default_value' => $status,
        '#options' => [
            $this->t('Blocked'),
            $this->t('Active'),
        ],
        '#access' => $account->status
            ->access('edit'),
    ];
    $roles = Role::loadMultiple();
    unset($roles[RoleInterface::ANONYMOUS_ID]);
    $roles = array_map(fn(RoleInterface $role) => Html::escape($role->label()), $roles);
    $form['account']['roles'] = [
        '#type' => 'checkboxes',
        '#title' => $this->t('Roles'),
        '#default_value' => !$register ? $account->getRoles() : [],
        '#options' => $roles,
        '#access' => $roles && $user->hasPermission('administer permissions'),
    ];
    // Special handling for the inevitable "Authenticated user" role.
    $form['account']['roles'][RoleInterface::AUTHENTICATED_ID] = [
        '#default_value' => TRUE,
        '#disabled' => TRUE,
    ];
    $form['account']['notify'] = [
        '#type' => 'checkbox',
        '#title' => $this->t('Notify user of new account'),
        '#access' => $admin_create,
    ];
    $user_preferred_langcode = $register ? $language_interface->getId() : $account->getPreferredLangcode();
    $user_preferred_admin_langcode = $register ? $language_interface->getId() : $account->getPreferredAdminLangcode(FALSE);
    // Is the user preferred language added?
    $user_language_added = FALSE;
    if ($this->languageManager instanceof ConfigurableLanguageManagerInterface) {
        $negotiator = $this->languageManager
            ->getNegotiator();
        $user_language_added = $negotiator && $negotiator->isNegotiationMethodEnabled(LanguageNegotiationUser::METHOD_ID, LanguageInterface::TYPE_INTERFACE);
    }
    $form['language'] = [
        '#type' => $this->languageManager
            ->isMultilingual() ? 'details' : 'container',
        '#title' => $this->t('Language settings'),
        '#open' => TRUE,
        // Display language selector when either creating a user on the admin
        // interface or editing a user account.
'#access' => !$self_register,
    ];
    $form['language']['preferred_langcode'] = [
        '#type' => 'language_select',
        '#title' => $this->t('Site language'),
        '#languages' => LanguageInterface::STATE_CONFIGURABLE,
        '#default_value' => $user_preferred_langcode,
        '#description' => $user_language_added ? $this->t("This account's preferred language for emails and site presentation.") : $this->t("This account's preferred language for emails."),
        // This is used to explain that user preferred language and entity
        // language are synchronized. It can be removed if a different behavior is
        // desired.
'#pre_render' => [
            'user_langcode' => [
                $this,
                'alterPreferredLangcodeDescription',
            ],
        ],
    ];
    // Only show the account setting for Administration pages language to users
    // if one of the detection and selection methods uses it.
    $show_admin_language = FALSE;
    if (($account->hasPermission('access administration pages') || $account->hasPermission('view the administration theme')) && $this->languageManager instanceof ConfigurableLanguageManagerInterface) {
        $negotiator = $this->languageManager
            ->getNegotiator();
        $show_admin_language = $negotiator && $negotiator->isNegotiationMethodEnabled(LanguageNegotiationUserAdmin::METHOD_ID);
    }
    $form['language']['preferred_admin_langcode'] = [
        '#type' => 'language_select',
        '#title' => $this->t('Administration pages language'),
        '#languages' => LanguageInterface::STATE_CONFIGURABLE,
        '#default_value' => $user_preferred_admin_langcode,
        '#access' => $show_admin_language,
        '#empty_option' => $this->t('- No preference -'),
        '#empty_value' => '',
    ];
    // User entities contain both a langcode property (for identifying the
    // language of the entity data) and a preferred_langcode property (see
    // above). Rather than provide a UI forcing the user to choose both
    // separately, assume that the user profile data is in the user's preferred
    // language. This entity builder provides that synchronization. For
    // use-cases where this synchronization is not desired, a module can alter
    // or remove this item. Sync user langcode only when a user registers and
    // not when a user is updated or translated.
    if ($register) {
        $form['#entity_builders']['sync_user_langcode'] = '::syncUserLangcode';
    }
    $system_date_config = \Drupal::config('system.date');
    $form['timezone'] = [
        '#type' => 'details',
        '#title' => $this->t('Locale settings'),
        '#open' => TRUE,
        '#weight' => 6,
        '#access' => $system_date_config->get('timezone.user.configurable'),
    ];
    if ($self_register && $system_date_config->get('timezone.user.default') != UserInterface::TIMEZONE_SELECT) {
        $form['timezone']['#access'] = FALSE;
    }
    $form['timezone']['timezone'] = [
        '#type' => 'select',
        '#title' => $this->t('Time zone'),
        '#default_value' => $account->getTimezone() ?: $system_date_config->get('timezone.default'),
        '#options' => TimeZoneFormHelper::getOptionsListByRegion($account->id() != $user->id()),
        '#description' => $this->t('Select the desired local time and time zone. Dates and times throughout this site will be displayed using this time zone.'),
    ];
    // If not set or selected yet, detect timezone for the current user only.
    $user_input = $form_state->getUserInput();
    if (!$account->getTimezone() && $account->id() == $user->id() && empty($user_input['timezone'])) {
        $form['timezone']['#attached']['library'][] = 'core/drupal.timezone';
        $form['timezone']['timezone']['#attributes'] = [
            'class' => [
                'timezone-detect',
            ],
        ];
    }
    return parent::form($form, $form_state);
}

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