merge

doc/files/agents/BottomlevelAgent.inc.txt

@@ -0,0 +1,26 @@
+<?php
+
+	/**
+	 * NRE
+	 *
+	 * @author	coderkun <olli@coderkun.de>
+	 * @copyright	2013 coderkun (http://www.coderkun.de)
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	http://www.coderkun.de/projects/nre
+	 */
+	
+	namespace nre\agents;
+	
+	
+	/**
+	 * The BottomlevelAgent is the standard Agent and can have indefinite
+	 * SubAgents.
+	 * 
+	 * @author	coderkun <olli@coderkun.de>
+	 */
+	abstract class BottomlevelAgent extends \nre\core\Agent
+	{
+	}
+
+?>
+

doc/files/agents/IntermediateAgent.inc.txt

@@ -0,0 +1,50 @@
+<?php
+
+	/**
+	 * NRE
+	 *
+	 * @author	coderkun <olli@coderkun.de>
+	 * @copyright	2013 coderkun (http://www.coderkun.de)
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	http://www.coderkun.de/projects/nre
+	 */
+	
+	namespace nre\agents;
+	
+	
+	/**
+	 * The IntermediateAgent assumes the task of a module. There is only one
+	 * IntermediateAgent per request.
+	 * 
+	 * @author	coderkun <olli@coderkun.de>
+	 */
+	abstract class IntermediateAgent extends \nre\core\Agent
+	{
+		
+		
+		
+		
+		/**
+		 * Get the layout if it was explicitly defined.
+		 * 
+		 * @param	string	$agentName	Agent name
+		 * @return	string			Layout of the IntermediateAgent
+		 */
+		public static function getLayout($agentName)
+		{
+			// Determine classname
+			$className = Autoloader::concatClassNames($agentName, 'Agent');
+			
+			// Check property
+			if(isset($className::$layout)) {
+				return $className::$layout;
+			}
+			
+			
+			return null;
+		}
+		
+	}
+
+?>
+

doc/files/agents/ToplevelAgent.inc.txt

