class NegotiationBrowserForm

Same name and namespace in other branches
  1. 9 core/modules/language/src/Form/NegotiationBrowserForm.php \Drupal\language\Form\NegotiationBrowserForm
  2. 8.9.x core/modules/language/src/Form/NegotiationBrowserForm.php \Drupal\language\Form\NegotiationBrowserForm
  3. 10 core/modules/language/src/Form/NegotiationBrowserForm.php \Drupal\language\Form\NegotiationBrowserForm

Configure the browser language negotiation method for this site.

@internal

Hierarchy

Expanded class hierarchy of NegotiationBrowserForm

1 string reference to 'NegotiationBrowserForm'
language.routing.yml in core/modules/language/language.routing.yml
core/modules/language/language.routing.yml

File

core/modules/language/src/Form/NegotiationBrowserForm.php, line 18

Namespace

Drupal\language\Form
View source
class NegotiationBrowserForm extends ConfigFormBase {
    
    /**
     * The configurable language manager.
     *
     * @var \Drupal\language\ConfigurableLanguageManagerInterface
     */
    protected $languageManager;
    
    /**
     * {@inheritdoc}
     */
    public function __construct(ConfigFactoryInterface $config_factory, TypedConfigManagerInterface $typedConfigManager, ConfigurableLanguageManagerInterface $language_manager) {
        parent::__construct($config_factory, $typedConfigManager);
        $this->languageManager = $language_manager;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container) {
        return new static($container->get('config.factory'), $container->get('config.typed'), $container->get('language_manager'));
    }
    
    /**
     * {@inheritdoc}
     */
    public function getFormId() {
        return 'language_negotiation_configure_browser_form';
    }
    
