Scroll_ScrollController Klassenreferenz

Controller zur Verwaltung einzelner Schriftrollen. Mehr ...

Klassendiagramm für Scroll_ScrollController:

Aufstellung aller Elemente

Öffentliche Methoden
	preDispatch ()
	Vor dem Dispatchen auszuführende Routinen.
	deleteAction ()
	Loescht eine Schriftrolle / einen Thread.
	sendAction ()
	Versenden einer Schriftrolle.

---

Ausführliche Beschreibung

Controller zur Verwaltung einzelner Schriftrollen.

Autor:

DSAo-Md

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

Version:

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

Definiert in Zeile 10 der Datei ScrollController.php.

---

Dokumentation der Elementfunktionen

Scroll_ScrollController::deleteAction

(

)

Loescht eine Schriftrolle / einen Thread.

Rückgabe:

Definiert in Zeile 22 der Datei ScrollController.php.

Benutzt Dsao_Controller_Action::_getModel(), Dsao_Controller_Action::getHelper(), Dsao_Controller_Action::getLog(), Dsao_Controller_Action::getUri(), Dsao_Controller_Action::getUser() und Dsao_Controller_Action::getView().

  {
    // Standardmaessig kein Template anzeigen
    $this->getView()->addTemplate(false);

    // int, ID der zu loeschenden Schriftrolle
    $idScroll = $this->getUri()->id;

    // bool|Dsao_Scroll, enthaelt entweder die zu loeschende Schriftrolle
    // oder false
    $scroll = $this->_getModel()->isParticipated
      ($this->getUser()->getId(), $idScroll);

    // Falls Schriftrolle nicht vorhanden bzw. Benutzer nicht daran beteiligt
    if (!$scroll || $scroll->isDeleted($this->getUser()->getId()))
    {
      $this->getLog()->err('scroll_scroll_delete_error_no_permission');

      return;
    }

    // string, Ob Schriftrolle oder Thread geloescht werden soll
    $scrollThread = 'scroll_scroll';

    // Falls Thread geloescht werden soll.
    if ($this->getUri()->thread)
    {
      $scrollThread = 'scroll_thread';
    }

    // Falls Benutzer Loeschen noch nicht bestaetigt hat
    if (!$this->getUri()->confirm)
    {
      // URI für die Bestätigung
      $uriConfirm = new Dsao_Uri_Http('/scroll/scroll/delete', array(
        'confirm' => true,
        'id'      => $idScroll,
      ));

      // Falls Thread gelöscht werden soll
      if ($scrollThread == 'scroll_thread')
      {
        $uriConfirm->thread = true;
      }

      $this->getView()->addConfirmationTemplate(array(
        'scroll_scroll_delete_confirm',
        array(
          'nameAuthor'    => $scroll->nameAuthor,
          'scrollThread'  => $scrollThread,
          'subject'       => $scroll->subject,
        ), true),
        $uriConfirm);

      return true;
    }

    // Token
    if (!$this->getHelper('SessionToken')->hasValidToken())
    {
      return;
    }

    // Dsao_Scrollset, die zu loeschenden Schriftrollen, im Normalfall ist
    // dies nur eine, naemlich $scroll. Falls es sich jedoch um einen Thread
    // handelt, sind es mehrere
    $scrolls = null;

    // Falls es sich um die Anfangsschriftrolle eines Threads handelt
    if ($scroll->idThread == 0)
    {
      $scrolls = $this->_getModel('Scroll_Thread')->fetchThread
        ($idScroll, $this->getUser()->getId());
    }
    else
    {
      $scrolls = new Dsao_Scrollset(array($scroll));
    }

    $scrolls->delete($this->getUser()->getId());

    // Bestaetigung
    $this->getLog()->affirm
      (array('scroll_scroll_delete_affirmation_deleted',
        array('scrollThread' => $scrollThread), true));
  }

Scroll_ScrollController::sendAction

(

)

Versenden einer Schriftrolle.

Rückgabe:

Definiert in Zeile 114 der Datei ScrollController.php.

Benutzt Dsao_Controller_Action::_getModel(), Dsao_Controller_Action::getHelper(), Dsao_Controller_Action::getLog(), Dsao_Controller_Action::getUser(), Dsao_Controller_Action::getView() und Dsao_Model_Abstract::underscore().

  {
    $this->getHelper('History')->setAddToHistory();

    $scrollDataSubmitted = array
      (
        'content'       => $this->getRequest()->getParam('content', false),
        'idThread'      => $this->getRequest()->getParam('idthread', 0),
        'nameRecipient' => $this->getRequest()->getParam('recipient', false),
        'subject'       => $this->getRequest()->getParam('subject', false)
      );

    $scrollSubmitted = new Dsao_Scroll($scrollDataSubmitted);

    // Falls Formular abgeschickt wurde.
    if ($this->getRequest()->isPost())
    {
      // Token
      if (!$this->getHelper('SessionToken')->hasValidToken())
      {
        return;
      }

      $scroll = clone $scrollSubmitted;

      // Falls Fehler beim Einfuegen aufgetreten sind.
      if (!$this->_getModel()->insertScroll($scroll)->isValid())
      {
        // Ueberpruefte Daten durchgehen.
        foreach ($scroll->toArray() as $key => $value)
        {
          // Falls Fehler aufgetreten.
          if (false === $value)
          {
            $this->getLog()
              ->err('scroll_scroll_send_error_'.Dsao_Model_Abstract::underscore($key));
          }
        }
      }
      else
      {
        // Bestaetigung ausgeben.
        $this->getLog()->affirm(array('scroll_scroll_send_affirmation_sent',
          array('username' => $scroll->nameRecipient)));

        // Kein Template anzeigen.
        $this->getView()->addTemplate(false);

        return;
      }
    }

    // Falls Thread-ID uebergeben wurde, Empfaenger und Betreff laden.
    if ($scrollSubmitted->idThread > 0)
    {
      // Falls Benutzer an Thread beteiligt.
      if ( ($scrollThread = $this->_getModel()->
        isParticipated($this->getUser()->id, $scrollSubmitted->idThread)) )
      {
        $scrollSubmitted->idThread      = $scrollThread->id;
        $scrollSubmitted->subject       = $scrollThread->subject;
        $scrollSubmitted->nameRecipient  = $scrollThread
          ->getOtherUser($this->getUser()->id)->username;
      }
      // Ansonsten Fehlermeldung ausgeben.
      else
      {
        $this->getLog()->err('scroll_scroll_send_error_idthread');
      }
    }

    $this->getView()->assign('scroll', $scrollSubmitted);
  }

---

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

• /var/www/devel.dsao.eu/controllers/scroll/ScrollController.php