User Tools

Site Tools


mantisbt:plugins_events

This is an old revision of the document!


Plugin Events Reference

This document is a reference for all events declared by the core Mantis plugin API. It should contain the event name, type, a description of where and when it is triggered, and any special parameters it may expect to receive.

NOTE: The event list has not yet been finalized. You should not rely on this reference until events have been fully implemented.

Plugin API Events

  • EVENT_PLUGIN_INIT ( Execute ) - This event is triggered by the Mantis core immediately after all plugins have been registered. All of the core API's will have already been loaded. It should always be the first event triggered for any page load. This event should be used for setting up configuration variables or any other per-instance setting.

Output Modifying Events

Mantis Layout Events

These events will be called on every page load, and are defined with relation to the overall style and layout of Mantis. They allow plugins to add content to the overall Mantis layout and theme.

  • EVENT_LAYOUT_RESOURCES ( Output ) - This event is triggered before the end of the <head> tag, after the standard Javascript and CSS resources have been included. This should be used for linking to plugin-specific Javascript or CSS resources.
  • EVENT_LAYOUT_PAGE_HEADER ( Output ) - This event is triggered after the site title and Mantis logo have been displayed, but before the login information and menu.
  • EVENT_LAYOUT_CONTENT_BEGIN ( Output ) - This event is triggered after the Mantis menu has been displayed, at the beginning of the content section.
  • EVENT_LAYOUT_CONTENT_END ( Output ) - This event is triggered after the content section has been displayed, but before the footer section.
  • EVENT_LAYOUT_PAGE_FOOTER ( Output ) - This event is triggered after the normal Mantis footer has been displayed, and any output from this event should be the last elements displayed on the page.

Mantis Display Events

These events are called whenever certain content is displayed, allowing plugins to modify the displayed content for formatting or other reasons.

  • EVENT_DISPLAY_GENERAL ( Chain )
  • EVENT_DISPLAY_GENERAL_LINKS ( Chain )
  • EVENT_DISPLAY_RSS ( Chain )

Content Adding Events

Mantis Menu Events

These events allow plugins to hook menu events in order to add new menu items in various places.

  • EVENT_MENU_MAIN ( Default )
  • EVENT_MENU_MANAGE ( Default )
  • EVENT_MENU_MANAGE_CONFIG ( Default )
  • EVENT_MENU_SUMMARY ( Default )
  • EVENT_MENU_DOCS ( Default )
  • EVENT_MENU_ACCOUNT ( Default )

Mantis View Events

These events allow plugins to add new content to individual view pages in various locations.

  • EVENT_VIEW_BUG_AFTER_DETAILS ( Output )
  • EVENT_VIEW_BUG_AFTER_RELATIONSHIP ( Output )
  • EVENT_VIEW_BUG_AFTER_UPLOAD ( Output )
  • EVENT_VIEW_BUG_AFTER_USERS ( Output )
  • EVENT_VIEW_BUG_AFTER_NOTES ( Output )

Mantis Update Events

These events allow plugins to add new forms or form elements to an update page in various locations.

  • EVENT_UPDATE_BUG_AFTER_DETAILS ( Output )
  • EVENT_UPDATE_BUG_AFTER_FORM ( Output )
  • EVENT_UPDATE_BUG_AFTER_NOTES ( Output )

Mantis Form Events

These events allow plugins to process form data submitted from update pages.

  • EVENT_FORM_BUG_BEFORE ( Execute )
  • EVENT_FORM_BUG_AFTER ( Execute )

Other

Filter API Events

  • EVENT_FILTER_MYVIEW_FILTERS ( Chain )

Bug API Events

  • EVENT_BUG_REPORTED ( Execute )
  • EVENT_BUG_UPDATED ( Execute )
  • EVENT_BUG_RESOLVED ( Execute )
  • EVENT_BUG_CLOSED ( Execute )
  • EVENT_BUG_BUGNOTE_ADDED ( Execute ) - Is this superfluous because of EVENT_BUG_UPDATED?
mantisbt/plugins_events.1194621343.txt.gz · Last modified: 2008/10/29 04:31 (external edit)