add PHPdoc (solves issue #343)

doc/files/agents%2FBottomlevelAgent.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%2FIntermediateAgent.inc.txt

@@ -0,0 +1,49 @@
+<?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.
+		 * 
+		 * @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%2FToplevelAgent.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 Request
+		 */
+		private $request;
+		/**
+		 * Current response
+		 * 
+		 * @var Response
+		 */
+		private $response;
+		/**
+		 * Layout instace
+		 * 
+		 * @var Layout
+		 */
+		private $layout = null;
+		/**
+		 * IntermediateAgent instance
+		 * 
+		 * @var IntermediateAgent
+		 */
+		private $intermediateAgent = null;
+		
+		
+		
+		
+		/**
+		 * Construct a ToplevelAgent.
+		 * 
+		 * @throws	ServiceUnavailableException
+		 * @throws	DatamodelException
+		 * @throws	DriverNotValidException
+		 * @throws	DriverNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	ControllerNotValidException
+		 * @throws	ControllerNotFoundException
+		 * @param	Request		$request	Current request
+		 * @param	Response	$respone	Current response
+		 * @param	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	ServiceUnavailableException
+		 * @param	Request		$request	Current request
+		 * @param	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	IntermediateAgent	IntermediateAgent
+		 */
+		public function getIntermediateAgent()
+		{
+			return $this->intermediateAgent;
+		}
+		
+		
+		
+		
+		/**
+		 * Load a SubAgent and add it.
+		 * 
+		 * @throws	ServiceUnavailableException
+		 * @throws	FatalDatamodelException
+		 * @throws	AgentNotFoundException
+		 * @throws	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	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	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	AccessDeniedException
+		 * @throws	IdNotFoundException
+		 * @throws	ServiceUnavailableException
+		 * @throws	DatamodelException
+		 * @param	Request		$request	Current request
+		 * @param	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	AccessDeniedException
+		 * @throws	ParamsNotValidException
+		 * @throws	IdNotFoundException
+		 * @throws	ServiceUnavailableException
+		 * @throws	DatamodelException
+		 */
+		private function runIntermediateAgent()
+		{
+			$this->intermediateAgent->run(
+				$this->request,
+				$this->response
+			);
+		}
+		
+		
+		/**
+		 * Handle an error that occurred during
+		 * loading/cnostructing/running of the IntermediateAgent.
+		 * 
+		 * @throws	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%2Fbottomlevel%2FMailreceiverAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fbottomlevel%2FMenuAgent.inc.txt

@@ -0,0 +1,38 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Add Seminary menu
+			$this->addSubAgent('Seminarymenu');
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fbottomlevel%2FQuestgroupshierarchypathAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fbottomlevel%2FSeminarybarAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fbottomlevel%2FSeminarymenuAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fbottomlevel%2FUserrolesAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function user(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FAchievementsAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FCharactergroupsAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FCharactergroupsquestsAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FCharactersAgent.inc.txt

@@ -0,0 +1,44 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+		
+		/**
+		 * Action: character.
+		 */
+		public function character(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FCharactertypesAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FErrorAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FIntroductionAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FLibraryAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FMailAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FMediaAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FQuestgroupsAgent.inc.txt

@@ -0,0 +1,64 @@
+<?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.
+		 */
+		public function questgroup(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+		
+
+		/**
+		 * Action: edit.
+		 */
+		public function edit(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+
+
+		/**
+		 * Action: edittexts.
+		 */
+		public function edittexts(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+		
+
+		/**
+		 * Action: delete.
+		 */
+		public function delete(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4));
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FQuestgroupshierarchyAgent.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%2Fintermediate%2FQuestsAgent.inc.txt

@@ -0,0 +1,100 @@
+<?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.
+		 */
+		public function quest(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+		
+		
+		/**
+		 * Action: submissions.
+		 */
+		public function submissions(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+		
+		
+		/**
+		 * Action: submission.
+		 */
+		public function submission(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: create.
+		 */
+		public function create(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: edit.
+		 */
+		public function edit(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: edittask.
+		 */
+		public function edittask(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: edittexts.
+		 */
+		public function edittexts(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Questgroupshierarchypath', 'index', $request->getParam(3), $request->getParam(4), true);
+		}
+
+
+		/**
+		 * Action: delete.
+		 */
+		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%2Fintermediate%2FSeminariesAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FUploadsAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FUsersAgent.inc.txt

@@ -0,0 +1,45 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+		
+		/**
+		 * Action: user.
+		 */
+		public function user(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubAgent('Userroles', 'user');
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Fintermediate%2FXplevelsAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Ftoplevel%2FAjaxAgent.inc.txt

@@ -0,0 +1,66 @@
+<?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
+	{
+		
+		
+		
+		
+		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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+		
+		
+		
+		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%2Ftoplevel%2FBinaryAgent.inc.txt

@@ -0,0 +1,42 @@
+<?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
+	{
+		
+		
+		
+		
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		/**
+		 * Action: index.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Ftoplevel%2FFaultAgent.inc.txt

@@ -0,0 +1,36 @@
+<?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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Ftoplevel%2FHtmlAgent.inc.txt

@@ -0,0 +1,71 @@
+<?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
+	{
+		
+		
+		
+		
+		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.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Add menu
+			$this->addSubAgent('Menu');
+			
+			// Add Seminary sidebar
+			$this->addSubAgent('Seminarybar');
+		}
+		
+		
+		
+		
+		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%2Ftoplevel%2FHtmlmailAgent.inc.txt

@@ -0,0 +1,46 @@
+<?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.
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		/**
+		 * Action: index.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubagent('mailreceiver', 'index', $request->getParam(3));
+		}
+		
+	}
+
+?>
+

doc/files/agents%2Ftoplevel%2FTextmailAgent.inc.txt

@@ -0,0 +1,48 @@
+<?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.
+		 */
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+		}
+		
+		
+		
+		
+		/**
+		 * Action: index.
+		 */
+		public function index(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			$this->addSubagent('mailreceiver', 'index', $request->getParam(3));
+		}
+		
+	}
+
+?>
+

doc/files/apis%2FWebApi.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%2FController.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 Logger
+		 */
+		protected $log = null;
+		/**
+		 * Linker instance
+		 * 
+		 * @var Linker
+		 */
+		protected $linker = null;
+		
+		
+		
+		
+		/**
+		 * Construct a new application Controller.
+		 * 
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of the current Layout
+		 * @param	string	$action		Current Action
+		 * @param	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	Request		$request	Current request
+		 * @param	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	Request		$request	Current request
+		 * @param	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%2FModel.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	DatamodelException
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 */
+		public function __construct()
+		{
+			parent::__construct('mysqli', \nre\configs\AppConfig::$database);
+		}
+		
+	}
+
+?>
+

doc/files/app%2FTextFormatter.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 Linker
+		 */
+		private $linker;
+		/**
+		 * Media-Model to retrieve media data
+		 * 
+		 * @static
+		 * @var model
+		 */
+		private static $Media = null;
+		
+		
+		
+		
+		/**
+		 * Create a new text formatter.
+		 * 
+		 * @param	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%2FUtils.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	MailingException
+		 * @param	string	$from		Sender of mail
+		 * @param	mixed	$to		One (string) or many (array) receivers
+		 * @param	string	$subject	Subject of mail
+		 * @param	string	$message	Message of mail
+		 * @param	boolean	$html		Whether mail should be formatted as HTML or not
+		 */
+		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%2Fagents%2FQuesttypeAgent.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 Request
+		 */
+		private $request;
+		/**
+		 * Current response
+		 * 
+		 * @var Response
+		 */
+		private $response;
+		
+		
+		
+		
+		/**
+		 * Load a QuesttypeAgent.
+		 * 
+		 * @static
+		 * @throws	QuesttypeAgentNotFoundException
+		 * @throws	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	DatamodelException
+		 * @throws	DriverNotValidException
+		 * @throws	DriverNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 * @throws	QuesttypeControllerNotValidException
+		 * @throws	QuesttypeControllerNotFoundException
+		 * @param	string		$questtypeName	Name of the QuesttypeAgent to instantiate
+		 * @param	Request		$request	Current request
+		 * @param	Response	$respone	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	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	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	DatamodelException
+		 * @throws	DriverNotValidException
+		 * @throws	DriverNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 * @throws	QuesttypeControllerNotValidException
+		 * @throws	QuesttypeControllerNotFoundException
+		 * @param	Request		$request	Current request
+		 * @param	Response	$respone	Current response
+		 * @param	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	DatamodelException
+		 * @throws	DriverNotValidException
+		 * @throws	DriverNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 * @throws	QuesttypeControllerNotValidException
+		 * @throws	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);
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fagents%2FToplevelAgent.inc.txt

@@ -0,0 +1,37 @@
+<?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 an application Controller.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class ToplevelAgent extends \nre\agents\ToplevelAgent
+	{
+		
+		
+		
+		
+		protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+		{
+			parent::__construct($request, $response, $log);
+			
+			
+			// Set timezone
+			date_default_timezone_set(\nre\configs\AppConfig::$app['timeZone']);
+		}
+	}
+
+?>
+

doc/files/app%2Fapis%2FMailApi.inc.txt

@@ -0,0 +1,199 @@
+<?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\apis;
+	
+	
+	/**
+	 * MailApi-implementation.
+	 * 
+	 * This class runs and renders e‑mail text and subject.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MailApi extends \nre\core\Api
+	{
+		
+		
+		
+		
+		/**
+		 * Construct a new MailApi.
+		 */
+		public function __construct()
+		{
+			parent::__construct(
+				new \hhu\z\requests\MailRequest(),
+				new \hhu\z\responses\MailResponse()
+			);
+			
+			// Set ToplevelAgent
+			$this->request->addParam(\nre\configs\AppConfig::$defaults['toplevel-mail']);
+			$this->request->addParam(\nre\configs\AppConfig::$defaults['intermediate-mail']);
+		}
+		
+		
+		
+		
+		/**
+		 * Set linker instance for creating links.
+		 * 
+		 * @param	Linker	$linker	Linker instance for creating links
+		 */
+		public function setLinker(\nre\core\Linker $linker)
+		{
+			$this->request->setLinker($linker);
+		}
+		
+		
+		/**
+		 * Use a ToplevelAgent for HTML-mail
+		 */
+		public function setHTML($html=true)
+		{
+			// Save params
+			$params = $this->request->getParams(1);
+			
+			// Set ToplevelAgent
+			$this->request->clearParams();
+			if($html) {
+				$this->request->addParam(\nre\configs\AppConfig::$defaults['toplevel-htmlmail']);
+			}
+			else {
+				$this->request->addParam(\nre\configs\AppConfig::$defaults['toplevel-mail']);
+			}
+			
+			// Restore params
+			if(!empty($params)) {
+				$this->addParams($params);
+			}
+		}
+		
+		
+		/**
+		 * Set the Action for the message to render.
+		 */
+		public function setMessage($messageAgent)
+		{
+			// Save params
+			$params = $this->request->getParams(3);
+			
+			// Set messageAgent
+			$this->request->clearParams(2);
+			$this->request->addParam($messageAgent);
+			
+			// Restore params
+			if(!empty($params)) {
+				$this->addParams($params);
+			}
+		}
+		
+		
+		/**
+		 * Set additional params to pass to the Action.
+		 * 
+		 * @param	array	$params	Additional params to set
+		 */
+		public function setParams($params)
+		{
+			// Add placeholder params
+			for($i=3; $i<count($this->request->getParams()); $i++) {
+				$this->request->addParam(null);
+			}
+			
+			// Set params
+			call_user_func_array(
+				array(
+					$this->request,
+					'addParams'
+				),
+				$params
+			);
+		}
+		
+		
+		/**
+		 * Return the subject set by the Controller.
+		 * 
+		 * @return	string	Subject set by Controller
+		 */
+		public function getSubject()
+		{
+			return $this->response->getSubject();
+		}
+		
+		
+		/**
+		 * Run mailtext generation.
+		 * 
+		 * This method runs the generation of mailtext.
+		 * 
+		 * @return	Exception	Occured exception or null
+		 */
+		public function run()
+		{
+			// Set response
+			$this->response->clearParams();
+			foreach($this->request->getParams() as $param) {
+				$this->response->addParam($param);
+			}
+			
+			// Run
+			try {
+				$exception = parent::run();
+				
+				
+				return $exception;
+			}
+			catch(\nre\Exception $e) {
+				return $e;
+			}
+		}
+		
+		
+		/**
+		 * Render output.
+		 * 
+		 * @return	string	Rendered output
+		 */
+		public function render()
+		{
+			// Generate output
+			parent::render();
+			
+			
+			// Return output
+			return $this->response->getOutput();
+		}
+		
+		
+		
+		
+		/**
+		 * Add multiple request params.
+		 * 
+		 * @param	array	$params	Request params to add
+		 */
+		private function addParams($params)
+		{
+			call_user_func_array(
+				array(
+					$this->request,
+					'addParams'
+				),
+				$params
+			);
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fcontrollers%2FIntermediateController.inc.txt

@@ -0,0 +1,196 @@
+<?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\controllers;
+	
+	
+	/**
+	 * Abstract class for implementing a Controller of an IntermediateAgent.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class IntermediateController extends \hhu\z\Controller
+	{
+		/**
+		 * Required models
+		 * 
+		 * @var array
+		 */
+		public $models = array('users', 'userroles', 'seminaries', 'characters');
+		/**
+		 * Current user
+		 * 
+		 * @var array
+		 */
+		public static $user = null;
+		/**
+		 * Title information
+		 * 
+		 * @var array
+		 */
+		private $title = array();
+		
+		
+		
+		
+		/**
+		 * Construct a new IntermediateController.
+		 * 
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of the current Layout
+		 * @param	string	$action		Current Action
+		 * @param	Agent	$agent		Corresponding Agent
+		 */
+		public function __construct($layoutName, $action, $agent)
+		{
+			parent::__construct($layoutName, $action, $agent);
+		}
+		
+		
+		
+		/**
+		 * Prefilter that is executed before running the Controller.
+		 * 
+		 * @param	Request		$request	Current request
+		 * @param	Response	$response	Current response
+		 */
+		public function preFilter(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			parent::preFilter($request, $response);
+			
+			// Get userdata
+			try {
+				self::$user = $this->Users->getUserById($this->Auth->getUserId());
+				self::$user['roles'] = array_map(function($r) { return $r['name']; }, $this->Userroles->getUserrolesForUserById(self::$user['id']));
+			}
+			catch(\nre\exceptions\IdNotFoundException $e) {
+			}
+			
+			// Check permissions
+			$this->checkPermission($request, $response);
+			
+			// Set userdata
+			$this->set('loggedUser', self::$user);
+		}
+		
+		
+		/**
+		 * Postfilter that is executed after running the Controller.
+		 * 
+		 * @param	Request		$request	Current request
+		 * @param	Response	$response	Current response
+		 */
+		public function postFilter(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			parent::postFilter($request, $response);
+		}
+		
+		
+		/**
+		 * Return current title information.
+		 * 
+		 * @return	string	Title information
+		 */
+		public function getTitle()
+		{
+			return $this->title;
+		}
+		
+		
+		
+		
+		/**
+		 * Add a piece of information to the current title.
+		 * 
+		 * @param	string	$title Title information
+		 */
+		protected function addTitle($title)
+		{
+			$this->title[] = $title;
+		}
+		
+		
+		/**
+		 * Add a piece of information to the current title and localize
+		 * it.
+		 * 
+		 * @param	string	$title Title information
+		 */
+		protected function addTitleLocalized($title)
+		{
+			$title = gettext($title);
+			
+			$args = func_get_args();
+			if(count($args) > 0) {
+				$title = call_user_func_array(
+					'sprintf',
+					array_merge(
+						array($title),
+						array_slice($args, 1)
+					)
+				);
+			}
+			
+			
+			$this->title[] = $title;
+		}
+		
+		
+		
+		
+		/**
+		 * Check user permissions.
+		 * 
+		 * @throws AccessDeniedException
+		 */
+		private function checkPermission(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Determine user
+			$userRoles = array('guest');
+			if(!is_null(self::$user)) {
+				$userRoles = self::$user['roles'];
+			}
+			
+			
+			// Do not check error pages
+			if($response->getParam(0, 'toplevel') == \nre\core\Config::getDefault('toplevel-error')) {
+				return;
+			}
+			if($response->getParam(1, 'intermediate') == \nre\core\Config::getDefault('intermediate-error')) {
+				return;
+			}
+			
+			// Determine permissions of Intermediate Controller for current action
+			$controller = $this->agent->controller;
+			$action = $this->request->getParam(2, 'action');
+			if(!property_exists($controller, 'permissions')) {
+				return;	// Allow if nothing is specified
+			}
+			if(!array_key_exists($action, $controller->permissions)) {
+				return;	// Allow if Action is not specified
+			}
+			$permissions = $controller->permissions[$action];
+			
+			
+			// Check permissions
+			if(count(array_intersect($userRoles, $permissions)) == 0) {
+				throw new \nre\exceptions\AccessDeniedException();
+			}
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fcontrollers%2FQuesttypeController.inc.txt

@@ -0,0 +1,320 @@
+<?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\controllers;
+	
+	
+	/**
+	 * Abstract class for implementing a QuesttypeController.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class QuesttypeController extends \hhu\z\Controller
+	{
+		/**
+		 * Required models
+		 * 
+		 * @var array
+		 */
+		public $models = array('seminaries', 'questgroups', 'quests', 'characters');
+		
+		
+		
+		
+		/**
+		 * 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 abstract function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers);
+		
+		
+		/**
+		 * Save additional data for 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	$data		Additional (POST-) data
+		 */
+		public abstract function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data);
+		
+		
+		/**
+		 * 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
+		 * @return	boolean			True/false for a right/wrong answer or null for moderator evaluation
+		 */
+		public abstract function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers);
+		
+		
+		/**
+		 * Action: quest.
+		 * 
+		 * Show the task of 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	Exception	$exception	Character submission exception
+		 */
+		public abstract function quest($seminary, $questgroup, $quest, $character, $exception);
+		
+		
+		/**
+		 * Action: submission.
+		 * 
+		 * Show the submission 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
+		 */
+		public abstract function submission($seminary, $questgroup, $quest, $character);
+
+
+		/**
+		 * Action: edittask.
+		 * 
+		 * Edit the task of a Quest.
+		 * 
+		 * @param	array		$seminary	Current Seminary data
+		 * @param	array		$questgroup	Current Questgroup data
+		 * @param	array		$quest		Current Quest data
+		 */
+		public abstract function edittask($seminary, $questgroup, $quest);
+		
+		
+		
+		
+		/**
+		 * Load a QuesttypeController.
+		 * 
+		 * @static
+		 * @throws	QuesttypeControllerNotFoundException
+		 * @throws	QuesttypeControllerNotValidException
+		 * @param	string	$controllerName		Name of the QuesttypeController to load
+		 */
+		public static function load($controllerName)
+		{
+			// Determine full classname
+			$className = self::getClassName($controllerName);
+			
+			try {
+				// Load class
+				static::loadClass($controllerName, $className);
+				
+				// Validate class
+				static::checkClass($className, get_class());
+			}
+			catch(\nre\exceptions\ClassNotValidException $e) {
+				throw new \hhu\z\exceptions\QuesttypeControllerNotValidException($e->getClassName());
+			}
+			catch(\nre\exceptions\ClassNotFoundException $e) {
+				throw new \hhu\z\exceptions\QuesttypeControllerNotFoundException($e->getClassName());
+			}
+		}
+		
+		
+		/**
+		 * Instantiate a QuesttypeController (Factory Pattern).
+		 * 
+		 * @static
+		 * @throws	DatamodelException
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @param	string	$controllerName	Name of the QuesttypeController to instantiate
+		 * @param	string	$layoutName	Name of the current Layout
+		 * @param	string	$action		Current Action
+		 */
+		public static function factory($controllerName, $layoutName, $action, $agent)
+		{
+			// Determine full classname
+			$className = self::getClassName($controllerName);
+			
+			// Construct and return Controller
+			return new $className($layoutName, $action, $agent);
+		}
+		
+		
+		/**
+		 * Determine the Controller-classname for the given Questtype-name.
+		 * 
+		 * @static
+		 * @param	string	$questtypeName	Questtype-name to get Controller-classname of
+		 * @return	string			Classname for the Questtype-name
+		 */
+		private static function getClassName($questtypeName)
+		{
+			$className = \nre\core\ClassLoader::concatClassNames($questtypeName, \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripNamespace(get_class())), 'controller');
+			
+			
+			return \nre\configs\AppConfig::$app['namespace']."questtypes\\$className";
+		}
+		
+		
+		/**
+		 * Load the class of a QuesttypeController
+		 * 
+		 * @static
+		 * @throws	ClassNotFoundException
+		 * @param	string	$questtypeName	Name of the QuesttypeController 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 QuesttypeController-class.
+		 * 
+		 * @static
+		 * @throws	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 application Controller.
+		 * 
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of the current Layout
+		 * @param	string	$action		Current Action
+		 * @param	Agent	$agent		Corresponding Agent
+		 */
+		public function __construct($layoutName, $action, $agent)
+		{
+			parent::__construct($layoutName, $action, $agent);
+		}
+		
+		
+		
+		
+		/**
+		 * Load the Models of this Controller.
+		 * 
+		 * @throws	DatamodelException
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 */
+		protected function loadModels()
+		{
+			// Load default models
+			parent::loadModels();
+			
+			// Load QuesttypeModel
+			$this->loadModel();
+		}
+		
+		
+		/**
+		 * Load the Model of the Questtype.
+		 * 
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 */
+		private function loadModel()
+		{
+			// Determine Model
+			$model = \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripNamespace(get_class($this))));
+			
+			// Load class
+			\hhu\z\models\QuesttypeModel::load($model);
+			
+			// Construct Model
+			$modelName = ucfirst(strtolower($model));
+			$this->$modelName = \hhu\z\models\QuesttypeModel::factory($model);
+		}
+		
+		
+		/**
+		 * Load the View of this QuesttypeController.
+		 * 
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of the current Layout
+		 * @param	string	$action		Current Action
+		 */
+		protected function loadView($layoutName, $action)
+		{
+			// Check Layout name
+			if(is_null($layoutName)) {
+				return;
+			}
+			
+			// Determine controller name
+			$controllerName = \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::getClassName(get_class($this)));
+			
+			
+			// Load view
+			$this->view = \hhu\z\views\QuesttypeView::loadAndFactory($layoutName, $controllerName, $action);
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fcontrollers%2FSeminaryController.inc.txt

@@ -0,0 +1,323 @@
+<?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\controllers;
+	
+	
+	/**
+	 * Abstract class for implementing a Controller for a Seminary and its
+	 * concepts.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class SeminaryController extends \hhu\z\controllers\IntermediateController
+	{
+		/**
+		 * Required components
+		 * 
+		 * @var array
+		 */
+		public $components = array('achievement', 'auth', 'notification');
+		/**
+		 * Required models
+		 * 
+		 * @var array
+		 */
+		public $models = array('seminaries', 'characters', 'characterroles', 'xplevels', 'avatars', 'achievements');
+		/**
+		 * Current Seminary
+		 * 
+		 * var array
+		 */
+		public static $seminary = null;
+		/**
+		 * Character of current user and Seminary
+		 * 
+		 * @var array
+		 */
+		public static $character = null;
+		
+		
+		
+		
+		/**
+		 * Construct a new Seminary Controller.
+		 * 
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	ModelNotValidException
+		 * @throws	ModelNotFoundException
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of the current Layout
+		 * @param	string	$action		Current Action
+		 * @param	Agent	$agent		Corresponding Agent
+		 */
+		public function __construct($layoutName, $action, $agent)
+		{
+			parent::__construct($layoutName, $action, $agent);
+		}
+		
+		
+		
+		/**
+		 * Prefilter that is executed before running the Controller.
+		 * 
+		 * @param	Request		$request	Current request
+		 * @param	Response	$response	Current response
+		 */
+		public function preFilter(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			parent::preFilter($request, $response);
+			
+			// Get Seminary and Character data
+			try {
+				self::$seminary = $this->Seminaries->getSeminaryByUrl($this->request->getParam(3));
+				if(!is_null(self::$user))
+				{
+					self::$character = $this->Characters->getCharacterForUserAndSeminary(self::$user['id'], self::$seminary['id']);
+					self::$character['characterroles'] = array_map(function($r) { return $r['name']; }, $this->Characterroles->getCharacterrolesForCharacterById(self::$character['id']));
+					try {
+						self::$character['xplevel'] = $this->Xplevels->getXPLevelById(self::$character['xplevel_id']);
+						self::$character['avatar'] = $this->Avatars->getAvatarByTypeAndLevel(self::$seminary['id'], self::$character['charactertype_url'], self::$character['xplevel']['level']);
+					}
+					catch(\nre\exceptions\IdNotFoundException $e) {
+						// No Avatar available
+					}
+				}
+			}
+			catch(\nre\exceptions\IdNotFoundException $e) {
+			}
+			
+			// Check permissions
+			$this->checkPermission($request, $response);
+			
+			// Check achievements
+			$this->checkAchievements($request, $response, 'date');
+			$this->checkAchievements($request, $response, 'achievement');
+			
+			// Set Seminary and Character data
+			$this->set('loggedSeminary', self::$seminary);
+			$this->set('loggedCharacter', self::$character);
+		}
+		
+		
+		/**
+		 * Postfilter that is executed after running the Controller.
+		 * 
+		 * @param	Request		$request	Current request
+		 * @param	Response	$response	Current response
+		 */
+		public function postFilter(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			parent::postFilter($request, $response);
+		}
+		
+		
+		
+		/**
+		 * Check user permissions.
+		 * 
+		 * @throws AccessDeniedException
+		 */
+		private function checkPermission(\nre\core\Request $request, \nre\core\Response $response)
+		{
+			// Do not check index page
+			if(is_null($request->getParam(3))) {
+				return;
+			}
+			
+			
+			// Determine permissions for current action
+			$action = $this->request->getParam(2, 'action');
+			if(!property_exists($this, 'seminaryPermissions')) {
+				return;	// Allow if nothing is specified
+			}
+			if(!array_key_exists($action, $this->seminaryPermissions)) {
+				return;	// Allow if Action is not specified
+			}
+			$permissions = $this->seminaryPermissions[$action];
+			
+			
+			// Check permissions
+			if(is_null(self::$character) || !array_key_exists('characterroles', self::$character) || count(array_intersect(self::$character['characterroles'], $permissions)) == 0) {
+				throw new \nre\exceptions\AccessDeniedException();
+			}
+		}
+		
+		
+		/**
+		 * Check for newly achieved Achievements.
+		 */
+		protected function checkAchievements(\nre\core\Request $request, \nre\core\Response $response, $checkConditions=null)
+		{
+			// Do not check MediaController
+			if($this->request->getParam(0, 'toplevel') != \nre\configs\AppConfig::$defaults['toplevel']) {
+				return;
+			}
+			
+			// Check if Character is present
+			if(is_null(self::$character)) {
+				return;
+			}
+			
+			// Set conditions to check
+			if(!is_null($checkConditions) && !is_array($checkConditions)) {
+				$checkConditions = array($checkConditions);
+			}
+			
+			// Get unachieved Achievments
+			$achievements = $this->Achievements->getUnachhievedAchievementsForCharacter(self::$seminary['id'], self::$character['id']);
+			if(in_array('user', self::$character['characterroles'])) {
+				$achievements = array_merge($achievements, $this->Achievements->getUnachievedOnlyOnceAchievementsForSeminary(self::$seminary['id']));
+			}
+			
+			// Check conditions
+			foreach($achievements as &$achievement)
+			{
+				// Check condition to test
+				if(!is_null($checkConditions) && !in_array($achievement['condition'], $checkConditions)) {
+					continue;
+				}
+				
+				// Check deadline
+				if(!is_null($achievement['deadline']) && $achievement['deadline'] < date('Y-m-d H:i:s')) {
+					continue;
+				}
+				
+				// Get conditions
+				$conditions = array();
+				$progress = 0;
+				switch($achievement['condition'])
+				{
+					// Date conditions
+					case 'date':
+						$conditionsDate = $this->Achievements->getAchievementConditionsDate($achievement['id']);
+						foreach($conditionsDate as &$condition)
+						{
+							$conditions[] = array(
+								'func'		=> 'checkAchievementConditionDate',
+								'params'	=> array(
+									$condition['select']
+								)
+							);
+						}
+					break;
+					// Character conditions
+					case 'character':
+						$conditionsCharacter = $this->Achievements->getAchievementConditionsCharacter($achievement['id']);
+						foreach($conditionsCharacter as &$condition)
+						{
+							$conditions[] = array(
+								'func'		=> 'checkAchievementConditionCharacter',
+								'params'	=> array(
+									$condition['field'],
+									$condition['value'],
+									self::$character['id']
+								)
+							);
+						}
+					break;
+					// Quest conditions
+					case 'quest':
+						$conditionsQuest = $this->Achievements->getAchievementConditionsQuest($achievement['id']);
+						foreach($conditionsQuest as &$condition)
+						{
+							$conditions[] = array(
+								'func'		=> 'checkAchievementConditionQuest',
+								'params'	=> array(
+									$condition['field'],
+									$condition['count'],
+									$condition['value'],
+									$condition['status'],
+									$condition['groupby'],
+									$condition['quest_id'],
+									self::$character['id']
+								)
+							);
+						}
+					break;
+					// Achievement conditions
+					case 'achievement':
+						$conditionsAchievement = $this->Achievements->getAchievementConditionsAchievement($achievement['id']);
+						foreach($conditionsAchievement as &$condition)
+						{
+							$conditions[] = array(
+								'func'		=> 'checkAchievementConditionAchievement',
+								'params'	=> array(
+									$condition['field'],
+									$condition['count'],
+									$condition['value'],
+									$condition['groupby'],
+									$condition['meta_achievement_id'],
+									self::$character['id']
+								)
+							);
+						}
+					break;
+				}
+				
+				// Do not achieve Achievements without conditions
+				if(empty($conditions)) {
+					continue;
+				}
+				
+				// Check conditions
+				$achieved = ($achievement['all_conditions'] == 1);
+				foreach($conditions as &$condition)
+				{
+					// Calculate result of condition
+					$result = call_user_func_array(
+						array(
+							$this->Achievements,
+							$condition['func']
+						),
+						$condition['params']
+					);
+					
+					// The overall result and abort if possible
+					if($achievement['all_conditions'])
+					{
+						if(!$result) {
+							$achieved = false;
+							break;
+						}
+					}
+					else
+					{
+						if($result) {
+							$achieved = true;
+							break;
+						}
+					}
+					
+				}
+				
+				// Achievement achieved
+				if($achieved)
+				{
+					// Set status
+					$this->Achievements->setAchievementAchieved($achievement['id'], self::$character['id']);
+					
+					// Add notification
+					$this->Notification->addNotification(
+						\hhu\z\controllers\components\NotificationComponent::TYPE_ACHIEVEMENT,
+						$achievement['title'],
+						$this->linker->link(array('achievements', 'index', self::$seminary['url']), 0, true, null, true, $achievement['url']),
+						(!is_null($achievement['achieved_achievementsmedia_id']) ? $this->linker->link(array('media','achievement',self::$seminary['url'],$achievement['url'])) : null)
+					);
+				}
+			}
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FFileUploadException.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\exceptions;
+	
+	
+	/**
+	 * Exception: File upload went wrong
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class FileUploadException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	203;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'File upload went wrong';
+		
+		/**
+		 * Nested message
+		 * 
+		 * @var string
+		 */
+		private $nestedMessage;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 */
+		function __construct($nestedMessage=null, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$nestedMessage
+			);
+			
+			// Store values
+			$this->nestedMessage = $nestedMessage;
+		}
+		
+		
+		
+		
+		/**
+		 * Get nested message.
+		 * 
+		 * @return	Nested message
+		 */
+		public function getNestedMessage()
+		{
+			return $this->nestedMessage;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FMailingException.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\exceptions;
+	
+	
+	/**
+	 * Exception during sending of an e‑mail.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MailingException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	300;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'Error sending e‑mail';
+		
+		/**
+		 * Nested error message
+		 * 
+		 * @var string
+		 */
+		private $error;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 */
+		function __construct($error, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$error
+			);
+			
+			// Store values
+			$this->error = $error;
+		}
+		
+		
+		
+		
+		/**
+		 * Get nested error message.
+		 * 
+		 * @return	string	Nested error message
+		 */
+		public function getError()
+		{
+			return $this->error;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FMaxFilesizeException.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\exceptions;
+	
+	
+	/**
+	 * Exception: File exceeds size maximum.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MaxFilesizeException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	202;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'File exceeds size maximum';
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 */
+		function __construct($message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code
+			);
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FQuesttypeAgentNotFoundException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: QuesttypeAgent not found.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeAgentNotFoundException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	101;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'QuesttypeAgent not found';
+		
+		/**
+		 * Name of the class that was not found
+		 * 
+		 * @var string
+		 */
+		private $questtypeName;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$questtypeName	Name of the QuesttypeAgent that was not found
+		 */
+		function __construct($questtypeName, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$questtypeName
+			);
+			
+			// Store values
+			$this->questtypeName = $questtypeName;
+		}
+		
+		
+		
+		
+		/**
+		 * Get the name of the QuesttypeAgent that was not found.
+		 * 
+		 * @return	string	Name of the QuesttypeAgent that was not found
+		 */
+		public function getClassName()
+		{
+			return $this->questtypeName;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FQuesttypeAgentNotValidException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: QuesttypeAgent not valid.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeAgentNotValidException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	102;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'QuesttypeAgent not valid';
+		
+		/**
+		 * Name of the invalid class
+		 * 
+		 * @var string
+		 */
+		private $questtypeName;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$questtypeName	Name of the invalid QuesttypeAgent
+		 */
+		function __construct($questtypeName, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$questtypeName
+			);
+			
+			// Store value
+			$this->questtypeName = $questtypeName;
+		}
+		
+		
+		
+		
+		/**
+		 * Get the name of the invalid QuesttypeAgent.
+		 * 
+		 * @return	string	Name of the invalid QuesttypeAgent
+		 */
+		public function getClassName()
+		{
+			return $this->questtypeName;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FQuesttypeControllerNotFoundException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: QuesttypeController not found.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeControllerNotFoundException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	103;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'QuesttypeController not found';
+		
+		/**
+		 * Name of the class that was not found
+		 * 
+		 * @var string
+		 */
+		private $questtypeName;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$questtypeName	Name of the QuesttypeController that was not found
+		 */
+		function __construct($questtypeName, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$questtypeName
+			);
+			
+			// Store values
+			$this->questtypeName = $questtypeName;
+		}
+		
+		
+		
+		
+		/**
+		 * Get the name of the QuesttypeController that was not found.
+		 * 
+		 * @return	string	Name of the QuesttypeController that was not found
+		 */
+		public function getClassName()
+		{
+			return $this->questtypeName;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FQuesttypeControllerNotValidException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: QuesttypeController not valid.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeControllerNotValidException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	104;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'QuesttypeController not valid';
+		
+		/**
+		 * Name of the invalid class
+		 * 
+		 * @var string
+		 */
+		private $questtypeName;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$questtypeName	Name of the invalid QuesttypeController
+		 */
+		function __construct($questtypeName, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$questtypeName
+			);
+			
+			// Store value
+			$this->questtypeName = $questtypeName;
+		}
+		
+		
+		
+		
+		/**
+		 * Get the name of the invalid QuesttypeController.
+		 * 
+		 * @return	string	Name of the invalid QuesttypeController
+		 */
+		public function getClassName()
+		{
+			return $this->questtypeName;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FQuesttypeModelNotFoundException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: QuesttypeModel not found.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeModelNotFoundException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	105;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'QuesttypeModel not found';
+		
+		/**
+		 * Name of the class that was not found
+		 * 
+		 * @var string
+		 */
+		private $questtypeName;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$questtypeName	Name of the QuesttypeModel that was not found
+		 */
+		function __construct($questtypeName, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$questtypeName
+			);
+			
+			// Store values
+			$this->questtypeName = $questtypeName;
+		}
+		
+		
+		
+		
+		/**
+		 * Get the name of the QuesttypeModel that was not found.
+		 * 
+		 * @return	string	Name of the QuesttypeModel that was not found
+		 */
+		public function getClassName()
+		{
+			return $this->questtypeName;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FQuesttypeModelNotValidException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: QuesttypeModel not valid.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeModelNotValidException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	106;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'QuesttypeModel not valid';
+		
+		/**
+		 * Name of the invalid class
+		 * 
+		 * @var string
+		 */
+		private $questtypeName;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$questtypeName	Name of the invalid QuesttypeModel
+		 */
+		function __construct($questtypeName, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$questtypeName
+			);
+			
+			// Store value
+			$this->questtypeName = $questtypeName;
+		}
+		
+		
+		
+		
+		/**
+		 * Get the name of the invalid QuesttypeModel.
+		 * 
+		 * @return	string	Name of the invalid QuesttypeModel
+		 */
+		public function getClassName()
+		{
+			return $this->questtypeName;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FSubmissionNotValidException.inc.txt

@@ -0,0 +1,78 @@
+<?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\exceptions;
+	
+	
+	/**
+	 * Exception: Character submission not valid.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class SubmissionNotValidException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	200;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'Character submission not valid';
+		
+		/**
+		 * Nested exception
+		 * 
+		 * @var Exception
+		 */
+		private $nestedException;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 * 
+		 * @param	string	$nestedException	Nested exception
+		 */
+		function __construct($nestedException, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$nestedException
+			);
+			
+			// Store value
+			$this->nestedException = $nestedException;
+		}
+		
+		
+		
+		
+		/**
+		 * Get Nested exception.
+		 * 
+		 * @return	string	Nested exception
+		 */
+		public function getNestedException()
+		{
+			return $this->nestedException;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fexceptions%2FWrongFiletypeException.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\exceptions;
+	
+	
+	/**
+	 * Exception: File has wrong filetype.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class WrongFiletypeException extends \nre\core\Exception
+	{
+		/**
+		 * Error code
+		 * 
+		 * @var int
+		 */
+		const CODE	=	201;
+		/**
+		 * Error message
+		 * 
+		 * @var string
+		 */
+		const MESSAGE	=	'File has wrong type “%s”';
+		
+		/**
+		 * Type of file
+		 * 
+		 * @var string
+		 */
+		private $type;
+		
+		
+		
+		
+		/**
+		 * Construct a new exception.
+		 */
+		function __construct($type, $message=self::MESSAGE, $code=self::CODE)
+		{
+			parent::__construct(
+				$message,
+				$code,
+				$type
+			);
+			
+			// Store values
+			$this->type = $type;
+		}
+		
+		
+		
+		
+		/**
+		 * Get type of file.
+		 * 
+		 * @return	Type of file
+		 */
+		public function getType()
+		{
+			return $this->type;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Flib%2FPHPMailerAutoload.inc.txt

@@ -0,0 +1,87 @@
+<?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\lib
+	{
+		
+		
+		/**
+		 * Class to ensure that Compatibility library below is loaded.
+		 * 
+		 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+		 */
+		class PHPMailerAutoload
+		{
+			
+			/**
+			 * Call this function to ensure this file is loaded.
+			 */
+			public static function load()
+			{
+			}
+			
+		}
+			
+	}
+	
+	namespace {
+	
+/**
+ * PHPMailer SPL autoloader.
+ * PHP Version 5
+ * @package PHPMailer
+ * @link https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project
+ * @author Marcus Bointon (Synchro/coolbru) <phpmailer@synchromedia.co.uk>
+ * @author Jim Jagielski (jimjag) <jimjag@gmail.com>
+ * @author Andy Prevost (codeworxtech) <codeworxtech@users.sourceforge.net>
+ * @author Brent R. Matzelle (original founder)
+ * @copyright 2012 - 2014 Marcus Bointon
+ * @copyright 2010 - 2012 Jim Jagielski
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License
+ * @note This program is distributed in the hope that it will be useful - WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.
+ */
+
+/**
+ * PHPMailer SPL autoloader.
+ * @param string $classname The name of the class to load
+ */
+function PHPMailerAutoload($classname)
+{
+    //Can't use __DIR__ as it's only in PHP 5.3+
+    $filename = dirname(__FILE__).DIRECTORY_SEPARATOR.'class.'.strtolower($classname).'.php';
+    if (is_readable($filename)) {
+        require $filename;
+    }
+}
+
+if (version_compare(PHP_VERSION, '5.1.2', '>=')) {
+    //SPL autoloading was introduced in PHP 5.1.2
+    if (version_compare(PHP_VERSION, '5.3.0', '>=')) {
+        spl_autoload_register('PHPMailerAutoload', true, true);
+    } else {
+        spl_autoload_register('PHPMailerAutoload');
+    }
+} else {
+    /**
+     * Fall back to traditional autoload for old PHP versions
+     * @param string $classname The name of the class to load
+     */
+    function __autoload($classname)
+    {
+        PHPMailerAutoload($classname);
+    }
+}
+
+}
+

doc/files/app%2Flib%2FPassword.inc.txt

@@ -0,0 +1,317 @@
+<?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\lib
+	{
+		
+		
+		/**
+		 * Class to ensure that Compatibility library below is loaded.
+		 * 
+		 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+		 */
+		class Password
+		{
+			
+			/**
+			 * Call this function to ensure this file is loaded.
+			 */
+			public static function load()
+			{
+			}
+			
+		}
+			
+	}
+
+
+
+
+/**
+ * A Compatibility library with PHP 5.5's simplified password hashing API.
+ *
+ * @author Anthony Ferrara <ircmaxell@php.net>
+ * @license http://www.opensource.org/licenses/mit-license.html MIT License
+ * @copyright 2012 The Authors
+ */
+
+namespace {
+
+if (!defined('PASSWORD_DEFAULT')) {
+
+    define('PASSWORD_BCRYPT', 1);
+    define('PASSWORD_DEFAULT', PASSWORD_BCRYPT);
+
+    /**
+     * Hash the password using the specified algorithm
+     *
+     * @param string $password The password to hash
+     * @param int    $algo     The algorithm to use (Defined by PASSWORD_* constants)
+     * @param array  $options  The options for the algorithm to use
+     *
+     * @return string|false The hashed password, or false on error.
+     */
+    function password_hash($password, $algo, array $options = array()) {
+        if (!function_exists('crypt')) {
+            trigger_error("Crypt must be loaded for password_hash to function", E_USER_WARNING);
+            return null;
+        }
+        if (!is_string($password)) {
+            trigger_error("password_hash(): Password must be a string", E_USER_WARNING);
+            return null;
+        }
+        if (!is_int($algo)) {
+            trigger_error("password_hash() expects parameter 2 to be long, " . gettype($algo) . " given", E_USER_WARNING);
+            return null;
+        }
+        $resultLength = 0;
+        switch ($algo) {
+            case PASSWORD_BCRYPT:
+                // Note that this is a C constant, but not exposed to PHP, so we don't define it here.
+                $cost = 10;
+                if (isset($options['cost'])) {
+                    $cost = $options['cost'];
+                    if ($cost < 4 || $cost > 31) {
+                        trigger_error(sprintf("password_hash(): Invalid bcrypt cost parameter specified: %d", $cost), E_USER_WARNING);
+                        return null;
+                    }
+                }
+                // The length of salt to generate
+                $raw_salt_len = 16;
+                // The length required in the final serialization
+                $required_salt_len = 22;
+                $hash_format = sprintf("$2y$%02d$", $cost);
+                // The expected length of the final crypt() output
+                $resultLength = 60;
+                break;
+            default:
+                trigger_error(sprintf("password_hash(): Unknown password hashing algorithm: %s", $algo), E_USER_WARNING);
+                return null;
+        }
+        $salt_requires_encoding = false;
+        if (isset($options['salt'])) {
+            switch (gettype($options['salt'])) {
+                case 'NULL':
+                case 'boolean':
+                case 'integer':
+                case 'double':
+                case 'string':
+                    $salt = (string) $options['salt'];
+                    break;
+                case 'object':
+                    if (method_exists($options['salt'], '__tostring')) {
+                        $salt = (string) $options['salt'];
+                        break;
+                    }
+                case 'array':
+                case 'resource':
+                default:
+                    trigger_error('password_hash(): Non-string salt parameter supplied', E_USER_WARNING);
+                    return null;
+            }
+            if (PasswordCompat\binary\_strlen($salt) < $required_salt_len) {
+                trigger_error(sprintf("password_hash(): Provided salt is too short: %d expecting %d", PasswordCompat\binary\_strlen($salt), $required_salt_len), E_USER_WARNING);
+                return null;
+            } elseif (0 == preg_match('#^[a-zA-Z0-9./]+$#D', $salt)) {
+                $salt_requires_encoding = true;
+            }
+        } else {
+            $buffer = '';
+            $buffer_valid = false;
+            if (function_exists('mcrypt_create_iv') && !defined('PHALANGER')) {
+                $buffer = mcrypt_create_iv($raw_salt_len, MCRYPT_DEV_URANDOM);
+                if ($buffer) {
+                    $buffer_valid = true;
+                }
+            }
+            if (!$buffer_valid && function_exists('openssl_random_pseudo_bytes')) {
+                $buffer = openssl_random_pseudo_bytes($raw_salt_len);
+                if ($buffer) {
+                    $buffer_valid = true;
+                }
+            }
+            if (!$buffer_valid && @is_readable('/dev/urandom')) {
+                $f = fopen('/dev/urandom', 'r');
+                $read = PasswordCompat\binary\_strlen($buffer);
+                while ($read < $raw_salt_len) {
+                    $buffer .= fread($f, $raw_salt_len - $read);
+                    $read = PasswordCompat\binary\_strlen($buffer);
+                }
+                fclose($f);
+                if ($read >= $raw_salt_len) {
+                    $buffer_valid = true;
+                }
+            }
+            if (!$buffer_valid || PasswordCompat\binary\_strlen($buffer) < $raw_salt_len) {
+                $bl = PasswordCompat\binary\_strlen($buffer);
+                for ($i = 0; $i < $raw_salt_len; $i++) {
+                    if ($i < $bl) {
+                        $buffer[$i] = $buffer[$i] ^ chr(mt_rand(0, 255));
+                    } else {
+                        $buffer .= chr(mt_rand(0, 255));
+                    }
+                }
+            }
+            $salt = $buffer;
+            $salt_requires_encoding = true;
+        }
+        if ($salt_requires_encoding) {
+            // encode string with the Base64 variant used by crypt
+            $base64_digits =
+                'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+            $bcrypt64_digits =
+                './ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+
+            $base64_string = base64_encode($salt);
+            $salt = strtr(rtrim($base64_string, '='), $base64_digits, $bcrypt64_digits);
+        }
+        $salt = PasswordCompat\binary\_substr($salt, 0, $required_salt_len);
+
+        $hash = $hash_format . $salt;
+
+        $ret = crypt($password, $hash);
+
+        if (!is_string($ret) || PasswordCompat\binary\_strlen($ret) != $resultLength) {
+            return false;
+        }
+
+        return $ret;
+    }
+
+    /**
+     * Get information about the password hash. Returns an array of the information
+     * that was used to generate the password hash.
+     *
+     * array(
+     *    'algo' => 1,
+     *    'algoName' => 'bcrypt',
+     *    'options' => array(
+     *        'cost' => 10,
+     *    ),
+     * )
+     *
+     * @param string $hash The password hash to extract info from
+     *
+     * @return array The array of information about the hash.
+     */
+    function password_get_info($hash) {
+        $return = array(
+            'algo' => 0,
+            'algoName' => 'unknown',
+            'options' => array(),
+        );
+        if (PasswordCompat\binary\_substr($hash, 0, 4) == '$2y$' && PasswordCompat\binary\_strlen($hash) == 60) {
+            $return['algo'] = PASSWORD_BCRYPT;
+            $return['algoName'] = 'bcrypt';
+            list($cost) = sscanf($hash, "$2y$%d$");
+            $return['options']['cost'] = $cost;
+        }
+        return $return;
+    }
+
+    /**
+     * Determine if the password hash needs to be rehashed according to the options provided
+     *
+     * If the answer is true, after validating the password using password_verify, rehash it.
+     *
+     * @param string $hash    The hash to test
+     * @param int    $algo    The algorithm used for new password hashes
+     * @param array  $options The options array passed to password_hash
+     *
+     * @return boolean True if the password needs to be rehashed.
+     */
+    function password_needs_rehash($hash, $algo, array $options = array()) {
+        $info = password_get_info($hash);
+        if ($info['algo'] != $algo) {
+            return true;
+        }
+        switch ($algo) {
+            case PASSWORD_BCRYPT:
+                $cost = isset($options['cost']) ? $options['cost'] : 10;
+                if ($cost != $info['options']['cost']) {
+                    return true;
+                }
+                break;
+        }
+        return false;
+    }
+
+    /**
+     * Verify a password against a hash using a timing attack resistant approach
+     *
+     * @param string $password The password to verify
+     * @param string $hash     The hash to verify against
+     *
+     * @return boolean If the password matches the hash
+     */
+    function password_verify($password, $hash) {
+        if (!function_exists('crypt')) {
+            trigger_error("Crypt must be loaded for password_verify to function", E_USER_WARNING);
+            return false;
+        }
+        $ret = crypt($password, $hash);
+        if (!is_string($ret) || PasswordCompat\binary\_strlen($ret) != PasswordCompat\binary\_strlen($hash) || PasswordCompat\binary\_strlen($ret) <= 13) {
+            return false;
+        }
+
+        $status = 0;
+        for ($i = 0; $i < PasswordCompat\binary\_strlen($ret); $i++) {
+            $status |= (ord($ret[$i]) ^ ord($hash[$i]));
+        }
+
+        return $status === 0;
+    }
+}
+
+}
+
+namespace PasswordCompat\binary {
+    /**
+     * Count the number of bytes in a string
+     *
+     * We cannot simply use strlen() for this, because it might be overwritten by the mbstring extension.
+     * In this case, strlen() will count the number of *characters* based on the internal encoding. A
+     * sequence of bytes might be regarded as a single multibyte character.
+     *
+     * @param string $binary_string The input string
+     *
+     * @internal
+     * @return int The number of bytes
+     */
+    function _strlen($binary_string) {
+           if (function_exists('mb_strlen')) {
+               return mb_strlen($binary_string, '8bit');
+           }
+           return strlen($binary_string);
+    }
+
+    /**
+     * Get a substring based on byte limits
+     *
+     * @see _strlen()
+     *
+     * @param string $binary_string The input string
+     * @param int    $start
+     * @param int    $length
+     *
+     * @internal
+     * @return string The substring
+     */
+    function _substr($binary_string, $start, $length) {
+       if (function_exists('mb_substr')) {
+           return mb_substr($binary_string, $start, $length, '8bit');
+       }
+       return substr($binary_string, $start, $length);
+   }
+
+}
+

doc/files/app%2Flib%2FSMTP.inc.txt

@@ -0,0 +1,973 @@
+<?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\lib
+	{
+		
+		
+		/**
+		 * Class to ensure that Compatibility library below is loaded.
+		 * 
+		 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+		 */
+		class SMTP
+		{
+			
+			/**
+			 * Call this function to ensure this file is loaded.
+			 */
+			public static function load()
+			{
+			}
+			
+		}
+			
+	}
+	
+	namespace {
+
+/**
+ * PHPMailer RFC821 SMTP email transport class.
+ * PHP Version 5
+ * @package PHPMailer
+ * @link https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project
+ * @author Marcus Bointon (Synchro/coolbru) <phpmailer@synchromedia.co.uk>
+ * @author Jim Jagielski (jimjag) <jimjag@gmail.com>
+ * @author Andy Prevost (codeworxtech) <codeworxtech@users.sourceforge.net>
+ * @author Brent R. Matzelle (original founder)
+ * @copyright 2014 Marcus Bointon
+ * @copyright 2010 - 2012 Jim Jagielski
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License
+ * @note This program is distributed in the hope that it will be useful - WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.
+ */
+
+/**
+ * PHPMailer RFC821 SMTP email transport class.
+ * Implements RFC 821 SMTP commands and provides some utility methods for sending mail to an SMTP server.
+ * @package PHPMailer
+ * @author Chris Ryan <unknown@example.com>
+ * @author Marcus Bointon <phpmailer@synchromedia.co.uk>
+ */
+class SMTP
+{
+    /**
+     * The PHPMailer SMTP version number.
+     * @type string
+     */
+    const VERSION = '5.2.8';
+
+    /**
+     * SMTP line break constant.
+     * @type string
+     */
+    const CRLF = "\r\n";
+
+    /**
+     * The SMTP port to use if one is not specified.
+     * @type int
+     */
+    const DEFAULT_SMTP_PORT = 25;
+
+    /**
+     * The maximum line length allowed by RFC 2822 section 2.1.1
+     * @type int
+     */
+    const MAX_LINE_LENGTH = 998;
+
+    /**
+     * The PHPMailer SMTP Version number.
+     * @type string
+     * @deprecated Use the constant instead
+     * @see SMTP::VERSION
+     */
+    public $Version = '5.2.8';
+
+    /**
+     * SMTP server port number.
+     * @type int
+     * @deprecated This is only ever used as a default value, so use the constant instead
+     * @see SMTP::DEFAULT_SMTP_PORT
+     */
+    public $SMTP_PORT = 25;
+
+    /**
+     * SMTP reply line ending.
+     * @type string
+     * @deprecated Use the constant instead
+     * @see SMTP::CRLF
+     */
+    public $CRLF = "\r\n";
+
+    /**
+     * Debug output level.
+     * Options:
+     * * `0` No output
+     * * `1` Commands
+     * * `2` Data and commands
+     * * `3` As 2 plus connection status
+     * * `4` Low-level data output
+     * @type int
+     */
+    public $do_debug = 0;
+
+    /**
+     * How to handle debug output.
+     * Options:
+     * * `echo` Output plain-text as-is, appropriate for CLI
+     * * `html` Output escaped, line breaks converted to <br>, appropriate for browser output
+     * * `error_log` Output to error log as configured in php.ini
+     * @type string
+     */
+    public $Debugoutput = 'echo';
+
+    /**
+     * Whether to use VERP.
+     * @link http://en.wikipedia.org/wiki/Variable_envelope_return_path
+     * @link http://www.postfix.org/VERP_README.html Info on VERP
+     * @type bool
+     */
+    public $do_verp = false;
+
+    /**
+     * The timeout value for connection, in seconds.
+     * Default of 5 minutes (300sec) is from RFC2821 section 4.5.3.2
+     * This needs to be quite high to function correctly with hosts using greetdelay as an anti-spam measure.
+     * @link http://tools.ietf.org/html/rfc2821#section-4.5.3.2
+     * @type int
+     */
+    public $Timeout = 300;
+
+    /**
+     * The SMTP timelimit value for reads, in seconds.
+     * @type int
+     */
+    public $Timelimit = 30;
+
+    /**
+     * The socket for the server connection.
+     * @type resource
+     */
+    protected $smtp_conn;
+
+    /**
+     * Error message, if any, for the last call.
+     * @type string
+     */
+    protected $error = '';
+
+    /**
+     * The reply the server sent to us for HELO.
+     * @type string
+     */
+    protected $helo_rply = '';
+
+    /**
+     * The most recent reply received from the server.
+     * @type string
+     */
+    protected $last_reply = '';
+
+    /**
+     * Constructor.
+     * @access public
+     */
+    public function __construct()
+    {
+        $this->smtp_conn = 0;
+        $this->error = null;
+        $this->helo_rply = null;
+        $this->do_debug = 0;
+    }
+
+    /**
+     * Output debugging info via a user-selected method.
+     * @param string $str Debug string to output
+     * @return void
+     */
+    protected function edebug($str)
+    {
+        switch ($this->Debugoutput) {
+            case 'error_log':
+                //Don't output, just log
+                error_log($str);
+                break;
+            case 'html':
+                //Cleans up output a bit for a better looking, HTML-safe output
+                echo htmlentities(
+                    preg_replace('/[\r\n]+/', '', $str),
+                    ENT_QUOTES,
+                    'UTF-8'
+                )
+                . "<br>\n";
+                break;
+            case 'echo':
+            default:
+                echo gmdate('Y-m-d H:i:s')."\t".trim($str)."\n";
+        }
+    }
+
+    /**
+     * Connect to an SMTP server.
+     * @param string $host SMTP server IP or host name
+     * @param int $port The port number to connect to
+     * @param int $timeout How long to wait for the connection to open
+     * @param array $options An array of options for stream_context_create()
+     * @access public
+     * @return bool
+     */
+    public function connect($host, $port = null, $timeout = 30, $options = array())
+    {
+        // Clear errors to avoid confusion
+        $this->error = null;
+        // Make sure we are __not__ connected
+        if ($this->connected()) {
+            // Already connected, generate error
+            $this->error = array('error' => 'Already connected to a server');
+            return false;
+        }
+        if (empty($port)) {
+            $port = self::DEFAULT_SMTP_PORT;
+        }
+        // Connect to the SMTP server
+        if ($this->do_debug >= 3) {
+            $this->edebug('Connection: opening');
+        }
+        $errno = 0;
+        $errstr = '';
+        $socket_context = stream_context_create($options);
+        //Suppress errors; connection failures are handled at a higher level
+        $this->smtp_conn = @stream_socket_client(
+            $host . ":" . $port,
+            $errno,
+            $errstr,
+            $timeout,
+            STREAM_CLIENT_CONNECT,
+            $socket_context
+        );
+        // Verify we connected properly
+        if (empty($this->smtp_conn)) {
+            $this->error = array(
+                'error' => 'Failed to connect to server',
+                'errno' => $errno,
+                'errstr' => $errstr
+            );
+            if ($this->do_debug >= 1) {
+                $this->edebug(
+                    'SMTP ERROR: ' . $this->error['error']
+                    . ": $errstr ($errno)"
+                );
+            }
+            return false;
+        }
+        if ($this->do_debug >= 3) {
+            $this->edebug('Connection: opened');
+        }
+        // SMTP server can take longer to respond, give longer timeout for first read
+        // Windows does not have support for this timeout function
+        if (substr(PHP_OS, 0, 3) != 'WIN') {
+            $max = ini_get('max_execution_time');
+            if ($max != 0 && $timeout > $max) { // Don't bother if unlimited
+                @set_time_limit($timeout);
+            }
+            stream_set_timeout($this->smtp_conn, $timeout, 0);
+        }
+        // Get any announcement
+        $announce = $this->get_lines();
+        if ($this->do_debug >= 2) {
+            $this->edebug('SERVER -> CLIENT: ' . $announce);
+        }
+        return true;
+    }
+
+    /**
+     * Initiate a TLS (encrypted) session.
+     * @access public
+     * @return bool
+     */
+    public function startTLS()
+    {
+        if (!$this->sendCommand('STARTTLS', 'STARTTLS', 220)) {
+            return false;
+        }
+        // Begin encrypted connection
+        if (!stream_socket_enable_crypto(
+            $this->smtp_conn,
+            true,
+            STREAM_CRYPTO_METHOD_TLS_CLIENT
+        )) {
+            return false;
+        }
+        return true;
+    }
+
+    /**
+     * Perform SMTP authentication.
+     * Must be run after hello().
+     * @see hello()
+     * @param string $username    The user name
+     * @param string $password    The password
+     * @param string $authtype    The auth type (PLAIN, LOGIN, NTLM, CRAM-MD5)
+     * @param string $realm       The auth realm for NTLM
+     * @param string $workstation The auth workstation for NTLM
+     * @access public
+     * @return bool True if successfully authenticated.
+     */
+    public function authenticate(
+        $username,
+        $password,
+        $authtype = 'LOGIN',
+        $realm = '',
+        $workstation = ''
+    ) {
+        if (empty($authtype)) {
+            $authtype = 'LOGIN';
+        }
+        switch ($authtype) {
+            case 'PLAIN':
+                // Start authentication
+                if (!$this->sendCommand('AUTH', 'AUTH PLAIN', 334)) {
+                    return false;
+                }
+                // Send encoded username and password
+                if (!$this->sendCommand(
+                    'User & Password',
+                    base64_encode("\0" . $username . "\0" . $password),
+                    235
+                )
+                ) {
+                    return false;
+                }
+                break;
+            case 'LOGIN':
+                // Start authentication
+                if (!$this->sendCommand('AUTH', 'AUTH LOGIN', 334)) {
+                    return false;
+                }
+                if (!$this->sendCommand("Username", base64_encode($username), 334)) {
+                    return false;
+                }
+                if (!$this->sendCommand("Password", base64_encode($password), 235)) {
+                    return false;
+                }
+                break;
+            case 'NTLM':
+                /*
+                 * ntlm_sasl_client.php
+                 * Bundled with Permission
+                 *
+                 * How to telnet in windows:
+                 * http://technet.microsoft.com/en-us/library/aa995718%28EXCHG.65%29.aspx
+                 * PROTOCOL Docs http://curl.haxx.se/rfc/ntlm.html#ntlmSmtpAuthentication
+                 */
+                require_once 'extras/ntlm_sasl_client.php';
+                $temp = new stdClass();
+                $ntlm_client = new ntlm_sasl_client_class;
+                //Check that functions are available
+                if (!$ntlm_client->Initialize($temp)) {
+                    $this->error = array('error' => $temp->error);
+                    if ($this->do_debug >= 1) {
+                        $this->edebug(
+                            'You need to enable some modules in your php.ini file: '
+                            . $this->error['error']
+                        );
+                    }
+                    return false;
+                }
+                //msg1
+                $msg1 = $ntlm_client->TypeMsg1($realm, $workstation); //msg1
+
+                if (!$this->sendCommand(
+                    'AUTH NTLM',
+                    'AUTH NTLM ' . base64_encode($msg1),
+                    334
+                )
+                ) {
+                    return false;
+                }
+                //Though 0 based, there is a white space after the 3 digit number
+                //msg2
+                $challenge = substr($this->last_reply, 3);
+                $challenge = base64_decode($challenge);
+                $ntlm_res = $ntlm_client->NTLMResponse(
+                    substr($challenge, 24, 8),
+                    $password
+                );
+                //msg3
+                $msg3 = $ntlm_client->TypeMsg3(
+                    $ntlm_res,
+                    $username,
+                    $realm,
+                    $workstation
+                );
+                // send encoded username
+                return $this->sendCommand('Username', base64_encode($msg3), 235);
+                break;
+            case 'CRAM-MD5':
+                // Start authentication
+                if (!$this->sendCommand('AUTH CRAM-MD5', 'AUTH CRAM-MD5', 334)) {
+                    return false;
+                }
+                // Get the challenge
+                $challenge = base64_decode(substr($this->last_reply, 4));
+
+                // Build the response
+                $response = $username . ' ' . $this->hmac($challenge, $password);
+
+                // send encoded credentials
+                return $this->sendCommand('Username', base64_encode($response), 235);
+                break;
+        }
+        return true;
+    }
+
+    /**
+     * Calculate an MD5 HMAC hash.
+     * Works like hash_hmac('md5', $data, $key)
+     * in case that function is not available
+     * @param string $data The data to hash
+     * @param string $key  The key to hash with
+     * @access protected
+     * @return string
+     */
+    protected function hmac($data, $key)
+    {
+        if (function_exists('hash_hmac')) {
+            return hash_hmac('md5', $data, $key);
+        }
+
+        // The following borrowed from
+        // http://php.net/manual/en/function.mhash.php#27225
+
+        // RFC 2104 HMAC implementation for php.
+        // Creates an md5 HMAC.
+        // Eliminates the need to install mhash to compute a HMAC
+        // Hacked by Lance Rushing
+
+        $bytelen = 64; // byte length for md5
+        if (strlen($key) > $bytelen) {
+            $key = pack('H*', md5($key));
+        }
+        $key = str_pad($key, $bytelen, chr(0x00));
+        $ipad = str_pad('', $bytelen, chr(0x36));
+        $opad = str_pad('', $bytelen, chr(0x5c));
+        $k_ipad = $key ^ $ipad;
+        $k_opad = $key ^ $opad;
+
+        return md5($k_opad . pack('H*', md5($k_ipad . $data)));
+    }
+
+    /**
+     * Check connection state.
+     * @access public
+     * @return bool True if connected.
+     */
+    public function connected()
+    {
+        if (!empty($this->smtp_conn)) {
+            $sock_status = stream_get_meta_data($this->smtp_conn);
+            if ($sock_status['eof']) {
+                // the socket is valid but we are not connected
+                if ($this->do_debug >= 1) {
+                    $this->edebug(
+                        'SMTP NOTICE: EOF caught while checking if connected'
+                    );
+                }
+                $this->close();
+                return false;
+            }
+            return true; // everything looks good
+        }
+        return false;
+    }
+
+    /**
+     * Close the socket and clean up the state of the class.
+     * Don't use this function without first trying to use QUIT.
+     * @see quit()
+     * @access public
+     * @return void
+     */
+    public function close()
+    {
+        $this->error = null; // so there is no confusion
+        $this->helo_rply = null;
+        if (!empty($this->smtp_conn)) {
+            // close the connection and cleanup
+            fclose($this->smtp_conn);
+            if ($this->do_debug >= 3) {
+                $this->edebug('Connection: closed');
+            }
+            $this->smtp_conn = 0;
+        }
+    }
+
+    /**
+     * Send an SMTP DATA command.
+     * Issues a data command and sends the msg_data to the server,
+     * finializing the mail transaction. $msg_data is the message
+     * that is to be send with the headers. Each header needs to be
+     * on a single line followed by a <CRLF> with the message headers
+     * and the message body being separated by and additional <CRLF>.
+     * Implements rfc 821: DATA <CRLF>
+     * @param string $msg_data Message data to send
+     * @access public
+     * @return bool
+     */
+    public function data($msg_data)
+    {
+        if (!$this->sendCommand('DATA', 'DATA', 354)) {
+            return false;
+        }
+        /* The server is ready to accept data!
+         * According to rfc821 we should not send more than 1000 characters on a single line (including the CRLF)
+         * so we will break the data up into lines by \r and/or \n then if needed we will break each of those into
+         * smaller lines to fit within the limit.
+         * We will also look for lines that start with a '.' and prepend an additional '.'.
+         * NOTE: this does not count towards line-length limit.
+         */
+
+        // Normalize line breaks before exploding
+        $lines = explode("\n", str_replace(array("\r\n", "\r"), "\n", $msg_data));
+
+        /* To distinguish between a complete RFC822 message and a plain message body, we check if the first field
+         * of the first line (':' separated) does not contain a space then it _should_ be a header and we will
+         * process all lines before a blank line as headers.
+         */
+
+        $field = substr($lines[0], 0, strpos($lines[0], ':'));
+        $in_headers = false;
+        if (!empty($field) && strpos($field, ' ') === false) {
+            $in_headers = true;
+        }
+
+        foreach ($lines as $line) {
+            $lines_out = array();
+            if ($in_headers and $line == '') {
+                $in_headers = false;
+            }
+            // ok we need to break this line up into several smaller lines
+            //This is a small micro-optimisation: isset($str[$len]) is equivalent to (strlen($str) > $len)
+            while (isset($line[self::MAX_LINE_LENGTH])) {
+                //Working backwards, try to find a space within the last MAX_LINE_LENGTH chars of the line to break on
+                //so as to avoid breaking in the middle of a word
+                $pos = strrpos(substr($line, 0, self::MAX_LINE_LENGTH), ' ');
+                if (!$pos) { //Deliberately matches both false and 0
+                    //No nice break found, add a hard break
+                    $pos = self::MAX_LINE_LENGTH - 1;
+                    $lines_out[] = substr($line, 0, $pos);
+                    $line = substr($line, $pos);
+                } else {
+                    //Break at the found point
+                    $lines_out[] = substr($line, 0, $pos);
+                    //Move along by the amount we dealt with
+                    $line = substr($line, $pos + 1);
+                }
+                /* If processing headers add a LWSP-char to the front of new line
+                 * RFC822 section 3.1.1
+                 */
+                if ($in_headers) {
+                    $line = "\t" . $line;
+                }
+            }
+            $lines_out[] = $line;
+
+            // Send the lines to the server
+            foreach ($lines_out as $line_out) {
+                //RFC2821 section 4.5.2
+                if (!empty($line_out) and $line_out[0] == '.') {
+                    $line_out = '.' . $line_out;
+                }
+                $this->client_send($line_out . self::CRLF);
+            }
+        }
+
+        // Message data has been sent, complete the command
+        return $this->sendCommand('DATA END', '.', 250);
+    }
+
+    /**
+     * Send an SMTP HELO or EHLO command.
+     * Used to identify the sending server to the receiving server.
+     * This makes sure that client and server are in a known state.
+     * Implements RFC 821: HELO <SP> <domain> <CRLF>
+     * and RFC 2821 EHLO.
+     * @param string $host The host name or IP to connect to
+     * @access public
+     * @return bool
+     */
+    public function hello($host = '')
+    {
+        // Try extended hello first (RFC 2821)
+        return (bool)($this->sendHello('EHLO', $host) or $this->sendHello('HELO', $host));
+    }
+
+    /**
+     * Send an SMTP HELO or EHLO command.
+     * Low-level implementation used by hello()
+     * @see hello()
+     * @param string $hello The HELO string
+     * @param string $host The hostname to say we are
+     * @access protected
+     * @return bool
+     */
+    protected function sendHello($hello, $host)
+    {
+        $noerror = $this->sendCommand($hello, $hello . ' ' . $host, 250);
+        $this->helo_rply = $this->last_reply;
+        return $noerror;
+    }
+
+    /**
+     * Send an SMTP MAIL command.
+     * Starts a mail transaction from the email address specified in
+     * $from. Returns true if successful or false otherwise. If True
+     * the mail transaction is started and then one or more recipient
+     * commands may be called followed by a data command.
+     * Implements rfc 821: MAIL <SP> FROM:<reverse-path> <CRLF>
+     * @param string $from Source address of this message
+     * @access public
+     * @return bool
+     */
+    public function mail($from)
+    {
+        $useVerp = ($this->do_verp ? ' XVERP' : '');
+        return $this->sendCommand(
+            'MAIL FROM',
+            'MAIL FROM:<' . $from . '>' . $useVerp,
+            250
+        );
+    }
+
+    /**
+     * Send an SMTP QUIT command.
+     * Closes the socket if there is no error or the $close_on_error argument is true.
+     * Implements from rfc 821: QUIT <CRLF>
+     * @param bool $close_on_error Should the connection close if an error occurs?
+     * @access public
+     * @return bool
+     */
+    public function quit($close_on_error = true)
+    {
+        $noerror = $this->sendCommand('QUIT', 'QUIT', 221);
+        $err = $this->error; //Save any error
+        if ($noerror or $close_on_error) {
+            $this->close();
+            $this->error = $err; //Restore any error from the quit command
+        }
+        return $noerror;
+    }
+
+    /**
+     * Send an SMTP RCPT command.
+     * Sets the TO argument to $toaddr.
+     * Returns true if the recipient was accepted false if it was rejected.
+     * Implements from rfc 821: RCPT <SP> TO:<forward-path> <CRLF>
+     * @param string $toaddr The address the message is being sent to
+     * @access public
+     * @return bool
+     */
+    public function recipient($toaddr)
+    {
+        return $this->sendCommand(
+            'RCPT TO',
+            'RCPT TO:<' . $toaddr . '>',
+            array(250, 251)
+        );
+    }
+
+    /**
+     * Send an SMTP RSET command.
+     * Abort any transaction that is currently in progress.
+     * Implements rfc 821: RSET <CRLF>
+     * @access public
+     * @return bool True on success.
+     */
+    public function reset()
+    {
+        return $this->sendCommand('RSET', 'RSET', 250);
+    }
+
+    /**
+     * Send a command to an SMTP server and check its return code.
+     * @param string $command       The command name - not sent to the server
+     * @param string $commandstring The actual command to send
+     * @param int|array $expect     One or more expected integer success codes
+     * @access protected
+     * @return bool True on success.
+     */
+    protected function sendCommand($command, $commandstring, $expect)
+    {
+        if (!$this->connected()) {
+            $this->error = array(
+                'error' => "Called $command without being connected"
+            );
+            return false;
+        }
+        $this->client_send($commandstring . self::CRLF);
+
+        $reply = $this->get_lines();
+        $code = substr($reply, 0, 3);
+
+        if ($this->do_debug >= 2) {
+            $this->edebug('SERVER -> CLIENT: ' . $reply);
+        }
+
+        if (!in_array($code, (array)$expect)) {
+            $this->last_reply = null;
+            $this->error = array(
+                'error' => "$command command failed",
+                'smtp_code' => $code,
+                'detail' => substr($reply, 4)
+            );
+            if ($this->do_debug >= 1) {
+                $this->edebug(
+                    'SMTP ERROR: ' . $this->error['error'] . ': ' . $reply
+                );
+            }
+            return false;
+        }
+
+        $this->last_reply = $reply;
+        $this->error = null;
+        return true;
+    }
+
+    /**
+     * Send an SMTP SAML command.
+     * Starts a mail transaction from the email address specified in $from.
+     * Returns true if successful or false otherwise. If True
+     * the mail transaction is started and then one or more recipient
+     * commands may be called followed by a data command. This command
+     * will send the message to the users terminal if they are logged
+     * in and send them an email.
+     * Implements rfc 821: SAML <SP> FROM:<reverse-path> <CRLF>
+     * @param string $from The address the message is from
+     * @access public
+     * @return bool
+     */
+    public function sendAndMail($from)
+    {
+        return $this->sendCommand('SAML', "SAML FROM:$from", 250);
+    }
+
+    /**
+     * Send an SMTP VRFY command.
+     * @param string $name The name to verify
+     * @access public
+     * @return bool
+     */
+    public function verify($name)
+    {
+        return $this->sendCommand('VRFY', "VRFY $name", array(250, 251));
+    }
+
+    /**
+     * Send an SMTP NOOP command.
+     * Used to keep keep-alives alive, doesn't actually do anything
+     * @access public
+     * @return bool
+     */
+    public function noop()
+    {
+        return $this->sendCommand('NOOP', 'NOOP', 250);
+    }
+
+    /**
+     * Send an SMTP TURN command.
+     * This is an optional command for SMTP that this class does not support.
+     * This method is here to make the RFC821 Definition complete for this class
+     * and _may_ be implemented in future
+     * Implements from rfc 821: TURN <CRLF>
+     * @access public
+     * @return bool
+     */
+    public function turn()
+    {
+        $this->error = array(
+            'error' => 'The SMTP TURN command is not implemented'
+        );
+        if ($this->do_debug >= 1) {
+            $this->edebug('SMTP NOTICE: ' . $this->error['error']);
+        }
+        return false;
+    }
+
+    /**
+     * Send raw data to the server.
+     * @param string $data The data to send
+     * @access public
+     * @return int|bool The number of bytes sent to the server or false on error
+     */
+    public function client_send($data)
+    {
+        if ($this->do_debug >= 1) {
+            $this->edebug("CLIENT -> SERVER: $data");
+        }
+        return fwrite($this->smtp_conn, $data);
+    }
+
+    /**
+     * Get the latest error.
+     * @access public
+     * @return array
+     */
+    public function getError()
+    {
+        return $this->error;
+    }
+
+    /**
+     * Get the last reply from the server.
+     * @access public
+     * @return string
+     */
+    public function getLastReply()
+    {
+        return $this->last_reply;
+    }
+
+    /**
+     * Read the SMTP server's response.
+     * Either before eof or socket timeout occurs on the operation.
+     * With SMTP we can tell if we have more lines to read if the
+     * 4th character is '-' symbol. If it is a space then we don't
+     * need to read anything else.
+     * @access protected
+     * @return string
+     */
+    protected function get_lines()
+    {
+        // If the connection is bad, give up straight away
+        if (!is_resource($this->smtp_conn)) {
+            return '';
+        }
+        $data = '';
+        $endtime = 0;
+        stream_set_timeout($this->smtp_conn, $this->Timeout);
+        if ($this->Timelimit > 0) {
+            $endtime = time() + $this->Timelimit;
+        }
+        while (is_resource($this->smtp_conn) && !feof($this->smtp_conn)) {
+            $str = @fgets($this->smtp_conn, 515);
+            if ($this->do_debug >= 4) {
+                $this->edebug("SMTP -> get_lines(): \$data was \"$data\"");
+                $this->edebug("SMTP -> get_lines(): \$str is \"$str\"");
+            }
+            $data .= $str;
+            if ($this->do_debug >= 4) {
+                $this->edebug("SMTP -> get_lines(): \$data is \"$data\"");
+            }
+            // If 4th character is a space, we are done reading, break the loop, micro-optimisation over strlen
+            if ((isset($str[3]) and $str[3] == ' ')) {
+                break;
+            }
+            // Timed-out? Log and break
+            $info = stream_get_meta_data($this->smtp_conn);
+            if ($info['timed_out']) {
+                if ($this->do_debug >= 4) {
+                    $this->edebug(
+                        'SMTP -> get_lines(): timed-out (' . $this->Timeout . ' sec)'
+                    );
+                }
+                break;
+            }
+            // Now check if reads took too long
+            if ($endtime and time() > $endtime) {
+                if ($this->do_debug >= 4) {
+                    $this->edebug(
+                        'SMTP -> get_lines(): timelimit reached ('.
+                        $this->Timelimit . ' sec)'
+                    );
+                }
+                break;
+            }
+        }
+        return $data;
+    }
+
+    /**
+     * Enable or disable VERP address generation.
+     * @param bool $enabled
+     */
+    public function setVerp($enabled = false)
+    {
+        $this->do_verp = $enabled;
+    }
+
+    /**
+     * Get VERP address generation mode.
+     * @return bool
+     */
+    public function getVerp()
+    {
+        return $this->do_verp;
+    }
+
+    /**
+     * Set debug output method.
+     * @param string $method The function/method to use for debugging output.
+     */
+    public function setDebugOutput($method = 'echo')
+    {
+        $this->Debugoutput = $method;
+    }
+
+    /**
+     * Get debug output method.
+     * @return string
+     */
+    public function getDebugOutput()
+    {
+        return $this->Debugoutput;
+    }
+
+    /**
+     * Set debug output level.
+     * @param int $level
+     */
+    public function setDebugLevel($level = 0)
+    {
+        $this->do_debug = $level;
+    }
+
+    /**
+     * Get debug output level.
+     * @return int
+     */
+    public function getDebugLevel()
+    {
+        return $this->do_debug;
+    }
+
+    /**
+     * Set SMTP timeout.
+     * @param int $timeout
+     */
+    public function setTimeout($timeout = 0)
+    {
+        $this->Timeout = $timeout;
+    }
+
+    /**
+     * Get SMTP timeout.
+     * @return int
+     */
+    public function getTimeout()
+    {
+        return $this->Timeout;
+    }
+}
+
+}
+

doc/files/app%2Fmodels%2FQuesttypeModel.inc.txt

@@ -0,0 +1,155 @@
+<?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\models;
+	
+	
+	/**
+	 * Abstract class for implementing a QuesttypeModel.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	abstract class QuesttypeModel extends \hhu\z\Model
+	{
+		
+		
+		
+		
+		/**
+		 * Load a Model.
+		 * 
+		 * @static
+		 * @throws	QuesttypeModelNotFoundException
+		 * @throws	QuesttypeModelNotValidException
+		 * @param	string	$modelName		Name of the QuesttypeModel to load
+		 */
+		public static function load($modelName)
+		{
+			// Determine full classname
+			$className = self::getClassName($modelName);
+			
+			try {
+				// Load class
+				static::loadClass($modelName, $className);
+				
+				// Validate class
+				static::checkClass($className, get_class());
+			}
+			catch(\nre\exceptions\ClassNotValidException $e) {
+				throw new \hhu\z\exceptions\QuesttypeModelNotValidException($e->getClassName());
+			}
+			catch(\nre\exceptions\ClassNotFoundException $e) {
+				throw new \hhu\z\exceptions\QuesttypeModelNotFoundException($e->getClassName());
+			}
+		}
+		
+		
+		/**
+		 * Instantiate a QuesttypeModel (Factory Pattern).
+		 * 
+		 * @static
+		 * @param	string	$questtypeName	Name of the QuesttypeModel to instantiate
+		 */
+		public static function factory($questtypeName)
+		{
+			// Determine full classname
+			$className = self::getClassName($questtypeName);
+			
+			// Construct and return Model
+			return new $className();
+		}
+		
+		
+		/**
+		 * Determine the Model-classname for the given Questtype-name.
+		 * 
+		 * @static
+		 * @param	string	$questtypeName	Questtype-name to get Model-classname of
+		 * @return	string			Classname for the Questtype-name
+		 */
+		private static function getClassName($questtypeName)
+		{
+			$className = \nre\core\ClassLoader::concatClassNames($questtypeName, \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripNamespace(get_class())), 'model');
+			
+			
+			return \nre\configs\AppConfig::$app['namespace']."questtypes\\$className";
+		}
+		
+		
+		/**
+		 * Load the class of a QuesttypeModel.
+		 * 
+		 * @static
+		 * @throws	ClassNotFoundException
+		 * @param	string	$questtypeName	Name of the QuesttypeModel 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 QuesttypeModel-class.
+		 * 
+		 * @static
+		 * @throws	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 QuesttypeModel.
+		 * 
+		 * @throws	DatamodelException
+		 * @throws	DriverNotFoundException
+		 * @throws	DriverNotValidException
+		 * @throws	QuesttypeModelNotValidException
+		 * @throws	QuesttypeModelNotFoundException
+		 */
+		public function __construct()
+		{
+			parent::__construct();
+		}
+		
+	}
+
+?>
+

doc/files/app%2Frequests%2FMailRequest.inc.txt

@@ -0,0 +1,93 @@
+<?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\requests;
+	
+	
+	/**
+	 * Representation of a mail-request.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MailRequest extends \nre\core\Request
+	{
+		/**
+		 * Linker
+		 * 
+		 * @var Linker
+		 */
+		private $linker = null;
+		
+		
+		
+		
+		/**
+		 * Add a parameter.
+		 * 
+		 * @param	mixed	$value	Value of parameter
+		 */
+		public function addParam($value)
+		{
+			$this->params[] = $value;
+		}
+		
+		
+		/**
+		 * Add multiple parameters.
+		 * 
+		 * @param	mixed	$value1	Value of first parameter
+		 * @param	mixed	…	Values of further parameters
+		 */
+		public function addParams($value1)
+		{
+			$this->params = array_merge(
+				$this->params,
+				func_get_args()
+			);
+		}
+		
+		
+		/**
+		 * Delete all stored parameters (from offset on).
+		 * 
+		 * @param	int	$offset	Offset-index
+		 */
+		public function clearParams($offset=0)
+		{
+			$this->params = array_slice($this->params, 0, $offset);
+		}
+		
+		
+		/**
+		 * Set linker instance for creating links.
+		 * 
+		 * @param	Linker	$linker	Linker instance for creating links
+		 */
+		public function setLinker(\nre\core\Linker $linker)
+		{
+			$this->linker = $linker;
+		}
+		
+		
+		/**
+		 * Get linker instance for creating links.
+		 * 
+		 * @return	Linker	Linker instance for creating links
+		 */
+		public function getLinker()
+		{
+			return $this->linker;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fresponses%2FMailResponse.inc.txt

@@ -0,0 +1,56 @@
+<?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\responses;
+	
+	
+	/**
+	 * Representation of a mail-response.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class MailResponse extends \nre\core\Response
+	{
+		/**
+		 * Mail subject
+		 * 
+		 * @var string
+		 */
+		private $subject = null;
+		
+		
+		
+		
+		/**
+		 * Set subject.
+		 * 
+		 * @param	string	$subject	Subject to set
+		 */
+		public function setSubject($subject)
+		{
+			$this->subject = $subject;
+		}
+		
+		
+		/**
+		 * Get subject.
+		 * 
+		 * @return	string	Subject
+		 */
+		public function getSubject()
+		{
+			return $this->subject;
+		}
+		
+	}
+
+?>
+

doc/files/app%2Fviews%2FQuesttypeView.inc.txt

@@ -0,0 +1,77 @@
+<?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\views;
+	
+	
+	/**
+	 * Abstract class for implementing a QuesttypeView.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class QuesttypeView extends \nre\core\View
+	{
+		
+		
+		
+		
+		/**
+		 * Load and instantiate the QuesttypeView of a QuesttypeAgent.
+		 * 
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of Layout in use
+		 * @param	string	$agentName	Name of the Agent
+		 * @param	string	$action		Current Action
+		 * @param	bool	$isToplevel	Agent is a ToplevelAgent
+		 */
+		public static function loadAndFactory($layoutName, $agentName=null, $action=null, $isToplevel=false)
+		{
+			return new QuesttypeView($layoutName, $agentName, $action, $isToplevel);
+		}
+		
+		
+		
+		
+		/**
+		 * Construct a new QuesttypeView.
+		 * 
+		 * @throws	ViewNotFoundException
+		 * @param	string	$layoutName	Name of Layout in use
+		 * @param	string	$agentName	Name of the Agent
+		 * @param	string	$action		Current Action
+		 * @param	bool	$isToplevel	Agent is a ToplevelAgent
+		 */
+		protected function __construct($layoutName, $agentName=null, $action=null, $isToplevel=false)
+		{
+			// Create template filename
+			// LayoutName
+			$fileName = ROOT.DS.\nre\configs\AppConfig::$dirs['questtypes'].DS.strtolower($agentName).DS.strtolower($layoutName).DS;
+			
+			// Action
+			$fileName .= strtolower($action);
+			
+			// File extension
+			$fileName .= \nre\configs\CoreConfig::getFileExt('views');
+			
+			
+			// Check template file
+			if(!file_exists($fileName)) {
+				throw new \nre\exceptions\ViewNotFoundException($fileName);
+			}
+			
+			// Save filename
+			$this->templateFilename = $fileName;
+		}
+		
+	}
+
+?>
+