User Klassenreferenz

Aufstellung aller Elemente

Öffentliche Methoden
	User ($userid='')
	listAll ()
	getAllUsers ()
	setCurrent ()
	getGroupClause ()
	hasProject ($projectid)
	getReadableProjects ()
	getReadableProjectIds ()
	loadProjects ()
	load ()
	isValid ()
	setDatabaseRow ($row)
	getName ()
	getUserName ($userid)
	save ()
	add ($name= '')
	addNewUserGroups ()
	delete ()
	getProperties ()
	checkPassword ($password)
	setPassword ($password, $always=true)
	getGroups ()
	getGroupIds ()
	getOtherGroups ()
	addGroup ($groupid)
	delGroup ($groupid)
	loadRights ($projectid, $languageid)
	getAllAcls ()
	getRights ()
	delRights ()
	hasRight ($objectid, $type)
	addRight ($objectid, $type)
	getAvailableStyles ()
	createPassword ()
Öffentliche, statische Methoden
	loadWithName ($name)
Öffentliche Attribute
	$userid = 0
	$error = ''
	$name = ''
	$fullname = ''
	$ldap_dn
	$tel
	$mail
	$desc
	$style
	$isAdmin
	$projects
	$rights
	$loginDate = 0
	$mustChangePassword = false
	$groups = null

---

Ausführliche Beschreibung

Definiert in Zeile 128 der Datei User.class.php.

---

Dokumentation der Elementfunktionen

User::add

(

$

name = ''

)

Benutzer hinzuf�gen

Parameter:

String

$name Benutzername

Definiert in Zeile 501 der Datei User.class.php.

Benutzt $db, $name, addNewUserGroups() und db_connection().

     {
          if   ( $name != '' )
               $this->name = $name;

          $db = db_connection();

          $sql = new Sql('SELECT MAX(id) FROM {t_user}');
          $this->userid = intval($db->getOne($sql->query))+1;

          $sql = new Sql('INSERT INTO {t_user}'.
                         ' (id,name,password,ldap_dn,fullname,tel,mail,descr,style,is_admin)'.
                         " VALUES( {userid},{name},'','','','','','','default',0 )" );
          $sql->setInt   ('userid',$this->userid);
          $sql->setString('name'  ,$this->name  );

          // Datenbankbefehl ausfuehren
          $db->query( $sql->query );
          
          $this->addNewUserGroups(); // Neue Gruppen hinzuf�gen.
     }

User::addGroup

(

$

groupid

)

Definiert in Zeile 938 der Datei User.class.php.

Benutzt $db und db_connection().

Wird benutzt von addNewUserGroups() und checkPassword().

     {
          $db = db_connection();

          $sql = new Sql('SELECT MAX(id) FROM {t_usergroup}');
          $usergroupid = intval($db->getOne($sql->query))+1;

          $sql = new Sql( 'INSERT INTO {t_usergroup} '.
                          '       (id,userid,groupid) '.
                          '       VALUES( {usergroupid},{userid},{groupid} )' );
          $sql->setInt('usergroupid',$usergroupid  );
          $sql->setInt('userid'     ,$this->userid );
          $sql->setInt('groupid'    ,$groupid      );

          $db->query( $sql->query );
     
     }

User::addNewUserGroups

(

)

Zu einem neuen Benutzer automatisch Gruppen hinzuf�gen. Diese Methode wird automatisch in "add()" aufgerufen.

Definiert in Zeile 529 der Datei User.class.php.

Benutzt $conf, $db, addGroup() und db_connection().

Wird benutzt von add().

     {
          global $conf;
          $groupNames = explode(',',@$conf['security']['newuser']['groups']);
          
          if   ( count($groupNames) == 0 )
               return; // Nichts zu tun.
               
          $db = db_connection();

          $sql = new Sql('SELECT id FROM {t_group} WHERE name IN({names})');
          $sql->setStringList('names',$groupNames);
          $groupIds = array_unique( $db->getCol($sql->query) );
          
          // Wir brauchen hier nicht weiter pr�fen, ob der Benutzer eine Gruppe schon hat, denn
          // - passiert dies nur bei der Neuanlage eines Benutzers
          // - Enth�lt die Group-Id-Liste eine ID nur 1x.

          // Gruppen diesem Benutzer zuordnen.
          foreach( $groupIds as $groupId )
               $this->addGroup( $groupId );
     }

User::addRight	(	$	objectid,
		$	type
	)

Berechtigung dem Benutzer hinzufuegen.

Parameter:

	objectid	Objekt-Id, zu dem eine Berechtigung hinzugefuegt werden soll
	Art	des Rechtes, welches hinzugefuegt werden soll

Definiert in Zeile 1124 der Datei User.class.php.

