Joomla! Programmierung/Framework/JFactory/getApplication

JFactory/getApplication Liefert eine Referenz zu dem globalen JApplication Objekt. Wird nur neu erstellt, wenn es noch nicht existiert.

static getApplication( [$id], [$config], [$prefix] )

• @return object JApplication
• @since

Parameter	Datentyp	Beschreibung	Standardwert
[$id]	string	Name des Application Clients. Joomla! hat vier verschiedene Application Clients: 'site', 'administrator', 'installation' und 'xmlrpc'.	null
[$config]	array	Assoziatives Array mir Eigenschaften, die dem Application Client übergeben werden sollen.	array()
[$prefix]	string	Prefix der dem Client Namen vorangestellt werden soll, damit Joomla! die Klasse des Application bilden kann.	'J'

Beispiele

$mainframe laden

Ab Joomla! 1.5 ist es nicht mehr nötig die Variable $mainframe mittels global einzubinden. Dies geschieht nun mit der Methode getApplication.

$mainframe = JFactory::getApplication();

Wert aus der globalen Konfiguration auslesen

Auslesen eines Wertes aus der globalen Konfiguration. ToDo Verlinken

/* PHP4 */
$application = JFactory::getApplication();
 
// Sitename aus der globalen Konfiguration ausgeben
echo $application->getCfg('sitename');
 
/* PHP5 */
// Sitename aus der globalen Konfiguration ausgeben
echo JFactory::getApplication()->getCfg('sitename');

Benutzer einloggen

Auch ist es möglich sehr einfach einen Benutzer einzuloggen.

$mainframe = JFactory::getApplication();
 
// speichere den Benutzernamen in einem Array
$data['username'] = 'admin';
// speichere das Passwort in einem Array
$data['password'] = 'password';
 
// Setze true/false ob sich Joomla! an den Benutzer "erinnern" soll
$option['remember'] = true;
// Setze true/false ob bei Fehlgeschlagenem Login eine Warnung ausgegeben werden soll
$option['silent']
 
// Logge den Benutzer ein
$mainframe->login($data, $option);

Benutzer ausloggen

Ausloggen eines Benutzers

$mainframe = JFactory::getApplication();
 
// Setzen der ID des Benutzer, der ausgeloggt werden soll, bei "null" wird der aktuelle Benutzer ausgeloggt
$userid = null;
 
// Logge den Benutzer aus
$mainframe->login($userid);

ToDo Weitere nützliche Beispiele hinzufügen?

Siehe auch

• JFactory->getApplication() auf api.joomla.org
• JApplication

Quellcode

JFactory::getApplication()

 libraries/joomla

•  factory.php

public static function getApplication($id = null, $config = array(), $prefix='J')
{
   if (!self::$application) {
      jimport('joomla.application.application');
 
      if (!$id) {
         JError::raiseError(500, 'Application Instantiation Error');
      }
 
      self::$application = JApplication::getInstance($id, $config, $prefix);
   }
 
   return self::$application;
}