This document discusses Drupal 8's multilingual APIs and improvements over Drupal 7. It outlines the four pillars of multilingual support in Drupal 8: language, interface translation, content translation, and configuration translation. It provides details on APIs for dealing with languages, interface translation, entity and field translation, configuration translation, and views integration. The document emphasizes that Drupal 8 provides built-in multilingual support through a unified and configurable architecture rather than separate modules.

1. Drupal 8 multilingual APIs
@gaborhojtsyGábor Hojtsy

10. DRUPAL 7 MULTILINGUAL

11. Drupal
CORE
DRUPAL 7 MULTILINGUAL

12. Drupal
CORE
LOCALE
!
DRUPAL 7 MULTILINGUAL

13. Drupal
CORE
L10n UP
LOCALE
!
m
DRUPAL 7 MULTILINGUAL

14. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
!
Ü
m
DRUPAL 7 MULTILINGUAL

15. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
I18N !
!
Ü
m
DRUPAL 7 MULTILINGUAL

16. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
I18N
VARIABLE
"
!
!
Ü
m
DRUPAL 7 MULTILINGUAL

17. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
I18N
VARIABLE
Entity
translation
#
"
!
!
Ü
m
DRUPAL 7 MULTILINGUAL

18. FOUR PILLARS IN DRUPAL 8

19. LANGUAGE
Base services for all
modules dealing
with data. Not just
multilingual.
!
FOUR PILLARS IN DRUPAL 8

20. LANGUAGE
Base services for all
modules dealing
with data. Not just
multilingual.
INTERFACE
Interface
translation has
built-in update
feature, improved
usability.
! 8
FOUR PILLARS IN DRUPAL 8

21. LANGUAGE
Base services for all
modules dealing
with data. Not just
multilingual.
INTERFACE
Interface
translation has
built-in update
feature, improved
usability.
CONTENT
Field translation in
built-in API for all
entities. Content
translation module
provides user
interface.
! 8 é
FOUR PILLARS IN DRUPAL 8