Benutzt $conf.

     {
          global $conf;
          
          if   ( $conf['security']['readonly'] )
               if   ( $type & ACL_READ )
                    $type = ACL_READ;
               else
                    $type = 0;

          if   ( $type & ACL_PUBLISH && $conf['security']['nopublish'] )
               $type -= ACL_PUBLISH;


          if   ( !isset($this->rights[$objectid]) )
               $this->rights[$objectid] = 0;

          $this->rights[$objectid] = $this->rights[$objectid] | $type;
     }

User::checkPassword

(

$

password

)

Ueberpruefen des Kennwortes.

Das Kennwort wird ueber Datenbank oder ueber LDAP-Verzeichnisdienst geprueft. Wenn

• ein LDAP-Dn ("distinghished-name") vorhanden ist, dann Pruefung ueber den LDAP-Server,
• sonst ueber die Benutzertabelle in der Datenbank.

Definiert in Zeile 637 der Datei User.class.php.

Benutzt $conf, $db, addGroup(), db_connection(), Logger::debug(), delGroup(), getGroupIds() und save().

     {
          global $conf;

          $db = db_connection();
          $this->mustChangePassword = false;
          
          // Lesen des Benutzers aus der DB-Tabelle
          $sql = new Sql( <<<SQL
SELECT * FROM {t_user}
 WHERE name={name}
SQL
          );
          $sql->setString('name',$this->name);
     
          $res_user = $db->query( $sql->query );

          $check = false;
          $authType = $conf['security']['auth']['type']; // Entweder 'ldap', 'authdb', 'http', oder 'database'
          
          if   ( $res_user->numRows() == 1 )
          {
               // Benutzername ist bereits in der Datenbank.
               $row_user = $res_user->fetchRow();
               $this->userid  = $row_user['id'];
               $this->ldap_dn = $row_user['ldap_dn'];
               $check   = true;
               $autoAdd = false; // Darf nicht hinzugef�gt werden, da schon vorhanden.
          }
          elseif( $res_user->numRows() == 0 && $authType == 'ldap' && $conf['ldap']['search']['add'] )
          {
               // Benutzer noch nicht in der Datenbank vorhanden.
               // Falls ein LDAP-Account gefunden wird, wird dieser �bernommen.
               $check   = true;
               $autoAdd = true;
          }
          elseif( $res_user->numRows() == 0 && $authType == 'authdb' && $conf['security']['authdb']['add'] )
          {
               $check = true;
               $autoAdd = true;
          }
          elseif( $res_user->numRows() == 0 && $authType == 'http' && $conf['security']['http']['add'] )
          {
               $check = true;
               $autoAdd = true;
          }

          if   ( $check )
          {
               // Falls benutzerspezifischer LDAP-dn vorhanden wird Benutzer per LDAP authentifiziert
               if   ( $conf['security']['auth']['userdn'] && !empty($this->ldap_dn ) )
               {
                    Logger::debug( 'checking login via ldap' );
                    $ldap = new Ldap();
                    $ldap->connect();
                    
                    // Benutzer ist bereits in Datenbank
                    // LDAP-Login mit dem bereits vorhandenen DN versuchen
                    $ok = $ldap->bind( $this->ldap_dn, $password );
                    
                    // Verbindung zum LDAP-Server brav beenden
                    $ldap->close();

                    return $ok;
               }
               elseif( $authType == 'ldap' )
               {
                    Logger::debug( 'checking login via ldap' );
                    $ldap = new Ldap();
                    $ldap->connect();
                    
                    if   ( empty($conf['ldap']['dn']) )
                    {
                         // Der Benutzername wird im LDAP-Verzeichnis gesucht.
                         // Falls gefunden, wird der DN (=der eindeutige Schl�ssel im Verzeichnis) ermittelt.
                         $dn = $ldap->searchUser( $this->name );
                         
                         if    ( empty($dn) )
                         {
                              Logger::debug( 'User not found in LDAP directory' );
                              return false; // Kein LDAP-Account gefunden.
                         }

                         Logger::debug( 'User found: '.$dn );
                    }
                    else
                    {
                         $dn = str_replace( '{user}',$this->name,$conf['ldap']['dn'] );
                    }
                         
                    // LDAP-Login versuchen
                    $ok = $ldap->bind( $dn, $password );
                    
                    Logger::debug( 'LDAP bind: '.($ok?'success':'failed') );
                    
                    if   ( $ok && $conf['security']['authorize']['type'] == 'ldap' )
                    {
                         $sucheAttribut = $conf['ldap']['authorize']['group_name'];
                         $sucheFilter   = str_replace('{dn}',$dn,$conf['ldap']['authorize']['group_filter']);
                         
                         $ldap_groups = $ldap->searchAttribute( $sucheFilter, $sucheAttribut );
                         
                         $sql = new Sql( <<<SQL
SELECT id,name FROM {t_group}
 WHERE name IN({name_list})
 ORDER BY name ASC
SQL
                         );
                         $sql->setStringList('name_list',$ldap_groups);
                         $oldGroups = $this->getGroupIds();
                         $this->groups = $db->getAssoc( $sql->query );
                         
                         foreach( $this->groups as $groupid=>$groupname)
                         {
                              if   ( ! in_array($groupid,$oldGroups))
                                   $this->addGroup($groupid);
                         }
                         foreach( $oldGroups as $groupid)
                         {
                              if   ( !isset($this->groups[$groupid]) )
                                   $this->delGroup($groupid);
                         }
                         
                         
                         // Pr�fen, ob Gruppen fehlen. Diese dann ggf. in der OpenRat-Datenbank hinzuf�gen.
                         if   ( $conf['ldap']['authorize']['auto_add'] )
                         {
                              foreach( $ldap_groups as $group )
                              {
                                   if   ( !in_array($group,$this->groups) ) // Gruppe schon da?
                                   {
                                        $g = new Group();
                                        $g->name = $group;
                                        $g->add(); // Gruppe hinzuf�gen
                                        
                                        $this->groups[$g->groupid] = $group;
                                   }
                              }
                         }
//                       Html::debug($this->groups,'Gruppen/Ids des Benutzers');
                    }
                    
                    // Verbindung zum LDAP-Server brav beenden
                    $ldap->close();

                    if   ( $ok && $autoAdd )
                    {
                         // Falls die Authentifizierung geklappt hat, wird der
                         // LDAP-Account in die Datenbank �bernommen.
                         $this->ldap_dn  = $dn;
                         $this->fullname = $this->name;
                         $this->add();
                         $this->save();
                    }
                    
                    return $ok;
               }
               elseif( $authType == 'database' )
               {
                    // Pruefen ob Kennwort mit Datenbank uebereinstimmt
                    if   ( $row_user['password'] == $password )
                    {
                         // Kennwort stimmt mit Datenbank �berein, aber nur im Klartext.
                         // Das Kennwort muss ge�ndert werden
                         $this->mustChangePassword = true;
                         
                         // Login nicht erfolgreich
                         return false;
                    }
                    elseif   ( $row_user['password'] == md5( $password ) )
                    {
                         // Die Kennwort-Pr�fsumme stimmt mit dem aus der Datenbank �berein.
                         // Juchuu, Login ist erfolgreich.
                         return true;
                    }
                    else
                    {
                         // Kennwort stimmt garnicht �berein.
                         return false;
                    }
               }
               elseif( $authType == 'authdb' )
               {
                    $authdb = new DB( $conf['security']['authdb'] );
                    $sql = new Sql( $conf['security']['authdb']['sql'] );
                    $sql->setString('username',$this->name);
                    $sql->setString('password',$password);
                    $res = $authdb->query($sql->query);
                    $ok = ($res->numRows() >= 1);

                    if   ( $ok && $autoAdd )
                    {
                         // Falls die Authentifizierung geklappt hat, wird der
                         // Benutzername in der eigenen Datenbank eingetragen.
                         $this->fullname = $this->name;
                         $this->add();
                         $this->save();
                    }
                    // noch nicht implementiert: $authdb->close();
                    
                    return $ok;
               }
               elseif( $authType == 'http' )
               {
                    $http = new Http( $conf['security']['http']['url'] );
                    $http->method = 'HEAD';
                    $http->setBasicAuthentication( $this->name, $password );
                    
                    $ok = $http->request();
                    
                    return $ok; 
               }
               else
               {
                    die( 'unknown authentication-type in configuration: '.$authType );
               }
          }

          // Benutzername nicht in Datenbank.
          return false;
     }

