Валентин Мацвейко та Владислав Мойсеєнко — D8: Migrate Yourself: code->module->mind
Download as PPTX, PDF0 likes160 views
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, and integrating modules with Views.
![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']);](https://image.slidesharecdn.com/valentinematsveiko-160907081253/85/D8-Migrate-Yourself-code-module-mind-21-320.jpg)
![Routing
src/Controller/ExampleController.php:
class ExampleController extends ControllerBase {
/**
* {@inheritdoc}
*/
public function content() {
return ['#type' => 'markup', '#markup' => t('Hello World!')];
}
}](https://image.slidesharecdn.com/valentinematsveiko-160907081253/85/D8-Migrate-Yourself-code-module-mind-28-320.jpg)
![Routing
src/Controller/ExampleController.php:
class ExampleController extends ControllerBase {
/**
* {@inheritdoc}
*/
public function content($my_arg) {
return ['#type' => 'markup', '#markup' => $my_arg];
}
}](https://image.slidesharecdn.com/valentinematsveiko-160907081253/85/D8-Migrate-Yourself-code-module-mind-30-320.jpg)
![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.](https://image.slidesharecdn.com/valentinematsveiko-160907081253/85/D8-Migrate-Yourself-code-module-mind-42-320.jpg)
Валентин Мацвейко та Владислав Мойсеєнко — D8: Migrate Yourself: code->module->mind
- 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]; } }
- 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);
- 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
- 54. Any questions?
- 55. Thanks!