Game_DeskController Klassenreferenz

Kontroller für den Spieltisch. Mehr ...

Klassendiagramm für Game_DeskController:

Aufstellung aller Elemente

Öffentliche Methoden
	preDispatch ()
	Modell und Session initialisieren.
	deleteAction ()
	Löscht Text mit übergebener ID.
	editAction ()
	Editieren vorhandener Texte.
	insertAction ()
	Fuegt neuen Text zu aktuellem Abenteuer hinzu.
	showAction ()
	Zeigt den Spieltisch oder laedt ueber Ajax Texte nach.
Geschützte Attribute
	$_namespaceGameDesk = null
	Zend_Session_Namespace, Sessionnamensbereich des Spieltisches.

---

Ausführliche Beschreibung

Kontroller für den Spieltisch.

Autor:

DSAo-Md

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

Version:

SVN: $Id: DeskController.php 507 2009-05-11 12:37:51Z saviola777 $

Definiert in Zeile 9 der Datei DeskController.php.

---

Dokumentation der Elementfunktionen

Game_DeskController::deleteAction

(

)

Löscht Text mit übergebener ID.

Löscht Text mit übergebener ID, sofern der Benutzer die Erlaubnis hat.

Rückgabe:

bool

Definiert in Zeile 48 der Datei DeskController.php.

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

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

    $idText = $this->getUri()->id;

    // Falls keine Ajax-Anfrage
    if(!$this->isXmlHttpRequest())
    {
      // Falls Benutzer das Loeschen noch nicht bestaetigt hat
      if (!$this->getUri()->confirmation)
      {
        // Bestätigungstemplate anzeigen
        $this->getView()->addConfirmationTemplate(
          'game_desk_delete_confirmation',
          '/game/desk/delete/id/'.$idText.'/confirmation/1');

        return true;
      }

      // Einbinden von Template verhindern
      $this->getView()->addTemplate(false);
    }

    // Falls Text geloescht werden konnte
    if ($this->_getModel()->deleteText($this->getUser()->getId(), $idText))
    {
      // Falls Ajax-Anfrage
      if ($this->isXmlHttpRequest())
      {
        // ID uebergeben
        $this->getView()->assign('idText', $idText);

        return true;
      }

      // Bestaetigung
      $this->getLog()->affirm('game_desk_delete_affirmation_deleted');

      return true;
    }

    // Fehlermeldung ausgeben
    $this->getLog()->err('game_desk_delete_error_permission_denied');

    return false;
  }

Game_DeskController::editAction

(

)

Editieren vorhandener Texte.

Rückgabe:

bool

Definiert in Zeile 105 der Datei DeskController.php.

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

  {
    // int, ID des zu bearbeitenden Textes
    $idText = $this->getUri()->id;

    // Falls der Benutzer keine Berechtigung hat, auf ID zuzugreifen
    if (!$rowText = $this->_getModel()->hasChangePermission
      ($this->getUser()->getId(), $idText))
    {
      // Fehlermeldung ausgeben.
      $this->getLog()->err('game_desk_edit_error_permission_denied');
      $this->getView()->addTemplate(false);

      return false;
    }

    // Falls Formular noch nicht abgeschickt wurde
    if (!$this->getRequest()->isPost())
    {
      $rowTextContent = $rowText->content;

      // Fuer Ajax muss Zeile dekodiert werden
      if ($this->isXmlHttpRequest())
      {
        $rowTextArray = $rowText->toArrayDecoded();

        $rowTextContent = $rowTextArray['content'];
      }

      $this->getView()->assign(array(
        'gameDeskEditContent' => $rowTextContent,
        'idText'              => $idText
        ));

      return true;
    }

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

    // Text editieren
    $this->_getModel()->editText($this->getUser(), $idText,
      $this->getRequest()->getPost('content'));

    // Falls Inhalt vorhanden
    if ($this->getRequest()->getPost('content'))
    {
      // Falls Ajax-Anfrage, den Inhalt zurueckgeben
      if ($this->isXmlHttpRequest())
      {
        // Zeile aktualisieren und dekodieren
        $rowText->refresh();
        $rowTextArray = $rowText->toArrayDecoded();

        // Inhalt uebergeben.
        $this->getView()->getAjaxResponse()->setData
          ($rowTextArray['content'] , Dsao_Ajax_Response::PLAIN);
      }

      $this->getLog()->affirm('game_desk_edit_affirmation_edited');
    }
    // Ansonsten ist Text geloescht worden
    else
    {
      $this->getLog()->affirm('game_desk_delete_affirmation_deleted');
    }

    $this->getView()->addTemplate(false);

    return true;
  }