@@ -0,0 +1,396 @@
+<?php
+
+	/**
+	 * NRE
+	 *
+	 * @author	coderkun <olli@coderkun.de>
+	 * @copyright	2013 coderkun (http://www.coderkun.de)
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	http://www.coderkun.de/projects/nre
+	 */
+	
+	namespace nre\agents;
+	
+	
+	/**
+	 * The ToplevelAgent assumes the task of a FrontController. There is
+	 * only one per request.
+	 * 
+	 * @author	coderkun <olli@coderkun.de>
+	 */
+	class ToplevelAgent extends \nre\core\Agent
+	{
+		/**
+		 * Stage: Load
+		 * 
+		 * @var string
+		 */
+		const STAGE_LOAD	=	'load';
+		/**
+		 * Stage: Run
+		 * 
+		 * @var string
+		 */
+		const STAGE_RUN		=	'run';
+		
+		/**
+		 * Current request
+		 * 
+		 * @var \nre\core\Request
+		 */
+		private $request;
+		/**
+		 * Current response
+		 * 
+		 * @var \nre\core\Response
+		 */
+		private $response;
+		/**
+		 * Layout instace
+		 * 
+		 * @var \nre\core\Layout
+		 */
+		private $layout = null;
+		/**
+		 * IntermediateAgent instance
+		 * 
+		 * @var IntermediateAgent
+		 */
+		private $intermediateAgent = null;
+		
+		
+		
+		
+		/**
+		 * Construct a ToplevelAgent.
+		 * 
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 * @throws	\nre\exceptions\DatamodelException
+		 * @throws	\nre\exceptions\DriverNotValidException
+		 * @throws	\nre\exceptions\DriverNotFoundException
+		 * @throws	\nre\exceptions\ViewNotFoundException
+		 * @throws	\nre\exceptions\ModelNotValidException
+		 * @throws	\nre\exceptions\ModelNotFoundException
+		 * @throws	\nre\exceptions\ControllerNotValidException
+		 * @throws	\nre\exceptions\ControllerNotFoundException
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Log-system
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			// Store values
+			$this->request = $request;
+			$this->response = $response;
+			
+			
+			// Create response
+			$response = clone $response;
+			$response->clearParams(1);
+			$response->addParams(
+				null,
+				\nre\configs\CoreConfig::$defaults['action']
+			);
+			
+			// Call parent constructor
+			parent::__construct($request, $response, $log, true);
+			
+			
+			// Load IntermediateAgent
+			$this->loadIntermediateAgent();
+		}
+		
+		
+		
+		
+		/**
+		 * Run the Controller of this Agent and its SubAgents.
+		 * 
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @return	\Exception				Last occurred exception of SubAgents
+		 */
+		public function run(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			try {
+				return $this->_run($request, $response);
+			}
+			catch(\nre\exceptions\AccessDeniedException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_FORBIDDEN, self::STAGE_RUN);
+			}
+			catch(\nre\exceptions\ParamsNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND, self::STAGE_RUN);
+			}
+			catch(\nre\exceptions\IdNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND, self::STAGE_RUN);
+			}
+			catch(\nre\exceptions\DatamodelException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE, self::STAGE_RUN);
+			}
+			catch(\nre\exceptions\ActionNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND, self::STAGE_RUN);
+			}
+		}
+		
+		
+		/**
+		 * Generate output of the Controller of this Agent and its
+		 * SubAgents.
+		 * 
+		 * @param	array	$data	View data
+		 * @return	string		Generated output
+		 */
+		public function render($data=array())
+		{
+			// Render IntermediateAgent
+			$data = array();
+			$data['intermediate'] = $this->intermediateAgent->render();
+			
+			
+			// Render ToplevelAgent
+			return parent::render($data);
+		}
+		
+		
+		/**
+		 * Return the IntermediateAgent.
+		 * 
+		 * @return	\nre\agents\IntermediateAgent	IntermediateAgent
+		 */
+		public function getIntermediateAgent()
+		{
+			return $this->intermediateAgent;
+		}
+		
+		
+		
+		
+		/**
+		 * Load a SubAgent and add it.
+		 * 
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 * @throws	\nre\exceptions\FatalDatamodelException
+		 * @throws	\nre\exceptions\AgentNotFoundException
+		 * @throws	\nre\exceptions\AgentNotValidException
+		 * @param	string	$agentName	Name of the Agent to load
+		 * @param	mixed	…		Additional parameters for the agent
+		 */
+		protected function addSubAgent($agentName)
+		{
+			try {
+				call_user_func_array(
+					array(
+						$this,
+						'_addSubAgent'
+					),
+					func_get_args()
+				);
+			}
+			catch(\nre\exceptions\DatamodelException $e) {
+				throw new \nre\exceptions\FatalDatamodelException($e->getDatamodelMessage(), $e->getDatamodelErrorNumber());
+			}
+		}
+		
+		
+		
+		
+		/**
+		 * Load IntermediateAgent defined by the current request.
+		 * 
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 */
+		private function loadIntermediateAgent()
+		{
+			try {
+				$this->_loadIntermediateAgent();
+			}
+			catch(\nre\exceptions\ViewNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+			}
+			catch(\nre\exceptions\DatamodelException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\DriverNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\DriverNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\ModelNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\ModelNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\ControllerNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\ControllerNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+			}
+			catch(\nre\exceptions\AgentNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\AgentNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+			}
+		}
+		
+		
+		/**
+		 * Load IntermediateAgent defined by the current request.
+		 * 
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 */
+		private function _loadIntermediateAgent()
+		{
+			// Determine IntermediateAgent
+			$agentName = $this->response->getParam(1);
+			if(is_null($agentName)) {
+				$agentName = $this->request->getParam(1, 'intermediate');
+				$this->response->addParam($agentName);
+			}
+			
+			// Load IntermediateAgent
+			IntermediateAgent::load($agentName);
+			
+			
+			// Determine Action
+			$action = $this->response->getParam(2);
+			if(is_null($action)) {
+				$action = $this->request->getParam(2, 'action');
+				$this->response->addParam($action);
+			}
+			
+			// Construct IntermediateAgent
+			$this->intermediateAgent = \nre\agents\IntermediateAgent::factory(
+				$agentName,
+				$this->request,
+				$this->response,
+				$this->log
+			);
+		}
+		
+		
+		/**
+		 * Run the Controller of this Agent and its SubAgents.
+		 * 
+		 * @throws	\nre\exceptions\AccessDeniedException
+		 * @throws	\nre\exceptions\IdNotFoundException
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 * @throws	\nre\exceptions\DatamodelException
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @return	\Exception			Last occurred exception of SubAgents
+		 */
+		private function _run(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Run IntermediateAgent
+			$this->runIntermediateAgent();
+			
+			
+			// TODO Request instead of response?
+			$response = clone $response;
+			$response->clearParams(2);
+			$response->addParam(\nre\configs\CoreConfig::$defaults['action']);
+			
+			
+			// Run ToplevelAgent
+			return parent::run($request, $response);
+		}
+		
+		
+		/**
+		 * Run IntermediateAgent.
+		 * 
+		 * @throws	\nre\exceptions\AccessDeniedException
+		 * @throws	\nre\exceptions\ParamsNotValidException
+		 * @throws	\nre\exceptions\IdNotFoundException
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 * @throws	\nre\exceptions\DatamodelException
+		 */
+		private function runIntermediateAgent()
+		{
+			$this->intermediateAgent->run(
+				$this->request,
+				$this->response
+			);
+		}
+		
+		
+		/**
+		 * Handle an error that occurred during
+		 * loading/cnostructing/running of the IntermediateAgent.
+		 * 
+		 * @throws	\nre\exceptions\ServiceUnavailableException
+		 * @param	\Exception	$exception	Occurred exception
+		 * @param	int		$httpStatusCode	HTTP-statuscode
+		 * @param	string		$stage		Stage of execution
+		 */
+		private function error($exception, $httpStatusCode, $stage=self::STAGE_LOAD)
+		{
+			// Log error
+			$this->log($exception, \nre\core\Logger::LOGMODE_AUTO);
+			
+			
+			try {
+				// Define ErrorAgent
+				$this->response->clearParams(1);
+				$this->response->addParams(
+					\nre\configs\AppConfig::$defaults['intermediate-error'],
+					\nre\configs\CoreConfig::$defaults['action'],
+					$httpStatusCode
+				);
+				
+				// Load ErrorAgent
+				$this->_loadIntermediateAgent();
+				
+				// Run ErrorAgent
+				if($stage == self::STAGE_RUN) {
+					$this->_run($this->request, $this->response);
+				}
+			}
+			catch(\nre\exceptions\ActionNotFoundException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+			}
+			catch(\nre\exceptions\DatamodelException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+		 	}
+			catch(\nre\exceptions\DriverNotValidException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+		 	}
+			catch(\nre\exceptions\DriverNotFoundException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+		 	}
+			catch(\nre\exceptions\ModelNotValidException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+		 	}
+		 	catch(\nre\exceptions\ModelNotFoundException $e) {
+		 		throw new \nre\exceptions\ServiceUnavailableException($e);
+		 	}
+		 	catch(\nre\exceptions\ViewNotFoundException $e) {
+		 		throw new \nre\exceptions\ServiceUnavailableException($e);
+		 	}
+			catch(\nre\exceptions\ControllerNotValidException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+			}
+			catch(\nre\exceptions\ControllerNotFoundException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+			}
+			catch(\nre\exceptions\AgentNotValidException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+			}
+			catch(\nre\exceptions\AgentNotFoundException $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+			}
+			catch(Exception $e) {
+				throw new \nre\exceptions\ServiceUnavailableException($e);
+			}
+		}
+		
+		
+	}
+
+?>
+