User::createPassword

(

)

Erzeugt ein aussprechbares Kennwort.

Inspired by http://www.phpbuilder.com/annotate/message.php3?id=1014451

Rückgabe:

String Zuf�lliges Kennwort

Definiert in Zeile 1183 der Datei User.class.php.

Benutzt $conf.

Wird benutzt von IndexAction::passwordcommit().

     {
          global $conf;
          
          $pw = '';
          $c  = 'bcdfghjklmnprstvwz'; //consonants except hard to speak ones
          $v  = 'aeiou';              //vowels
          $a  = $c.$v;                //both
           
          //use two syllables...
          for ( $i=0; $i < intval($conf['security']['password']['min_length'])/3; $i++ )
          {
               $pw .= $c[rand(0, strlen($c)-1)];
               $pw .= $v[rand(0, strlen($v)-1)];
               $pw .= $a[rand(0, strlen($a)-1)];
          }
          //... and add a nice number
          $pw .= rand(10,99);
           
          return $pw;
     }

User::delete

(

)

Benutzer entfernen.
Vor dem Entfernen werden alle Referenzen auf diesen Benutzer entfernt:

• "Erzeugt von" f�r diesen Benutzer entfernen.
  
• "Letzte �nderung von" f�r diesen Benutzer entfernen
  
• Alle Archivdaten in Dateien mit diesem Benutzer entfernen
  
• Alle Berechtigungen dieses Benutzers l?schen
  
• Alle Gruppenzugehoerigkeiten dieses Benutzers l?schen
  
• Benutzer loeschen
  

