language.module 31.4 KB
Newer Older
1
2
3
4
5
6
7
<?php

/**
 * @file
 * Add language handling functionality to Drupal.
 */

8
use Drupal\node\NodeTypeInterface;
9
10
use Drupal\Core\Language\Language;

11
12
13
14
15
16
17
18
/**
 * Implements hook_help().
 */
function language_help($path, $arg) {
  switch ($path) {
    case 'admin/help#language':
      $output = '';
      $output .= '<h3>' . t('About') . '</h3>';
19
      $output .= '<p>' . t('The Language module allows you to maintain a list of languages used on your Drupal site for providing language information for content and for interface translation (using the Locale module). For more information, see the online handbook entry for <a href="@language">Language module</a>.', array('@language' => 'http://drupal.org/documentation/modules/language')) . '</p>';
20
21
22
23
      $output .= '<h3>' . t('Uses') . '</h3>';
      $output .= '<dl>';
      $output .= '<dt>' . t('Configuring the list of languages') . '</dt>';
      $output .= '<dd>' . t('<a href="@configure-languages">Configure the list of languages</a> either using the built-in language list or providing any custom languages you wish.', array('@configure-languages' => url('admin/config/regional/language'))) . '</dd>';
24
25
      $output .= '<dt>' . t('Configuring a multilingual site') . '</dt>';
      $output .= '<dd>' . t("Language negotiation allows your site to automatically change language based on the domain or path used for each request. Users may (optionally) select their preferred language on their <em>My account</em> page, and your site can be configured to honor a web browser's preferred language settings. Site content can be translated using the <a href='@content-help'>Content Translation module</a>.", array('@content-help' => url('admin/help/translation'))) . '</dd>';
26
27
28
29
      $output .= '</dl>';
      return $output;

    case 'admin/config/regional/language':
30
      return '<p>' . t('With multiple languages enabled, registered users may select their preferred language and authors can assign a specific language to content. The selection of what language is used to display page elements is made depending on the detection menthod settings in the <a href="@detection">Detection and Selection</a> tab.', array('@detection' => url('admin/config/regional/language/detection'))) . '</p>';
31
32
33

    case 'admin/config/regional/language/add':
      return '<p>' . t('Add a language to be supported by your site. If your desired language is not available, pick <em>Custom language...</em> at the end and provide a language code and other details manually.') . '</p>';
34
35

    case 'admin/config/regional/language/detection':
36
      $output = '<p>' . t('Define how to decide which language is used to display page elements (primarily text provided by Drupal and modules, such as field labels and help text). This decision is made by evaluating a series of detection methods for languages; the first detection method that gets a result will determine which language is used for that type of text. Be aware that some language negotiation methods are unreliable under certain conditions, such as browser detection when page-caching is enabled and a user is not currently logged in. Define the order of evaluation of language detection methods on this page. Default language can be changed at the <a href="@region-settings">Regional settings</a> page.', array('@region-settings' => url('admin/config/regional/settings'))) . '</p>';
37
38
39
40
41
42
      return $output;

    case 'admin/config/regional/language/detection/session':
      $output = '<p>' . t('Determine the language from a request/session parameter. Example: "http://example.com?language=de" sets language to German based on the use of "de" within the "language" parameter.') . '</p>';
      return $output;

43
44
45
46
    case 'admin/config/regional/language/detection/browser':
      $output = '<p>' . t('Browsers use different language codes to refer to the same languages. You can add and edit mappings from browser language codes to the <a href="@configure-languages">languages used by Drupal</a>.', array('@configure-languages' => url('admin/config/regional/language'))) . '</p>';
      return $output;

47
48
49
50
51
52
    case 'admin/config/regional/language/detection/selected':
      $output = '<p>' . t('Changing the selected language here (and leaving this option as the last among the detection and selection options) is the easiest way to change the fallback language for the website, if you need to change how your site works by default (eg. when using an empty path prefix or using the default domain). <a href="@admin-change-language">Changing the site\'s default language</a> itself might have other undesired side effects.
', array('@admin-change-language' => url('admin/config/regional/language'))) . '</p>';

      return $output;

53
54
    case 'admin/structure/block/manage/%':
    case 'admin/structure/block/add/%/%':
55
      if ($arg[4] == 'language' && $arg[5] == 'language_interface') {
56
        return '<p>' . t('With multiple languages enabled, registered users can select their preferred language and authors can assign a specific language to content.') . '</p>';
57
58
      }
      break;
59
60
61

    case 'admin/config/regional/content-language':
      return t('Change language settings for <em>content types</em>, <em>taxonomy vocabularies</em>, <em>user profiles</em>, or any other supported element on your site. By default, language settings hide the language selector and the language is the site\'s default language.');
62
63
64
65
66
67
68
  }
}

/**
 * Implements hook_menu().
 */
function language_menu() {
69
  // Base language management and configuration.
70
71
72
  $items['admin/config/regional/language'] = array(
    'title' => 'Languages',
    'description' => 'Configure languages for content and the user interface.',
73
    'route_name' => 'language.admin_overview',
74
75
76
77
78
79
80
    'weight' => -10,
  );
  $items['admin/config/regional/language/list'] = array(
    'title' => 'List',
    'type' => MENU_DEFAULT_LOCAL_TASK,
  );
  $items['admin/config/regional/language/add'] = array(
81
    'route_name' => 'language.add',
82
    'type' => MENU_SIBLING_LOCAL_TASK,
83
84
85
  );
  $items['admin/config/regional/language/edit/%language'] = array(
    'title' => 'Edit language',
86
    'route_name' => 'language.edit',
87
  );
88
89
90
91
92
  $items['admin/config/regional/language/edit/%language/edit'] = array(
    'title' => 'Edit',
    'type' => MENU_DEFAULT_LOCAL_TASK,
    'weight' => -10,
   );
93
94
95
96

  // Language negotiation.
  $items['admin/config/regional/language/detection'] = array(
    'title' => 'Detection and selection',
97
    'route_name' => 'language.negotiation',
98
99
100
101
102
    'weight' => 10,
    'type' => MENU_LOCAL_TASK,
  );
  $items['admin/config/regional/language/detection/url'] = array(
    'title' => 'URL language detection configuration',
103
    'route_name' => 'language.negotiation_url',
104
105
106
107
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
  );
  $items['admin/config/regional/language/detection/session'] = array(
    'title' => 'Session language detection configuration',
108
    'route_name' => 'language.negotiation_session',
109
110
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
  );
111
112
  $items['admin/config/regional/language/detection/browser'] = array(
    'title' => 'Browser language detection configuration',
113
    'route_name' => 'language.negotiation_browser',
114
115
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
  );
116
117
  $items['admin/config/regional/language/detection/selected'] = array(
    'title' => 'Selected language detection configuration',
118
    'route_name' => 'language.negotiation_selected',
119
120
    'type' => MENU_VISIBLE_IN_BREADCRUMB,
  );
121

122
123
124
125
  // Content language settings.
  $items['admin/config/regional/content-language'] = array(
    'title' => 'Content language settings',
    'description' => 'Configure content language support for any multilingual element.',
126
    'route_name' => 'language.content_settings_page',
127
128
  );

129
130
131
  return $items;
}

132
133
/**
 * Editing or deleting locked languages should not be possible.
134
135
 *
 * @deprecated Use \Drupal\language\LanguageAccessController instead.
136
137
138
139
140
 */
function language_access_language_edit_or_delete($language) {
  return !$language->locked && user_access('administer languages');
}

141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
/**
 * Implements hook_permission().
 */
function language_permission() {
  return array(
    'administer languages' => array(
      'title' => t('Administer languages'),
    ),
  );
}

/**
 * Implements hook_theme().
 */
function language_theme() {
  return array(
157
158
159
    'language_negotiation_configure_form' => array(
      'render element' => 'form',
    ),
160
161
162
163
    'language_negotiation_configure_browser_form_table' => array(
      'render element' => 'form',
      'file' => 'language.admin.inc',
    ),
164
165
166
167
    'language_content_settings_table' => array(
      'render element' => 'element',
      'file' => 'language.admin.inc',
    ),
168
169
170
  );
}

171
172
173
174
175
176
177
178
179
/**
 * Returns a list of supported entity types.
 *
 * @return array
 *   An array of entity type names.
 */
function language_entity_supported() {
  $supported = array();
  foreach (entity_get_info() as $entity_type => $info) {
180
    if (!empty($info['translatable'])) {
181
182
183
184
185
186
      $supported[$entity_type] = $entity_type;
    }
  }
  return $supported;
}

187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
/**
 * Implements hook_element_info_alter().
 */
function language_element_info_alter(&$type) {
  // Alter the language_select element so that it will be rendered like a select
  // field.
  if (isset($type['language_select'])) {
    if (!isset($type['language_select']['#process'])) {
      $type['language_select']['#process'] = array();
    }
    if (!isset($type['language_select']['#theme_wrappers'])) {
      $type['language_select']['#theme_wrappers'] = array();
    }
    $type['language_select']['#process'] = array_merge($type['language_select']['#process'], array('language_process_language_select', 'form_process_select', 'ajax_process_form'));
    $type['language_select']['#theme'] = 'select';
    $type['language_select']['#theme_wrappers'] = array_merge($type['language_select']['#theme_wrappers'], array('form_element'));
203
    $type['language_select']['#languages'] = Language::STATE_CONFIGURABLE;
204
205
206
207
208
209
210
211
212
213
214
215
216
217
    $type['language_select']['#multiple'] = FALSE;
  }
}

/**
 * Processes a language select list form element.
 *
 * @param array $element
 *   The form element to process.
 *
 * @return array $element
 *   The processed form element.
 */
function language_process_language_select($element) {
218
  // Don't set the options if another module (translation for example) already
219
220
221
222
223
224
225
226
227
228
  // set the options.
  if (!isset($element['#options'])) {
    $element['#options'] = array();
    foreach (language_list($element['#languages']) as $langcode => $language) {
      $element['#options'][$langcode] = $language->locked ? t('- @name -', array('@name' => $language->name)) : $language->name;
    }
  }
  return $element;
}

229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
/**
 * Implements hook_element_info().
 */
function language_element_info() {
  $types['language_configuration'] = array(
    '#input' => TRUE,
    '#tree' => TRUE,
    '#process' => array('language_configuration_element_process'),
  );
  return $types;
}

/**
 * Returns the default options for the language configuration form element.
 *
 * @return array
 *   An array containing the default options.
 */
function language_configuration_element_default_options() {
  $language_options = array();

250
  $languages = language_list(Language::STATE_ALL);
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
  foreach ($languages as $langcode => $language) {
    $language_options[$langcode] = $language->locked ? t('- @name -', array('@name' => $language->name)) : $language->name;
  }

  $language_options += array(
    'site_default' => t("Site's default language (!language)", array('!language' => language_default()->name)),
    'current_interface' => t('Current interface language'),
    'authors_default' => t("Author's preferred language"),
  );
  return $language_options;
}

/**
 * Process handler for the language_configuration form element.
 */
function language_configuration_element_process($element, &$form_state, &$form) {
  $options = isset($element['#options']) ? $element['#options'] : array();
  // Avoid validation failure since we are moving the '#options' key in the
  // nested 'language' select element.
  unset($element['#options']);
  $element['langcode'] = array(
    '#type' => 'select',
    '#title' => t('Default language'),
    '#options' => $options + language_configuration_element_default_options(),
    '#description' => t('Explanation of the language options is found on the <a href="@languages_list_page">languages list page</a>.', array('@languages_list_page' => url('admin/config/regional/language'))),
    '#default_value' => isset($element['#default_value']['langcode']) ? $element['#default_value']['langcode'] : NULL,
  );

279
  $element['language_show'] = array(
280
    '#type' => 'checkbox',
281
282
    '#title' => t('Show language selector on create and edit pages'),
    '#default_value' => isset($element['#default_value']['language_show']) ? $element['#default_value']['language_show'] : NULL,
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
  );

  // Add the entity type and bundle information to the form if they are set.
  // They will be used, in the submit handler, to generate the names of the
  // variables that will store the settings and are a way to uniquely identify
  // the entity.
  if (!isset($form_state['language'])) {
    $form_state['language'] = array();
  }
  $form_state['language'] += array(
    $element['#name'] => array(
      'entity_type' => $element['#entity_information']['entity_type'],
      'bundle' => $element['#entity_information']['bundle'],
    ),
  );

299
300
301
302
303
304
305
306
307
308
309
310
  // Do not add the submit callback for the language content settings page,
  // which is handled separately.
  if (array_search('language_content_settings_form_submit', $form['#submit']) === FALSE) {
    // Determine where to attach the language_configuration element submit handler.
    // @todo Form API: Allow form widgets/sections to declare #submit handlers.
    if (isset($form['actions']['submit']['#submit']) && array_search('language_configuration_element_submit', $form['actions']['submit']['#submit']) === FALSE) {
      $form['actions']['submit']['#submit'][] = 'language_configuration_element_submit';
    }
    elseif (array_search('language_configuration_element_submit', $form['#submit']) === FALSE) {
      $form['#submit'][] = 'language_configuration_element_submit';
    }
  }
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
  return $element;
}

/**
 * Submit handler for the forms that have a language_configuration element.
 */
function language_configuration_element_submit(&$form, &$form_state) {
  // Iterate through all the language_configuration elements and save their
  // values.
  if (isset($form_state['language'])) {
    foreach ($form_state['language'] as $element_name => $values) {
      language_save_default_configuration($values['entity_type'], $values['bundle'],  $form_state['values'][$element_name]);
    }
  }
}

/**
 * Saves a language configuration that is attached to an entity type and bundle.
 *
 * @param string $entity_type
 *   A string representing the entity type.
 * @param string $bundle
 *   A string representing the bundle.
 * @param array $values
 *   An array holding the values to be saved having the following keys:
 *   - langcode: the language code.
337
 *   - language_show: if the language element should be hidden or not.
338
339
 */
function language_save_default_configuration($entity_type, $bundle, $values = array()) {
340
  \Drupal::config('language.settings')->set(language_get_default_configuration_settings_key($entity_type, $bundle), array('langcode' => $values['langcode'], 'language_show' => $values['language_show']))->save();
341
342
343
344
345
346
347
348
349
350
351
352
353
}

/**
 * Returns the language configuration stored for an entity type and bundle.
 *
 * @param string $entity_type
 *   A string representing the entity type.
 * @param string $bundle
 *   A string representing the bundle.
 *
 * @return array
 *   An array with the following keys:
 *   - langcode: the language code.
354
 *   - language_show: if the language element is hidden or not.
355
356
 */
function language_get_default_configuration($entity_type, $bundle) {
357
  $configuration = \Drupal::config('language.settings')->get(language_get_default_configuration_settings_key($entity_type, $bundle));
358
359
360
  if (is_null($configuration)) {
    $configuration = array();
  }
361
  $configuration += array('langcode' => 'site_default', 'language_show' => FALSE);
362
363
364
365
366
367
368
369
370
371
372
373
  return $configuration;
}

/**
 * Clears the default language configuration for an entity type and bundle.
 *
 * @param string $entity_type
 *   A string representing the entity type.
 * @param string $bundle
 *   A string representing the bundle.
 */
function language_clear_default_configuration($entity_type, $bundle) {
374
  \Drupal::config('language.settings')->clear(language_get_default_configuration_settings_key($entity_type, $bundle))->save();
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
}

/**
 * Returns the root name of the variables used to store the configuration.
 *
 * Based on the entity type and bundle, the variables used to store the
 * configuration will have a common root name.
 *
 * @param string $entity_type
 *   A string representing the entity type.
 * @param string $bundle
 *   A string representing the bundle.
 *
 * @return string
 *   The root name of the variables.
 */
function language_get_default_configuration_settings_key($entity_type, $bundle) {
  // Replace all the characters that are not letters, numbers or "_" with "_".
  $entity_type = preg_replace('/[^0-9a-zA-Z_]/', "_", $entity_type);
  $bundle = preg_replace('/[^0-9a-zA-Z_]/', "_", $bundle);
  return $entity_type . '.' . $bundle . '.language.default_configuration';
}

/**
 * Implements hook_node_type_update().
 */
401
402
403
404
function language_node_type_update(NodeTypeInterface $type) {
  if ($type->original->id() != $type->id()) {
    language_save_default_configuration('node', $type->id(), language_get_default_configuration('node', $type->original->id()));
    language_clear_default_configuration('node', $type->original->id());
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
  }
}

/**
 * Returns the default language code assigned to an entity type and a bundle.
 *
 * @param string $entity_type
 *   The entity type.
 * @param string $bundle
 *   The bundle name.
 *
 * @return string
 *   The language code.
 */
function language_get_default_langcode($entity_type, $bundle) {
  $configuration = language_get_default_configuration($entity_type, $bundle);

  if (!isset($configuration['langcode'])) {
    $configuration['langcode'] = 'site_default';
  }

  $default_value = NULL;
427
  $language_interface = language(Language::TYPE_INTERFACE);
428
429
  switch ($configuration['langcode']) {
    case 'site_default':
430
      $default_value = language_default()->id;
431
432
433
      break;

    case 'current_interface':
434
      $default_value = $language_interface->id;
435
436
437
438
      break;

    case 'authors_default':
      global $user;
439
440
441
      $language_code = $user->getPreferredLangcode();
      if (!empty($language_code)) {
        $default_value = $language_code;
442
443
      }
      else {
444
        $default_value = $language_interface->id;
445
446
447
448
449
450
451
452
453
454
455
456
      }
      break;
  }
  if ($default_value) {
    return $default_value;
  }

  // If we still do not have a default value, just return the value stored in
  // the configuration; it has to be an actual language code.
  return $configuration['langcode'];
}

457
458
459
460
/**
 * API function to add or update a language.
 *
 * @param $language
461
462
 *   Language object with properties corresponding to the 'language'
 *   configuration properties.
463
464
 */
function language_save($language) {
465
466
467
468
469
470
471
  $language_entity = entity_load('language_entity', $language->id);
  if (!$language_entity) {
    $language_entity = entity_create('language_entity', array(
      'id' => $language->id,
    ));
  }
  $language->is_new = $language_entity->isNew();
472
473

  // Let other modules modify $language before saved.
474
  \Drupal::moduleHandler()->invokeAll('language_presave', array($language));
475

476
477
478
479
480
481
  // Assign language properties to language entity.
  $language_entity->label = isset($language->name) ? $language->name : '';
  $language_entity->direction = isset($language->direction) ? $language->direction : '0';
  $language_entity->locked = isset($language->locked) ? $language->locked : '0';
  $language_entity->weight = isset($language->weight) ? $language->weight : '0';

482
  // Save the record and inform others about the change.
483
484
  $language_entity->save();
  $t_args = array('%language' => $language->name, '%langcode' => $language->id);
485
  if ($language->is_new) {
486
    \Drupal::moduleHandler()->invokeAll('language_insert', array($language));
487
488
489
    watchdog('language', 'The %language (%langcode) language has been created.', $t_args);
  }
  else {
490
    \Drupal::moduleHandler()->invokeAll('language_update', array($language));
491
492
493
494
495
    watchdog('language', 'The %language (%langcode) language has been updated.', $t_args);
  }

  if (!empty($language->default)) {
    // Set the new version of this language as default in a variable.
496
    variable_set('language_default', (array) $language);
497
498
  }

499
500
501
  // Kill the static cache in language_list().
  drupal_static_reset('language_list');

502
  // Update language count based on unlocked language count.
503
  language_update_count();
504

505
506
507
  // Update weight of locked system languages.
  language_update_locked_weights();

508
509
  language_negotiation_include();

510
511
512
513
  // Update URL Prefixes for all languages after the new default language is
  // propagated and the language_list() cache is flushed.
  language_negotiation_url_prefixes_update();

514
515
516
  return $language;
}

517
/**
518
 * Updates the language_count state.
519
520
521
522
523
524
 *
 * This is used to check if a site is multilingual or not.
 *
 * @see language_multilingual()
 */
function language_update_count() {
525
526
527
528
529
530
  $count = 0;
  foreach (entity_load_multiple('language_entity') as $language) {
    if (!$language->locked) {
      $count++;
    }
  }
531
  \Drupal::state()->set('language_count', $count);
532
533
}

534
535
536
537
538
/**
 * Delete a language.
 *
 * @param $langcode
 *   Language code of the language to be deleted.
539
 *
540
541
542
543
 * @return
 *   TRUE if language is successfully deleted. Otherwise FALSE.
 */
function language_delete($langcode) {
544
  $languages = language_list(Language::STATE_ALL);
545
  if (isset($languages[$langcode]) && !$languages[$langcode]->locked) {
546
547
    $language = $languages[$langcode];

548
    \Drupal::moduleHandler()->invokeAll('language_delete', array($language));
549
550

    // Remove the language.
551
    entity_delete_multiple('language_entity', array($language->id));
552

553
554
    drupal_static_reset('language_list');

555
    language_update_count();
556

557
558
559
    // Update weight of locked system languages.
    language_update_locked_weights();

560
    $t_args = array('%language' => $language->name, '%langcode' => $language->id);
561
562
563
564
565
    watchdog('language', 'The %language (%langcode) language has been removed.', $t_args);
    return TRUE;
  }
  return FALSE;
}
566

567
568
569
570
571
572
/**
 * Implements hook_library_info().
 */
function language_library_info() {
  $libraries['language.admin'] = array(
    'title' => 'Language detection admin',
573
    'version' => \Drupal::VERSION,
574
575
576
577
578
579
580
581
582
583
584
585
586
    'js' => array(
      drupal_get_path('module', 'language') . '/language.admin.js' => array(),
    ),
    'dependencies' => array(
      array('system', 'jquery'),
      array('system', 'drupal'),
      array('system', 'jquery.once'),
    ),
  );

  return $libraries;
}

587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
/**
 * Implements hook_language_types_info().
 *
 * Defines the three core language types:
 * - Interface language is the only configurable language type in core. It is
 *   used by t() as the default language if none is specified.
 * - Content language is by default non-configurable and inherits the interface
 *   language negotiated value. It is used by the Field API to determine the
 *   display language for fields if no explicit value is specified.
 * - URL language is by default non-configurable and is determined through the
 *   URL language negotiation method or the URL fallback language negotiation
 *   method if no language can be detected. It is used by l() as the default
 *   language if none is specified.
 */
function language_language_types_info() {
  language_negotiation_include();

  return array(
605
    Language::TYPE_INTERFACE => array(
606
607
      'name' => t('User interface text'),
      'description' => t('Order of language detection methods for user interface text. If a translation of user interface text is available in the detected language, it will be displayed.'),
608
      'locked' => TRUE,
609
    ),
610
    Language::TYPE_CONTENT => array(
611
612
613
      'name' => t('Content'),
      'description' => t('Order of language detection methods for content. If a version of content is available in the detected language, it will be displayed.'),
      'fixed' => array(LANGUAGE_NEGOTIATION_INTERFACE),
614
      'locked' => TRUE,
615
    ),
616
    Language::TYPE_URL => array(
617
      'fixed' => array(LANGUAGE_NEGOTIATION_URL, LANGUAGE_NEGOTIATION_URL_FALLBACK),
618
      'locked' => TRUE,
619
620
621
622
623
624
625
626
627
628
629
630
631
    ),
  );
}

/**
 * Implements hook_language_negotiation_info().
 */
function language_language_negotiation_info() {
  language_negotiation_include();
  $file = drupal_get_path('module', 'language') . '/language.negotiation.inc';

  $negotiation_info = array();
  $negotiation_info[LANGUAGE_NEGOTIATION_URL] = array(
632
    'types' => array(Language::TYPE_CONTENT, Language::TYPE_INTERFACE, Language::TYPE_URL),
633
634
635
636
637
638
639
    'callbacks' => array(
      'negotiation' => 'language_from_url',
      'language_switch' => 'language_switcher_url',
    ),
    'file' => $file,
    'weight' => -8,
    'name' => t('URL'),
640
    'description' => t('Language from the URL (Path prefix or domain).'),
641
642
643
644
645
646
647
648
649
650
651
652
    'config' => 'admin/config/regional/language/detection/url',
  );

  $negotiation_info[LANGUAGE_NEGOTIATION_SESSION] = array(
    'callbacks' => array(
      'negotiation' => 'language_from_session',
      'language_switch' => 'language_switcher_session',
      'url_rewrite' => 'language_url_rewrite_session',
    ),
    'file' => $file,
    'weight' => -6,
    'name' => t('Session'),
653
    'description' => t('Language from a request/session parameter.'),
654
655
656
657
658
659
660
    'config' => 'admin/config/regional/language/detection/session',
  );

  $negotiation_info[LANGUAGE_NEGOTIATION_USER] = array(
    'callbacks' => array('negotiation' => 'language_from_user'),
    'file' => $file,
    'weight' => -4,
661
662
    'name' => t('Account preference for site'),
    'description' => t("The language setting for the site in the user's account."),
663
664
665
666
667
668
669
670
  );

  $negotiation_info[LANGUAGE_NEGOTIATION_BROWSER] = array(
    'callbacks' => array('negotiation' => 'language_from_browser'),
    'file' => $file,
    'weight' => -2,
    'cache' => 0,
    'name' => t('Browser'),
671
    'description' => t("Language from the browser's language settings."),
672
    'config' => 'admin/config/regional/language/detection/browser',
673
674
675
  );

  $negotiation_info[LANGUAGE_NEGOTIATION_INTERFACE] = array(
676
    'types' => array(Language::TYPE_CONTENT),
677
678
679
680
681
682
683
684
    'callbacks' => array('negotiation' => 'language_from_interface'),
    'file' => $file,
    'weight' => 8,
    'name' => t('Interface'),
    'description' => t('Use the detected interface language.'),
  );

  $negotiation_info[LANGUAGE_NEGOTIATION_URL_FALLBACK] = array(
685
    'types' => array(Language::TYPE_URL),
686
687
688
689
690
691
692
    'callbacks' => array('negotiation' => 'language_url_fallback'),
    'file' => $file,
    'weight' => 8,
    'name' => t('URL fallback'),
    'description' => t('Use an already detected language for URLs if none is found.'),
  );

693
  $negotiation_info[LANGUAGE_NEGOTIATION_USER_ADMIN] = array(
694
    'types' => array(Language::TYPE_INTERFACE),
695
696
697
    'callbacks' => array('negotiation' => 'language_from_user_admin'),
    'file' => $file,
    'weight' => 10,
698
699
    'name' => t('Account preference for administration pages'),
    'description' => t("The language setting for account administration pages in the user's account."),
700
701
  );

702
703
704
705
706
707
708
709
  return $negotiation_info;
}

/**
 * Include negotiation backend functionality.
 */
function language_negotiation_include() {
  include_once DRUPAL_ROOT . '/core/includes/language.inc';
710
  include_once __DIR__ . '/language.negotiation.inc';
711
712
713
}

/**
714
 * Implements hook_modules_installed().
715
 */
716
function language_modules_installed($modules) {
717
718
719
  include_once DRUPAL_ROOT . '/core/includes/language.inc';
  // Load configurability options from configuration.
  language_types_set(array());
720
721
722
723
  language_negotiation_purge();
}

/**
724
 * Implements hook_modules_uninstalled().
725
 */
726
727
function language_modules_uninstalled($modules) {
  language_modules_installed($modules);
728
729
730
731
732
733
}

/**
 * Implements hook_language_insert().
 */
function language_language_insert($language) {
734
735
736
737
  if (!empty($language->locked)) {
    return;
  }

738
739
740
741
  language_negotiation_include();

  // Add language to the list of language domains.
  $domains = language_negotiation_url_domains();
742
  $domains[$language->id] = '';
743
744
745
746
747
748
749
750
751
752
753
  language_negotiation_url_domains_save($domains);
}

/**
 * Implements hook_language_delete().
 */
function language_language_delete($language) {
  language_negotiation_include();

  // Remove language from language prefix list.
  $prefixes = language_negotiation_url_prefixes();
754
  unset($prefixes[$language->id]);
755
756
757
758
  language_negotiation_url_prefixes_save($prefixes);

  // Remove language from language domain list.
  $domains = language_negotiation_url_domains();
759
  unset($domains[$language->id]);
760
761
762
763
  language_negotiation_url_domains_save($domains);
}

/**
764
 * Implements hook_preprocess_HOOK() for block.html.twig.
765
766
 */
function language_preprocess_block(&$variables) {
767
  if ($variables['configuration']['module'] == 'language') {
768
    $variables['attributes']['role'] = 'navigation';
769
770
771
  }
}

772
773
774
775
776
777
778
779
/**
 * Returns language mappings between browser and Drupal language codes.
 *
 * @return array
 *   An array containing browser language codes as keys with corresponding
 *   Drupal language codes as values.
 */
function language_get_browser_drupal_langcode_mappings() {
780
  $config = \Drupal::config('language.mappings');
781
782
783
784
785
786
787
788
789
790
791
792
793
794
  if ($config->isNew()) {
    return array();
  }
  return $config->get();
}

/**
 * Stores language mappings between browser and Drupal language codes.
 *
 * @param array $mappings
 *   An array containing browser language codes as keys with corresponding
 *   Drupal language codes as values.
 */
function language_set_browser_drupal_langcode_mappings($mappings) {
795
  $config = \Drupal::config('language.mappings');
796
797
798
  $config->setData($mappings);
  $config->save();
}
799
800
801
802
803

/**
 * Updates locked system language weights.
 */
function language_update_locked_weights() {
804
805
  $max_weight = 0;

806
  // Get maximum weight to update the system languages to keep them on bottom.
807
808
809
810
811
812
  foreach (language_list(Language::STATE_CONFIGURABLE) as $language) {
    if (!$language->locked && $language->weight > $max_weight) {
      $max_weight = $language->weight;
    }
  }

813
  // Loop locked languages to maintain the existing order.
814
  foreach (language_list(Language::STATE_LOCKED) as $language) {
815
816
    $max_weight++;
    // Update system languages weight.
817
    \Drupal::config('language.entity.' . $language->id)
818
819
      ->set('weight', $max_weight)
      ->save();
820
821
  }
}
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836

/**
 * Implements hook_form_FORM_ID_alter for system_regional_settings().
 *
 * @see language_system_regional_settings_form_submit()
 */
function language_form_system_regional_settings_alter(&$form, &$form_state) {
  $languages = language_list();
  $default = language_default();
  foreach ($languages as $key => $language) {
    $language_options[$key] = $language->name;
  }
  $form['locale']['site_default_language'] = array(
    '#type' => 'select',
    '#title' => t('Default language'),
837
    '#default_value' => $default->id,
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
    '#options' => $language_options,
    '#description' => t('It is not recommended to change the default language on a working site. <a href="@language-detection">Configure the Selected language</a> setting on the detection and selection page to change the fallback language for language selection.', array('@language-detection' => url('admin/config/regional/language/detection'))),
    '#weight' => -1,
  );
  // Add submit handler to save default language.
  $form['#submit'][] = 'language_system_regional_settings_form_submit';
}

/**
 * Form submission handler for system_regional_settings().
 *
 * @see language_form_system_regional_settings_alter()
 */
function language_system_regional_settings_form_submit($form, &$form_state) {
  $languages = language_list();
  $language = $languages[$form_state['values']['site_default_language']];
  $language->default = TRUE;
  language_save($language);
}