doc/files/agents/bottomlevel/MailreceiverAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\bottomlevel;
+	
+	
+	/**
+	 * Agent to generate a mail receiver salutation.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MailreceiverAgent extends \nre\agents\BottomlevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/bottomlevel/MenuAgent.inc.txt

@@ -0,0 +1,41 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\bottomlevel;
+	
+	
+	/**
+	 * Agent to display a menu.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MenuAgent extends \nre\agents\BottomlevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Add Seminary menu
+			$this->addSubAgent('Seminarymenu');
+		}
+		
+	}
+
+?>
+

doc/files/agents/bottomlevel/QuestgroupshierarchypathAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\bottomlevel;
+	
+	
+	/**
+	 * Agent to display the Questgroups hierarchy path.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuestgroupshierarchypathAgent extends \nre\agents\BottomlevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/bottomlevel/SeminarybarAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\bottomlevel;
+	
+	
+	/**
+	 * Agent to display a sidebar with Seminary related information.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class SeminarybarAgent extends \nre\agents\BottomlevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/bottomlevel/SeminarymenuAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\bottomlevel;
+	
+	
+	/**
+	 * Agent to display a menu with Seminary related links.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class SeminarymenuAgent extends \nre\agents\BottomlevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/bottomlevel/UserrolesAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\bottomlevel;
+	
+	
+	/**
+	 * Agent to display and manage userroles.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class UserrolesAgent extends \nre\agents\BottomlevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: user.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function user(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/AchievementsAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to list Achievements.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class AchievementsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/CharactergroupsAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to display Character groups.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class CharactergroupsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/CharactergroupsquestsAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to display Character groups Quests.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class CharactergroupsquestsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/CharactersAgent.inc.txt

@@ -0,0 +1,50 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to list registered Characters and their data.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class CharactersAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+		
+		/**
+		 * Action: character.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function character(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/CharactertypesAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to handle Charactertyes of a Seminary.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class CharactertypesAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/ErrorAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to show an error page.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class ErrorAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/IntroductionAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to show an introduction page.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class IntroductionAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/LibraryAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to list Quest topics.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class LibraryAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/MailAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to generate a mail-message.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MailAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/MediaAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+	
+	/**
+	 * Agent to process and show media.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MediaAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/QuestgroupsAgent.inc.txt

@@ -0,0 +1,76 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to display Questgroups.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuestgroupsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: questgroup.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function questgroup(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+		
+
+		/**
+		 * Action: edit.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function edit(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+
+
+		/**
+		 * Action: edittexts.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function edittexts(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+		
+
+		/**
+		 * Action: delete.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function delete(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/QuestgroupshierarchyAgent.inc.txt

@@ -0,0 +1,25 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to manage Questgroupshierarchy.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuestgroupshierarchyAgent extends \nre\agents\IntermediateAgent
+	{
+	}
+
+?>
+

doc/files/agents/intermediate/QuestsAgent.inc.txt

@@ -0,0 +1,124 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to display Quests.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuestsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: quest.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function quest(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+		
+		
+		/**
+		 * Action: submissions.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function submissions(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+		
+		
+		/**
+		 * Action: submission.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function submission(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: create.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function create(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: edit.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function edit(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: edittask.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function edittask(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: edittexts.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function edittexts(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: delete.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function delete(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/SeminariesAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to list registered seminaries.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class SeminariesAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/UploadsAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+	
+	/**
+	 * Agent to process and show user uploads.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class UploadsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/UsersAgent.inc.txt

@@ -0,0 +1,51 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to list registered users and their data.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class UsersAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+		
+		/**
+		 * Action: user.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function user(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Userroles', 'user');
+		}
+		
+	}
+
+?>
+

doc/files/agents/intermediate/XplevelsAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\intermediate;
+	
+
+	/**
+	 * Agent to handle XP-levels of a Seminary.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class XplevelsAgent extends \nre\agents\IntermediateAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/toplevel/AjaxAgent.inc.txt

@@ -0,0 +1,81 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\toplevel;
+	
+	
+	/**
+	 * Agent to return a JSON-string used by AJAX.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class AjaxAgent extends \hhu\z\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new AjaxAgent.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Logger instance
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+			
+			
+			$this->setLanguage($request);
+		}
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+		
+		
+		
+		/**
+		 * Set requested language.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 */
+		private function setLanguage(\nre\core\Request $request)
+		{
+			// Set domain
+			$domain = \nre\configs\AppConfig::$app['genericname'];
+			
+			// Get language
+			$locale = $request->getGetParam('lang', 'language');
+			if(is_null($locale)) {
+				return;
+			}
+			
+			// Load translation
+			putenv("LC_ALL=$locale");
+			setlocale(LC_ALL, $locale);
+			bindtextdomain($domain, ROOT.DS.\nre\configs\AppConfig::$dirs['locale']);
+			textdomain($domain);
+		}
+		
+	}
+
+?>
+

doc/files/agents/toplevel/BinaryAgent.inc.txt

@@ -0,0 +1,52 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\toplevel;
+	
+	
+	/**
+	 * Agent to display binary data (e. g. images).
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class BinaryAgent extends \hhu\z\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new BinaryAgent.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Logger instance
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/toplevel/FaultAgent.inc.txt

@@ -0,0 +1,39 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\toplevel;
+	
+	
+	/**
+	 * Agent to display a toplevel error page.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class FaultAgent extends \nre\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents/toplevel/HtmlAgent.inc.txt

@@ -0,0 +1,86 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\toplevel;
+	
+	
+	/**
+	 * Agent to display a HTML-page.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class HtmlAgent extends \hhu\z\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new HtmlAgent.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Logger instance
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+			
+			
+			$this->setLanguage($request);
+		}
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Add menu
+			$this->addSubAgent('Menu');
+			
+			// Add Seminary sidebar
+			$this->addSubAgent('Seminarybar');
+		}
+		
+		
+		
+		
+		/**
+		 * Set requested language.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 */
+		private function setLanguage(\nre\core\Request $request)
+		{
+			// Set domain
+			$domain = \nre\configs\AppConfig::$app['genericname'];
+			
+			// Get language
+			$locale = $request->getGetParam('lang', 'language');
+			if(is_null($locale)) {
+				return;
+			}
+			
+			// Load translation
+			putenv("LC_ALL=$locale");
+			setlocale(LC_ALL, $locale);
+			bindtextdomain($domain, ROOT.DS.\nre\configs\AppConfig::$dirs['locale']);
+			textdomain($domain);
+		}
+		
+	}
+
+?>
+

