View source for JModuleHelper/getModule

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

<span class="editsection" style="font-size:76%;">
	<nowiki>[</nowiki>[[Description:JModuleHelper/getModule|Edit Descripton]]<nowiki>]</nowiki>
</span>

{{Description:JModuleHelper/getModule}}

===Syntax===
<source lang="php">static& getModule($name, $title=null)</source>

 {| class="wikitable"
|-
!Parameter Name
!Default Value
!Description
|-
| $name
| 
|  $name The name of the module 
|-
| $title
| null
|  $title The title of the module, optional
|}

===Returns===
object The Module object 

===Defined in===
libraries/joomla/application/module/helper.php
===Importing===
<source lang="php">jimport( 'joomla.application.module.helper' );</source>

===Source Body===
<source lang="php">
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;
}
</source>

<span class="editsection" style="font-size:76%;">
	<nowiki>[</nowiki>[[SeeAlso:JModuleHelper/getModule|Edit See Also]]<nowiki>]</nowiki>
</span>
{{SeeAlso:JModuleHelper/getModule}}

===Examples===
<CodeExamplesForm />
<dpl>
 noresultsheader=\n
 category=getModule
 category=JModuleHelper
 category=CodeExample
 category=MethodExample
 include=*
 format= ,,,
</dpl>