Definiert in Zeile 563 der Datei User.class.php.

Benutzt $db und db_connection().

     {
          $db = db_connection();

          // "Erzeugt von" f�r diesen Benutzer entfernen.
          $sql = new Sql( 'UPDATE {t_object} '.
                          'SET create_userid=null '.
                          'WHERE create_userid={userid}' );
          $sql->setInt   ('userid',$this->userid );
          $db->query( $sql->query );

          // "Letzte �nderung von" f�r diesen Benutzer entfernen
          $sql = new Sql( 'UPDATE {t_object} '.
                          'SET lastchange_userid=null '.
                          'WHERE lastchange_userid={userid}' );
          $sql->setInt   ('userid',$this->userid );
          $db->query( $sql->query );

          // Alle Archivdaten in Dateien mit diesem Benutzer entfernen
          $sql = new Sql( 'UPDATE {t_value} '.
                          'SET lastchange_userid=null '.
                          'WHERE lastchange_userid={userid}' );
          $sql->setInt   ('userid',$this->userid );
          $db->query( $sql->query );

          // Alle Berechtigungen dieses Benutzers l?schen
          $sql = new Sql( 'DELETE FROM {t_acl} '.
                          'WHERE userid={userid}' );
          $sql->setInt   ('userid',$this->userid );
          $db->query( $sql->query );

          // Alle Gruppenzugehoerigkeiten dieses Benutzers l?schen
          $sql = new Sql( 'DELETE FROM {t_usergroup} '.
                          'WHERE userid={userid}' );
          $sql->setInt   ('userid',$this->userid );
          $db->query( $sql->query );

          // Benutzer loeschen
          $sql = new Sql( 'DELETE FROM {t_user} '.
                          'WHERE id={userid}' );
          $sql->setInt   ('userid',$this->userid );
          $db->query( $sql->query );
     }

User::delGroup

(

$

groupid

)

Definiert in Zeile 958 der Datei User.class.php.

Benutzt $db und db_connection().

Wird benutzt von checkPassword().

     {
          $db = db_connection();

          $sql = new Sql( 'DELETE FROM {t_usergroup} '.
                          '  WHERE userid={userid} AND groupid={groupid}' );
          $sql->setInt   ('userid'  ,$this->userid );
          $sql->setInt   ('groupid' ,$groupid      );

          $db->query( $sql->query );
     }

User::delRights

(

)

Entfernt alle Rechte aus diesem Benutzerobjekt.

Definiert in Zeile 1090 der Datei User.class.php.

Wird benutzt von getAllAcls().

     {
          $this->rights = array();
     }

User::getAllAcls

(

)

Ermitteln aller Berechtigungen des Benutzers.
Diese Daten werden auf der Benutzerseite in der Administration angezeigt.

Rückgabe:

unknown

Definiert in Zeile 988 der Datei User.class.php.

Benutzt $db, db_connection(), delRights(), getGroupClause() und lang().

     {

          $this->delRights();

          $db = db_connection();

          $group_clause = $this->getGroupClause();

          $sql = new Sql( 'SELECT {t_acl}.*,{t_object}.projectid,{t_language}.name AS languagename FROM {t_acl}'.
                          '  LEFT JOIN {t_object} '.
                          '         ON {t_object}.id={t_acl}.objectid '.
                          '  LEFT JOIN {t_language} '.
                          '         ON {t_language}.id={t_acl}.languageid '.
                          '  WHERE ( {t_acl}.userid={userid} OR '.$group_clause.
                                                           ' OR ({t_acl}.userid IS NULL AND {t_acl}.groupid IS NULL) )'.
                          '  ORDER BY {t_object}.projectid,{t_acl}.languageid' );
          $sql->setInt  ( 'userid'    ,$this->userid );

          $aclList = array();

          foreach( $db->getAll( $sql->query ) as $row )
          {
               $acl = new Acl();
               $acl->setDatabaseRow( $row );
               $acl->projectid    = $row['projectid'   ];
               if   ( intval($acl->languageid) == 0 )
                    $acl->languagename = lang('GLOBAL_ALL_LANGUAGES');
               else
                    $acl->languagename = $row['languagename'];
               $aclList[] = $acl;
          }
          
          return $aclList;
     }

User::getAllUsers

(

)

Definiert in Zeile 171 der Datei User.class.php.

Benutzt $db, db_connection() und User().

Wird benutzt von UserAction::listing() und AdministrationTree::users().

     {
          $list = array();
          $db = db_connection();

          $sql = new Sql( 'SELECT * '.
                          '  FROM {t_user}'.
                          '  ORDER BY name' );

          foreach( $db->getAll( $sql->query ) as $row )
          {
               $user = new User();
               $user->setDatabaseRow( $row );

               $list[] = $user;
          }
          
          return $list;
     }

User::getAvailableStyles

(

)

Ermitteln aller zur Verfuegung stehenden Stylesheets

Definiert in Zeile 1148 der Datei User.class.php.

