Session held at Drupal MountainCamp 2017, Davos, Switzerland. February 17th 2017 https://drupalmountaincamp.ch/sessions/drupal-8s-multilingual-apis-building-entire-world Are you interested in writing contributed modules, themes or distributions for Drupal 8? Then this is the session for you. In this session, we'll look at the most important APIs you would use to integrate with and best practices to use to ensure that your project is fully multilingual-ready. This session will be valuable to all contributors even those whose projects are not inherently multilingual. Even if your project is not immediately intended to be multilingual, having a multilingual-capable module, theme or distribution makes your solution appealing to a much broader audience and is likely to provide value to global users. Drupal 8 is a great platform to work with not only because it is so multilingual capable out-of-the-box, but also because you can easily expand while maintaining the translatability of your data. Drupal 8’s multilingual core offers a robust multilingual foundation, making the integration process much more seamless. The majority of Drupal 8's APIs are designed to support multilingual by default and make sane assumptions about common scenarios. As a result, there are several important things to keep in mind to build the best integration possible. In this session, we will walk through: Working with language APIs, and the language your data is in. Making your output strings translatable: t() and its friends, but also in twig templates Why you should and how to code translatable content entities. Customizing your field properties translatability so site builders can choose. Configuration translation: translating your configuration entities INTENDED AUDIENCE Drupal developers working with contrib or custom modules that are designed for multilingual or non-English sites would benefit from this session (that means nearly every Drupal developer out there). Drupal themers intending to make their theme templates translation ready. Attendees will walk away with knowledge to add Drupal 8 multilingual support to your modules, themes and distributions. SKILL LEVELS This session is suitable for beginners or intermediate Drupal users. It is best if you come to the session with some exposure to OOP, Drupal 8 code and twig templates, but even if you don’t have that foundation I’m sure you can catch up.

1. DRUPAL 8'S MULTILINGUAL APIS:
BUILDING FOR THE ENTIRE
WORLD

2. penyaskito
Christian López Espínola
Drupal 8 Multilingual
Initiative contributor

5. Drupal 7 MULTILINGUAL

6. Drupal
CORE
Drupal 7 MULTILINGUAL

7. Drupal
CORE
LOCALE
Drupal 7 MULTILINGUAL

8. Drupal
CORE
L10n UP
LOCALE
m
Drupal 7 MULTILINGUAL

9. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
Ü
m
Drupal 7 MULTILINGUAL

10. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
I18N
Ü
m
Drupal 7 MULTILINGUAL

11. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
I18N
VARIABLE
Ü
m
Drupal 7 MULTILINGUAL

12. Drupal
CORE
L10n UP
CONTENT
TRANSLATION
LOCALE
I18N
VARIABLE
Entity
translation
Ü
m
Drupal 7 MULTILINGUAL

13. Four pillars in Drupal 8

14. LANGUAGE
Base services for all
modules dealing
with data. Not just
multilingual.
Four pillars in Drupal 8

15. 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

16. 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

17. 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

18. LANGUAGE INTERFACE CONTENT CONFIG
(8 é
Four pillars in Drupal 8

19. DEALING WITH LANGUAGE
Drupal:languageManager()
LanguageManager

20. DEALING WITH LANGUAGE
Drupal:languageManager()
LanguageManagerConfigurableLanguageManager
With language
module enabled

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

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

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

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

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

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

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

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

29. LANGUAGE INTERFACE CONTENT CONFIG
(8 é
Four pillars in Drupal 8

30. INTERFACE LANGUAGE

31. INTERFACE LANGUAGE
t(‘English text’)

32. INTERFACE LANGUAGE

33. DEPENDENCY INJECTION
LOGIC
TRANSLATION
CONFIGURATION
USER

34. DEPENDENCY INJECTION
LOGIC
TRANSLATION
CONFIGURATION
USER

35. INTERFACE LANGUAGE
t(‘English text’)

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

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

38. INTERFACE LANGUAGE

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

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

41. Javascript api
Drupal.t(…)
Drupal.formatPlural()

42. TWIG TEMPLATES
<input {{ attributes }}
placeholder="{{ 'Search'|trans }}" />
INPUT--SEARCH.HTML.TWIG
<div{{ author_attributes }}>
{% trans %}
Submitted by {{ author_name }} on {{ date }}
{% endtrans %}
</div>
NODE.HTML.TWIG

43. 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

44. 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

45. LANGUAGE INTERFACE CONTENT CONFIG
(8 é
Four pillars in Drupal 8
English to X

46. Node.php (Snippet)
/**
* Defines the node entity class.
*
* @ContentEntityType(
* id = "node",
* label = @Translation(“Content"),
* translatable = TRUE,
* entity_keys = {
* "id" = "nid",
* "label" = "title",
* "langcode" = "langcode",
* }
* )

47. contententitybase.php
(Snippet)
function baseFieldDefinitions($entity_type) {
// …
if ($entity_type->hasKey('langcode')) {
$fields[$entity_type->getKey('langcode')] =
BaseFieldDefinition::create('language')
->setLabel(new TranslatableMarkup('Language'))
->setDisplayOptions('view', [
'type' => 'hidden',
])
}
}

48. Node.php (Snippet)
function baseFieldDefinitions($entity_type) {
$fields = parent::baseFieldDefinitions($entity_type);
// …
$fields['title'] = BaseFieldDefinition::create('string')
->setLabel(t('Title'))
->setRequired(TRUE)
->setTranslatable(TRUE);
}

49. FIELDS THEMSELVES

50. FIELDS THEMSELVES
AUTOMATED!

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

52. Entity language API
$node = Node::load(42);
$node = $node
->getTranslation(‘hu’);
$node = $entityRepository
->getTranslationFromContext($node);

53. Entity language API
$node->getUntranslated()
$node->language()
$node->getTranslationLanguages()
$node->hasTranslation(‘hu’)
$node->addTranslation(‘hu’)
$node->removeTranslation(‘hu’)

54. Views ALL the things

55. LANGUAGE INTERFACE CONTENT CONFIG
(8 é
Four pillars in Drupal 8
English to X X to Y
Intelligent
objects

56. config/install/system.maintenance.yml
message: '@site is currently under
maintenance. We should be back
shortly. Thank you for your
patience.'
langcode: en

57. Core.data_types.schema.yml
config_object:
type: mapping
mapping:
langcode:
type: string
label: 'Language code'
…
text:
type: string
label: 'Text'
translatable: true

58. config/schema/system.schema.yml
system.maintenance:
type: config_object
label: 'Maintenance mode'
mapping:
message:
type: text
label: 'Message to display…’
LANGCODE
TRANSLATABLE
STRING

59. system.maintenance.yml
message: '@site is currently under
maintenance. We should be back
shortly. Thank you for your
patience.'
langcode: en

60. 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

61. 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…’

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
message: '@site karbantartás alatt
áll…’
LANGUAGES/IT/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…’
LANGUAGES/IT/SYSTEM.…YML
message: '@site …’

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

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

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

67. 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

68. LANGUAGE INTERFACE CONTENT CONFIG
(8 é
Four pillars in Drupal 8
English to X X to Y
Intelligent
objects
X to Y
Dumb
arrays

71. Gábor hojtsy
Gábor Hojtsy
Drupal 8 Multilingual
Initiative lead

72. CONTRIBUTION SPRINTS
DOWNSTAIRS
:-)

74. DRUPAL 8'S MULTILINGUAL APIS:
BUILDING FOR THE ENTIRE
WORLD