doc/files/agents/toplevel/HtmlmailAgent.inc.txt

@@ -0,0 +1,53 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\toplevel;
+	
+	
+	/**
+	 * Agent for generating a HTML-mail message.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class HtmlmailAgent extends \hhu\z\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new HtmlmailAgent.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Logger instance
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubagent('mailreceiver', 'index', $request->getParam(3));
+		}
+		
+	}
+
+?>
+

doc/files/agents/toplevel/TextmailAgent.inc.txt

@@ -0,0 +1,55 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents\toplevel;
+	
+	
+	/**
+	 * Agent for generating a simple text-mail message.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class TextmailAgent extends \hhu\z\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new TextmailAgent.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Logger instance
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubagent('mailreceiver', 'index', $request->getParam(3));
+		}
+		
+	}
+
+?>
+

doc/files/apis/WebApi.inc.txt

@@ -0,0 +1,251 @@
+<?php
+
+	/**
+	 * NRE
+	 *
+	 * @author	coderkun <olli@coderkun.de>
+	 * @copyright	2013 coderkun (http://www.coderkun.de)
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	http://www.coderkun.de/projects/nre
+	 */
+	
+	namespace nre\apis;
+	
+	
+	/**
+	 * WebApi-implementation.
+	 * 
+	 * This class runs and renders an web-applictaion.
+	 * 
+	 * @author	coderkun <olli@coderkun.de>
+	 */
+	class WebApi extends \nre\core\Api
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new WebApi.
+		 */
+		public function __construct()
+		{
+			parent::__construct(
+				new \nre\requests\WebRequest(),
+				new \nre\responses\WebResponse()
+			);
+			
+			// Add routes
+			$this->addRoutes();
+			
+			// Disable screen logging for AJAX requests
+			if($this->request->getParam(0, 'toplevel') == 'ajax') {
+				$this->log->disableAutoLogToScreen();
+			}
+		}
+		
+		
+		
+		
+		/**
+		 * Run application.
+		 * 
+		 * This method runs the application and handles all errors.
+		 */
+		public function run()
+		{
+			try {
+				$exception = parent::run();
+				
+				if(!is_null($exception)) {
+					$this->errorService($exception);
+				}
+			}
+			catch(\nre\exceptions\ServiceUnavailableException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\ActionNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+			}
+			catch(\nre\exceptions\FatalDatamodelException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\DatamodelException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+		 	}
+			catch(\nre\exceptions\DriverNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+		 	}
+			catch(\nre\exceptions\DriverNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+		 	}
+			catch(\nre\exceptions\ModelNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+		 	}
+		 	catch(\nre\exceptions\ModelNotFoundException $e) {
+		 		$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+		 	}
+		 	catch(\nre\exceptions\ViewNotFoundException $e) {
+		 		$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+		 	}
+			catch(\nre\exceptions\ControllerNotValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\ControllerNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+			}
+			catch(\nre\exceptions\AgentNoaatValidException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_SERVICE_UNAVAILABLE);
+			}
+			catch(\nre\exceptions\AgentNotFoundException $e) {
+				$this->error($e, \nre\core\WebUtils::HTTP_NOT_FOUND);
+			}
+			catch(\nre\exceptions\ClassNotValidException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\ClassNotFoundException $e) {
+				$this->errorService($e);
+			}
+		}
+		
+		
+		/**
+		 * Render output.
+		 */
+		public function render()
+		{
+			// Generate output
+			parent::render();
+			
+			
+			// Set HTTP-header
+			$this->response->header();
+			
+			// Show output
+			echo $this->response->getOutput();
+		}
+		
+		
+		
+		
+		/**
+		 * Add routes (normal and reverse) defined in the AppConfig.
+		 */
+		private function addRoutes()
+		{
+			// Normal routes
+			if(property_exists('\nre\configs\AppConfig', 'routes')) {
+				foreach(\nre\configs\AppConfig::$routes as &$route) {
+					$this->request->addRoute($route[0], $route[1], $route[2]);
+				}
+			}
+
+			// Reverse routes
+			if(property_exists('\nre\configs\AppConfig', 'reverseRoutes')) {
+				foreach(\nre\configs\AppConfig::$reverseRoutes as &$route) {
+					$this->request->addReverseRoute($route[0], $route[1], $route[2]);
+				}
+			}
+			
+			// Revalidate request
+			$this->request->revalidate();
+		}
+
+
+		/**
+		 * Handle an error that orrcurred during the
+		 * loading/constructing/running of the ToplevelAgent.
+		 * 
+		 * @param	\Exception	$exception	Occurred exception
+		 * @param	int		$httpStatusCode	HTTP-statuscode
+		 */
+		private function error(\nre\core\Exception $exception, $httpStatusCode)
+		{
+			// Log error message
+			$this->log($exception, \nre\core\Logger::LOGMODE_AUTO);
+			
+			try {
+				// Set agent for handling errors
+				$this->response->clearParams();
+				$this->response->addParams(
+					\nre\configs\AppConfig::$defaults['toplevel-error'],
+					\nre\configs\AppConfig::$defaults['intermediate-error'],
+					\nre\configs\CoreConfig::$defaults['action'],
+					$httpStatusCode
+				);
+				
+				// Run this agent
+				parent::run();
+			}
+			catch(\nre\exceptions\ServiceUnavailableException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\ActionNotFoundException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\DatamodelException $e) {
+				$this->errorService($e);
+		 	}
+			catch(\nre\exceptions\DriverNotValidException $e) {
+				$this->errorService($e);
+		 	}
+			catch(\nre\exceptions\DriverNotFoundException $e) {
+				$this->errorService($e);
+		 	}
+			catch(\nre\exceptions\ModelNotValidException $e) {
+				$this->errorService($e);
+		 	}
+		 	catch(\nre\exceptions\ModelNotFoundException $e) {
+		 		$this->errorService($e);
+		 	}
+		 	catch(\nre\exceptions\ViewNotFoundException $e) {
+		 		$this->errorService($e);
+		 	}
+			catch(\nre\exceptions\ControllerNotValidException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\ControllerNotFoundException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\AgentNotValidException $e) {
+				$this->errorService($e);
+			}
+			catch(\nre\exceptions\AgentNotFoundException $e) {
+				$this->errorService($e);
+			}
+			catch(Exception $e) {
+				$this->errorService($e);
+			}
+		}
+		
+		
+		/**
+		 * Handle a error which cannot be handles by the system (and
+		 * HTTP 503).
+		 * 
+		 * @param	\Exception	$exception	Occurred exception
+		 */
+		private function errorService($exception)
+		{
+			// Log error message
+			$this->log($exception, \nre\core\Logger::LOGMODE_AUTO);
+			
+			// Set HTTP-rtatuscode
+			$this->response->addHeader(\nre\core\WebUtils::getHttpHeader(503));
+			
+			
+			// Read and print static error file
+			$fileName = ROOT.DS.\nre\configs\CoreConfig::getClassDir('views').DS.\nre\configs\CoreConfig::$defaults['errorFile'].\nre\configs\CoreConfig::getFileExt('views');
+			ob_start();
+			include($fileName);
+			$this->response->setOutput(ob_get_clean());
+			
+			
+			// Prevent further execution
+			$this->response->setExit();
+		}
+		
+	}
+
+?>
+