    /**
     * {@inheritdoc}
     */
    protected function getEditableConfigNames() {
        return [
            'language.mappings',
        ];
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildForm(array $form, FormStateInterface $form_state) {
        $form = [];
        // Initialize a language list to the ones available, including English.
        $languages = $this->languageManager
            ->getLanguages();
        $existing_languages = [];
        foreach ($languages as $langcode => $language) {
            $existing_languages[$langcode] = $language->getName();
        }
        // If we have no languages available, present the list of predefined languages
        // only. If we do have already added languages, set up two option groups with
        // the list of existing and then predefined languages.
        if (empty($existing_languages)) {
            $language_options = $this->languageManager
                ->getStandardLanguageListWithoutConfigured();
        }
        else {
            $language_options = [
                (string) $this->t('Existing languages') => $existing_languages,
                (string) $this->t('Languages not yet added') => $this->languageManager
                    ->getStandardLanguageListWithoutConfigured(),
            ];
        }
        $form['mappings'] = [
            '#type' => 'table',
            '#header' => [
                $this->t('Browser language code'),
                $this->t('Site language'),
                $this->t('Operations'),
            ],
            '#attributes' => [
                'id' => 'language-negotiation-browser',
            ],
            '#empty' => $this->t('No browser language mappings available.'),
        ];
        $mappings = $this->language_get_browser_drupal_langcode_mappings();
        foreach ($mappings as $browser_langcode => $drupal_langcode) {
            $form['mappings'][$browser_langcode] = [
                'browser_langcode' => [
                    '#title' => $this->t('Browser language code'),
                    '#title_display' => 'invisible',
                    '#type' => 'textfield',
                    '#default_value' => $browser_langcode,
                    '#size' => 20,
                    '#required' => TRUE,
                ],
                'drupal_langcode' => [
                    '#title' => $this->t('Site language'),
                    '#title_display' => 'invisible',
                    '#type' => 'select',
                    '#options' => $language_options,
                    '#default_value' => $drupal_langcode,
                    '#required' => TRUE,
                ],
            ];
            // Operations column.
            $form['mappings'][$browser_langcode]['operations'] = [
                '#type' => 'operations',
                '#links' => [],
            ];
            $form['mappings'][$browser_langcode]['operations']['#links']['delete'] = [
                'title' => $this->t('Delete'),
                'url' => Url::fromRoute('language.negotiation_browser_delete', [
                    'browser_langcode' => $browser_langcode,
                ]),
            ];
        }
        // Add empty row.
        $form['new_mapping'] = [
            '#type' => 'details',
            '#title' => $this->t('Add a new mapping'),
            '#tree' => TRUE,
        ];
        $form['new_mapping']['browser_langcode'] = [
            '#type' => 'textfield',
            '#title' => $this->t('Browser language code'),
            '#description' => $this->t('Use language codes as <a href=":w3ctags">defined by the W3C</a> for interoperability. <em>Examples: "en", "en-gb" and "zh-hant".</em>', [
                ':w3ctags' => 'http://www.w3.org/International/articles/language-tags/',
            ]),
            '#size' => 20,
        ];
        $form['new_mapping']['drupal_langcode'] = [
            '#type' => 'select',
            '#title' => $this->t('Site language'),
            '#options' => $language_options,
        ];
        return parent::buildForm($form, $form_state);
    }
    
    /**
     * {@inheritdoc}
     */
    public function validateForm(array &$form, FormStateInterface $form_state) {
        // Array to check if all browser language codes are unique.
        $unique_values = [];
        // Check all mappings.
        if ($form_state->hasValue('mappings')) {
            $mappings = $form_state->getValue('mappings');
            foreach ($mappings as $key => $data) {
                // Make sure browser_langcode is unique.
                if (array_key_exists($data['browser_langcode'], $unique_values)) {
                    $form_state->setErrorByName('mappings][new_mapping][browser_langcode', $this->t('Browser language codes must be unique.'));
                }
                elseif (preg_match('/[^a-z\\-]/', $data['browser_langcode'])) {
                    $form_state->setErrorByName('mappings][new_mapping][browser_langcode', $this->t('Browser language codes can only contain lowercase letters and a hyphen(-).'));
                }
                $unique_values[$data['browser_langcode']] = $data['drupal_langcode'];
            }
        }
        // Check new mapping.
        $data = $form_state->getValue('new_mapping');
        if (!empty($data['browser_langcode'])) {
            // Make sure browser_langcode is unique.
            if (array_key_exists($data['browser_langcode'], $unique_values)) {
                $form_state->setErrorByName('mappings][' . $key . '][browser_langcode', $this->t('Browser language codes must be unique.'));
            }
            elseif (preg_match('/[^a-z\\-]/', $data['browser_langcode'])) {
                $form_state->setErrorByName('mappings][' . $key . '][browser_langcode', $this->t('Browser language codes can only contain lowercase letters and a hyphen(-).'));
            }
            $unique_values[$data['browser_langcode']] = $data['drupal_langcode'];
        }
        $form_state->set('mappings', $unique_values);
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitForm(array &$form, FormStateInterface $form_state) {
        $mappings = $form_state->get('mappings');
        if (!empty($mappings)) {
            $config = $this->config('language.mappings');
            $config->setData([
                'map' => $mappings,
            ]);
            $config->save();
        }
        parent::submitForm($form, $form_state);
    }
    
    /**
     * Retrieves the browser's langcode mapping configuration array.
     *
     * @return array
     *   The browser's langcode mapping configuration array.
     */
    protected function language_get_browser_drupal_langcode_mappings() {
        $config = $this->config('language.mappings');
        if ($config->isNew()) {
            return [];
        }
        return $config->get('map');
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
ConfigFormBase::CONFIG_KEY_TO_FORM_ELEMENT_MAP protected constant The $form_state key which stores a map of config keys to form elements.
ConfigFormBase::copyFormValuesToConfig private static function Copies form values to Config keys.
ConfigFormBase::doStoreConfigMap protected function Helper method for #after_build callback ::storeConfigKeyToFormElementMap().
ConfigFormBase::formatMultipleViolationsMessage protected function Formats multiple violation messages associated with a single form element. 1
ConfigFormBase::loadDefaultValuesFromConfig public function Process callback to recursively load default values from #config_target.
ConfigFormBase::storeConfigKeyToFormElementMap public function #after_build callback which stores a map of element names to config keys.
ConfigFormBase::typedConfigManager protected function Returns the typed config manager service.
ConfigFormBaseTrait::config protected function Retrieves a configuration object.
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::configFactory protected function Gets the config factory for this form. 2
FormBase::container private function Returns the service container.
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.
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.
NegotiationBrowserForm::$languageManager protected property The configurable language manager.
NegotiationBrowserForm::buildForm public function Form constructor. Overrides ConfigFormBase::buildForm
NegotiationBrowserForm::create public static function Instantiates a new instance of this class. Overrides ConfigFormBase::create
NegotiationBrowserForm::getEditableConfigNames protected function Gets the configuration names that will be editable. Overrides ConfigFormBaseTrait::getEditableConfigNames
NegotiationBrowserForm::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
NegotiationBrowserForm::language_get_browser_drupal_langcode_mappings protected function Retrieves the browser&#039;s langcode mapping configuration array.
NegotiationBrowserForm::submitForm public function Form submission handler. Overrides ConfigFormBase::submitForm
NegotiationBrowserForm::validateForm public function Form validation handler. Overrides ConfigFormBase::validateForm
NegotiationBrowserForm::__construct public function Constructs a \Drupal\system\ConfigFormBase object. Overrides ConfigFormBase::__construct
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.
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.