This document provides an overview of key concepts in Drupal 8 including common framework subsystems, routing, the form API, libraries, and multilingual configuration. It also encourages migrating Drupal 7 modules to Drupal 8 and leveraging object-oriented programming practices and dependency injection. Developers are directed to documentation and examples for implementing routing, forms, plugins, entities and more according to Drupal 8 standards.

2. Intro
is a web framework

3. Common Framework subsystems
Security
- Auth
- ACL
- ?
Database
- PDO
- ORM
- Migrations
- ?
Routing
AJAX/J
Web servises/resources
View

4. Ready… Steady… Migrate!
Migrate yourself!

5. Migrate yourself!: Porting a module guide
STEP #1
Rename my_module.info -> me_module.info.yml
AND…

6. Migrate yourself!: Porting a module guide
That’s all!
Congrats, you’re ported a module
lets make an adoptations now)))

7. Migrate yourself!: src / Mind
- OOP
- PSR-4
- Annotations
- Dependency Injection
- Service Containers
- Plugins
- Entities
/ CoreConcepts.php

8. Migrate yourself!: src / Mind / Annotations.php
@see core/lib/Drupal/Core/Annotation/Mail.php

9. / CoreConcepts / DependencyInjection.php
DI is implementation of
the IoC design pattern

10. NO!
YES
/ CoreConcepts / DependencyInjection.php

11. / CoreConcepts / ServiceContainers.php
@are Auto-instantiate service-oriented
actionable classes with all
registered dependencies

12. / CoreConcepts / Plugins.php
“Plugin - A discreet class that executes an
operation within the context of a given
scope, as a means to extend Drupal’s
functionality”

13. / CoreConcepts / Plugins.php
- Block
- FieldWidget
- FieldType
- Filter
- ImageEffect
- Tips
- Display
- ActionPlugin
- EntityTypePlugin
…...
USED IN:
ctools
- panels
- hybridauth
- feeds
- addressfield
fluxservice:
- own plugin system,
cfr
- own plugin system,
D8 D7

14. / CoreConcepts / Plugins.php
- Lazy loaded
- Unified code (using interfaces)
- extensible
- reusable across a projects
- each plugin type should have own
plugin manager, wasted?
PROFIT
NOTICE

15. / CoreConcepts / Plugins.php
Plugin Manager
Discovery
Factory
Mapper
STANDS ON

16. / CoreConcepts / Plugins.php
AnnotatedClassDiscovery
HookDiscovery
YamlDiscovery
StaticDiscovery
DISCOVERY

17. / CoreConcepts / Plugins.php
DEMO

18. / CoreConcepts / Entity.php
ONLY DEMO :)
2X

19. Cache API
Drupal 7 caching style?
Forget it!

20. New Cache API
Drupal 8 Cache API

21. New Cache API
Request cache_default bin:
$cache = Drupal::cache();
Request a particular bin(cache_custom):
$custom_cache = Drupal::cache('custom');
Retrieve a cached data:
$data = Drupal::cache()->get('my_value');
Save data to the cache:
$data = Drupal::cache()->set('my_value', ['some_data']);

22. New Cache API
Cache tags

23. New Cache API
Invalidate a cache items with a particular tag(s):
DrupalCoreCacheCache::invalidateTags(array('node:5', 'my_tag'));
Retrieve an existent entity’s cache tags:
● DrupalCoreEntityEntityInterface::getCacheTags()
● DrupalCoreEntityEntityTypeInterface::getListCacheTags()
Cache tags allow us to invalidate caches more smartly.

24. New Cache API
Cache contexts

25. New Cache API
Cache contexts are analogous to HTTP's Vary header.
It helps Drupal to decide whether the cached response can be
used rather than requesting a fresh one.
Contexts examples:
theme (vary by negotiated theme)
user.roles (vary by the combination of roles)
languages (vary by all language types: interface, content …)

26. Routing
Drupal 8 Routing System

27. Routing
*.routing.yml
example.content:
path: '/example'
defaults:
_controller: 'DrupalexampleControllerExampleController::content'
_title: 'Hello World'
requirements:
_permission: 'access content'
_method: 'GET'