doc/files/app/Controller.inc.txt

@@ -0,0 +1,132 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z;
+	
+	
+	/**
+	 * Abstract class for implementing an application Controller.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class Controller extends \nre\core\Controller
+	{
+		/**
+		 * Required components
+		 * 
+		 * @var array
+		 */
+		public $components = array('auth');
+		
+		/**
+		 * Logger instance
+		 * 
+		 * @var \nre\core\Logger
+		 */
+		protected $log = null;
+		/**
+		 * Linker instance
+		 * 
+		 * @var \nre\core\Linker
+		 */
+		protected $linker = null;
+		
+		
+		
+		
+		/**
+		 * Construct a new application Controller.
+		 * 
+		 * @throws	\nre\exceptions\DriverNotFoundException
+		 * @throws	\nre\exceptions\DriverNotValidException
+		 * @throws	\nre\exceptions\ModelNotValidException
+		 * @throws	\nre\exceptions\ModelNotFoundException
+		 * @throws	\nre\exceptions\ViewNotFoundException
+		 * @param	string		$layoutName	Name of the current Layout
+		 * @param	string		$action		Current Action
+		 * @param	\nre\core\Agent	$agent		Corresponding Agent
+		 */
+		public function __construct($layoutName, $action, $agent)
+		{
+			parent::__construct($layoutName, $action, $agent);
+			
+			// Create logger
+			$this->log = new \nre\core\Logger();
+		}
+		
+		
+		
+		/**
+		 * Prefilter that is executed before running the Controller.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function preFilter(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			parent::preFilter($request, $response);
+			
+			// Create linker
+			$this->linker = new \nre\core\Linker($request);
+			$this->set('linker', $this->linker);
+			
+			// Create text formatter
+			$this->set('t', new \hhu\z\TextFormatter($this->linker));
+			
+			// Create date and time and number formatter
+			$this->set('dateFormatter', new \IntlDateFormatter(
+				\nre\core\Config::getDefault('locale'),
+				\IntlDateFormatter::MEDIUM,
+				\IntlDateFormatter::NONE,
+				NULL
+			));
+			$this->set('timeFormatter', new \IntlDateFormatter(
+				\nre\core\Config::getDefault('locale'),
+				\IntlDateFormatter::NONE,
+				\IntlDateFormatter::SHORT,
+				NULL
+			));
+			$this->set('numberFormatter', new \NumberFormatter(
+				\nre\core\Config::getDefault('locale'),
+				\NumberFormatter::DEFAULT_STYLE
+			));
+		}
+		
+		
+		/**
+		 * Postfilter that is executed after running the Controller.
+		 * 
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 */
+		public function postFilter(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			parent::postFilter($request, $response);
+		}
+		
+		
+		
+		
+		/**
+		 * Log an error.
+		 * 
+		 * @param	string	$message	Error message to log
+		 * @param	int	$logMode	Log mode (optional)
+		 */
+		protected function log($message, $logMode=\nre\core\Logger::LOGMODE_AUTO)
+		{
+			$this->log->log($message, $logMode);
+		}
+		
+	}
+
+?>
+

doc/files/app/Model.inc.txt

@@ -0,0 +1,43 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z;
+	
+	
+	/**
+	 * Abstract class for implementing an application Model.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class Model extends \nre\models\DatabaseModel
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new application Model.
+		 * 
+		 * @throws	\nre\exceptions\DatamodelException
+		 * @throws	\nre\exceptions\DriverNotFoundException
+		 * @throws	\nre\exceptions\DriverNotValidException
+		 * @throws	\nre\exceptions\ModelNotValidException
+		 * @throws	\nre\exceptions\ModelNotFoundException
+		 */
+		public function __construct()
+		{
+			parent::__construct('mysqli', \nre\configs\AppConfig::$database);
+		}
+		
+	}
+
+?>
+

doc/files/app/TextFormatter.inc.txt

@@ -0,0 +1,150 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z;
+	
+	
+	/**
+	 * Class to format text with different syntax tags.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class TextFormatter
+	{
+		/**
+		 * Linker to create links.
+		 * 
+		 * @var \nre\core\Linker
+		 */
+		private $linker;
+		/**
+		 * Media-Model to retrieve media data
+		 * 
+		 * @static
+		 * @var \nre\core\Model
+		 */
+		private static $Media = null;
+		
+		
+		
+		
+		/**
+		 * Create a new text formatter.
+		 * 
+		 * @param	\nre\core\Linker $linker	Linker to create links with
+		 */
+		public function __construct(\nre\core\Linker $linker)
+		{
+			$this->linker = $linker;
+		}
+		
+		
+		
+		
+		/**
+		 * Format a string.
+		 * 
+		 * @param	string	$string	String to format
+		 * @return	string		Formatted string
+		 */
+		public function t($string)
+		{
+			// Remove chars
+			$string = htmlspecialchars($string, ENT_NOQUOTES);
+			
+			// Important text
+			$string = str_replace('[strong]', '<strong>', $string);
+			$string = str_replace('[/strong]', '</strong>', $string);
+			
+			// Create tables
+			$string = preg_replace('/(\[table\])\s+/u', '$1', $string);
+			$string = preg_replace('/\s*(\[tr\])\s*/u', '$1', $string);
+			$string = preg_replace('%\s+(\[/table\])%u', '$1', $string);
+			$string = preg_replace('%\s*(\[/tr\])\s*%u', '$1', $string);
+			$string = str_replace('[table]', '</p><table>', $string);
+			$string = str_replace('[/table]', '</table><p>', $string);
+			$string = str_replace('[tr]', '<tr>', $string);
+			$string = str_replace('[/tr]', '</tr>', $string);
+			$string = str_replace('[th]', '<th>', $string);
+			$string = str_replace('[/th]', '</th>', $string);
+			$string = str_replace('[td]', '<td>', $string);
+			$string = str_replace('[/td]', '</td>', $string);
+			
+			// Create links
+			$string = preg_replace('!(^|\s)"([^"]+)":(https?://[^\s]+)(\s|$)!i', '$1<a href="$3">$2</a>$4', $string);
+			$string = preg_replace('!(^|\s)(https?://[^\s]+)(\s|$)!i', '$1<a href="$2">$2</a>$3', $string);
+			
+			// Handle Seminarymedia
+			$seminarymedia = array();
+			preg_match_all('/\[seminarymedia:(\d+)\]/iu', $string, $matches); //, PREG_SET_ORDER | PREG_OFFSET_CAPTURE);
+			$seminarymediaIds = array_unique($matches[1]);
+			foreach($seminarymediaIds as &$seminarymediaId)
+			{
+				$replacement = null;
+				if(!is_null(\hhu\z\controllers\SeminaryController::$seminary) && $this->loadMediaModel())
+				{
+					try {
+						$medium = self::$Media->getSeminaryMediaById($seminarymediaId);
+						$replacement = sprintf(
+							'<img src="%s" alt="%s" />',
+							$this->linker->link(array('media','seminary', \hhu\z\controllers\SeminaryController::$seminary['url'],$medium['url'])),
+							$medium['description']
+						);
+					}
+					catch(\nre\exceptions\IdNotFoundException $e) {
+					}
+				}
+				
+				$seminarymedia[$seminarymediaId] = $replacement;
+			}
+			foreach($seminarymedia as $seminarymediaId => $replacement) {
+				$string = str_replace("[seminarymedia:$seminarymediaId]", $replacement, $string);
+			}
+			
+			
+			// Return processed string
+			return nl2br($string);
+		}
+		
+		
+		
+		
+		/**
+		 * Load the Media-Model if it is not loaded
+		 * 
+		 * @return	boolean	Whether the Media-Model has been loaded or not
+		 */
+		private function loadMediaModel()
+		{
+			// Do not load Model if it has already been loaded
+			if(!is_null(self::$Media)) {
+				return true;
+			}
+			
+			try {
+				// Load class
+				Model::load('media');
+			
+				// Construct Model
+				self::$Media = Model::factory('media');
+			}
+			catch(\Exception $e) {
+			}
+			
+			
+			// Return whether Media-Model has been loaded or not
+			return !is_null(self::$Media);
+		}
+		
+	}
+
+?>
+

doc/files/app/Utils.inc.txt

