Improve Plugin API doc

Created on 6 April 2013, about 11 years ago

Updated 2 December 2023, 7 months ago

I would like to suggest some improvements to the Plugin documentation.
I'm a Drupal (6 and 7) trainer and will have to face students questions when I teach. I'm preparing D8 workshops.

First, I think it would be useful to distinguish between using plugins, and defining new plugins in order not to confuse those who are not already familiar with plugins.

Next, It seem's to me that "hooks" are already a mecanism to extend Drupal, and so, plugins competes with hooks in the mind of the student. It would be important to explain in what case we use hooks, and in what case we use plugins. Will some day all the hooks be converted to plugins ? what is the process to decide if a set of hooks become a plugin or not ? will hooks still exists but be reserved for "deeper API" (plugin would be more important for new comers than hooks).

It seem's that hooks will disapear for Drupal 9, I'm I right ? http://drupal.org/node/1509164 and http://drupal.org/node/1331486 don't talk about plugins but EventDispatcher.
"Module/hook system functions replaced with module_handler service" confuses me even more along with "hook based plugin discovery".

📌 Task

Status

Closed: outdated

Version

9.5

Component

Plugin →

Last updated 9 days ago

Maintained by
🇺🇸United States @EclipseGc
🇺🇸United States @effulgentsia
🇺🇸United States @tim.plunkett

Created by

🇫🇷France ybabel

Live updates comments and jobs are added and updated live.

Incomplete comments

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

Comment 7 months ago →
🇳🇿New Zealand quietone New Zealand
In the 10 years since this issue was created the docs have been improved. Specifically, https://www.drupal.org/docs/drupal-apis/plugin-api/why-plugins → . There is also more information available by searching, such as:

https://drupalize.me/tutorial/what-are-plugins

https://jhodgdon.com/poplarware-articles/hooks7-to-plugins8-drupal

I am going to close this as outdated. If there are further questions, it is probably best to ask in Drupal Slack, or make a new issue.

Thanks.

contrib.social Blog FAQ Discussions

Production build 0.69.0 2024