Benutzt $conf_themedir und Http::serverError().

     {
          global $conf_themedir;
          
          $allstyles = array();
          
          // Theme-Verzeichnis nach "*.css"-Dateien durchsuchen.
          $dir = $conf_themedir.'/css';
          $handle = @opendir( $dir ); 

          if   ( !is_resource($handle) )
               Http::serverError('Cannot open CSS dir: '.$dir);
               
          while ($file = readdir ($handle))
          { 
               if ( eregi('\.css$',$file) )
               { 
                    $file = eregi_replace('\.css$','',$file);
                    $allstyles[$file] = ucwords($file);
               }
          }
          closedir($handle);

          asort($allstyles); // Alphabetisch sortieren.     
          return $allstyles;  
     }

User::getGroupClause

(

)

Erzeugt eine WHERE-Bedingung zur Verwendung in einer SQL-Anfrage.
Es wird eine Oder-Liste mit allen Gruppen-Ids erzeugt.

Rückgabe:

String SQL-WHERE-Bedingung

Definiert in Zeile 210 der Datei User.class.php.

Benutzt getGroupIds().

Wird benutzt von getAllAcls(), getReadableProjects() und hasProject().

     {
          $groupIds = $this->getGroupIds();
          
          if   ( count($groupIds) > 0 )
               $groupclause = ' groupid='.implode(' OR groupid=',$groupIds );
          else
               $groupclause = ' 1=0 ';

          return $groupclause;
     }

User::getGroupIds

(

)

Definiert in Zeile 907 der Datei User.class.php.

Benutzt getGroups().

Wird benutzt von checkPassword() und getGroupClause().

     {
          return array_keys( $this->getGroups() );

          /*
          $db = db_connection();

          $sql = new Sql( 'SELECT groupid FROM {t_usergroup} '.
                          'WHERE userid={userid}' );
          $sql->setInt('userid',$this->userid );

          return $db->getCol( $sql->query );
          */
     }

User::getGroups

(

)

Gruppen ermitteln, in denen der Benutzer Mitglied ist.

Rückgabe:

Array mit Id:Name

Definiert in Zeile 889 der Datei User.class.php.

Benutzt $db und db_connection().

Wird benutzt von getGroupIds().

     {
          if   ( !is_array($this->groups) )
          {
               $db = db_connection();
     
               $sql = new Sql( 'SELECT {t_group}.id,{t_group}.name FROM {t_group} '.
                               'LEFT JOIN {t_usergroup} ON {t_usergroup}.groupid={t_group}.id '.
                               'WHERE {t_usergroup}.userid={userid}' );
               $sql->setInt('userid',$this->userid );
               $this->groups = $db->getAssoc( $sql->query );
          }
          
          return $this->groups;
     }

User::getName

(

)

Namen ermitteln.
Wenn "fullname" gefuellt, dann diesen benutzen, sonst den Benutzernamen.

Definiert in Zeile 432 der Datei User.class.php.

     {
          if   ( empty($this->fullname))
               return $this->name;
          else
               return $this->fullname;
     }

User::getOtherGroups

(

)

Definiert in Zeile 924 der Datei User.class.php.

Benutzt $db und db_connection().

     {
          $db = db_connection();

          $sql = new Sql( 'SELECT {t_group}.id,{t_group}.name FROM {t_group}'.
                          '   LEFT JOIN {t_usergroup} ON {t_usergroup}.groupid={t_group}.id AND {t_usergroup}.userid={userid}'.
                          '   WHERE {t_usergroup}.userid IS NULL' );
          $sql->setInt('userid'  ,$this->userid );

          return $db->getAssoc( $sql->query );
     }

User::getProperties

(

)

Ermitteln der Eigenschaften zu diesem Benutzer

Rückgabe:

Array Liste der Eigenschaften als assoziatives Array

Definiert in Zeile 613 der Datei User.class.php.

     {
          return Array( 'userid'  => $this->userid,
                        'id'      => $this->userid,
                        'fullname'=> $this->fullname,
                        'name'    => $this->name,
                        'ldap_dn' => $this->ldap_dn,
                        'tel'     => $this->tel,
                        'desc'    => $this->desc,
                        'mail'    => $this->mail,
                        'style'   => $this->style,
                        'is_admin'=> $this->isAdmin,
                        'isAdmin' => $this->isAdmin );
     }

User::getReadableProjectIds

(

)

Ermittelt alls Projekte, fuer die der Benutzer berechtigt ist.

Rückgabe:

Array [0..n] = Projekt-Id

Definiert in Zeile 284 der Datei User.class.php.

Benutzt getReadableProjects().

     {
          return array_keys( $this->getReadableProjects() );
     }

User::getReadableProjects

(

)

Lesen aller Projekte, fuer die der Benutzer berechtigt ist.

Rückgabe:

Array [Projekt-Id] = Projekt-Name

Definiert in Zeile 246 der Datei User.class.php.