@@ -0,0 +1,215 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z;
+	
+	
+	/**
+	 * Class for implementing utility methods.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class Utils
+	{
+		
+		
+		/**
+		 * Mask HTML-chars for save output.
+		 * 
+		 * @static
+		 * @param	string	$string	String to be masked
+		 * @return	string		Masked string
+		 */
+		public static function t($string)
+		{
+			return nl2br(htmlspecialchars($string));
+		}
+		
+		
+		/**
+		 * ‚htmlspecialchars‘ with support for UTF-8.
+		 * 
+		 * @static
+		 * @param	string	$string	String to be masked
+		 * @return	string		Masked string
+		 */
+		public static function htmlspecialchars_utf8($string)
+		{
+			return htmlspecialchars($string, ENT_COMPAT, 'UTF-8');
+		}
+		
+		
+		/**
+		 * Cut a string to the given length but only word boundaries.
+		 * 
+		 * @static
+		 * @param	string	$string	String to cut
+		 * @param	int	$length	Length to cut string
+		 * @param	int	$scope	Maximum length to cut string regardless word boundaries
+		 * @return	string		Cutted string
+		 */
+		public static function shortenString($string, $length, $scope)
+		{
+			// Determine length
+			$length = min($length, strlen($string));
+			
+			// Look for word boundary
+			if(($pos = strpos($string, ' ', $length)) !== false)
+			{
+				// Check if boundary is outside of scope
+				if($pos > $length + $scope) {
+					$pos = strrpos(substr($string, 0, $pos), ' ');
+				}
+			}
+			else {
+				$pos = strlen($string);
+			}
+			
+			
+			// Cut string and return it
+			return substr($string, 0, $pos);
+		}
+		
+		
+		/**
+		 * Send an e‑mail.
+		 * 
+		 * @throws	\hhu\z\exceptions\MailingException
+		 * @param	mixed			$to		One (string) or many (array) receivers
+		 * @param	string			$messageAction	Message Action
+		 * @param	boolean			$html		Whether mail should be formatted as HTML or not
+		 * @param	array			$params		Parameters to pass
+		 * @param	\nre\core\Linker	$linker		Linker instance
+		 */
+		public static function sendMail($to, $messageAction, $html=false, $params=null, $linker=null)
+		{
+			// Check configuration
+			if(
+				empty(\nre\configs\AppConfig::$mail['host']) ||
+				empty(\nre\configs\AppConfig::$mail['port']) ||
+				empty(\nre\configs\AppConfig::$mail['username'])
+			) {
+				return;
+			}
+			
+			// Load classes
+			\hhu\z\lib\PHPMailerAutoload::load();
+			\hhu\z\lib\PHPMailer::load();
+			\hhu\z\lib\SMTP::load();
+			
+			// Create mailer
+			$mail = new \PHPMailer();
+			
+			// Configure mailer
+			$mail->isSMTP();
+			$mail->Host = \nre\configs\AppConfig::$mail['host'];
+			$mail->Port = \nre\configs\AppConfig::$mail['port'];
+			$mail->SMTPAuth = true;
+			$mail->Username = \nre\configs\AppConfig::$mail['username'];
+			$mail->Password = \nre\configs\AppConfig::$mail['password'];
+			$mail->SMTPSecure = \nre\configs\AppConfig::$mail['secure'];
+			
+			// Set properties
+			$mail->CharSet = 'UTF-8';
+			$mail->From = \nre\configs\AppConfig::$app['mailsender'];
+			$mail->FromName = \nre\configs\AppConfig::$app['name'];
+			if(!is_array($to)) {
+				$to = array($to);
+			}
+			foreach($to as &$receiver) {
+				$mail->addAddress($receiver);
+			}
+			if($html) {
+				$mail->isHTML(true);
+			}
+			
+			// Create message
+			try {
+				// Create MailApi
+				$mailApi = new \hhu\z\apis\MailApi();
+				if(!is_null($linker)) {
+					$mailApi->setLinker($linker);
+				}
+				$mailApi->setMessage($messageAction);
+				$mailApi->setParams($params);
+				if($html) {
+					$mailApi->setHTML();
+				}
+				
+				// Render message
+				$exception = $mailApi->run();
+				if(!is_null($exception)) {
+					return $exception;
+				}
+				$mail->Subject = $mailApi->getSubject();
+				$mail->Body = $mailApi->render();
+				
+				// Try to render alternativ plaintext message
+				if($html)
+				{
+					$mailApi->setHTML(false);
+					
+					// Render message
+					$exception = $mailApi->run();
+					if(is_null($exception))
+					{
+						try {
+							$mail->AltBody = $mailApi->render();
+						}
+						catch(\nre\core\Exception $e) {
+							// No alternative plaintext available
+						}
+					}
+				}
+			}
+			catch(\nre\core\Exception $e) {
+				throw new \hhu\z\exceptions\MailingException($e->getMessage());
+			}
+			
+			
+			// Return status
+			if(!$mail->send()) {
+				throw new \hhu\z\exceptions\MailingException($mail->ErrorInfo);
+			}
+		}
+		
+		
+		/**
+		 * Detect Mimetype of a file.
+		 * 
+		 * @param	string	$filename		Name of file to detect Mimetype of
+		 * @param	string	$defaultMimetype	Default Mimetype to use
+		 * @return	string				Detected Mimetype of file
+		 */
+		public static function getMimetype($filename, $defaultMimetype=null)
+		{
+			$mimetype = (!is_null($defaultMimetype)) ? $defaultMimetype : 'application/octet-stream';
+			// Use Fileinfo
+			if(class_exists('\finfo'))
+			{
+				$finfo = new \finfo(FILEINFO_MIME_TYPE);
+				if(!is_null($finfo)) {
+					$mimetype = $finfo->file($filename);
+				}
+			}
+			// Use deprecated mime_content_type()
+			elseif(function_exists('mime_content_type')) {
+				$mimetype = mime_content_type($filename);
+			}
+			
+			
+			return $mimetype;
+		}
+		
+	}
+
+?>
+

doc/files/app/agents/QuesttypeAgent.inc.txt