Game_DeskController::insertAction

(

)

Fuegt neuen Text zu aktuellem Abenteuer hinzu.

Rückgabe:

bool

Definiert in Zeile 185 der Datei DeskController.php.

Benutzt Dsao_Controller_Action::_getModel(), Dsao_Controller_Action::_gotoSimple(), Dsao_Controller_Action::getHelper(), Dsao_Controller_Action::getUser(), Dsao_Controller_Action::isXmlHttpRequest() und showAction().

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

    $this->_getModel()->insertText(1, $this->getUser()->username,
      $this->getRequest()->getPost('content'));

    // Falls keine Ajax-Anfrage
    if (!$this->isXmlHttpRequest())
    {
      $this->_gotoSimple('show');

      return true;
    }

    // Texte laden
    $this->showAction();

    return true;
  }

Game_DeskController::preDispatch

(

)

Modell und Session initialisieren.

Rückgabe:

void

Erneute Implementation von Dsao_Controller_Action.

Definiert in Zeile 21 der Datei DeskController.php.

Benutzt Dsao_Controller_Action::_getModel() und Dsao_Controller_Action::_setDefaultModelClass().

  {
    // Standardmodellklasse
    $this->_setDefaultModelClass('Game_Desk');

    // Falls Seite zum ersten Mal aufgerufen wurde, Session initialisieren
    if (!Zend_Session::namespaceIsset('game_desk'))
    {
      $this->_namespaceGameDesk = new Zend_Session_Namespace('game_desk');
      $this->_namespaceGameDesk->lastRefresh = time()-60*60*24*7;
    }
    else
    {
      $this->_namespaceGameDesk = new Zend_Session_Namespace('game_desk');
    }

    // Ggf. Aufraeumaktion durchfuehren -> leere Zeilen werden geloescht
    $this->_getModel()->deleteEmptyRows();
  }

Game_DeskController::showAction

(

)

Zeigt den Spieltisch oder laedt ueber Ajax Texte nach.

Rückgabe:

bool

Definiert in Zeile 215 der Datei DeskController.php.

Benutzt Dsao_Controller_Action::_addJsFile(), Dsao_Controller_Action::_getModel(), Dsao_Controller_Action::getHelper(), Dsao_Controller_Action::getTranslate(), Dsao_Controller_Action::getView() und Dsao_Controller_Action::isXmlHttpRequest().

Wird benutzt von insertAction().

  {
    // Falls es eine Ajax-Anfrage ist
    if ($this->isXmlHttpRequest())
    {
      $this->getView()->assign('texts', $this->_getModel()->fetchGroupTexts
        (1, $this->_namespaceGameDesk->lastRefresh, true)->toArrayDecoded());

      // Session aktualisieren
      $this->_namespaceGameDesk->lastRefresh = time();

      return true;
    }
    // Zur History hinzufügen
    else
    {
      $this->getHelper('History')->setAddToHistory();
    }

    // array, Geladene Texte
    $loadedTexts = $this->_getModel()->fetchGroupTexts
      (1, time()-60*60*24*7)->toArrayDecoded();

    // Session aktualisieren
    $this->_namespaceGameDesk->lastRefresh = time();

    // Systemeintrag
    $loadedTexts[] = array
      (
        'author'          => 'System',
        'content'         => $this->getTranslate()->
          _('game_desk_show_info_no_texts'),
        'id'              => 'system',
        'lastEditedBy'  => 'System',
        'timeCreated'    => date('d.m.y - H:i:s'),
        'timeLastEdited'=> date('d.m.y - H:i:s'),
      );

    $this->getView()->assign_by_ref('gameDeskTexts', $loadedTexts);

    // Scriptaculous laden
    $this->getView()->addScriptaculousFiles(array('effects', 'controls'));

    // JS-Datei hinzufuegen
    $this->_addJsFile();

    // JS-Texte hinzufuegen
    $this->getView()->addJsTexts(array
      (
        'game_desk_delete_confirmation',
        'game_desk_edit_js_cancel_template',
        'game_desk_edit_js_loading_template',
        'game_desk_edit_js_saving_template',
        'game_desk_edit_js_submit_template'
      ));

    return true;
  }

---

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

• /var/www/devel.dsao.eu/controllers/game/DeskController.php