Events are hook locations/ledges. For more information about them and how to add them please take a look at the
wiki events and listeners category.
Please note all explanations in this post should include:
- At least 1 use-case
- Preferably an extension/MOD that exists that might make use of it (optional)
- What it could be used for
- Why should it have those parameters and that location
How to request a template event:
Post a topic with the title
[Template] Identifier
Then it should include the following information:
Code: Select all
Identifier:
Prosilver Location (if applicable):
Subsilver Location (if applicable):
Explanation:
The identifier should be formatted as prosilver location file followed by a descriptor. For e.g.
overall_footer_copyright
If it is only in subsilver then the subsilver location should be used (as hooks don't have to be in both styles)
How to request an acp template event:
Post a topic with the title
[ACP Template] Identifier
Then it should include the following information:
Code: Select all
Identifier:
Location:
Explanation:
How to request a core event:
Post a topic with the title
[Core] Identifier
Then it should include the following information:
Code: Select all
Identifer:
Location:
Parameters:
Explanation:
The identifier should be formatted as a general descriptor. All core events are prefixed by
core.
For e.g.
core.viewtopic_postrow
for postrow in viewtopic.php
Review Process:
After being posted it will be reviewed to check it would work ok and then someone will either implement it for you or you can submit a patch for it.
The patch will then be reviewed by somone who cannot be the original suggester or implementer. It will then be merged by a developer.
Adding events:
For now if you choose to add any events yourself then you must base it on
https://github.com/p/phpbb3/tree/feature/ledges-2
Then send a PR to oleg (p) and it will be reviewed by myself or nickvergessen and then it will be merged.
If not then the ledge will be added by myself or nickvergessen at some point.
After it has been merged to the core then this post will be updated.