@@ -0,0 +1,286 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z\agents;
+	
+	
+	/**
+	 * Abstract class for implementing a QuesttypeAgent.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class QuesttypeAgent extends \nre\agents\BottomlevelAgent
+	{
+		/**
+		 * Current request
+		 * 
+		 * @var \nre\core\Request
+		 */
+		private $request;
+		/**
+		 * Current response
+		 * 
+		 * @var \nre\core\Response
+		 */
+		private $response;
+		
+		
+		
+		
+		/**
+		 * Load a QuesttypeAgent.
+		 * 
+		 * @static
+		 * @throws	\hhu\z\exceptions\QuesttypeAgentNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeAgentNotValidException
+		 * @param	string	$questtypeName	Name of the QuesttypeAgent to load
+		 */
+		public static function load($questtypeName)
+		{
+			// Determine full classname
+			$className = self::getClassName($questtypeName);
+			
+			try {
+				// Load class
+				static::loadClass($questtypeName, $className);
+				
+				// Validate class
+				static::checkClass($className, get_class());
+			}
+			catch(\nre\exceptions\ClassNotValidException $e) {
+				throw new \hhu\z\exceptions\QuesttypeAgentNotValidException($e->getClassName());
+			}
+			catch(\nre\exceptions\ClassNotFoundException $e) {
+				throw new \hhu\z\exceptions\QuesttypeAgentNotFoundException($e->getClassName());
+			}
+		}
+		
+		
+		/**
+		 * Instantiate a QuesttypeAgent (Factory Pattern).
+		 * 
+		 * @static
+		 * @throws	\nre\exceptions\DatamodelException
+		 * @throws	\nre\exceptions\DriverNotValidException
+		 * @throws	\nre\exceptions\DriverNotFoundException
+		 * @throws	\nre\exceptions\ViewNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeModelNotValidException
+		 * @throws	\hhu\z\exceptions\QuesttypeModelNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeControllerNotValidException
+		 * @throws	\hhu\z\exceptions\QuesttypeControllerNotFoundException
+		 * @param	string		$questtypeName	Name of the QuesttypeAgent to instantiate
+		 * @param	Request		$request	Current request
+		 * @param	Response	$response	Current respone
+		 * @param	Logger		$log		Log-system
+		 */
+		public static function factory($questtypeName, \nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			// Determine full classname
+			$className = self::getClassName($questtypeName);
+			
+			// Construct and return Questmodule
+			return new $className($request, $response, $log);
+		}
+		
+		
+		/**
+		 * Determine the Agent-classname for the given Questtype-name.
+		 * 
+		 * @static
+		 * @param	string	$questtypeName	Questtype-name to get Agent-classname of
+		 * @param	string	$agentType	Agent type of given Agent name
+		 * @return	string			Classname for the Questtype-name
+		 */
+		private static function getClassName($questtypeName, $agentType=null)
+		{
+			$className = \nre\core\ClassLoader::concatClassNames($questtypeName, \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripNamespace(get_class())), 'agent');
+			
+			
+			return \nre\configs\AppConfig::$app['namespace']."questtypes\\$className";
+		}
+		
+		
+		/**
+		 * Determine the classname for the given Agent name.
+		 * 
+		 * @static
+		 * @param	string	$agentName	Agent name to get classname of
+		 * @param	string	$agentType	Agent type of given Agent name
+		 * @return	string			Classname for the Agent name
+		 */
+		/*private static function getClassName($agentName, $agentType)
+		{
+			$className = ClassLoader::concatClassNames($agentName, 'agent');
+			
+			
+			return \nre\configs\AppConfig::$app['namespace']."agents\\$agentType\\$className";
+		}*/
+		
+		
+		/**
+		 * Load the class of a QuesttypeAgent.
+		 * 
+		 * @static
+		 * @throws	\nre\exceptions\ClassNotFoundException
+		 * @param	string	$questtypeName	Name of the QuesttypeAgent to load
+		 * @param	string	$fullClassName	Name of the class to load
+		 */
+		private static function loadClass($questtypeName, $fullClassName)
+		{
+			// Determine folder to look in
+			$className = explode('\\', $fullClassName);
+			$className = array_pop($className);
+			
+			// Determine filename
+			$fileName = ROOT.DS.\nre\configs\AppConfig::$dirs['questtypes'].DS.strtolower($questtypeName).DS.$className.\nre\configs\CoreConfig::getFileExt('includes');
+			
+			// Check file
+			if(!file_exists($fileName))
+			{
+				throw new \nre\exceptions\ClassNotFoundException(
+					$fullClassName
+				);
+			}
+			
+			// Include file
+			include_once($fileName);
+		}
+		
+		
+		/**
+		 * Check inheritance of the QuesttypeAgent-class.
+		 * 
+		 * @static
+		 * @throws	\nre\exceptions\ClassNotValidException
+		 * @param	string	$className		Name of the class to check
+		 * @param	string	$parentClassName	Name of the parent class
+		 */
+		public static function checkClass($className, $parentClassName)
+		{
+			// Check if class is subclass of parent class
+			if(!is_subclass_of($className, $parentClassName)) {
+				throw new \nre\exceptions\ClassNotValidException(
+					$className
+				);
+			}
+		}
+		
+		
+		
+		
+		/**
+		 * Construct a new QuesttypeAgent.
+		 * 
+		 * @throws	\nre\exceptions\DatamodelException
+		 * @throws	\nre\exceptions\DriverNotValidException
+		 * @throws	\nre\exceptions\DriverNotFoundException
+		 * @throws	\nre\exceptions\ViewNotFoundException
+		 * @throws	\nre\exceptions\ModelNotValidException
+		 * @throws	\nre\exceptions\ModelNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeModelNotValidException
+		 * @throws	\hhu\z\exceptions\QuesttypeModelNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeControllerNotValidException
+		 * @throws	\hhu\z\exceptions\QuesttypeControllerNotFoundException
+		 * @param	\nre\core\Request	$request	Current request
+		 * @param	\nre\core\Response	$response	Current response
+		 * @param	\nre\core\Logger	$log		Log-system
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			// Store values
+			$this->request = $request;
+			$this->response = $response;
+			
+			
+			// Call parent constructor
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		
+		
+		/**
+		 * Save the answers of a Character for a Quest.
+		 * 
+		 * @param	array	$seminary	Current Seminary data
+		 * @param	array	$questgroup	Current Questgroup data
+		 * @param	array	$quest		Current Quest data
+		 * @param	array	$character	Current Character data
+		 * @param	array	$answers	Character answers for the Quest
+		 */
+		public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
+		{
+			$this->controller->saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers);
+		}
+		
+		
+		/**
+		 * Check if answers of a Character for a Quest match the correct ones.
+		 * 
+		 * @param	array	$seminary	Current Seminary data
+		 * @param	array	$questgroup	Current Questgroup data
+		 * @param	array	$quest		Current Quest data
+		 * @param	array	$character	Current Character data
+		 * @param	array	$answers	Character answers for the Quest
+		 */
+		public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
+		{
+			return $this->controller->matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers);
+		}
+		
+		
+		
+		
+		/**
+		 * Load the Controller of this Agent.
+		 * 
+		 * @throws	\nre\exceptions\DatamodelException
+		 * @throws	\nre\exceptions\DriverNotValidException
+		 * @throws	\nre\exceptions\DriverNotFoundException
+		 * @throws	\nre\exceptions\ViewNotFoundException
+		 * @throws	\nre\exceptions\ModelNotValidException
+		 * @throws	\nre\exceptions\ModelNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeModelNotValidException
+		 * @throws	\hhu\z\exceptions\QuesttypeModelNotFoundException
+		 * @throws	\hhu\z\exceptions\QuesttypeControllerNotValidException
+		 * @throws	\hhu\z\exceptions\QuesttypeControllerNotFoundException
+		 */
+		protected function loadController()
+		{
+			// Determine Controller name
+			$controllerName = \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::getClassName(get_class($this)));
+			
+			// Determine ToplevelAgent
+			$toplevelAgentName = $this->response->getParam(0);
+			if(is_null($toplevelAgentName)) {
+				$toplevelAgentName = $this->request->getParam(0, 'toplevel');
+				$this->response->addParam($toplevelAgentName);
+			}
+			
+			// Determine Action
+			$action = $this->response->getParam(2);
+			if(is_null($action)) {
+				$action = $this->request->getParam(2, 'action');
+				$this->response->addParam($action);
+			}
+			
+			
+			// Load Controller
+			\hhu\z\controllers\QuesttypeController::load($controllerName);
+			
+			// Construct Controller
+			$this->controller = \hhu\z\controllers\QuesttypeController::factory($controllerName, $toplevelAgentName, $action, $this);
+		}
+		
+	}
+
+?>
+