Skip to content

Conversation

@ghost
Copy link

@ghost ghost commented Feb 26, 2020

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:

  • Sending a notification
  • Updating a notification
  • Deleting a notification
  • Marking a notification
  • Advanced lessons
    • Building a users list

Copy link
Member

@iMattPro iMattPro left a 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

@ghost ghost requested a review from iMattPro May 6, 2020 09:45
============================
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``.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Author

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.

Copy link
Member

@iMattPro iMattPro May 8, 2020

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.

@iMattPro iMattPro merged commit 6bd992e into phpbb:3.2.x Aug 22, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants