API16:JModuleHelper/getModule

Description

Get module by name (real, eg 'Breadcrumbs' or folder, eg 'mod_breadcrumbs')

Syntax

static& getModule($name, $title=null)

Parameter Name	Default Value	Description
$name		The name of the module
$title	null	The title of the module, optional

Returns

object The Module object

Defined in

libraries/joomla/application/module/helper.php

Importing

jimport( 'joomla.application.module.helper' );

Source Body

public static function &getModule($name, $title = null)
{
        $result         = null;
        $modules        = &JModuleHelper::_load();
        $total          = count($modules);
        for ($i = 0; $i < $total; $i++)
        {
                // Match the name of the module
                if ($modules[$i]->name == $name)
                {
                        // Match the title if we're looking for a specific instance of the module
                        if (!$title || $modules[$i]->title == $title)
                        {
                                $result = &$modules[$i];
                                break;  // Found it
                        }
                }
        }

        // if we didn't find it, and the name is mod_something, create a dummy object
        if (is_null($result) && substr($name, 0, 4) == 'mod_')
        {
                $result                         = new stdClass;
                $result->id                     = 0;
                $result->title          = '';
                $result->module         = $name;
                $result->position       = '';
                $result->content        = '';
                $result->showtitle      = 0;
                $result->control        = '';
                $result->params         = '';
                $result->user           = 0;
        }

        return $result;
}