History.php

<?php
class Dsao_Controller_Action_Helper_History
  extends Zend_Controller_Action_Helper_Abstract
{
  protected $_addToHistory = 0;

  protected $_namespaceHistory = null;

  public function getPreviousUri()
  {
    // Falls History nicht vorhanden
    if (null === $this->_namespaceHistory)
    {
      return null;
    }

    return new Dsao_Uri_Http(end(array_keys($this->_namespaceHistory->entries)));
  }

  public function init()
  {
    // Falls Benutzer gültig und History noch nicht initialisiert
    if ($this->getActionController()->getUser()->isValid()
      && null === $this->_namespaceHistory)
    {
      $this->_namespaceHistory = new Zend_Session_Namespace('history');

      // Falls Array mit History-Einträgen noch nicht vorhanden
      if (!isset($this->_namespaceHistory->entries))
      {
        $this->_namespaceHistory->entries = array();
      }
    }
  }

  public function postDispatch()
  {
    // Falls Ajax-Anfrage, Weiterleitung aktiviert, Benutzer nicht
    // angemeldet oder noch Aktionen ausgeführt werden sollen, abbrechen
    if ($this->getActionController()->isXmlHttpRequest()
        || $this->getResponse()->isRedirect()
        || !$this->getActionController()->getUser()->isValid()
        || !$this->getRequest()->isDispatched())
    {
      return;
    }

    // string, Message-ID für die Beschriftung des Links
    $label = null;

    // string, URI der zur aktuellen Seite
    $uri = null;

    // array, Array aus aufgerufenem Modul, Controller und Aktion
    $moduleControllerAction = array
      (
        $this->getRequest()->getModuleName(),
        $this->getRequest()->getControllerName(),
        $this->getRequest()->getActionName(),
      );

    $label = implode('_', $moduleControllerAction);

    // Falls Parameter des Aufrufs beibehalten werden sollen
    if (2 == $this->_addToHistory)
    {
      // Token entfernen
      unset($this->getActionController()->getUri()->token);

      // String
      $uri = $this->getActionController()->getUri()->getUriString();
    }
    // Ansonsten Link aus aktuellem Modul, Controller und Aktion aufbauen
    else
    {
      $uri = $this->getActionController()->getUri()->getUriString(false);
    }

    // Falls ein Eintrag mit der gleichen Beschreibung existiert, diesen
    // löschen
    if (null !== $label && isset($this->_namespaceHistory->entries[$label]))
    {
      unset($this->_namespaceHistory->entries[$label]);
    }

    // Falls History vorhanden
    if (!empty($this->_namespaceHistory->entries))
    {
      $history = array_reverse($this->_namespaceHistory->entries);

      // History-Einträge an Smarty übergeben
      $this->getActionController()->getView()
        ->assign_by_ref('historyEntries', $history);
    }

    // Falls Seite nicht zur History hinzugefügt werden soll, abbrechen
    if (!$this->_addToHistory)
    {
      return false;
    }

    // Eintrag hinzufügen
    $this->_namespaceHistory->entries[$label] = $uri;

    // Falls maximale Anzahl Einträge erreicht ist, ersten Eintrag entfernen
    if (count($this->_namespaceHistory->entries) >
      $this->getActionController()->getConfig()->history->maxEntries)
    {
      array_shift($this->_namespaceHistory->entries);
    }

    return true;
  }

  public function setAddToHistory($add = true, $retainParameters = true)
  {
    // Falls Seite hinzugefügt, und Parameter behalten werden sollen
    if ($add && $retainParameters)
    {
      $this->_addToHistory = 2;
    }
    else
    {
      $this->_addToHistory = (int) (bool) $add;
    }

    return $this;
  }
}