Benutzt $db, db_connection(), Project::getAllProjects() und getGroupClause().

Wird benutzt von getReadableProjectIds() und loadProjects().

     {
          $db = db_connection();

          if   ( $this->isAdmin )
          {
               // Administratoren haben Rechte auf alle Projekte.
               return Project::getAllProjects();
          }
          else
          {
               $groupClause = $this->getGroupClause();
               $sql = new Sql(<<<SQL
SELECT DISTINCT {t_project}.id,{t_project}.name
  FROM {t_object}
  LEFT JOIN {t_acl}     ON {t_object}.id  = {t_acl}.objectid 
  LEFT JOIN {t_project} ON {t_project}.id = {t_object}.projectid 
 WHERE {t_object}.parentid IS NULL     AND
       {t_acl}.id          IS NOT NULL AND
       (  {t_acl}.userid={userid} OR
       $groupClause OR 
       ({t_acl}.userid IS NULL AND {t_acl}.groupid IS NULL)) 
 ORDER BY {t_project}.name
SQL
);
          $sql->setInt   ( 'userid',$this->userid );

               return $db->getAssoc( $sql->query );
          }
          
     }

User::getRights

(

)

Ermitteln aller Berechtigungen.

Rückgabe:

Array Berechtigungen

Definiert in Zeile 1029 der Datei User.class.php.

     {
          die('User.class::getRights()');
          
//        $db = db_connection();
//        $var = array();
//
//        // Alle Projekte lesen
//        $sql = new Sql( 'SELECT id,name FROM {t_project}' );
//        $projects = $db->getAssoc( $sql->query );    
//
//        foreach( $projects as $projectid=>$projectname )
//        {
//             $var[$projectid] = array();
//             $var[$projectid]['name'] = $projectname;
//             $var[$projectid]['folders'] = array();
//             $var[$projectid]['rights'] = array();
//
//             $sql = new Sql( 'SELECT {t_acl}.* FROM {t_acl}'.
//                             '  LEFT JOIN {t_folder} ON {t_acl}.folderid = {t_folder}.id'.
//                             '  WHERE {t_folder}.projectid={projectid}'.
//                             '    AND {t_acl}.userid={userid}' );
//             $sql->setInt('projectid',$projectid    );
//             $sql->setInt('userid'   ,$this->userid );
//             
//             $acls = $db->getAll( $sql->query );
//
//             foreach( $acls as $acl )
//             {
//                  $aclid = $acl['id'];
//                  $folder = new Folder( $acl['folderid'] );
//                  $folder->load();
//                  $var[$projectid]['rights'][$aclid] = $acl;
//                  $var[$projectid]['rights'][$aclid]['foldername'] = implode(' » ',$folder->parentfolder( false,true ));
//                  $var[$projectid]['rights'][$aclid]['delete_url'] = Html::url(array('action'=>'user','subaction'=>'delright','aclid'=>$aclid));
//             }
//             
//             $sql = new Sql( 'SELECT id FROM {t_folder}'.
//                             '  WHERE projectid={projectid}' );
//             $sql->setInt('projectid',$projectid);
//             $folders = $db->getCol( $sql->query );
//
//             $var[$projectid]['folders'] = array();
//
//             foreach( $folders as $folderid )
//             {
//                  $folder = new Folder( $folderid );
//                  $folder->load();
//                  $var[$projectid]['folders'][$folderid] = implode(' » ',$folder->parentfolder( false,true ));
//             }
//
//             asort( $var[$projectid]['folders'] );
//        }
//        
//        return $var;
     }

User::getUserName

(

$

userid

)

Liest einen Benutzernamen aus der Datenbank.

Parameter:

int

Benutzer-Id

Rückgabe:

String Benutzername

Definiert in Zeile 448 der Datei User.class.php.

Benutzt $db, $name, $userid, db_connection() und lang().

     {
          $db = db_connection();

          $sql = new Sql( 'SELECT name FROM {t_user}'.
                          ' WHERE id={userid}' );
          $sql->setInt( 'userid',$userid );

          $name = $db->getOne( $sql->query );
          
          if   ( $name == '' )
               return lang('UNKNOWN');
          else return $name;
     }

User::hasProject

(

$

projectid

)

Definiert in Zeile 224 der Datei User.class.php.

Benutzt $db, db_connection() und getGroupClause().

     {
          $db = db_connection();

          $sql = new Sql( 'SELECT COUNT(*)'.
                          '  FROM {t_acl}'.
                          '  LEFT JOIN {t_object} ON {t_object}.id={t_acl}.objectid '.
                          '  WHERE projectid={projectidid} AND '.
                          '        ( userid={userid} OR'.
                          '          '.$this->getGroupClause().'    )' );
          $sql->setInt   ( 'userid',$this->userid );

          return $db->getOne( $sql->query ) > 0;
     }

User::hasRight	(	$	objectid,
		$	type
	)

Ueberpruft, ob der Benutzer ein bestimmtes Recht hat

