-
-
Notifications
You must be signed in to change notification settings - Fork 62
Tutorial: Notifications #190
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great work so far
Loads of proof reading and re-wording
| ============================ | ||
| The first thing is to determine a name for the type of notification we will create. | ||
| For the purposes of this tutorial we will name it ''sample''. All extensions should always | ||
| use their vendor and name as prefixes, so the notification type name we'll be using is: ``vendor.extension.notification.type.sample``. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe use acme.demo as name like in https://area51.phpbb.com/docs/dev/3.1.x/extensions/tutorial_key_concepts.html
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As far as I am aware, we are trying to move away from acme/demo to vendor/extension. So it's truly clear what is being meant, cause while most of us might know that acme is used as a 'fictional extension writer', it isn't really clear for everyone. While it should be 'obvious to anyone looking at it, even for the first time'.
Perhaps @VSEphpbb can way in.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't like using acme demo. It's been my experience some people don't know what the heck we're talking about when we use it.
This is a tutorial for the extensions documentation.
Might become a bit large, but that is to cover all bases.
As I've seen quite a few questions in regards to notifications; creating a notification type and how to manage (send, update, mark, delete) them. And I've lately also seen a few extensions with notifications that could use a tutorial :P
First few sections are finished, mostly focused on creating a notification type and all the available functions within. Already creating the PR so people (read: @VSEphpbb) can already have a look.
Still to-do: