Dsao_Model_User_Profile Klassenreferenz

Klasse verarbeitet Eingaben des Benutzers in seinem Profil. Mehr ...

Klassendiagramm für Dsao_Model_User_Profile:

Aufstellung aller Elemente

Öffentliche Methoden
	editProfile (Zend_Controller_Request_Http $request, Dsao_User $user)
	Bearbeitung des Profils.
Geschützte Methoden
	_editEmailAddress ()
	Ändern der E-Mail-Adresse.
	_editPassword ()
	Ändern des Passworts.
	_editUserData ()
	Ändern der Benutzerdaten.
Geschützte Attribute
	$_request = null
	Zend_Controller_Request_Http, Objekt mit Formulardaten.
	$_user = null
	Dsao_User, Benutzer, dessen Daten geändert werden sollen.

---

Ausführliche Beschreibung

Klasse verarbeitet Eingaben des Benutzers in seinem Profil.

Autor:

DSAo-Md

http://www.gnu.org/licenses/gpl-3.0.html GNU Public License

Version:

SVN: $Id: Profile.php 512 2009-06-19 08:11:48Z saviola777 $

Definiert in Zeile 9 der Datei Profile.php.

---

Dokumentation der Elementfunktionen

Dsao_Model_User_Profile::_editEmailAddress

(

)

[protected]

Ändern der E-Mail-Adresse.

Prüft, ob neue E-Mail-Adresse gültig ist und setzt sie ggf.

Rückgabe:

bool, ob neue E-Mail-Adresse übernommen werden soll

Definiert in Zeile 28 der Datei Profile.php.

Benutzt Dsao_Model_Abstract::getLog() und Dsao_Registry::getModel().

Wird benutzt von editProfile().

  {
    // Falls HTTP-Abfrage oder Benutzer nicht initialisiert, abbrechen
    if (!$this->_request || !$this->_user)
    {
      return false;
    }

    // Formulardaten initialisieren
    $emailAddress             = strtolower(trim
      ($this->_request->getPost('emailAddress')));
    $emailAddressVerification = strtolower(trim($this->_request->getPost
      ('emailAddressVerification')));
    $password                 = $this->_request->getPost('password');

    // Validator für die E-Mail-Adresse
    $validator = new Zend_Validate_EmailAddress();

    // Falls keine E-Mail-Adresse übergeben, oder neue mit bisheriger
    // uebereinstimmt
    if (!$emailAddress || $emailAddress == $this->_user->emailAddress)
    {
      $this->getLog()->err(null, __METHOD__);
    }

    // Falls zweite Eingabe nicht mit der ersten uebereinstimmt
    else if ($emailAddress != $emailAddressVerification)
    {
      $this->getLog()->err('user_register_email_error_nonconform', __METHOD__);
    }

    // Falls Passwort nicht eingegeben wurde
    else if (!$password)
    {
      $this->getLog()->err
        ('user_profile_edit_error_password_missing', __METHOD__);
    }

    // Falls Passwort falsch, abbrechen
    else if (md5($password) != $this->_user->password)
    {
      $this->getLog()->err('user_profile_edit_error_password_wrong', __METHOD__);
    }

    // Falls E-Mail-Adresse ungueltig, abbrechen
    else if (!$validator->isValid($emailAddress))
    {
      $this->getLog()->err('user_register_email_error_invalid', __METHOD__);
    }

    // Einmaligkeit der E-Mail-Adresse pruefen
    else if (Dsao_Registry::getModel('User_Register')->isUniqueEmailAddress($emailAddress))
    {
      $this->getLog()->err('user_register_email_error_not_unique', __METHOD__);
    }

    // Falls Fehler aufgetreten sind
    if ($this->getLog()->hasError(__METHOD__))
    {
      return false;
    }

    // Keine Fehler aufgetreten, also E-Mail-Adresse ändern
    $this->_user->emailAddress = $emailAddress;

    return true;
  }

Dsao_Model_User_Profile::_editPassword

(

)

[protected]

Ändern des Passworts.

Die Methode prueft, ob der Benutzer sowohl das alte, als auch das neue (zwei mal) Passwort korrekt eingegeben hat und aendert es ggf.

Rückgabe:

bool, ob Passwort geändert wurde

Definiert in Zeile 104 der Datei Profile.php.

Benutzt Dsao_Hash::fromText() und Dsao_Model_Abstract::getLog().

Wird benutzt von editProfile().

  {
    // Falls HTTP-Abfrage oder Benutzer nicht initialisiert, abbrechen
    if (!$this->_request || !$this->_user)
    {
      return false;
    }

    // Formulardaten initialisieren
    $password                 = $this->_request->getPost('password');
    $passwordNew              = $this->_request->getPost('passwordNew');
    $passwordNewVerification  = $this->_request->getPost
      ('passwordNewVerification');

    // Validator für das Passwort instanziieren
    $validator = new Dsao_Validate_Password();

    // Falls neues Passwort nicht uebergeben wurde oder mit bisherigem
    // übereinstimmt, abbrechen
    if (!$passwordNew || md5($passwordNew) == $this->_user->password)
    {
      $this->getLog()->err(null, __METHOD__);
    }

    // Falls zweite Eingabe nicht mit erster uebereinstimmt, abbrechen
    else if ($passwordNew != $passwordNewVerification)
    {
      $this->getLog()->err
        ('user_register_password_error_nonconform', __METHOD__);
    }

    // Falls Passwort nicht eingegeben, abbrechen
    else if (!$password)
    {
      $this->getLog()->err
        ('user_profile_edit_error_password_missing', __METHOD__);
    }

    // Falls Passwort falsch, abbrechen
    else if (md5($password) != $this->_user->password)
    {
      $this->getLog()->err('user_profile_edit_error_password_wrong', __METHOD__);
    }

    // Falls neues Passwort ungueltig, abbrechen
    else if (!$validator->isValid($passwordNew))
    {
      $this->getLog()->err('user_register_password_error_invalid', __METHOD__);
    }

    // Falls Fehler aufgetreten sind, abbrechen
    if ($this->getLog()->hasError(__METHOD__))
    {
      return false;
    }

    // Keine Fehler aufgetreten, also Passwort aendern
    $this->_user->password = Dsao_Hash_Password::fromText($passwordNew)
      ->getHash();

    return true;
  }

Dsao_Model_User_Profile::_editUserData

(

)

[protected]

Ändern der Benutzerdaten.

Prueft, ob Benutzerdaten geaendert wurden und, falls gueltige Werte uebergeben wurden, schreibt diese in das Benutzerobjekt.

Die Methode geht gruppierte Elemente (numerisch, alphanumerisch usw.) durch und filtert / prueft sie auf Gueltigkeit, bevor sie ggf. in das Benutzerobjekt geschrieben werden.

Rückgabe:

array, Array mit geaenderten Benutzerdaten oder leeres Array

Definiert in Zeile 179 der Datei Profile.php.

Benutzt Dsao_Model_Abstract::underscore().

Wird benutzt von editProfile().

  {
    // array, Geaenderte Benutzerdaten
    $changedCols = array();

    // array, Spalten, in denen Fehler aufgetreten sind
    $invalidCols = array();

    // array, Enthaelt alle Arrays fuer die Benutzerdaten
    $userDataFilters = array();

    // Zend_Filter_Input, Filter fuer alphanumerische Daten
    $userDataFilters['alphanumeric'] = new Dsao_Filter_Input
    (
      array // Filter
      (
        '*' => 'StringTrim',
      ),
      null, // Validatoren
      array // Daten
      (
        'contactAim'       => $this->_request->getPost('contactAim'),
        'contactSkype'     => $this->_request->getPost('contactSkype'),
        'layout'           => $this->_request->getPost('layout'),
        'personalBirthday' => $this->_request->getPost('personalBirthday'),
        'personalCity'     => $this->_request->getPost('personalCity'),
        'personalCountry'  => $this->_request->getPost('personalCountry'),
        'personalForename' => $this->_request->getPost('personalForename'),
        'personalStreet'   => $this->_request->getPost('personalStreet'),
        'personalSurname'  => $this->_request->getPost('personalSurname'),
      )
    );

    // Zend_Filter_Input, Filter fuer Benutzerdaten in E-Mail-Adressen-Form
    // (MSN, Jabber)
    $userDataFilters['emailAddresses'] = new Dsao_Filter_Input
    (
      array // Filter
      (
        '*' => 'StringTrim',
      ),
      array // Validatoren
      (
        '*' => array
        (
          'EmailAddress',
          'allowEmpty' => true,
        ),
      ),
      array // Daten
      (
        'contactJabber'  => $this->_request->getPost('contactJabber'),
        'contactMsn'     => $this->_request->getPost('contactMsn'),
      )
    );

    // Zend_Filter_Input, Filter fuer Benutzereinstellungen, die nur an oder
    // aus sein koennen
    $userDataFilters['flags'] = new Dsao_Filter_Input
    (
      array // Filter
      (
        '*' => 'Int',
      ),
      null, // Validatoren
      array // Daten
      (
        'javascriptLoadFiles'          => $this->_request->getPost
          ('javascriptLoadFiles'),
        'profileShowContactData'      => $this->_request->getPost
          ('showContactData'),
        'profileShowEmailAddress'     => $this->_request->getPost
          ('showEmailAddress'),
        'profileShowPersonalData'     => $this->_request->getPost
          ('showPersonalData'),
        'scrollMailNotification'      => $this->_request->getPost
          ('scrollMailNotification'),
      )
    );

    // Zend_Filter_Input, Filter fuer numerische Benutzerdaten
    $userDataFilters['numeric'] = new Dsao_Filter_Input
    (
      array // Filter
      (
        '*' => 'StringTrim',
      ),
      array // Validatoren
      (
        '*' => array
        (
          'Digits',
          'allowEmpty' => true,
        ),
      ),
      array // Daten
      (
        'contactIcq'       => $this->_request->getPost('contactIcq'),
        'personalPostcode' => $this->_request->getPost('personalPostcode'),
      )
    );

    // Arrays mit Filtern durchgehen
    foreach ($userDataFilters as $userDataFilter)
    {
      // Falls ungueltige Felder vorhanden
      if ($userDataFilter->hasInvalid())
      {
        // Ungueltige Felder durchlaufen und Fehlermeldungen ausgeben
        foreach ($userDataFilter->getUnknown() as $col => $formValue)
        {
          $invalidCols[] = self::underscore($col);
        }
      }

      // Benutzerdaten durchgehen
      foreach ($userDataFilter->getEscaped() as $col => $formValue)
      {
        // Falls Wert altem entspricht, zum Naechsten springen
        if ($formValue == $this->_user->$col)
        {
          continue;
        }

        // Ansonsten Wert in Benutzerobjekt schreiben
        $this->_user->$col = $formValue;

        // Aktuelle Spalte zu geaenderten Benutzerdaten hinzufuegen
        $changedCols[] = $col;
      }
    }

    return array(
      'changedCols' => $changedCols,
      'invalidCols' => $invalidCols);
  }

Dsao_Model_User_Profile::editProfile	(	Zend_Controller_Request_Http $	request,
		Dsao_User $	user
	)

Bearbeitung des Profils.

Nimmt eine HTTP-Anfrage und ein Benutzerobjekt entgegen und prüft dann, ob der Benutzer gültige Angaben zur Änderung seines Profils gemacht hat und gibt ggf. einen Array der geänderten Spalten zurück.

Parameter:

	$request	Zend_Controller_Request_Http, HTTP-Anfrage des Benutzers
	$user	Dsao_User, Benutzerobjekt

Rückgabe:

array, Geänderte Spalten

Definiert in Zeile 327 der Datei Profile.php.

Benutzt _editEmailAddress(), _editPassword(), _editUserData() und Dsao_DataHandler_Abstract::setReadOnly().

  {
    // Klassenvariablen setzen
    $this->_request = $request;
    $this->_user = $user->setReadOnly(false);

    // array, Geänderte / Fehlerhafte Spalten
    $cols = $this->_editUserData();

    // Falls E-Mail-Adresse geändert werden soll
    if ($this->_editEmailAddress())
    {
      $cols['changedCols'][] = 'emailAddress';
    }

    // Falls Passwort geändert werden soll
    if ($this->_editPassword())
    {
      $cols['changedCols'][] = 'password';
    }

    // Falls Benutzerdaten veraendert wurden
    if ($cols['changedCols'])
    {
      // Benutzerdaten in Datenbank aktualisieren
      $this->_user->update($cols['changedCols'])->setReserialize(true);
    }

    // Gültigkeit setzen und wieder als schreibgeschützt markieren
    $this->_user->setValid()->setReadOnly();

    // Klassenvariablen wieder zurücksetzen
    $this->_request = null;
    $this->_user = null;

    return $cols;
  }

---

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

• /var/www/devel.dsao.eu/library/Dsao/Model/User/Profile.php