28. Routing
src/Controller/ExampleController.php:
class ExampleController extends ControllerBase {
/**
* {@inheritdoc}
*/
public function content() {
return ['#type' => 'markup', '#markup' => t('Hello World!')];
}
}

29. Routing
Arguments inside routes:
*.routing.yml
example.content:
path: '/example/{my_arg}'
defaults:
_controller: 'DrupalexampleControllerExampleController::content'
_title: 'Hello World'
requirements:
_permission: 'access content'

30. Routing
src/Controller/ExampleController.php:
class ExampleController extends ControllerBase {
/**
* {@inheritdoc}
*/
public function content($my_arg) {
return ['#type' => 'markup', '#markup' => $my_arg];
}
}

31. Form API
Form API

32. Form API
New Form(s) implementation
workflow

33. Form API
DrupalCoreFormFormInterface
- everything what you usually need!
- getFormId() - specify Form ID
- buildForm() - build form array
- validateForm() - form validation handler
- submitForm() - form submit handler

34. Form API
New HTML 5 elements:
● '#type' => 'tel'
● '#type' => 'email'
● '#type' => 'number'
● '#type' => 'date'
● '#type' => 'url'
● '#type' => 'search'
● '#type' => 'range'
● etc.

35. Form API
Not enought? - Create your own!

36. Form API
Integrate the form in a request:
mymodule.test_form:
path: 'mymodule/test_form'
defaults:
_form: 'DrupalmymoduleFormsExampleForm'
_title: 'Test form'
requirements:
_permission: 'access content'

37. Form API
Retrieving the form outside of routes:
$form = Drupal::formBuilder()
->getForm('DrupalexampleFormExampleForm');

38. Form API
Forms altering...doesn’t really changed

39. Form API
Rendering forms programmatically:
// Retrieve a form array.
$form = Drupal::formBuilder()
->getForm('DrupalexampleFormExampleForm');
// Render it.
$rendered_form = Drupal::service('renderer')
->render($form);

40. Libraries
Libraries

41. Libraries
*.libraries.yml:
my_library:
version: 1.x
css:
theme:
css/styles.css: {}
js:
js/script.js: {}
dependencies:
- core/drupal

42. Libraries
Attaching libraries:
function mymodule_element_info_alter(array &$types) {
$types['table']['#attached']['library'][] = 'mymodule/my_library';
}
Note: Can be attached to any render-able array.

43. Libraries
Twig attach libraries:
{{ attach_library('mymodule/my_library') }}
<div>Some markup {{ message }}</div>

44. Libraries
Disable aggregation:
my_library:
version: 1.x
css:
theme:
css/style.css: {preprocess: false}
js:
js/script.js: {preprocess: false}

45. Libraries
CDN/externally hosted libraries:
angular.angularjs:
remote: https://github.com/angular/angular.js
version: 1.4.4
js:
https://ajax.googleapis.com/ajax/libs/angularjs/1.4.4/angular.min.js: {
type: external, minified: true }

46. Libraries
Inline JavaScript is highly discouraged!

47. Migrate yourself!: src / Module / Multilingual / ConfigVariables.php

48. Migrate yourself!: src / Module / Multilingual / ConfigVariables.php
STEP #1 add variables with text, string type to the
root of config_object var inside a
my_module.schema.yml
WARNING: works only with first level depth text-based elements
in the config_object

49. Migrate yourself!: src / Module / Multilingual / ConfigVariables.php
STEP #2 add default local task, my_module.links.task.yml

50. Migrate yourself!: src / Module / Multilingual / ConfigVariables.php
STEP #3 make config_object translateable
my_module.config_translation.yml

51. Migrate yourself!: src / Module / ViewsIntegration / CustomTable.php
@see core/modules/tracker/tracker.views.inc

52. Dev Tools
Don’t forget about a new Dev tools:
● Drupal console
● Kint
● REPL
● Webprofiler

53. Conclusion
is awesome!

54. Any questions?

55. Thanks!