From Joomla! Documentation

< API16:JDispatcher

The "API16" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.


Triggers an event by dispatching arguments to all observers that handle the event and returning their return values.

<! removed transcluded page call, red link never existed >


trigger($event, $args=array())
Parameter Name Default Value Description
$event $event The event to trigger.
$args array() $args An array of arguments.


array An array of results from each function call.

Defined in[edit]



jimport( 'joomla.event.dispatcher' );

Source Body[edit]

public function trigger($event, $args = array())
        // Initialise variables.
        $result = array();

         * If no arguments were passed, we still need to pass an empty array to
         * the call_user_func_array function.
        if (!is_array($args)) {
                $args = (array)$args;

        $event = strtolower($event);

        // Check if any plugins are attached to the event.
        if (!isset($this->_methods[$event]) || empty($this->_methods[$event])) {
                // No Plugins Associated To Event!
                return $result;

        // Loop through all plugins having a method matching our event
        foreach ($this->_methods[$event] AS $key)
                // Check if the plugin is present.
                if (!isset($this->_observers[$key])) {

                // Fire the event for an object based observer.
                if (is_object($this->_observers[$key])) {
                        $args['event'] = $event;
                        $result[] = $this->_observers[$key]->update($args);
                // Fire the event for a function based observer.
                elseif (is_array($this->_observers[$key])) {
                        $result[] = call_user_func_array($this->_observers[$key]['handler'], $args);

        return $result;

<! removed transcluded page call, red link never existed >


Code Examples[edit]