Parameter:

	$objectid	Objekt-Id zu dem Objekt, dessen Rechte untersucht werden sollen
	$type	Typ des Rechts (Lesen,Schreiben,...) als Konstante ACL_*

Definiert in Zeile 1102 der Datei User.class.php.

Benutzt $conf.

     {
          global $conf;
          if   ( $this->isAdmin && !$conf['security']['readonly'] )
               return true;

          if   ( $this->isAdmin && $type & ACL_READ )
               return true;
               
          if   ( !isset($this->rights[$objectid]) )
               return false;

          return $this->rights[$objectid] & $type;
     }

User::isValid

(

)

Stellt fest, ob der Benutzer korrekt geladen ist.

Definiert in Zeile 348 der Datei User.class.php.

     {
          return intval($this->userid) > 0;
     }

User::listAll

(

)

Definiert in Zeile 157 der Datei User.class.php.

Benutzt $conf, $db und db_connection().

Wird benutzt von ObjectAction::aclform(), SearchAction::content(), SearchAction::prop() und StatusAction::show().

     {
          global $conf;
          $db = db_connection();

          $sql = new Sql( 'SELECT id,name '.
                          '  FROM {t_user}'.
                          '  ORDER BY name' );

          return $db->getAssoc( $sql->query );
     }

User::load

(

)

Lesen Benutzer aus der Datenbank.

Definiert in Zeile 304 der Datei User.class.php.

Benutzt $conf, $db, db_connection() und setDatabaseRow().

     {
          global $conf;
          $db = db_connection();

          $sql = new Sql( 'SELECT * FROM {t_user}'.
                          ' WHERE id={userid}' );
          $sql->setInt( 'userid',$this->userid );
          $row = $db->getRow( $sql->query );

          $this->setDatabaseRow( $row );          
     }

User::loadProjects

(

)

Lädt die Liste alle Projekte, fuer die der Benutzer berechtigt ist und speichert diese in diesem Benutzerobjekt.

Definiert in Zeile 294 der Datei User.class.php.

Benutzt getReadableProjects().

Wird benutzt von setCurrent().

     {
          $this->projects = $this->getReadableProjects();
     }

User::loadRights	(	$	projectid,
		$	languageid
	)

Ermitteln aller Rechte des Benutzers im aktuellen Projekt.

Parameter:

	Integer	$projectid Projekt-Id
	Integer	$languageid Sprache-Id

Definiert in Zeile 977 der Datei User.class.php.

     {
     }

User::loadWithName

(

$

name

)

[static]

Benutzerobjekt �ber Benutzernamen ermitteln.
Liefert ein neues Benutzerobjekt zur�ck.

Parameter:

name

Benutzername

Definiert in Zeile 325 der Datei User.class.php.

Benutzt $conf, $db, $name, db_connection() und User().

Wird benutzt von IndexAction::openid(), IndexAction::passwordcode(), IndexAction::passwordcommit(), IndexAction::registercommit(), IndexAction::show() und IndexAction::showlogin().

     {
          global $conf;
          $db = db_connection();

          // Benutzer �ber Namen suchen
          $sql = new Sql( 'SELECT id FROM {t_user}'.
                          ' WHERE name={name}' );
          $sql->setString( 'name',$name );
          $userId = $db->getOne( $sql->query );

          // Benutzer �ber Id instanziieren
          $neuerUser = new User( $userId );
          $neuerUser->load();
          
          return $neuerUser;
     }

User::save

(

)

Speichern Benutzer in der Datenbank.

Definiert in Zeile 467 der Datei User.class.php.

Benutzt $db und db_connection().

Wird benutzt von checkPassword().

     {
          $db = db_connection();

          $sql = new Sql( 'UPDATE {t_user}'.
                          ' SET name={name},'.
                          '     fullname={fullname},'.
                          '     ldap_dn ={ldap_dn} ,'.
                          '     tel     ={tel}     ,'.
                          '     descr   ={desc}    ,'.
                          '     mail    ={mail}    ,'.
                          '     style   ={style}   ,'.
                          '     is_admin={isAdmin} '.
                          ' WHERE id={userid}' );
          $sql->setInt    ( 'userid'  ,$this->userid  );
          $sql->setString ( 'fullname',$this->fullname);
          $sql->setString ( 'name'    ,$this->name    );
          $sql->setString ( 'ldap_dn' ,$this->ldap_dn );
          $sql->setString ( 'tel'     ,$this->tel     );
          $sql->setString ( 'desc'    ,$this->desc    );
          $sql->setString ( 'mail'    ,$this->mail    );
          $sql->setString ( 'style'   ,$this->style   );
          $sql->setBoolean( 'isAdmin' ,$this->isAdmin );
          
          // Datenbankabfrage ausfuehren
          $db->query( $sql->query );
     }

User::setCurrent

(

)

Benutzer als aktiven Benutzer in die Session schreiben.

Definiert in Zeile 195 der Datei User.class.php.

