For developers
The program list and the program finder dispatch two PSR-14 events each, a
program page one, and every content element of this extension the plugin view
event of academic_base. They are the supported way to change what
a plugin queries and what a page renders, and they replace what projects did
before: subclassing
Program, querying the database from
ViewHelpers, or replacing the data processor of the program page.
Which classes of this extension are public API, and what that promises, is stated for all academic extensions on the extension points page of academic_base.
Nothing changes in an installation that has no listener: without one, the plugins query and render, and program pages show, exactly what they did before.
Events
| Event | Dispatched | What a listener can change | Owner |
|---|---|---|---|
| ModifyProgramDemandEvent | by the Course List and the Course Finder, after the demand is built from the content element settings and the request and before the programs are queried | replace the demand | this extension |
| ModifyProgramListEvent | by the same two, after the query and before the view variables are assigned | replace the programs, replace the applicable categories, assign further view variables | this extension |
| ModifyProgramDataEvent | on a program page, by the data processor
program-,
after the data of the page is built from the page record and before
the facts are built from it | replace or change the program data the page template and the facts show | this extension |
| ModifyPluginViewEvent | by all three content elements, once each time they render, after the action assigned its own variables | assign further view variables | academic_base |
The list and the finder dispatch them in this order: the demand event, the list event, the plugin view event. The Course Data element dispatches only the plugin view event, and a program page only the program data event.