22. LANGUAGE
Base services for all
modules dealing
with data. Not just
multilingual.
INTERFACE
Interface
translation has
built-in update
feature, improved
usability.
CONTENT
Field translation in
built-in API for all
entities. Content
translation module
provides user
interface.
CONFIG
Common
configuration
system handles
blocks, views, field
settings. Unified
translation.
(! 8 é
FOUR PILLARS IN DRUPAL 8

23. LANGUAGE INTERFACE CONTENT CONFIG
(! 8 é
FOUR PILLARS IN DRUPAL 8

24. DEALING WITH LANGUAGE
Drupal:languageManager()
LanguageManager
ConfigurableLanguageManager

25. DEALING WITH LANGUAGE
->getLanguages()
UND: NOT SPECIFIED
ZXX: NOT APPLICABLE
EN: ENGLISH (DEFAULT)

26. DEALING WITH LANGUAGE
->getLanguages()
UND: NOT SPECIFIED
ZXX: NOT APPLICABLE
HU: HUNGARIAN
IT: ITALIAN

27. DEALING WITH LANGUAGE
->getLanguages()
UND: NOT SPECIFIED
ZXX: NOT APPLICABLE
HU: HUNGARIAN
IT: ITALIAN
language.entity.$langcode.yml

28. DEALING WITH LANGUAGE
->getLanguages()
UND: NOT SPECIFIED
ZXX: NOT APPLICABLE
HU: HUNGARIAN
IT: ITALIAN
language.entity.$langcode.yml
Locked

29. DEALING WITH LANGUAGE
->getLanguages()
UND: NOT SPECIFIED
ZXX: NOT APPLICABLE
HU: HUNGARIAN
IT: ITALIAN
language.entity.$langcode.yml
Locked Not locked

30. DEALING WITH LANGUAGE
ConfigurableLanguage::
createFromLangcode(‘fr’)
->save()

31. DEALING WITH LANGUAGE
ConfigurableLanguage::
load(‘fr’)->delete()

32. DEALING WITH LANGUAGE
$languageManager
->getCurrentLanguage()

33. LANGUAGE INTERFACE CONTENT CONFIG
(! 8 é
FOUR PILLARS IN DRUPAL 8

34. INTERFACE LANGUAGE

35. INTERFACE LANGUAGE
t(‘English text’)

36. INTERFACE LANGUAGE

37. DEPENDENCY INJECTION
LOGIC
TRANSLATION
CONFIGURATION
USER

38. DEPENDENCY INJECTION
LOGIC
TRANSLATION
CONFIGURATION
USER

39. INTERFACE LANGUAGE
t(‘English text’)

40. INTERFACE LANGUAGE
t(‘English text’)
$this->t(‘English text’)

41. INTERFACE LANGUAGE
class Foo {
use StringTranslationTrait;
…
}

42. INTERFACE LANGUAGE

43. INTERFACE LANGUAGE
$this->t(‘English text’)
->getOption(‘langcode’);

44. INTERFACE LANGUAGE
format_plural(…)
$this->formatPlural(…)

45. JAVASCRIPT API
Drupal.t(…)
Drupal.formatPlural()

46. LOCALE.LINKS.MENU.YML
locale.translate_page:
title: 'User interface translation'
description: 'Configure the import …’
route_name: locale.translate_page
parent: system.admin_config_regional
weight: 15
locale.translate_status:
title: 'Available translation updates'
route_name: locale.translate_status
description: 'Get a status report …’
parent: system.admin_reports

47. LOCALE.LINKS.MENU.YML
locale.translate_page:
title: 'User interface translation'
description: 'Configure the import …’
route_name: locale.translate_page
parent: system.admin_config_regional
weight: 15
locale.translate_status:
title: 'Available translation updates'
route_name: locale.translate_status
description: 'Get a status report …’
parent: system.admin_reports

48. LANGUAGE INTERFACE CONTENT CONFIG
(! 8 é
FOUR PILLARS IN DRUPAL 8
English to X

49. NODE.PHP (SNIPPET)
/**
* Defines the node entity class.
*
* @ContentEntityType(
* id = "node",
* label = @Translation(“Content"),
* translatable = TRUE,
* entity_keys = {
* "id" = "nid",
* "label" = "title",
* "langcode" = "langcode",
* }
* )

50. NODE.PHP (SNIPPET)
function baseFieldDefinitions($entity_type) {
// …
$fields['title'] =
BaseFieldDefinition::create('string')
->setLabel(t('Title'))
->setRequired(TRUE)
->setTranslatable(TRUE);
}

51. FIELDS THEMSELVES

52. FIELDS THEMSELVES
AUTOMATED!

53. MULTICOLUMN FIELD SNIPPET
* @FieldType(
* id = "image",
* column_groups = {
* "file" = {
* "label" = @Translation("File"),
* "columns" = {
* "target_id", "width", "height"
* },
* },
* "alt" = {
* "label" = @Translation("Alt"),
* "translatable" = TRUE
* },
* }

54. ENTITY LANGUAGE API
$node = Node::load(42);
$node = $node
->getTranslation(‘hu’);
$node = $entityRepository
->getTranslationFromContext($node);

55. ENTITY LANGUAGE API
$node->getUntranslated()
$node->language()
$node->getTranslationLanguages()
$node->hasTranslation(‘hu’)
$node->addTranslation(‘hu’)
$node->removeTranslation(‘hu’)

56. VIEWS ALL THE THINGS

57. LANGUAGE INTERFACE CONTENT CONFIG
(! 8 é
FOUR PILLARS IN DRUPAL 8
English to X X to Y
Intelligent
objects

58. CONFIG/INSTALL/SYSTEM.MAINTENANCE.YML
message: '@site is currently
under maintenance. We should be
back shortly. Thank you for your
patience.'
langcode: en

59. CORE.DATA_TYPES.SCHEMA.YML
config_object:
type: mapping
mapping:
langcode:
type: string
label: 'Language code'
…
text:
type: string
label: 'Text'
translatable: true

60. CONFIG/SCHEMA/SYSTEM.SCHEMA.YML
system.maintenance:
type: config_object
label: 'Maintenance mode'
mapping:
message:
type: text
label: 'Message to display…’
LANGCODE
TRANSLATABLE
STRING

61. SYSTEM.MAINTENANCE.YML
message: '@site is currently
under maintenance. We should be
back shortly. Thank you for your
patience.'
langcode: en

62. SYSTEM.MAINTENANCE.YML
message: '@site is currently
under maintenance. We should be
back shortly. Thank you for your
patience.'
langcode: en
LANGUAGES/HU/SYSTEM.…YML

63. SYSTEM.MAINTENANCE.YML
message: '@site is currently
under maintenance. We should be
back shortly. Thank you for your
patience.'
langcode: en
LANGUAGES/HU/SYSTEM.…YML
message: '@site karbantartás
alatt áll…’

64. SYSTEM.MAINTENANCE.YML
message: '@site is currently
under maintenance. We should be
back shortly. Thank you for your
patience.'
langcode: en
LANGUAGES/HU/SYSTEM.…YML
message: '@site karbantartás
alatt áll…’
LANGUAGES/IT/SYSTEM.…YML

65. SYSTEM.MAINTENANCE.YML
message: '@site is currently
under maintenance. We should be
back shortly. Thank you for your
patience.'
langcode: en
LANGUAGES/HU/SYSTEM.…YML
message: '@site karbantartás
alatt áll…’
LANGUAGES/IT/SYSTEM.…YML
message: '@site …’

66. CONFIGURATION API
$config =
Drupal::config(‘system.maintenance’);
$config->get(‘message’);

67. CONFIGURATION API
$config =
Drupal::config(‘system.maintenance’);
$config->get(‘message’);
OVERRIDES
APPLY AS
APPROPRIATE

68. CONFIGURATION API
$manager = Drupal::languageManager();
$hu = $manager->getLanguage('hu');
$original = $manager->getConfigOverrideLanguage();
$manager->setConfigOverrideLanguage($hu);
$config = Drupal::config(‘system.maintenance');
// …
$manager->setConfigOverrideLanguage($original);

69. CONFIGURATION API
Drupal::config(‘system.maintenance’);
Drupal::configFactory()-
>getEditable(‘system.maintenance’);
Drupal::languageManager()
->getLanguageConfigOverride
('hu', 'system.maintenance')
->set('message', 'Karbantartás...')
->save();
OVERRIDES
APPLY AS
APPROPRIATE
NO OVERRIDES
APPLY
THE OVERRIDE
ITSELF

70. LANGUAGE INTERFACE CONTENT CONFIG
(! 8 é
FOUR PILLARS IN DRUPAL 8
English to X X to Y
Intelligent
objects
X to Y
Dumb
arrays

71. TEXT
www.drupalaton.hu @drupalaton

74. @gaborhojtsy