Dev days Szeged 2014: Plugin system in drupal 8
- 1. Drupal 8 plugin system aspilicious!
- 2. About me â˘âŻ Bram Goffings @aspilicious â˘âŻ Drupal developer â˘âŻ Work for Nascom www.nascom.be â˘âŻ Maintainer of Display Suite â˘âŻ Drupal 8 core contributor
- 3. Target audience â˘âŻ Site builders & module developers â˘âŻ Experience with module development â˘âŻ Understanding of the hook system â˘âŻ Know how to handle object oriented code
- 4. Success? â˘âŻ Nobody is scared anymore â˘âŻ Everyone can make a *basic* plugin type
- 5. Not the expert â˘âŻ Iâm an end user, just like you â˘âŻ Learned by trying (and failing) â˘âŻ I can say stupid things
- 6. Drupal developer â˘âŻ Mr. Steven â˘âŻ Brave drupal 7 expert â˘âŻ Made his first Drupal 8 site â˘âŻ Wants to build a plugin system
- 7. Client â˘âŻ Mr. Arnold â˘âŻ Rich webmaster â˘âŻ Loves cars
- 8. â˘âŻ I want to choose my favorite car on my profile from a predefined list. â˘âŻ It should be possible to plug in different cars into the list. â˘âŻ The name and an image of the selected car should placed on the homepage.
- 9. I take the jobâŚ
- 10. Step 1 I want to choose my favorite car on my profile from a predefined list.
- 12. Stevenâs plan â˘âŻ Add a âCar selectorâ field â˘âŻ Create a custom select widget
- 13. The drupal 7 way â˘âŻ Implements hook_field_widget_info() â˘âŻ Implements hook_field_widget_form()
- 14. Those hooks are gone!
- 16. What is a plugin? Plugins are small pieces of functionality that are swappable. Plugins that perform similar functionality are of the same plugin type.
- 17. Field widget plugins! â˘âŻ There is a âwidgetâ plugin type! â˘âŻ Each ďŹeld widget is from that type!
- 18. Structure
- 23. Namespaces â˘âŻ Namespaces were introduced in PHP 5.3 â˘âŻ Used to avoid name collisions
- 24. PSR-0 â˘âŻ Aims to provide a standard file, class and namespace convention to allow plug-and-play code. â˘âŻ Uses the defined namespaces to automatically load files when needed. â˘âŻ One on one mapping between namespaces and directory structure.
- 26. Structure
- 27. PSR-4 â˘âŻ âNew standardâ â˘âŻ Makes alternative mapping possible â˘âŻ Drupal will use it to remove âunneededâ folders. The empty *drupal* and *module-name* folder wonât be needed anymore.
- 28. Letâs recap â˘âŻ We know how to find plugins â˘âŻ We understand namespaces and the directory structure â˘âŻ We understand PSR-0 and the difference between PSR-4
- 29. SelectWidget.php
- 32. car.info.yml
- 34. Step 1: done
- 36. Letâs recap â˘âŻ We know how to start with writing a field widget plugin â˘âŻ We know how to start writing a custom module
- 37. Step 2 It should be possible to plug in different cars into the list.
- 38. Stevenâs plan â˘âŻ Create a custom plugin type named âCarâ â˘âŻ Create two sample car plugins
- 39. Custom plugin type â˘âŻ Create a plugin manager service record â˘âŻ Create an annotation class â˘âŻ Create the plugin manager class
- 41. car.services.yml
- 44. Car module structure (part 2)
- 45. Sample plugins
- 46. Sample plugins
- 47. getOptions() v2
- 48. Debug output
- 49. Car module structure (part 3)
- 50. Letâs recap â˘âŻ We know how to write a basic plugin manager â˘âŻ We know how to handle annotations â˘âŻ We know how to get all the plugin definitions
- 51. Disadvantage Each car requires a plugin
- 52. Derivative â˘âŻ Allows you to create multiple plugin definitions through a single plugin class.
- 53. Derivative example! â˘âŻ Create a yml ďŹle containing cars! â˘âŻ Create a derivative plugin! â˘âŻ Create a deďŹnition for each car in the yml ďŹle!
- 54. cars-example.yml
- 55. YamlCar.php
- 57. Step 2: done
- 59. Letâs recap â˘âŻ We know when to use derivatives â˘âŻ We are able to build one
- 60. Step 3 The name and an image of the selected car should placed on the homepage.
- 61. Stevenâs plan â˘âŻ Add a function to the plugins that returns an image url â˘âŻ Create the frontpage
- 68. car.routing.yml
- 72. Car module structure (part 4)
- 73. Letâs recap â˘âŻ We figured out how to add a function to a plugin â˘âŻ We know how to create a plugin instance â˘âŻ We saw how we should create our routes â˘âŻ We learned how to build a page controller
- 74. The end
- 75. Questions?
- 76. THANK YOU!