class SelectLanguageForm

Same name in other branches
  1. 9 core/lib/Drupal/Core/Installer/Form/SelectLanguageForm.php \Drupal\Core\Installer\Form\SelectLanguageForm
  2. 8.9.x core/lib/Drupal/Core/Installer/Form/SelectLanguageForm.php \Drupal\Core\Installer\Form\SelectLanguageForm
  3. 10 core/lib/Drupal/Core/Installer/Form/SelectLanguageForm.php \Drupal\Core\Installer\Form\SelectLanguageForm

Provides the language selection form.

Note that hardcoded text provided by this form is not translated. This is because translations are downloaded as a result of submitting this form.

@internal

Hierarchy

Expanded class hierarchy of SelectLanguageForm

File

core/lib/Drupal/Core/Installer/Form/SelectLanguageForm.php, line 19

Namespace

Drupal\Core\Installer\Form
View source
class SelectLanguageForm extends FormBase {
    
    /**
     * {@inheritdoc}
     */
    public function getFormId() {
        return 'install_select_language_form';
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildForm(array $form, FormStateInterface $form_state, $install_state = NULL) {
        if (count($install_state['translations']) > 1) {
            $files = $install_state['translations'];
        }
        else {
            $files = [];
        }
        $standard_languages = LanguageManager::getStandardLanguageList();
        $select_options = [];
        $browser_options = [];
        $form['#title'] = 'Choose language';
        // Build a select list with language names in native language for the user
        // to choose from. And build a list of available languages for the browser
        // to select the language default from.
        // Select lists based on all standard languages.
        foreach ($standard_languages as $langcode => $language_names) {
            $select_options[$langcode] = $language_names[1];
            $browser_options[$langcode] = $langcode;
        }
        // Add languages based on language files in the translations directory.
        if (count($files)) {
            foreach ($files as $langcode => $uri) {
                $select_options[$langcode] = isset($standard_languages[$langcode]) ? $standard_languages[$langcode][1] : $langcode;
                $browser_options[$langcode] = $langcode;
            }
        }
        asort($select_options);
        $request = Request::createFromGlobals();
        $browser_langcode = UserAgent::getBestMatchingLangcode($request->server
            ->get('HTTP_ACCEPT_LANGUAGE', ''), $browser_options);
        $form['langcode'] = [
            '#type' => 'select',
            '#title' => 'Choose language',
            '#title_display' => 'invisible',
            '#options' => $select_options,
            // Use the browser detected language as default or English if nothing found.
'#default_value' => !empty($browser_langcode) ? $browser_langcode : 'en',
        ];
        $link_to_english = install_full_redirect_url([
            'parameters' => [
                'langcode' => 'en',
            ],
        ]);
        $form['help'] = [
            '#type' => 'item',
            // #markup is XSS admin filtered which ensures unsafe protocols will be
            // removed from the URL.
'#markup' => '<p>Translations will be downloaded from the <a href="https://localize.drupal.org/download">Drupal Translation website</a>. If you do not want this, select <a href="' . $link_to_english . '">English</a>.</p>',
            '#states' => [
                'invisible' => [
                    'select[name="langcode"]' => [
                        'value' => 'en',
                    ],
                ],
            ],
        ];
        $form['actions'] = [
            '#type' => 'actions',
        ];
        $form['actions']['submit'] = [
            '#type' => 'submit',
            '#value' => 'Save and continue',
            '#button_type' => 'primary',
        ];
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitForm(array &$form, FormStateInterface $form_state) {
        $build_info = $form_state->getBuildInfo();
        $build_info['args'][0]['parameters']['langcode'] = $form_state->getValue('langcode');
        $form_state->setBuildInfo($build_info);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
FormBase::$configFactory protected property The config factory. 2
FormBase::$requestStack protected property The request stack. 1
FormBase::$routeMatch protected property The route match.
FormBase::config protected function Retrieves a configuration object.
FormBase::configFactory protected function Gets the config factory for this form. 2
FormBase::container private function Returns the service container.
FormBase::create public static function Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create 109
FormBase::currentUser protected function Gets the current user. 2
FormBase::getRequest protected function Gets the request object.
FormBase::getRouteMatch protected function Gets the route match.
FormBase::logger protected function Gets the logger for a specific channel.
FormBase::redirect protected function Returns a redirect response object for the specified route.
FormBase::resetConfigFactory public function Resets the configuration factory.
FormBase::setConfigFactory public function Sets the config factory for this form.
FormBase::setRequestStack public function Sets the request stack object to use.
FormBase::validateForm public function Form validation handler. Overrides FormInterface::validateForm 57
LoggerChannelTrait::$loggerFactory protected property The logger channel factory service.
LoggerChannelTrait::getLogger protected function Gets the logger for a specific channel.
LoggerChannelTrait::setLoggerFactory public function Injects the logger channel factory.
MessengerTrait::$messenger protected property The messenger. 16
MessengerTrait::messenger public function Gets the messenger. 16
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 2
RedirectDestinationTrait::getDestinationArray protected function Prepares a &#039;destination&#039; URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
SelectLanguageForm::buildForm public function Form constructor. Overrides FormInterface::buildForm
SelectLanguageForm::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
SelectLanguageForm::submitForm public function Form submission handler. Overrides FormInterface::submitForm
StringTranslationTrait::$stringTranslation protected property The string translation service. 3
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.

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