Benutzt loadProjects() und Session::setUser().

     {
          $this->loadProjects();
          $this->loginDate = time();

          Session::setUser( $this );
     }

User::setDatabaseRow

(

$

row

)

Definiert in Zeile 356 der Datei User.class.php.

Benutzt $conf und lang().

Wird benutzt von load().

     {
          global $conf;
          
          if   ( count($row) > 1 )
          {
               $this->userid   = $row['id'      ];
               $this->name     = $row['name'    ];
               $this->style    = $row['style'   ];
               $this->isAdmin  = ( $row['is_admin'] == '1');
               $this->ldap_dn  = $row['ldap_dn' ];
               $this->fullname = $row['fullname'];
               $this->tel      = $row['tel'     ];
               $this->mail     = $row['mail'    ];
               $this->desc     = $row['descr'   ];
               
               if   ( $this->fullname == '' )
                    $this->fullname = $this->name;
                    
               if   ( $this->style == '' )
                    $this->style = $conf['interface']['style']['default'];
          }
          else
          {
               $this->userid   = -99;
               $this->name     = lang('UNKNOWN');
               $this->style    = $conf['interface']['style']['default'];
               $this->isAdmin  = false;
               $this->ldap_dn  = '';
               $this->fullname = lang('UNKNOWN');
               $this->tel      = '';
               $this->mail     = '';
               $this->desc     = '';
          }

          /* vorerst unbenutzt:
          if   ( $row['use_ldap'] == '1' )
          {
               // Daten aus LDAP-Verzeichnisdienst lesen

               // Verbindung zum LDAP-Server herstellen
               $ldap_conn = @ldap_connect( $conf['ldap']['host'],$conf['ldap']['port'] );
               
               if   ( !$ldap_conn )
               {
                    logger( 'INFO','cannot connect to LDAP server '.$conf['ldap']['host'].' '.$conf['ldap']['port'] );
                    $this->error = 'cannot connect to LDAP server';
                    return false;
               }
               
               // Anonymes LDAP-Login versuchen
               $ldap_bind = @ldap_bind( $ldap_conn );
               
               if   ( $ldap_bind )
               {
                    // Login erfolgreich
                    $sr = ldap_read( $ldap_conn,$row['ldap_dn'],'(objectclass=*)' );
                    
                    $daten   = ldap_get_entries( $ldap_conn,$sr );
                    
                    $this->fullname = $daten[0]['givenName'][0].' '.$daten[0]['sn'][0];
                    $this->tel      = $daten[0]['telephoneNumber'][0];
                    $this->mail     = $daten[0]['mail'][0];
                    $this->desc     = $daten[0]['description'][0];
               }
               
          }
          */
     }

User::setPassword	(	$	password,
		$	always = true
	)

Setzt ein neues Kennwort f�r diesen Benutzer.

Parameter:

	password	Kennwortt
	always	true, wenn Kennwort dauerhaft.

Definiert in Zeile 866 der Datei User.class.php.

Benutzt $db und db_connection().

     {
          $db = db_connection();

          $sql = new Sql( 'UPDATE {t_user} SET password={password}'.
                          'WHERE id={userid}' );
                          
          if   ( $always )
               $sql->setString('password',md5($password) );
          else
               $sql->setString('password',$password      );
               
          $sql->setInt   ('userid'  ,$this->userid  );

          $db->query( $sql->query );
     }

User::User

(

$

userid = ''

)

Definiert in Zeile 149 der Datei User.class.php.

Benutzt $userid.

Wird benutzt von getAllUsers() und loadWithName().

     {
          if   ( is_numeric($userid) )
               $this->userid = $userid;
     }

---

Dokumentation der Datenelemente

User::$desc

Definiert in Zeile 138 der Datei User.class.php.

User::$error = ''

Definiert in Zeile 131 der Datei User.class.php.

User::$fullname = ''

Definiert in Zeile 134 der Datei User.class.php.

User::$groups = null

Definiert in Zeile 146 der Datei User.class.php.

User::$isAdmin

Definiert in Zeile 140 der Datei User.class.php.

User::$ldap_dn

Definiert in Zeile 135 der Datei User.class.php.

User::$loginDate = 0

Definiert in Zeile 143 der Datei User.class.php.

User::$mail

Definiert in Zeile 137 der Datei User.class.php.

User::$mustChangePassword = false

Definiert in Zeile 145 der Datei User.class.php.

User::$name = ''

Definiert in Zeile 133 der Datei User.class.php.

Wird benutzt von add(), getUserName() und loadWithName().

User::$projects

Definiert in Zeile 141 der Datei User.class.php.

User::$rights

Definiert in Zeile 142 der Datei User.class.php.

User::$style

Definiert in Zeile 139 der Datei User.class.php.

User::$tel

Definiert in Zeile 136 der Datei User.class.php.

User::$userid = 0

Definiert in Zeile 130 der Datei User.class.php.

Wird benutzt von getUserName() und User().

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• objectClasses/User.class.php