Actions

Difference between revisions of "Plugin"

From Joomla! Documentation

m (Corrected links to point to Reference pages)
m (Corrected more links)
Line 13: Line 13:
 
Prior to Joomla! 1.5 plugins were known as mambots.  Mambots were able to change content only and were based on certain signal words.  Since then their scope has been stretched and extended to such an extent that to enhance the meaning of the new functionality the developers decided to change the name from mambots to plugins.  Joomla! 1.5 includes legacy support for Joomla! 1.0 mambots.
 
Prior to Joomla! 1.5 plugins were known as mambots.  Mambots were able to change content only and were based on certain signal words.  Since then their scope has been stretched and extended to such an extent that to enhance the meaning of the new functionality the developers decided to change the name from mambots to plugins.  Joomla! 1.5 includes legacy support for Joomla! 1.0 mambots.
  
 +
[[Category:Development]]
 +
[[Category:Plugins]]
 
======Events======
 
======Events======
 
Joomla! ships with a variety of core events, organised into groups.  These are described in the following topics.
 
Joomla! ships with a variety of core events, organised into groups.  These are described in the following topics.
Line 18: Line 20:
 
   * [[plugins:system_events|System events]]
 
   * [[plugins:system_events|System events]]
 
   * [[plugins:user_events|User events]]
 
   * [[plugins:user_events|User events]]
   * [[plugins:editor_events|Editor events]]
+
   * [[Reference:Editor_Events_for_Plugin_System|Editor events]]
 
   * [[Reference:Content Events for Plugin System|Content events]]
 
   * [[Reference:Content Events for Plugin System|Content events]]
  
Line 40: Line 42:
 
   *[[Reference:Content Events for Plugin System#onBeforeDisplayContent|onBeforeDisplayContent]] (content)
 
   *[[Reference:Content Events for Plugin System#onBeforeDisplayContent|onBeforeDisplayContent]] (content)
 
   *[[plugins:user_events#onBeforeStoreUser|onBeforeStoreUser]] (user)
 
   *[[plugins:user_events#onBeforeStoreUser|onBeforeStoreUser]] (user)
   *[[plugins:editor_events#onCustomEditorButton|onCustomEditorButton]] (editors-xtd)
+
   *[[Reference:Editor_Events_for_Plugin_System#onCustomEditorButton|onCustomEditorButton]] (editors-xtd)
   *[[plugins:editor_events#onDisplay|onDisplay]] (editors)
+
   *[[Reference:Editor_Events_for_Plugin_System#onDisplay|onDisplay]] (editors)
   *[[plugins:editor_events#onGetContent|onGetContent]] (editors)
+
   *[[Reference:Editor_Events_for_Plugin_System#onGetContent|onGetContent]] (editors)
   *[[plugins:editor_events#onGetInsertMethod|onGetInsertMethod]] (editors)
+
   *[[Reference:Editor_Events_for_Plugin_System#onGetInsertMethod|onGetInsertMethod]] (editors)
 
   *[[plugins:system_events#onGetWebServices|onGetWebServices]] (xmlrpc)
 
   *[[plugins:system_events#onGetWebServices|onGetWebServices]] (xmlrpc)
   *[[plugins:editor_events#onInit|onInit]] (editors)
+
   *[[Reference:Editor_Events_for_Plugin_System#onInit|onInit]] (editors)
 
   *[[plugins:user_events#onLoginUser|onLoginUser]] (user)
 
   *[[plugins:user_events#onLoginUser|onLoginUser]] (user)
 
   *[[plugins:user_events#onLogoutUser|onLogoutUser]] (user)
 
   *[[plugins:user_events#onLogoutUser|onLogoutUser]] (user)
 
   *[[Reference:Content Events for Plugin System#onPrepareContent|onPrepareContent]] (content)
 
   *[[Reference:Content Events for Plugin System#onPrepareContent|onPrepareContent]] (content)
   *[[plugins:editor_events#onSave|onSave]] (editors)
+
   *[[Reference:Editor_Events_for_Plugin_System#onSave|onSave]] (editors)
 
   *[[plugins:system_events#onSearch|onSearch]] (search)
 
   *[[plugins:system_events#onSearch|onSearch]] (search)
 
   *[[plugins:system_events#onSearchAreas|onSearchAreas]] (search)
 
   *[[plugins:system_events#onSearchAreas|onSearchAreas]] (search)
   *[[plugins:editor_events#onSetContent|onSetContent]] (editors)
+
   *[[Reference:Editor_Events_for_Plugin_System#onSetContent|onSetContent]] (editors)

Revision as of 06:48, 31 July 2008

Plugins

Joomla! plugins enable you to execute code in response to certain events, either Joomla! core events or custom events that are triggered from your own code. This is a powerful way of extending the basic Joomla! functionality. To see where plugins fit in with the overall Joomla! architecture, look at [overview].

The Joomla! plugin architecture follows the [[1]] design pattern. The JPlugin class is derived from JObserver and provides the means to register custom plugin code with core or custom events. The JEventDispatcher class, derived from JObservable, is an event handler which calls all plugins registered for a particular event, when that event is triggered.

 * How to create your own plugin
 * How to use plugins in your own code
 * Creating an Authentication Plugin

Useful reference: [2: Embedding: Event-Based Loose-Coupled Integration]

Prior to Joomla! 1.5 plugins were known as mambots. Mambots were able to change content only and were based on certain signal words. Since then their scope has been stretched and extended to such an extent that to enhance the meaning of the new functionality the developers decided to change the name from mambots to plugins. Joomla! 1.5 includes legacy support for Joomla! 1.0 mambots.

Events

Joomla! ships with a variety of core events, organised into groups. These are described in the following topics.

 * System events
 * User events
 * Editor events
 * Content events

This is an alphabetical list of the core events in Joomla! 1.5 together with the group name to which each belongs. Each event name links to more detailed information.

 *onAfterContentSave (content)
 *onAfterDeleteUser (user)
 *onAfterDisplay (content)
 *onAfterDisplayTitle (content)
 *onAfterDisplayContent (content)
 *onAfterInitialise (system)
 *onAfterRoute (system)
 *onAfterDispatch (system)
 *onAfterRender (system)
 *onAfterStoreUser (user)
 *onAuthenticate (authentication)
 *onAuthenticateFailure (authentication)
 *onBeforeContentSave (content)
 *onBeforeDeleteUser (user)
 *onBeforeDisplay (content)
 *onBeforeDisplayContent (content)
 *onBeforeStoreUser (user)
 *onCustomEditorButton (editors-xtd)
 *onDisplay (editors)
 *onGetContent (editors)
 *onGetInsertMethod (editors)
 *onGetWebServices (xmlrpc)
 *onInit (editors)
 *onLoginUser (user)
 *onLogoutUser (user)
 *onPrepareContent (content)
 *onSave (editors)
 *onSearch (search)
 *onSearchAreas (search)
 *onSetContent (editors)