merge branch ?charactergroupsqueststations?

.hgignore

@@ -7,3 +7,4 @@ syntax: regexp
 ^seminaryuploads/*
 ^www/analytics/config/config.ini.php*
 ^www/analytics/temp/*
+^app/lib/phpqrcode/cache/*

agents/intermediate/CharactergroupsqueststationsAgent.inc

@@ -0,0 +1,103 @@
+<?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 Quest stations.
+     * 
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class CharactergroupsqueststationsAgent extends \nre\agents\IntermediateAgent
+    {
+
+
+
+
+        /**
+         * Action: index.
+         * 
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function index(\nre\core\Request $request, \nre\core\Response $response)
+        {
+        }
+
+
+        /**
+         * Action: station.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function station(\nre\core\Request $request, \nre\core\Response $response)
+        {
+            // Add Moodpic
+            $this->addSubAgent('Moodpic', 'seminary', $request->getParam(3), 'charactergroups');
+        }
+
+
+        /**
+         * Action: create.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function create(\nre\core\Request $request, \nre\core\Response $response)
+        {
+            // Add Moodpic
+            $this->addSubAgent('Moodpic', 'seminary', $request->getParam(3), 'charactergroups');
+        }
+
+
+        /**
+         * Action: edit.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function edit(\nre\core\Request $request, \nre\core\Response $response)
+        {
+            // Add Moodpic
+            $this->addSubAgent('Moodpic', 'seminary', $request->getParam(3), 'charactergroups');
+        }
+
+
+        /**
+         * Action: edittask.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function edittask(\nre\core\Request $request, \nre\core\Response $response)
+        {
+            // Add Moodpic
+            $this->addSubAgent('Moodpic', 'seminary', $request->getParam(3), 'charactergroups');
+        }
+
+
+        /**
+         * Action: delete.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function delete(\nre\core\Request $request, \nre\core\Response $response)
+        {
+            // Add Moodpic
+            $this->addSubAgent('Moodpic', 'seminary', $request->getParam(3), 'charactergroups');
+        }
+
+    }
+
+?>

agents/intermediate/QrAgent.inc

@@ -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\intermediate;
+
+
+    /**
+     * Agent to redirect to a page from a (short) QR-code link.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class QrAgent extends \nre\agents\IntermediateAgent
+    {
+
+
+
+
+        /**
+         * Action: index.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function index(\nre\core\Request $request, \nre\core\Response $response)
+        {
+        }
+
+    }
+
+?>

agents/intermediate/QrcodesAgent.inc

@@ -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\intermediate;
+
+
+    /**
+     * Agent to generate and show QR-codes.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class QrcodesAgent extends \nre\agents\IntermediateAgent
+    {
+
+
+
+
+        /**
+         * Action: index.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function index(\nre\core\Request $request, \nre\core\Response $response)
+        {
+        }
+
+    }
+
+?>

app/agents/StationtypeAgent.inc

@@ -0,0 +1,298 @@
+<?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 StationtypeAgent.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    abstract class StationtypeAgent extends \nre\agents\BottomlevelAgent
+    {
+        /**
+         * Current request
+         *
+         * @var \nre\core\Request
+         */
+        private $request;
+        /**
+         * Current response
+         *
+         * @var \nre\core\Response
+         */
+        private $response;
+
+
+
+
+        /**
+         * Load a StationtypeAgent.
+         *
+         * @static
+         * @throws  \hhu\z\exceptions\StationtypeAgentNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeAgentNotValidException
+         * @param   string  $stationtypeName    Name of the StationtypeAgent to load
+         */
+        public static function load($stationtypeName)
+        {
+            // Determine full classname
+            $className = self::getClassName($stationtypeName);
+
+            try {
+                // Load class
+                static::loadClass($stationtypeName, $className);
+
+                // Validate class
+                static::checkClass($className, get_class());
+            }
+            catch(\nre\exceptions\ClassNotValidException $e) {
+                throw new \hhu\z\exceptions\StationtypeAgentNotValidException($e->getClassName());
+            }
+            catch(\nre\exceptions\ClassNotFoundException $e) {
+                throw new \hhu\z\exceptions\StationtypeAgentNotFoundException($e->getClassName());
+            }
+        }
+
+
+        /**
+         * Instantiate a StationtypeAgent (Factory Pattern).
+         *
+         * @static
+         * @throws  \nre\exceptions\DatamodelException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\ViewNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotFoundException
+         * @param   string      $stationtypeName    Name of the StationtypeAgent to instantiate
+         * @param   Request     $request            Current request
+         * @param   Response    $response           Current respone
+         * @param   Logger      $log                Log-system
+         */
+        public static function factory($stationtypeName, \nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+        {
+            // Determine full classname
+            $className = self::getClassName($stationtypeName);
+
+            // Construct and return Stationmodule
+            return new $className($request, $response, $log);
+        }
+
+
+        /**
+         * Determine the Agent-classname for the given Stationtype-name.
+         *
+         * @static
+         * @param   string  $stationtypeName    Stationtype-name to get Agent-classname of
+         * @param   string  $agentType          Agent type of given Agent name
+         * @return  string                      Classname for the Stationtype-name
+         */
+        private static function getClassName($stationtypeName, $agentType=null)
+        {
+            $className = \nre\core\ClassLoader::concatClassNames(
+                $stationtypeName,
+                \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripNamespace(get_class())),
+                'agent'
+            );
+
+
+            return \nre\configs\AppConfig::$app['namespace']."stationtypes\\$className";
+        }
+
+
+        /**
+         * Load the class of a StationtypeAgent.
+         *
+         * @static
+         * @throws  \nre\exceptions\ClassNotFoundException
+         * @param   string  $stationtypeName    Name of the StationtypeAgent to load
+         * @param   string  $fullClassName      Name of the class to load
+         */
+        private static function loadClass($stationtypeName, $fullClassName)
+        {
+            // Determine folder to look in
+            $className = explode('\\', $fullClassName);
+            $className = array_pop($className);
+
+            // Determine filename
+            $fileName = ROOT.DS.
+                \nre\configs\AppConfig::$dirs['stationtypes'].DS.
+                strtolower($stationtypeName).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 StationtypeAgent-class.
+         *
+         * @static
+         * @throws  \nre\exceptions\ClassNotValidException
+         * @param   string  $className          Name of the class to check
+         * @param   string  $parentClassName    Name of the parent class
+         */
+        public static function checkClass($className, $parentClassName)
+        {
+            // Check if class is subclass of parent class
+            if(!is_subclass_of($className, $parentClassName)) {
+                throw new \nre\exceptions\ClassNotValidException(
+                    $className
+                );
+            }
+        }
+
+
+
+
+        /**
+         * Construct a new StationtypeAgent.
+         *
+         * @throws  \nre\exceptions\DatamodelException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\ViewNotFoundException
+         * @throws  \nre\exceptions\ModelNotValidException
+         * @throws  \nre\exceptions\ModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotFoundException
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         * @param   \nre\core\Logger    $log        Log-system
+         */
+        protected function __construct(\nre\core\Request $request, \nre\core\Response $response, \nre\core\Logger $log=null)
+        {
+            // Store values
+            $this->request = $request;
+            $this->response = $response;
+
+
+            // Call parent constructor
+            parent::__construct($request, $response, $log);
+        }
+
+
+
+
+        /**
+         * Save the answer of a Character group for a Station.
+         *
+         * @param   array   $seminary   Current Seminary data
+         * @param   array   $questgroup Current Questgroup data
+         * @param   array   $quest      Current Quest data
+         * @param   array   $station    Current Station data
+         * @param   array   $group      Current Character data
+         * @param   array   $answers    Character answers for the Quest
+         */
+        public function saveAnswer($seminary, $groupsgroup, $quest, $station, $group, $answer)
+        {
+            $this->controller->saveAnswer(
+                $seminary,
+                $groupsgroup,
+                $quest,
+                $station,
+                $group,
+                $answer
+            );
+        }
+
+
+        /**
+         * Check if the answer of a Character group for a Station matches the
+         * correct one.
+         *
+         * @param   array   $seminary   Current Seminary data
+         * @param   array   $questgroup Current Questgroup data
+         * @param   array   $quest      Current Quest data
+         * @param   array   $station    Current Station data
+         * @param   array   $group      Current Character group data
+         * @param   array   $answers    Character answers for the Quest
+         */
+        public function matchAnswer($seminary, $groupsgroup, $quest, $station, $group, $answer)
+        {
+            return $this->controller->matchAnswer(
+                $seminary,
+                $groupsgroup,
+                $quest,
+                $station,
+                $group,
+                $answer
+            );
+        }
+
+
+
+
+        /**
+         * Load the Controller of this Agent.
+         *
+         * @throws  \nre\exceptions\DatamodelException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\ViewNotFoundException
+         * @throws  \nre\exceptions\ModelNotValidException
+         * @throws  \nre\exceptions\ModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationxuesttypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotFoundException
+         */
+        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\StationtypeController::load($controllerName);
+
+            // Construct Controller
+            $this->controller = \hhu\z\controllers\StationtypeController::factory(
+                $controllerName,
+                $toplevelAgentName,
+                $action,
+                $this
+            );
+        }
+
+    }
+
+?>

app/controllers/StationtypeController.inc

@@ -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 StationtypeController.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    abstract class StationtypeController extends \hhu\z\Controller
+    {
+        /**
+         * Required models
+         *
+         * @var array
+         */
+        public $models = array('seminaries'); //, 'questgroups', 'quests', 'characters');
+
+
+
+
+
+        /**
+         * Save the answer of a Character group for a Station.
+         *
+         * @param   array   $seminary       Current Seminary data
+         * @param   array   $groupsgroup    Current Groups group data
+         * @param   array   $quest          Current Quest data
+         * @param   array   $station        Current Station data
+         * @param   array   $charactergroup Current Character group data
+         * @param   array   $answer         Character group answer for the Station
+         */
+        public abstract function saveAnswer($seminary, $groupsgroup, $quest, $station, $charactergroup, $answer);
+
+
+        /**
+         * Check if answer of a Character group for a Station matches the correct one.
+         *
+         * @param   array   $seminary       Current Seminary data
+         * @param   array   $groupsgroup    Current Groups group data
+         * @param   array   $quest          Current Quest data
+         * @param   array   $station        Current Station data
+         * @param   array   $charactergroup Current Character group data
+         * @param   array   $answer         Character group answer for the Station
+         * @return  boolean                 True/false for a right/wrong answer
+         */
+        public abstract function matchAnswer($seminary, $groupsgroup, $quest, $station, $charactergroup, $answer);
+
+
+        /**
+         * Action: quest.
+         *
+         * Show the task of a Station.
+         *
+         * @param   array   $seminary       Current Seminary data
+         * @param   array   $groupsgroup    Current Groups group data
+         * @param   array   $quest          Current Quest data
+         * @param   array   $station        Current Station data
+         * @param   array   $charactergroup Current Character group data
+         */
+        public abstract function quest($seminary, $groupsgroup, $quest, $station, $charactergroup);
+
+
+        /**
+         * Action: edittask.
+         *
+         * Edit the task of a Station.
+         *
+         * @param   array   $seminary       Current Seminary data
+         * @param   array   $groupsgroup    Current Groups group data
+         * @param   array   $quest          Current Quest data
+         * @param   array   $station        Current Station data
+         */
+        public abstract function edittask($seminary, $groupsgroup, $quest, $station);
+
+
+
+
+        /**
+         * Load a StationtypeController.
+         *
+         * @static
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeControllerNotValidException
+         * @param   string  $controllerName     Name of the StationtypeController 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\StationtypeControllerNotValidException($e->getClassName());
+            }
+            catch(\nre\exceptions\ClassNotFoundException $e) {
+                throw new \hhu\z\exceptions\StationtypeControllerNotFoundException($e->getClassName());
+            }
+        }
+
+
+        /**
+         * Instantiate a StationtypeController (Factory Pattern).
+         *
+         * @static
+         * @throws  \nre\exceptions\DatamodelException
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \nre\exceptions\ModelNotValidException
+         * @throws  \nre\exceptions\ModelNotFoundException
+         * @throws  \nre\exceptions\ViewNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         * @param   string      $controllerName Name of the StationtypeController to instantiate
+         * @param   string      $layoutName     Name of the current Layout
+         * @param   string      $action         Current Action
+         * @param   \nre\core\Agent $agent      Corresponding Agent
+         */
+        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 Stationtype-name.
+         *
+         * @static
+         * @param   string  $stationtypeName    Stationtype-name to get Controller-classname of
+         * @return  string                      Classname for the Stationtype-name
+         */
+        private static function getClassName($stationtypeName)
+        {
+            $className = \nre\core\ClassLoader::concatClassNames(
+                $stationtypeName,
+                \nre\core\ClassLoader::stripClassType(\nre\core\ClassLoader::stripNamespace(get_class())),
+                'controller'
+            );
+
+
+            return \nre\configs\AppConfig::$app['namespace']."stationtypes\\$className";
+        }
+
+
+        /**
+         * Load the class of a StationtypeController
+         *
+         * @static
+         * @throws  \nre\exceptions\ClassNotFoundException
+         * @param   string  $stationtypeName    Name of the StationtypeController to load
+         * @param   string  $fullClassName      Name of the class to load
+         */
+        private static function loadClass($stationtypeName, $fullClassName)
+        {
+            // Determine folder to look in
+            $className = explode('\\', $fullClassName);
+            $className = array_pop($className);
+
+            // Determine filename
+            $fileName = ROOT.DS.
+                \nre\configs\AppConfig::$dirs['stationtypes'].DS.
+                strtolower($stationtypeName).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 StationtypeController-class.
+         *
+         * @static
+         * @throws  \nre\exceptions\ClassNotValidException
+         * @param   string  $className          Name of the class to check
+         * @param   string  $parentClassName    Name of the parent class
+         */
+        public static function checkClass($className, $parentClassName)
+        {
+            // Check if class is subclass of parent class
+            if(!is_subclass_of($className, $parentClassName)) {
+                throw new \nre\exceptions\ClassNotValidException(
+                    $className
+                );
+            }
+        }
+
+
+
+
+        /**
+         * Construct a new application Controller.
+         *
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \nre\exceptions\ModelNotValidException
+         * @throws  \nre\exceptions\ModelNotFoundException
+         * @throws  \nre\exceptions\ViewNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         * @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  \nre\exceptions\DatamodelException
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \nre\exceptions\ModelNotValidException
+         * @throws  \nre\exceptions\ModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         */
+        protected function loadModels()
+        {
+            // Load default models
+            parent::loadModels();
+
+            // Load StationtypeModel
+            $this->loadModel();
+        }
+
+
+        /**
+         * Load the Model of the Stationtype.
+         *
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         */
+        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\StationtypeModel::load($model);
+
+            // Construct Model
+            $modelName = ucfirst(strtolower($model));
+            $this->$modelName = \hhu\z\models\StationtypeModel::factory($model);
+        }
+
+
+        /**
+         * Load the View of this StationtypeController.
+         *
+         * @throws  \nre\exceptions\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\StationtypeView::loadAndFactory(
+                $layoutName,
+                $controllerName,
+                $action
+            );
+        }
+
+    }
+
+?>

app/exceptions/StationtypeAgentNotFoundException.inc

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

app/exceptions/StationtypeAgentNotValidException.inc

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

app/exceptions/StationtypeControllerNotFoundException.inc

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

app/exceptions/StationtypeControllerNotValidException.inc

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

app/exceptions/StationtypeModelNotFoundException.inc

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

app/exceptions/StationtypeModelNotValidException.inc

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

app/lib/Phpqrcode-lib.inc

@@ -0,0 +1,33 @@
+<?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 Phpqrcode
+    {
+
+        /**
+         * Call this function to load necessary files.
+         */
+        public static function load()
+        {
+            require_once('phpqrcode'.DS.'qrlib.php');
+        }
+
+    }
+
+?>

app/lib/phpqrcode/CHANGELOG

@@ -0,0 +1,38 @@
+* 1.0.0 build 2010031920 
+
+  - first public release
+  - help in readme, install
+  - cleanup ans separation of QRtools and QRspec
+  - now TCPDF binding requires minimal changes in TCPDF, having most of job
+    done in QRtools tcpdfBarcodeArray
+  - nicer QRtools::timeBenchmark output
+  - license and copyright notices in files
+  - indent cleanup - from tab to 4spc, keep it that way please :)
+  - sf project, repository, wiki
+  - simple code generator in index.php
+  
+* 1.1.0 build 2010032113
+
+  - added merge tool wich generate merged version of code
+    located in phpqrcode.php
+  - splited qrconst.php from qrlib.php
+  
+* 1.1.1 build 2010032405
+
+  - patch by Rick Seymour allowing saving PNG and displaying it at the same time
+  - added version info in VERSION file
+  - modified merge tool to include version info into generated file
+  - fixed e-mail in almost all head comments
+  
+* 1.1.2 build 2010032722
+
+  - full integration with TCPDF thanks to Nicola Asuni, it's author
+  - fixed bug with alphanumeric encoding detection
+  
+* 1.1.3 build 2010081807
+
+  - short opening tags replaced with standard ones
+  
+* 1.1.4 build 2010100721
+
+  - added missing static keyword QRinput::check (found by Luke Brookhart, Onjax LLC)

app/lib/phpqrcode/INSTALL

@@ -0,0 +1,67 @@
+== REQUIREMENTS ==
+
+ * PHP5
+ * PHP GD2 extension with JPEG and PNG support
+ 
+== INSTALLATION ==
+
+If you want to recreate cache by yourself make sure cache directory is
+writable and you have permisions to write into it. Also make sure you are
+able to read files in it if you have cache option enabled
+ 
+== CONFIGURATION ==
+
+Feel free to modify config constants in qrconfig.php file. Read about it in
+provided comments and project wiki page (links in README file)
+
+== QUICK START ==
+
+Notice: probably you should'nt use all of this in same script :)
+
+<?phpb
+
+//include only that one, rest required files will be included from it
+include "qrlib.php"
+
+//write code into file, Error corection lecer is lowest, L (one form: L,M,Q,H)
+//each code square will be 4x4 pixels (4x zoom)
+//code will have 2 code squares white boundary around 
+
+QRcode::png('PHP QR Code :)', 'test.png', 'L', 4, 2);
+
+//same as above but outputs file directly into browser (with appr. header etc.)
+//all other settings are default
+//WARNING! it should be FIRST and ONLY output generated by script, otherwise
+//rest of output will land inside PNG binary, breaking it for sure
+QRcode::png('PHP QR Code :)');
+
+//show benchmark
+QRtools::timeBenchmark();
+
+//rebuild cache
+QRtools::buildCache();
+
+//code generated in text mode - as a binary table
+//then displayed out as HTML using Unicode block building chars :)
+$tab = $qr->encode('PHP QR Code :)');
+QRspec::debug($tab, true);
+
+== TCPDF INTEGRATION ==
+
+Inside bindings/tcpdf you will find slightly modified 2dbarcodes.php.
+Instal phpqrcode liblaty inside tcpdf folder, then overwrite (or merge)
+2dbarcodes.php 
+
+Then use similar as example #50 from TCPDF examples:
+
+<?php
+
+$style = array(
+    'border' => true,
+    'padding' => 4,
+    'fgcolor' => array(0,0,0),
+    'bgcolor' => false, //array(255,255,255)
+);
+
+//code name: QR, specify error correction level after semicolon (L,M,Q,H)
+$pdf->write2DBarcode('PHP QR Code :)', 'QR,L', '', '', 30, 30, $style, 'N');

app/lib/phpqrcode/LICENSE

@@ -0,0 +1,165 @@
+                  GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

app/lib/phpqrcode/README

@@ -0,0 +1,45 @@
+This is PHP implementation of QR Code 2-D barcode generator. It is pure-php
+LGPL-licensed implementation based on C libqrencode by Kentaro Fukuchi.
+
+== LICENSING ==
+
+Copyright (C) 2010 by Dominik Dzienia 
+
+This library is free software; you can redistribute it and/or modify it under
+the terms of the GNU Lesser General Public License as published by the Free
+Software Foundation; either version 3 of the License, or any later version.
+
+This library is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU Lesser General Public License (LICENSE file)
+for more details.
+
+You should have received a copy of the GNU Lesser General Public License along
+with this library; if not, write to the Free Software Foundation, Inc., 51
+Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+== INSTALATION AND USAGE ==
+
+ * INSTALL file
+ * http://sourceforge.net/apps/mediawiki/phpqrcode/index.php?title=Main_Page
+
+== CONTACT ==
+
+Fell free to contact me via e-mail (deltalab at poczta dot fm) or using
+folowing project pages:
+
+ * http://sourceforge.net/projects/phpqrcode/
+ * http://phpqrcode.sourceforge.net/
+  
+== ACKNOWLEDGMENTS ==
+
+Based on C libqrencode library (ver. 3.1.1) 
+Copyright (C) 2006-2010 by Kentaro Fukuchi
+http://megaui.net/fukuchi/works/qrencode/index.en.html
+
+QR Code is registered trademarks of DENSO WAVE INCORPORATED in JAPAN and other
+countries.
+
+Reed-Solomon code encoder is written by Phil Karn, KA9Q.
+Copyright (C) 2002, 2003, 2004, 2006 Phil Karn, KA9Q
+ 

app/lib/phpqrcode/VERSION

@@ -0,0 +1,2 @@
+1.1.4
+2010100721

app/lib/phpqrcode/index.php

@@ -0,0 +1,94 @@
+<?php    
+/*
+ * PHP QR Code encoder
+ *
+ * Exemplatory usage
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+    
+    echo "<h1>PHP QR Code</h1><hr/>";
+    
+    //set it to writable location, a place for temp generated PNG files
+    $PNG_TEMP_DIR = dirname(__FILE__).DIRECTORY_SEPARATOR.'temp'.DIRECTORY_SEPARATOR;
+    
+    //html PNG location prefix
+    $PNG_WEB_DIR = 'temp/';
+
+    include "qrlib.php";    
+    
+    //ofcourse we need rights to create temp dir
+    if (!file_exists($PNG_TEMP_DIR))
+        mkdir($PNG_TEMP_DIR);
+    
+    
+    $filename = $PNG_TEMP_DIR.'test.png';
+    
+    //processing form input
+    //remember to sanitize user input in real-life solution !!!
+    $errorCorrectionLevel = 'L';
+    if (isset($_REQUEST['level']) && in_array($_REQUEST['level'], array('L','M','Q','H')))
+        $errorCorrectionLevel = $_REQUEST['level'];    
+
+    $matrixPointSize = 4;
+    if (isset($_REQUEST['size']))
+        $matrixPointSize = min(max((int)$_REQUEST['size'], 1), 10);
+
+
+    if (isset($_REQUEST['data'])) { 
+    
+        //it's very important!
+        if (trim($_REQUEST['data']) == '')
+            die('data cannot be empty! <a href="?">back</a>');
+            
+        // user data
+        $filename = $PNG_TEMP_DIR.'test'.md5($_REQUEST['data'].'|'.$errorCorrectionLevel.'|'.$matrixPointSize).'.png';
+        QRcode::png($_REQUEST['data'], $filename, $errorCorrectionLevel, $matrixPointSize, 2);    
+        
+    } else {    
+    
+        //default data
+        echo 'You can provide data in GET parameter: <a href="?data=like_that">like that</a><hr/>';    
+        QRcode::png('PHP QR Code :)', $filename, $errorCorrectionLevel, $matrixPointSize, 2);    
+        
+    }    
+        
+    //display generated file
+    echo '<img src="'.$PNG_WEB_DIR.basename($filename).'" /><hr/>';  
+    
+    //config form
+    echo '<form action="index.php" method="post">
+        Data:&nbsp;<input name="data" value="'.(isset($_REQUEST['data'])?htmlspecialchars($_REQUEST['data']):'PHP QR Code :)').'" />&nbsp;
+        ECC:&nbsp;<select name="level">
+            <option value="L"'.(($errorCorrectionLevel=='L')?' selected':'').'>L - smallest</option>
+            <option value="M"'.(($errorCorrectionLevel=='M')?' selected':'').'>M</option>
+            <option value="Q"'.(($errorCorrectionLevel=='Q')?' selected':'').'>Q</option>
+            <option value="H"'.(($errorCorrectionLevel=='H')?' selected':'').'>H - best</option>
+        </select>&nbsp;
+        Size:&nbsp;<select name="size">';
+        
+    for($i=1;$i<=10;$i++)
+        echo '<option value="'.$i.'"'.(($matrixPointSize==$i)?' selected':'').'>'.$i.'</option>';
+        
+    echo '</select>&nbsp;
+        <input type="submit" value="GENERATE"></form><hr/>';
+        
+    // benchmark
+    QRtools::timeBenchmark();    
+
+    

app/lib/phpqrcode/qrbitstream.php

@@ -0,0 +1,180 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Bitstream class
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+     
+    class QRbitstream {
+    
+        public $data = array();
+        
+        //----------------------------------------------------------------------
+        public function size()
+        {
+            return count($this->data);
+        }
+        
+        //----------------------------------------------------------------------
+        public function allocate($setLength)
+        {
+            $this->data = array_fill(0, $setLength, 0);
+            return 0;
+        }
+    
+        //----------------------------------------------------------------------
+        public static function newFromNum($bits, $num)
+        {
+            $bstream = new QRbitstream();
+            $bstream->allocate($bits);
+            
+            $mask = 1 << ($bits - 1);
+            for($i=0; $i<$bits; $i++) {
+                if($num & $mask) {
+                    $bstream->data[$i] = 1;
+                } else {
+                    $bstream->data[$i] = 0;
+                }
+                $mask = $mask >> 1;
+            }
+
+            return $bstream;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function newFromBytes($size, $data)
+        {
+            $bstream = new QRbitstream();
+            $bstream->allocate($size * 8);
+            $p=0;
+
+            for($i=0; $i<$size; $i++) {
+                $mask = 0x80;
+                for($j=0; $j<8; $j++) {
+                    if($data[$i] & $mask) {
+                        $bstream->data[$p] = 1;
+                    } else {
+                        $bstream->data[$p] = 0;
+                    }
+                    $p++;
+                    $mask = $mask >> 1;
+                }
+            }
+
+            return $bstream;
+        }
+        
+        //----------------------------------------------------------------------
+        public function append(QRbitstream $arg)
+        {
+            if (is_null($arg)) {
+                return -1;
+            }
+            
+            if($arg->size() == 0) {
+                return 0;
+            }
+            
+            if($this->size() == 0) {
+                $this->data = $arg->data;
+                return 0;
+            }
+            
+            $this->data = array_values(array_merge($this->data, $arg->data));
+
+            return 0;
+        }
+        
+        //----------------------------------------------------------------------
+        public function appendNum($bits, $num)
+        {
+            if ($bits == 0) 
+                return 0;
+
+            $b = QRbitstream::newFromNum($bits, $num);
+            
+            if(is_null($b))
+                return -1;
+
+            $ret = $this->append($b);
+            unset($b);
+
+            return $ret;
+        }
+
+        //----------------------------------------------------------------------
+        public function appendBytes($size, $data)
+        {
+            if ($size == 0) 
+                return 0;
+
+            $b = QRbitstream::newFromBytes($size, $data);
+            
+            if(is_null($b))
+                return -1;
+
+            $ret = $this->append($b);
+            unset($b);
+
+            return $ret;
+        }
+        
+        //----------------------------------------------------------------------
+        public function toByte()
+        {
+        
+            $size = $this->size();
+
+            if($size == 0) {
+                return array();
+            }
+            
+            $data = array_fill(0, (int)(($size + 7) / 8), 0);
+            $bytes = (int)($size / 8);
+
+            $p = 0;
+            
+            for($i=0; $i<$bytes; $i++) {
+                $v = 0;
+                for($j=0; $j<8; $j++) {
+                    $v = $v << 1;
+                    $v |= $this->data[$p];
+                    $p++;
+                }
+                $data[$i] = $v;
+            }
+            
+            if($size & 7) {
+                $v = 0;
+                for($j=0; $j<($size & 7); $j++) {
+                    $v = $v << 1;
+                    $v |= $this->data[$p];
+                    $p++;
+                }
+                $data[$bytes] = $v;
+            }
+
+            return $data;
+        }
+
+    }

app/lib/phpqrcode/qrconfig.php

@@ -0,0 +1,17 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Config file, feel free to modify
+ */
+     
+    define('QR_CACHEABLE', true);                                                               // use cache - more disk reads but less CPU power, masks and format templates are stored there
+    define('QR_CACHE_DIR', dirname(__FILE__).DIRECTORY_SEPARATOR.'cache'.DIRECTORY_SEPARATOR);  // used when QR_CACHEABLE === true
+    define('QR_LOG_DIR', dirname(__FILE__).DIRECTORY_SEPARATOR);                                // default error logs dir   
+    
+    define('QR_FIND_BEST_MASK', true);                                                          // if true, estimates best mask (spec. default, but extremally slow; set to false to significant performance boost but (propably) worst quality code
+    define('QR_FIND_FROM_RANDOM', false);                                                       // if false, checks all masks available, otherwise value tells count of masks need to be checked, mask id are got randomly
+    define('QR_DEFAULT_MASK', 2);                                                               // when QR_FIND_BEST_MASK === false
+                                                  
+    define('QR_PNG_MAXIMUM_SIZE',  1024);                                                       // maximum allowed png image width (in pixels), tune to make sure GD and PHP can handle such big images
+                                                  

app/lib/phpqrcode/qrconst.php

@@ -0,0 +1,54 @@
+<?php
+
+/*
+ * PHP QR Code encoder
+ *
+ * Common constants
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+	// Encoding modes
+	 
+	define('QR_MODE_NUL', -1);
+	define('QR_MODE_NUM', 0);
+	define('QR_MODE_AN', 1);
+	define('QR_MODE_8', 2);
+	define('QR_MODE_KANJI', 3);
+	define('QR_MODE_STRUCTURE', 4);
+
+	// Levels of error correction.
+
+	define('QR_ECLEVEL_L', 0);
+	define('QR_ECLEVEL_M', 1);
+	define('QR_ECLEVEL_Q', 2);
+	define('QR_ECLEVEL_H', 3);
+	
+	// Supported output formats
+	
+	define('QR_FORMAT_TEXT', 0);
+	define('QR_FORMAT_PNG',  1);
+	
+	class qrstr {
+		public static function set(&$srctab, $x, $y, $repl, $replLen = false) {
+			$srctab[$y] = substr_replace($srctab[$y], ($replLen !== false)?substr($repl,0,$replLen):$repl, $x, ($replLen !== false)?$replLen:strlen($repl));
+		}
+	}	

app/lib/phpqrcode/qrencode.php

@@ -0,0 +1,502 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Main encoder classes.
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+    class QRrsblock {
+        public $dataLength;
+        public $data = array();
+        public $eccLength;
+        public $ecc = array();
+        
+        public function __construct($dl, $data, $el, &$ecc, QRrsItem $rs)
+        {
+            $rs->encode_rs_char($data, $ecc);
+        
+            $this->dataLength = $dl;
+            $this->data = $data;
+            $this->eccLength = $el;
+            $this->ecc = $ecc;
+        }
+    };
+    
+    //##########################################################################
+
+    class QRrawcode {
+        public $version;
+        public $datacode = array();
+        public $ecccode = array();
+        public $blocks;
+        public $rsblocks = array(); //of RSblock
+        public $count;
+        public $dataLength;
+        public $eccLength;
+        public $b1;
+        
+        //----------------------------------------------------------------------
+        public function __construct(QRinput $input)
+        {
+            $spec = array(0,0,0,0,0);
+            
+            $this->datacode = $input->getByteStream();
+            if(is_null($this->datacode)) {
+                throw new Exception('null imput string');
+            }
+
+            QRspec::getEccSpec($input->getVersion(), $input->getErrorCorrectionLevel(), $spec);
+
+            $this->version = $input->getVersion();
+            $this->b1 = QRspec::rsBlockNum1($spec);
+            $this->dataLength = QRspec::rsDataLength($spec);
+            $this->eccLength = QRspec::rsEccLength($spec);
+            $this->ecccode = array_fill(0, $this->eccLength, 0);
+            $this->blocks = QRspec::rsBlockNum($spec);
+            
+            $ret = $this->init($spec);
+            if($ret < 0) {
+                throw new Exception('block alloc error');
+                return null;
+            }
+
+            $this->count = 0;
+        }
+        
+        //----------------------------------------------------------------------
+        public function init(array $spec)
+        {
+            $dl = QRspec::rsDataCodes1($spec);
+            $el = QRspec::rsEccCodes1($spec);
+            $rs = QRrs::init_rs(8, 0x11d, 0, 1, $el, 255 - $dl - $el);
+            
+
+            $blockNo = 0;
+            $dataPos = 0;
+            $eccPos = 0;
+            for($i=0; $i<QRspec::rsBlockNum1($spec); $i++) {
+                $ecc = array_slice($this->ecccode,$eccPos);
+                $this->rsblocks[$blockNo] = new QRrsblock($dl, array_slice($this->datacode, $dataPos), $el,  $ecc, $rs);
+                $this->ecccode = array_merge(array_slice($this->ecccode,0, $eccPos), $ecc);
+                
+                $dataPos += $dl;
+                $eccPos += $el;
+                $blockNo++;
+            }
+
+            if(QRspec::rsBlockNum2($spec) == 0)
+                return 0;
+
+            $dl = QRspec::rsDataCodes2($spec);
+            $el = QRspec::rsEccCodes2($spec);
+            $rs = QRrs::init_rs(8, 0x11d, 0, 1, $el, 255 - $dl - $el);
+            
+            if($rs == NULL) return -1;
+            
+            for($i=0; $i<QRspec::rsBlockNum2($spec); $i++) {
+                $ecc = array_slice($this->ecccode,$eccPos);
+                $this->rsblocks[$blockNo] = new QRrsblock($dl, array_slice($this->datacode, $dataPos), $el, $ecc, $rs);
+                $this->ecccode = array_merge(array_slice($this->ecccode,0, $eccPos), $ecc);
+                
+                $dataPos += $dl;
+                $eccPos += $el;
+                $blockNo++;
+            }
+
+            return 0;
+        }
+        
+        //----------------------------------------------------------------------
+        public function getCode()
+        {
+            $ret;
+
+            if($this->count < $this->dataLength) {
+                $row = $this->count % $this->blocks;
+                $col = $this->count / $this->blocks;
+                if($col >= $this->rsblocks[0]->dataLength) {
+                    $row += $this->b1;
+                }
+                $ret = $this->rsblocks[$row]->data[$col];
+            } else if($this->count < $this->dataLength + $this->eccLength) {
+                $row = ($this->count - $this->dataLength) % $this->blocks;
+                $col = ($this->count - $this->dataLength) / $this->blocks;
+                $ret = $this->rsblocks[$row]->ecc[$col];
+            } else {
+                return 0;
+            }
+            $this->count++;
+            
+            return $ret;
+        }
+    }
+
+    //##########################################################################
+    
+    class QRcode {
+    
+        public $version;
+        public $width;
+        public $data; 
+        
+        //----------------------------------------------------------------------
+        public function encodeMask(QRinput $input, $mask)
+        {
+            if($input->getVersion() < 0 || $input->getVersion() > QRSPEC_VERSION_MAX) {
+                throw new Exception('wrong version');
+            }
+            if($input->getErrorCorrectionLevel() > QR_ECLEVEL_H) {
+                throw new Exception('wrong level');
+            }
+
+            $raw = new QRrawcode($input);
+            
+            QRtools::markTime('after_raw');
+            
+            $version = $raw->version;
+            $width = QRspec::getWidth($version);
+            $frame = QRspec::newFrame($version);
+            
+            $filler = new FrameFiller($width, $frame);
+            if(is_null($filler)) {
+                return NULL;
+            }
+
+            // inteleaved data and ecc codes
+            for($i=0; $i<$raw->dataLength + $raw->eccLength; $i++) {
+                $code = $raw->getCode();
+                $bit = 0x80;
+                for($j=0; $j<8; $j++) {
+                    $addr = $filler->next();
+                    $filler->setFrameAt($addr, 0x02 | (($bit & $code) != 0));
+                    $bit = $bit >> 1;
+                }
+            }
+            
+            QRtools::markTime('after_filler');
+            
+            unset($raw);
+            
+            // remainder bits
+            $j = QRspec::getRemainder($version);
+            for($i=0; $i<$j; $i++) {
+                $addr = $filler->next();
+                $filler->setFrameAt($addr, 0x02);
+            }
+            
+            $frame = $filler->frame;
+            unset($filler);
+            
+            
+            // masking
+            $maskObj = new QRmask();
+            if($mask < 0) {
+            
+                if (QR_FIND_BEST_MASK) {
+                    $masked = $maskObj->mask($width, $frame, $input->getErrorCorrectionLevel());
+                } else {
+                    $masked = $maskObj->makeMask($width, $frame, (intval(QR_DEFAULT_MASK) % 8), $input->getErrorCorrectionLevel());
+                }
+            } else {
+                $masked = $maskObj->makeMask($width, $frame, $mask, $input->getErrorCorrectionLevel());
+            }
+            
+            if($masked == NULL) {
+                return NULL;
+            }
+            
+            QRtools::markTime('after_mask');
+            
+            $this->version = $version;
+            $this->width = $width;
+            $this->data = $masked;
+            
+            return $this;
+        }
+    
+        //----------------------------------------------------------------------
+        public function encodeInput(QRinput $input)
+        {
+            return $this->encodeMask($input, -1);
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeString8bit($string, $version, $level)
+        {
+            if(string == NULL) {
+                throw new Exception('empty string!');
+                return NULL;
+            }
+
+            $input = new QRinput($version, $level);
+            if($input == NULL) return NULL;
+
+            $ret = $input->append($input, QR_MODE_8, strlen($string), str_split($string));
+            if($ret < 0) {
+                unset($input);
+                return NULL;
+            }
+            return $this->encodeInput($input);
+        }
+
+        //----------------------------------------------------------------------
+        public function encodeString($string, $version, $level, $hint, $casesensitive)
+        {
+
+            if($hint != QR_MODE_8 && $hint != QR_MODE_KANJI) {
+                throw new Exception('bad hint');
+                return NULL;
+            }
+
+            $input = new QRinput($version, $level);
+            if($input == NULL) return NULL;
+
+            $ret = QRsplit::splitStringToQRinput($string, $input, $hint, $casesensitive);
+            if($ret < 0) {
+                return NULL;
+            }
+
+            return $this->encodeInput($input);
+        }
+        
+        //----------------------------------------------------------------------
+        public static function png($text, $outfile = false, $level = QR_ECLEVEL_L, $size = 3, $margin = 4, $saveandprint=false) 
+        {
+            $enc = QRencode::factory($level, $size, $margin);
+            return $enc->encodePNG($text, $outfile, $saveandprint=false);
+        }
+
+        //----------------------------------------------------------------------
+        public static function text($text, $outfile = false, $level = QR_ECLEVEL_L, $size = 3, $margin = 4) 
+        {
+            $enc = QRencode::factory($level, $size, $margin);
+            return $enc->encode($text, $outfile);
+        }
+
+        //----------------------------------------------------------------------
+        public static function raw($text, $outfile = false, $level = QR_ECLEVEL_L, $size = 3, $margin = 4) 
+        {
+            $enc = QRencode::factory($level, $size, $margin);
+            return $enc->encodeRAW($text, $outfile);
+        }
+    }
+    
+    //##########################################################################
+    
+    class FrameFiller {
+    
+        public $width;
+        public $frame;
+        public $x;
+        public $y;
+        public $dir;
+        public $bit;
+        
+        //----------------------------------------------------------------------
+        public function __construct($width, &$frame)
+        {
+            $this->width = $width;
+            $this->frame = $frame;
+            $this->x = $width - 1;
+            $this->y = $width - 1;
+            $this->dir = -1;
+            $this->bit = -1;
+        }
+        
+        //----------------------------------------------------------------------
+        public function setFrameAt($at, $val)
+        {
+            $this->frame[$at['y']][$at['x']] = chr($val);
+        }
+        
+        //----------------------------------------------------------------------
+        public function getFrameAt($at)
+        {
+            return ord($this->frame[$at['y']][$at['x']]);
+        }
+        
+        //----------------------------------------------------------------------
+        public function next()
+        {
+            do {
+            
+                if($this->bit == -1) {
+                    $this->bit = 0;
+                    return array('x'=>$this->x, 'y'=>$this->y);
+                }
+
+                $x = $this->x;
+                $y = $this->y;
+                $w = $this->width;
+
+                if($this->bit == 0) {
+                    $x--;
+                    $this->bit++;
+                } else {
+                    $x++;
+                    $y += $this->dir;
+                    $this->bit--;
+                }
+
+                if($this->dir < 0) {
+                    if($y < 0) {
+                        $y = 0;
+                        $x -= 2;
+                        $this->dir = 1;
+                        if($x == 6) {
+                            $x--;
+                            $y = 9;
+                        }
+                    }
+                } else {
+                    if($y == $w) {
+                        $y = $w - 1;
+                        $x -= 2;
+                        $this->dir = -1;
+                        if($x == 6) {
+                            $x--;
+                            $y -= 8;
+                        }
+                    }
+                }
+                if($x < 0 || $y < 0) return null;
+
+                $this->x = $x;
+                $this->y = $y;
+
+            } while(ord($this->frame[$y][$x]) & 0x80);
+                        
+            return array('x'=>$x, 'y'=>$y);
+        }
+        
+    } ;
+    
+    //##########################################################################    
+    
+    class QRencode {
+    
+        public $casesensitive = true;
+        public $eightbit = false;
+        
+        public $version = 0;
+        public $size = 3;
+        public $margin = 4;
+        
+        public $structured = 0; // not supported yet
+        
+        public $level = QR_ECLEVEL_L;
+        public $hint = QR_MODE_8;
+        
+        //----------------------------------------------------------------------
+        public static function factory($level = QR_ECLEVEL_L, $size = 3, $margin = 4)
+        {
+            $enc = new QRencode();
+            $enc->size = $size;
+            $enc->margin = $margin;
+            
+            switch ($level.'') {
+                case '0':
+                case '1':
+                case '2':
+                case '3':
+                        $enc->level = $level;
+                    break;
+                case 'l':
+                case 'L':
+                        $enc->level = QR_ECLEVEL_L;
+                    break;
+                case 'm':
+                case 'M':
+                        $enc->level = QR_ECLEVEL_M;
+                    break;
+                case 'q':
+                case 'Q':
+                        $enc->level = QR_ECLEVEL_Q;
+                    break;
+                case 'h':
+                case 'H':
+                        $enc->level = QR_ECLEVEL_H;
+                    break;
+            }
+            
+            return $enc;
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeRAW($intext, $outfile = false) 
+        {
+            $code = new QRcode();
+
+            if($this->eightbit) {
+                $code->encodeString8bit($intext, $this->version, $this->level);
+            } else {
+                $code->encodeString($intext, $this->version, $this->level, $this->hint, $this->casesensitive);
+            }
+            
+            return $code->data;
+        }
+
+        //----------------------------------------------------------------------
+        public function encode($intext, $outfile = false) 
+        {
+            $code = new QRcode();
+
+            if($this->eightbit) {
+                $code->encodeString8bit($intext, $this->version, $this->level);
+            } else {
+                $code->encodeString($intext, $this->version, $this->level, $this->hint, $this->casesensitive);
+            }
+            
+            QRtools::markTime('after_encode');
+            
+            if ($outfile!== false) {
+                file_put_contents($outfile, join("\n", QRtools::binarize($code->data)));
+            } else {
+                return QRtools::binarize($code->data);
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodePNG($intext, $outfile = false,$saveandprint=false) 
+        {
+            try {
+            
+                ob_start();
+                $tab = $this->encode($intext);
+                $err = ob_get_contents();
+                ob_end_clean();
+                
+                if ($err != '')
+                    QRtools::log($outfile, $err);
+                
+                $maxSize = (int)(QR_PNG_MAXIMUM_SIZE / (count($tab)+2*$this->margin));
+                
+                QRimage::png($tab, $outfile, min(max(1, $this->size), $maxSize), $this->margin,$saveandprint);
+            
+            } catch (Exception $e) {
+            
+                QRtools::log($outfile, $e->getMessage());
+            
+            }
+        }
+    }

app/lib/phpqrcode/qrimage.php

@@ -0,0 +1,95 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Image output of code using GD2
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+    define('QR_IMAGE', true);
+
+    class QRimage {
+    
+        //----------------------------------------------------------------------
+        public static function png($frame, $filename = false, $pixelPerPoint = 4, $outerFrame = 4,$saveandprint=FALSE) 
+        {
+            $image = self::image($frame, $pixelPerPoint, $outerFrame);
+            
+            if ($filename === false) {
+                Header("Content-type: image/png");
+                ImagePng($image);
+            } else {
+                if($saveandprint===TRUE){
+                    ImagePng($image, $filename);
+                    header("Content-type: image/png");
+                    ImagePng($image);
+                }else{
+                    ImagePng($image, $filename);
+                }
+            }
+            
+            ImageDestroy($image);
+        }
+    
+        //----------------------------------------------------------------------
+        public static function jpg($frame, $filename = false, $pixelPerPoint = 8, $outerFrame = 4, $q = 85) 
+        {
+            $image = self::image($frame, $pixelPerPoint, $outerFrame);
+            
+            if ($filename === false) {
+                Header("Content-type: image/jpeg");
+                ImageJpeg($image, null, $q);
+            } else {
+                ImageJpeg($image, $filename, $q);            
+            }
+            
+            ImageDestroy($image);
+        }
+    
+        //----------------------------------------------------------------------
+        private static function image($frame, $pixelPerPoint = 4, $outerFrame = 4) 
+        {
+            $h = count($frame);
+            $w = strlen($frame[0]);
+            
+            $imgW = $w + 2*$outerFrame;
+            $imgH = $h + 2*$outerFrame;
+            
+            $base_image =ImageCreate($imgW, $imgH);
+            
+            $col[0] = ImageColorAllocate($base_image,255,255,255);
+            $col[1] = ImageColorAllocate($base_image,0,0,0);
+
+            imagefill($base_image, 0, 0, $col[0]);
+
+            for($y=0; $y<$h; $y++) {
+                for($x=0; $x<$w; $x++) {
+                    if ($frame[$y][$x] == '1') {
+                        ImageSetPixel($base_image,$x+$outerFrame,$y+$outerFrame,$col[1]); 
+                    }
+                }
+            }
+            
+            $target_image =ImageCreate($imgW * $pixelPerPoint, $imgH * $pixelPerPoint);
+            ImageCopyResized($target_image, $base_image, 0, 0, 0, 0, $imgW * $pixelPerPoint, $imgH * $pixelPerPoint, $imgW, $imgH);
+            ImageDestroy($base_image);
+            
+            return $target_image;
+        }
+    }

app/lib/phpqrcode/qrinput.php

@@ -0,0 +1,729 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Input encoding class
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+    define('STRUCTURE_HEADER_BITS',  20);
+    define('MAX_STRUCTURED_SYMBOLS', 16);
+
+    class QRinputItem {
+    
+        public $mode;
+        public $size;
+        public $data;
+        public $bstream;
+
+        public function __construct($mode, $size, $data, $bstream = null) 
+        {
+            $setData = array_slice($data, 0, $size);
+            
+            if (count($setData) < $size) {
+                $setData = array_merge($setData, array_fill(0,$size-count($setData),0));
+            }
+        
+            if(!QRinput::check($mode, $size, $setData)) {
+                throw new Exception('Error m:'.$mode.',s:'.$size.',d:'.join(',',$setData));
+                return null;
+            }
+            
+            $this->mode = $mode;
+            $this->size = $size;
+            $this->data = $setData;
+            $this->bstream = $bstream;
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeModeNum($version)
+        {
+            try {
+            
+                $words = (int)($this->size / 3);
+                $bs = new QRbitstream();
+                
+                $val = 0x1;
+                $bs->appendNum(4, $val);
+                $bs->appendNum(QRspec::lengthIndicator(QR_MODE_NUM, $version), $this->size);
+
+                for($i=0; $i<$words; $i++) {
+                    $val  = (ord($this->data[$i*3  ]) - ord('0')) * 100;
+                    $val += (ord($this->data[$i*3+1]) - ord('0')) * 10;
+                    $val += (ord($this->data[$i*3+2]) - ord('0'));
+                    $bs->appendNum(10, $val);
+                }
+
+                if($this->size - $words * 3 == 1) {
+                    $val = ord($this->data[$words*3]) - ord('0');
+                    $bs->appendNum(4, $val);
+                } else if($this->size - $words * 3 == 2) {
+                    $val  = (ord($this->data[$words*3  ]) - ord('0')) * 10;
+                    $val += (ord($this->data[$words*3+1]) - ord('0'));
+                    $bs->appendNum(7, $val);
+                }
+
+                $this->bstream = $bs;
+                return 0;
+                
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeModeAn($version)
+        {
+            try {
+                $words = (int)($this->size / 2);
+                $bs = new QRbitstream();
+                
+                $bs->appendNum(4, 0x02);
+                $bs->appendNum(QRspec::lengthIndicator(QR_MODE_AN, $version), $this->size);
+
+                for($i=0; $i<$words; $i++) {
+                    $val  = (int)QRinput::lookAnTable(ord($this->data[$i*2  ])) * 45;
+                    $val += (int)QRinput::lookAnTable(ord($this->data[$i*2+1]));
+
+                    $bs->appendNum(11, $val);
+                }
+
+                if($this->size & 1) {
+                    $val = QRinput::lookAnTable(ord($this->data[$words * 2]));
+                    $bs->appendNum(6, $val);
+                }
+        
+                $this->bstream = $bs;
+                return 0;
+            
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeMode8($version)
+        {
+            try {
+                $bs = new QRbitstream();
+
+                $bs->appendNum(4, 0x4);
+                $bs->appendNum(QRspec::lengthIndicator(QR_MODE_8, $version), $this->size);
+
+                for($i=0; $i<$this->size; $i++) {
+                    $bs->appendNum(8, ord($this->data[$i]));
+                }
+
+                $this->bstream = $bs;
+                return 0;
+            
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeModeKanji($version)
+        {
+            try {
+
+                $bs = new QRbitrtream();
+                
+                $bs->appendNum(4, 0x8);
+                $bs->appendNum(QRspec::lengthIndicator(QR_MODE_KANJI, $version), (int)($this->size / 2));
+
+                for($i=0; $i<$this->size; $i+=2) {
+                    $val = (ord($this->data[$i]) << 8) | ord($this->data[$i+1]);
+                    if($val <= 0x9ffc) {
+                        $val -= 0x8140;
+                    } else {
+                        $val -= 0xc140;
+                    }
+                    
+                    $h = ($val >> 8) * 0xc0;
+                    $val = ($val & 0xff) + $h;
+
+                    $bs->appendNum(13, $val);
+                }
+
+                $this->bstream = $bs;
+                return 0;
+            
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+
+        //----------------------------------------------------------------------
+        public function encodeModeStructure()
+        {
+            try {
+                $bs =  new QRbitstream();
+                
+                $bs->appendNum(4, 0x03);
+                $bs->appendNum(4, ord($this->data[1]) - 1);
+                $bs->appendNum(4, ord($this->data[0]) - 1);
+                $bs->appendNum(8, ord($this->data[2]));
+
+                $this->bstream = $bs;
+                return 0;
+            
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public function estimateBitStreamSizeOfEntry($version)
+        {
+            $bits = 0;
+
+            if($version == 0) 
+                $version = 1;
+
+            switch($this->mode) {
+                case QR_MODE_NUM:        $bits = QRinput::estimateBitsModeNum($this->size);    break;
+                case QR_MODE_AN:        $bits = QRinput::estimateBitsModeAn($this->size);    break;
+                case QR_MODE_8:            $bits = QRinput::estimateBitsMode8($this->size);    break;
+                case QR_MODE_KANJI:        $bits = QRinput::estimateBitsModeKanji($this->size);break;
+                case QR_MODE_STRUCTURE:    return STRUCTURE_HEADER_BITS;            
+                default:
+                    return 0;
+            }
+
+            $l = QRspec::lengthIndicator($this->mode, $version);
+            $m = 1 << $l;
+            $num = (int)(($this->size + $m - 1) / $m);
+
+            $bits += $num * (4 + $l);
+
+            return $bits;
+        }
+        
+        //----------------------------------------------------------------------
+        public function encodeBitStream($version)
+        {
+            try {
+            
+                unset($this->bstream);
+                $words = QRspec::maximumWords($this->mode, $version);
+                
+                if($this->size > $words) {
+                
+                    $st1 = new QRinputItem($this->mode, $words, $this->data);
+                    $st2 = new QRinputItem($this->mode, $this->size - $words, array_slice($this->data, $words));
+
+                    $st1->encodeBitStream($version);
+                    $st2->encodeBitStream($version);
+                    
+                    $this->bstream = new QRbitstream();
+                    $this->bstream->append($st1->bstream);
+                    $this->bstream->append($st2->bstream);
+                    
+                    unset($st1);
+                    unset($st2);
+                    
+                } else {
+                    
+                    $ret = 0;
+                    
+                    switch($this->mode) {
+                        case QR_MODE_NUM:        $ret = $this->encodeModeNum($version);    break;
+                        case QR_MODE_AN:        $ret = $this->encodeModeAn($version);    break;
+                        case QR_MODE_8:            $ret = $this->encodeMode8($version);    break;
+                        case QR_MODE_KANJI:        $ret = $this->encodeModeKanji($version);break;
+                        case QR_MODE_STRUCTURE:    $ret = $this->encodeModeStructure();    break;
+                        
+                        default:
+                            break;
+                    }
+                    
+                    if($ret < 0)
+                        return -1;
+                }
+
+                return $this->bstream->size();
+            
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+    };
+    
+    //##########################################################################
+
+    class QRinput {
+
+        public $items;
+        
+        private $version;
+        private $level;
+        
+        //----------------------------------------------------------------------
+        public function __construct($version = 0, $level = QR_ECLEVEL_L)
+        {
+            if ($version < 0 || $version > QRSPEC_VERSION_MAX || $level > QR_ECLEVEL_H) {
+                throw new Exception('Invalid version no');
+                return NULL;
+            }
+            
+            $this->version = $version;
+            $this->level = $level;
+        }
+        
+        //----------------------------------------------------------------------
+        public function getVersion()
+        {
+            return $this->version;
+        }
+        
+        //----------------------------------------------------------------------
+        public function setVersion($version)
+        {
+            if($version < 0 || $version > QRSPEC_VERSION_MAX) {
+                throw new Exception('Invalid version no');
+                return -1;
+            }
+
+            $this->version = $version;
+
+            return 0;
+        }
+        
+        //----------------------------------------------------------------------
+        public function getErrorCorrectionLevel()
+        {
+            return $this->level;
+        }
+
+        //----------------------------------------------------------------------
+        public function setErrorCorrectionLevel($level)
+        {
+            if($level > QR_ECLEVEL_H) {
+                throw new Exception('Invalid ECLEVEL');
+                return -1;
+            }
+
+            $this->level = $level;
+
+            return 0;
+        }
+        
+        //----------------------------------------------------------------------
+        public function appendEntry(QRinputItem $entry)
+        {
+            $this->items[] = $entry;
+        }
+        
+        //----------------------------------------------------------------------
+        public function append($mode, $size, $data)
+        {
+            try {
+                $entry = new QRinputItem($mode, $size, $data);
+                $this->items[] = $entry;
+                return 0;
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        
+        public function insertStructuredAppendHeader($size, $index, $parity)
+        {
+            if( $size > MAX_STRUCTURED_SYMBOLS ) {
+                throw new Exception('insertStructuredAppendHeader wrong size');
+            }
+            
+            if( $index <= 0 || $index > MAX_STRUCTURED_SYMBOLS ) {
+                throw new Exception('insertStructuredAppendHeader wrong index');
+            }
+
+            $buf = array($size, $index, $parity);
+            
+            try {
+                $entry = new QRinputItem(QR_MODE_STRUCTURE, 3, buf);
+                array_unshift($this->items, $entry);
+                return 0;
+            } catch (Exception $e) {
+                return -1;
+            }
+        }
+
+        //----------------------------------------------------------------------
+        public function calcParity()
+        {
+            $parity = 0;
+            
+            foreach($this->items as $item) {
+                if($item->mode != QR_MODE_STRUCTURE) {
+                    for($i=$item->size-1; $i>=0; $i--) {
+                        $parity ^= $item->data[$i];
+                    }
+                }
+            }
+
+            return $parity;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function checkModeNum($size, $data)
+        {
+            for($i=0; $i<$size; $i++) {
+                if((ord($data[$i]) < ord('0')) || (ord($data[$i]) > ord('9'))){
+                    return false;
+                }
+            }
+
+            return true;
+        }
+
+        //----------------------------------------------------------------------
+        public static function estimateBitsModeNum($size)
+        {
+            $w = (int)$size / 3;
+            $bits = $w * 10;
+            
+            switch($size - $w * 3) {
+                case 1:
+                    $bits += 4;
+                    break;
+                case 2:
+                    $bits += 7;
+                    break;
+                default:
+                    break;
+            }
+
+            return $bits;
+        }
+        
+        //----------------------------------------------------------------------
+        public static $anTable = array(
+            -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
+            -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
+            36, -1, -1, -1, 37, 38, -1, -1, -1, -1, 39, 40, -1, 41, 42, 43,
+             0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 44, -1, -1, -1, -1, -1,
+            -1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24,
+            25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, -1, -1, -1, -1, -1,
+            -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,
+            -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1
+        );
+        
+        //----------------------------------------------------------------------
+        public static function lookAnTable($c)
+        {
+            return (($c > 127)?-1:self::$anTable[$c]);
+        }
+        
+        //----------------------------------------------------------------------
+        public static function checkModeAn($size, $data)
+        {
+            for($i=0; $i<$size; $i++) {
+                if (self::lookAnTable(ord($data[$i])) == -1) {
+                    return false;
+                }
+            }
+
+            return true;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function estimateBitsModeAn($size)
+        {
+            $w = (int)($size / 2);
+            $bits = $w * 11;
+            
+            if($size & 1) {
+                $bits += 6;
+            }
+
+            return $bits;
+        }
+    
+        //----------------------------------------------------------------------
+        public static function estimateBitsMode8($size)
+        {
+            return $size * 8;
+        }
+        
+        //----------------------------------------------------------------------
+        public function estimateBitsModeKanji($size)
+        {
+            return (int)(($size / 2) * 13);
+        }
+        
+        //----------------------------------------------------------------------
+        public static function checkModeKanji($size, $data)
+        {
+            if($size & 1)
+                return false;
+
+            for($i=0; $i<$size; $i+=2) {
+                $val = (ord($data[$i]) << 8) | ord($data[$i+1]);
+                if( $val < 0x8140 
+                || ($val > 0x9ffc && $val < 0xe040) 
+                || $val > 0xebbf) {
+                    return false;
+                }
+            }
+
+            return true;
+        }
+
+        /***********************************************************************
+         * Validation
+         **********************************************************************/
+
+        public static function check($mode, $size, $data)
+        {
+            if($size <= 0) 
+                return false;
+
+            switch($mode) {
+                case QR_MODE_NUM:       return self::checkModeNum($size, $data);   break;
+                case QR_MODE_AN:        return self::checkModeAn($size, $data);    break;
+                case QR_MODE_KANJI:     return self::checkModeKanji($size, $data); break;
+                case QR_MODE_8:         return true; break;
+                case QR_MODE_STRUCTURE: return true; break;
+                
+                default:
+                    break;
+            }
+
+            return false;
+        }
+        
+        
+        //----------------------------------------------------------------------
+        public function estimateBitStreamSize($version)
+        {
+            $bits = 0;
+
+            foreach($this->items as $item) {
+                $bits += $item->estimateBitStreamSizeOfEntry($version);
+            }
+
+            return $bits;
+        }
+        
+        //----------------------------------------------------------------------
+        public function estimateVersion()
+        {
+            $version = 0;
+            $prev = 0;
+            do {
+                $prev = $version;
+                $bits = $this->estimateBitStreamSize($prev);
+                $version = QRspec::getMinimumVersion((int)(($bits + 7) / 8), $this->level);
+                if ($version < 0) {
+                    return -1;
+                }
+            } while ($version > $prev);
+
+            return $version;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function lengthOfCode($mode, $version, $bits)
+        {
+            $payload = $bits - 4 - QRspec::lengthIndicator($mode, $version);
+            switch($mode) {
+                case QR_MODE_NUM:
+                    $chunks = (int)($payload / 10);
+                    $remain = $payload - $chunks * 10;
+                    $size = $chunks * 3;
+                    if($remain >= 7) {
+                        $size += 2;
+                    } else if($remain >= 4) {
+                        $size += 1;
+                    }
+                    break;
+                case QR_MODE_AN:
+                    $chunks = (int)($payload / 11);
+                    $remain = $payload - $chunks * 11;
+                    $size = $chunks * 2;
+                    if($remain >= 6) 
+                        $size++;
+                    break;
+                case QR_MODE_8:
+                    $size = (int)($payload / 8);
+                    break;
+                case QR_MODE_KANJI:
+                    $size = (int)(($payload / 13) * 2);
+                    break;
+                case QR_MODE_STRUCTURE:
+                    $size = (int)($payload / 8);
+                    break;
+                default:
+                    $size = 0;
+                    break;
+            }
+            
+            $maxsize = QRspec::maximumWords($mode, $version);
+            if($size < 0) $size = 0;
+            if($size > $maxsize) $size = $maxsize;
+
+            return $size;
+        }
+        
+        //----------------------------------------------------------------------
+        public function createBitStream()
+        {
+            $total = 0;
+
+            foreach($this->items as $item) {
+                $bits = $item->encodeBitStream($this->version);
+                
+                if($bits < 0) 
+                    return -1;
+                    
+                $total += $bits;
+            }
+
+            return $total;
+        }
+        
+        //----------------------------------------------------------------------
+        public function convertData()
+        {
+            $ver = $this->estimateVersion();
+            if($ver > $this->getVersion()) {
+                $this->setVersion($ver);
+            }
+
+            for(;;) {
+                $bits = $this->createBitStream();
+                
+                if($bits < 0) 
+                    return -1;
+                    
+                $ver = QRspec::getMinimumVersion((int)(($bits + 7) / 8), $this->level);
+                if($ver < 0) {
+                    throw new Exception('WRONG VERSION');
+                    return -1;
+                } else if($ver > $this->getVersion()) {
+                    $this->setVersion($ver);
+                } else {
+                    break;
+                }
+            }
+
+            return 0;
+        }
+        
+        //----------------------------------------------------------------------
+        public function appendPaddingBit(&$bstream)
+        {
+            $bits = $bstream->size();
+            $maxwords = QRspec::getDataLength($this->version, $this->level);
+            $maxbits = $maxwords * 8;
+
+            if ($maxbits == $bits) {
+                return 0;
+            }
+
+            if ($maxbits - $bits < 5) {
+                return $bstream->appendNum($maxbits - $bits, 0);
+            }
+
+            $bits += 4;
+            $words = (int)(($bits + 7) / 8);
+
+            $padding = new QRbitstream();
+            $ret = $padding->appendNum($words * 8 - $bits + 4, 0);
+            
+            if($ret < 0) 
+                return $ret;
+
+            $padlen = $maxwords - $words;
+            
+            if($padlen > 0) {
+                
+                $padbuf = array();
+                for($i=0; $i<$padlen; $i++) {
+                    $padbuf[$i] = ($i&1)?0x11:0xec;
+                }
+                
+                $ret = $padding->appendBytes($padlen, $padbuf);
+                
+                if($ret < 0)
+                    return $ret;
+                
+            }
+
+            $ret = $bstream->append($padding);
+            
+            return $ret;
+        }
+
+        //----------------------------------------------------------------------
+        public function mergeBitStream()
+        {
+            if($this->convertData() < 0) {
+                return null;
+            }
+
+            $bstream = new QRbitstream();
+            
+            foreach($this->items as $item) {
+                $ret = $bstream->append($item->bstream);
+                if($ret < 0) {
+                    return null;
+                }
+            }
+
+            return $bstream;
+        }
+
+        //----------------------------------------------------------------------
+        public function getBitStream()
+        {
+
+            $bstream = $this->mergeBitStream();
+            
+            if($bstream == null) {
+                return null;
+            }
+            
+            $ret = $this->appendPaddingBit($bstream);
+            if($ret < 0) {
+                return null;
+            }
+
+            return $bstream;
+        }
+        
+        //----------------------------------------------------------------------
+        public function getByteStream()
+        {
+            $bstream = $this->getBitStream();
+            if($bstream == null) {
+                return null;
+            }
+            
+            return $bstream->toByte();
+        }
+    }
+        
+        
+    

app/lib/phpqrcode/qrlib.php

@@ -0,0 +1,43 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Root library file, prepares environment and includes dependencies
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+	
+	$QR_BASEDIR = dirname(__FILE__).DIRECTORY_SEPARATOR;
+	
+	// Required libs
+	
+	include $QR_BASEDIR."qrconst.php";
+	include $QR_BASEDIR."qrconfig.php";
+	include $QR_BASEDIR."qrtools.php";
+	include $QR_BASEDIR."qrspec.php";
+	include $QR_BASEDIR."qrimage.php";
+	include $QR_BASEDIR."qrinput.php";
+	include $QR_BASEDIR."qrbitstream.php";
+	include $QR_BASEDIR."qrsplit.php";
+	include $QR_BASEDIR."qrrscode.php";
+	include $QR_BASEDIR."qrmask.php";
+	include $QR_BASEDIR."qrencode.php";
+

app/lib/phpqrcode/qrmask.php

@@ -0,0 +1,328 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Masking
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+	define('N1', 3);
+	define('N2', 3);
+	define('N3', 40);
+	define('N4', 10);
+
+	class QRmask {
+	
+		public $runLength = array();
+		
+		//----------------------------------------------------------------------
+		public function __construct() 
+        {
+            $this->runLength = array_fill(0, QRSPEC_WIDTH_MAX + 1, 0);
+        }
+        
+        //----------------------------------------------------------------------
+        public function writeFormatInformation($width, &$frame, $mask, $level)
+        {
+            $blacks = 0;
+            $format =  QRspec::getFormatInfo($mask, $level);
+
+            for($i=0; $i<8; $i++) {
+                if($format & 1) {
+                    $blacks += 2;
+                    $v = 0x85;
+                } else {
+                    $v = 0x84;
+                }
+                
+                $frame[8][$width - 1 - $i] = chr($v);
+                if($i < 6) {
+                    $frame[$i][8] = chr($v);
+                } else {
+                    $frame[$i + 1][8] = chr($v);
+                }
+                $format = $format >> 1;
+            }
+            
+            for($i=0; $i<7; $i++) {
+                if($format & 1) {
+                    $blacks += 2;
+                    $v = 0x85;
+                } else {
+                    $v = 0x84;
+                }
+                
+                $frame[$width - 7 + $i][8] = chr($v);
+                if($i == 0) {
+                    $frame[8][7] = chr($v);
+                } else {
+                    $frame[8][6 - $i] = chr($v);
+                }
+                
+                $format = $format >> 1;
+            }
+
+            return $blacks;
+        }
+        
+        //----------------------------------------------------------------------
+        public function mask0($x, $y) { return ($x+$y)&1;                       }
+        public function mask1($x, $y) { return ($y&1);                          }
+        public function mask2($x, $y) { return ($x%3);                          }
+        public function mask3($x, $y) { return ($x+$y)%3;                       }
+        public function mask4($x, $y) { return (((int)($y/2))+((int)($x/3)))&1; }
+        public function mask5($x, $y) { return (($x*$y)&1)+($x*$y)%3;           }
+        public function mask6($x, $y) { return ((($x*$y)&1)+($x*$y)%3)&1;       }
+        public function mask7($x, $y) { return ((($x*$y)%3)+(($x+$y)&1))&1;     }
+        
+        //----------------------------------------------------------------------
+        private function generateMaskNo($maskNo, $width, $frame)
+        {
+            $bitMask = array_fill(0, $width, array_fill(0, $width, 0));
+            
+            for($y=0; $y<$width; $y++) {
+                for($x=0; $x<$width; $x++) {
+                    if(ord($frame[$y][$x]) & 0x80) {
+                        $bitMask[$y][$x] = 0;
+                    } else {
+                        $maskFunc = call_user_func(array($this, 'mask'.$maskNo), $x, $y);
+                        $bitMask[$y][$x] = ($maskFunc == 0)?1:0;
+                    }
+                    
+                }
+            }
+            
+            return $bitMask;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function serial($bitFrame)
+        {
+            $codeArr = array();
+            
+            foreach ($bitFrame as $line)
+                $codeArr[] = join('', $line);
+                
+            return gzcompress(join("\n", $codeArr), 9);
+        }
+        
+        //----------------------------------------------------------------------
+        public static function unserial($code)
+        {
+            $codeArr = array();
+            
+            $codeLines = explode("\n", gzuncompress($code));
+            foreach ($codeLines as $line)
+                $codeArr[] = str_split($line);
+            
+            return $codeArr;
+        }
+        
+        //----------------------------------------------------------------------
+        public function makeMaskNo($maskNo, $width, $s, &$d, $maskGenOnly = false) 
+        {
+            $b = 0;
+            $bitMask = array();
+            
+            $fileName = QR_CACHE_DIR.'mask_'.$maskNo.DIRECTORY_SEPARATOR.'mask_'.$width.'_'.$maskNo.'.dat';
+
+            if (QR_CACHEABLE) {
+                if (file_exists($fileName)) {
+                    $bitMask = self::unserial(file_get_contents($fileName));
+                } else {
+                    $bitMask = $this->generateMaskNo($maskNo, $width, $s, $d);
+                    if (!file_exists(QR_CACHE_DIR.'mask_'.$maskNo))
+                        mkdir(QR_CACHE_DIR.'mask_'.$maskNo);
+                    file_put_contents($fileName, self::serial($bitMask));
+                }
+            } else {
+                $bitMask = $this->generateMaskNo($maskNo, $width, $s, $d);
+            }
+
+            if ($maskGenOnly)
+                return;
+                
+            $d = $s;
+
+            for($y=0; $y<$width; $y++) {
+                for($x=0; $x<$width; $x++) {
+                    if($bitMask[$y][$x] == 1) {
+                        $d[$y][$x] = chr(ord($s[$y][$x]) ^ (int)$bitMask[$y][$x]);
+                    }
+                    $b += (int)(ord($d[$y][$x]) & 1);
+                }
+            }
+
+            return $b;
+        }
+        
+        //----------------------------------------------------------------------
+        public function makeMask($width, $frame, $maskNo, $level)
+        {
+            $masked = array_fill(0, $width, str_repeat("\0", $width));
+            $this->makeMaskNo($maskNo, $width, $frame, $masked);
+            $this->writeFormatInformation($width, $masked, $maskNo, $level);
+       
+            return $masked;
+        }
+        
+        //----------------------------------------------------------------------
+        public function calcN1N3($length)
+        {
+            $demerit = 0;
+
+            for($i=0; $i<$length; $i++) {
+                
+                if($this->runLength[$i] >= 5) {
+                    $demerit += (N1 + ($this->runLength[$i] - 5));
+                }
+                if($i & 1) {
+                    if(($i >= 3) && ($i < ($length-2)) && ($this->runLength[$i] % 3 == 0)) {
+                        $fact = (int)($this->runLength[$i] / 3);
+                        if(($this->runLength[$i-2] == $fact) &&
+                           ($this->runLength[$i-1] == $fact) &&
+                           ($this->runLength[$i+1] == $fact) &&
+                           ($this->runLength[$i+2] == $fact)) {
+                            if(($this->runLength[$i-3] < 0) || ($this->runLength[$i-3] >= (4 * $fact))) {
+                                $demerit += N3;
+                            } else if((($i+3) >= $length) || ($this->runLength[$i+3] >= (4 * $fact))) {
+                                $demerit += N3;
+                            }
+                        }
+                    }
+                }
+            }
+            return $demerit;
+        }
+        
+        //----------------------------------------------------------------------
+        public function evaluateSymbol($width, $frame)
+        {
+            $head = 0;
+            $demerit = 0;
+
+            for($y=0; $y<$width; $y++) {
+                $head = 0;
+                $this->runLength[0] = 1;
+                
+                $frameY = $frame[$y];
+                
+                if ($y>0)
+                    $frameYM = $frame[$y-1];
+                
+                for($x=0; $x<$width; $x++) {
+                    if(($x > 0) && ($y > 0)) {
+                        $b22 = ord($frameY[$x]) & ord($frameY[$x-1]) & ord($frameYM[$x]) & ord($frameYM[$x-1]);
+                        $w22 = ord($frameY[$x]) | ord($frameY[$x-1]) | ord($frameYM[$x]) | ord($frameYM[$x-1]);
+                        
+                        if(($b22 | ($w22 ^ 1))&1) {                                                                     
+                            $demerit += N2;
+                        }
+                    }
+                    if(($x == 0) && (ord($frameY[$x]) & 1)) {
+                        $this->runLength[0] = -1;
+                        $head = 1;
+                        $this->runLength[$head] = 1;
+                    } else if($x > 0) {
+                        if((ord($frameY[$x]) ^ ord($frameY[$x-1])) & 1) {
+                            $head++;
+                            $this->runLength[$head] = 1;
+                        } else {
+                            $this->runLength[$head]++;
+                        }
+                    }
+                }
+    
+                $demerit += $this->calcN1N3($head+1);
+            }
+
+            for($x=0; $x<$width; $x++) {
+                $head = 0;
+                $this->runLength[0] = 1;
+                
+                for($y=0; $y<$width; $y++) {
+                    if($y == 0 && (ord($frame[$y][$x]) & 1)) {
+                        $this->runLength[0] = -1;
+                        $head = 1;
+                        $this->runLength[$head] = 1;
+                    } else if($y > 0) {
+                        if((ord($frame[$y][$x]) ^ ord($frame[$y-1][$x])) & 1) {
+                            $head++;
+                            $this->runLength[$head] = 1;
+                        } else {
+                            $this->runLength[$head]++;
+                        }
+                    }
+                }
+            
+                $demerit += $this->calcN1N3($head+1);
+            }
+
+            return $demerit;
+        }
+        
+        
+        //----------------------------------------------------------------------
+        public function mask($width, $frame, $level)
+        {
+            $minDemerit = PHP_INT_MAX;
+            $bestMaskNum = 0;
+            $bestMask = array();
+            
+            $checked_masks = array(0,1,2,3,4,5,6,7);
+            
+            if (QR_FIND_FROM_RANDOM !== false) {
+            
+                $howManuOut = 8-(QR_FIND_FROM_RANDOM % 9);
+                for ($i = 0; $i <  $howManuOut; $i++) {
+                    $remPos = rand (0, count($checked_masks)-1);
+                    unset($checked_masks[$remPos]);
+                    $checked_masks = array_values($checked_masks);
+                }
+            
+            }
+            
+            $bestMask = $frame;
+             
+            foreach($checked_masks as $i) {
+                $mask = array_fill(0, $width, str_repeat("\0", $width));
+
+                $demerit = 0;
+                $blacks = 0;
+                $blacks  = $this->makeMaskNo($i, $width, $frame, $mask);
+                $blacks += $this->writeFormatInformation($width, $mask, $i, $level);
+                $blacks  = (int)(100 * $blacks / ($width * $width));
+                $demerit = (int)((int)(abs($blacks - 50) / 5) * N4);
+                $demerit += $this->evaluateSymbol($width, $mask);
+                
+                if($demerit < $minDemerit) {
+                    $minDemerit = $demerit;
+                    $bestMask = $mask;
+                    $bestMaskNum = $i;
+                }
+            }
+            
+            return $bestMask;
+        }
+        
+        //----------------------------------------------------------------------
+    }

app/lib/phpqrcode/qrrscode.php

@@ -0,0 +1,210 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Reed-Solomon error correction support
+ * 
+ * Copyright (C) 2002, 2003, 2004, 2006 Phil Karn, KA9Q
+ * (libfec is released under the GNU Lesser General Public License.)
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+    class QRrsItem {
+    
+        public $mm;                  // Bits per symbol 
+        public $nn;                  // Symbols per block (= (1<<mm)-1) 
+        public $alpha_to = array();  // log lookup table 
+        public $index_of = array();  // Antilog lookup table 
+        public $genpoly = array();   // Generator polynomial 
+        public $nroots;              // Number of generator roots = number of parity symbols 
+        public $fcr;                 // First consecutive root, index form 
+        public $prim;                // Primitive element, index form 
+        public $iprim;               // prim-th root of 1, index form 
+        public $pad;                 // Padding bytes in shortened block 
+        public $gfpoly;
+    
+        //----------------------------------------------------------------------
+        public function modnn($x)
+        {
+            while ($x >= $this->nn) {
+                $x -= $this->nn;
+                $x = ($x >> $this->mm) + ($x & $this->nn);
+            }
+            
+            return $x;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function init_rs_char($symsize, $gfpoly, $fcr, $prim, $nroots, $pad)
+        {
+            // Common code for intializing a Reed-Solomon control block (char or int symbols)
+            // Copyright 2004 Phil Karn, KA9Q
+            // May be used under the terms of the GNU Lesser General Public License (LGPL)
+
+            $rs = null;
+            
+            // Check parameter ranges
+            if($symsize < 0 || $symsize > 8)                     return $rs;
+            if($fcr < 0 || $fcr >= (1<<$symsize))                return $rs;
+            if($prim <= 0 || $prim >= (1<<$symsize))             return $rs;
+            if($nroots < 0 || $nroots >= (1<<$symsize))          return $rs; // Can't have more roots than symbol values!
+            if($pad < 0 || $pad >= ((1<<$symsize) -1 - $nroots)) return $rs; // Too much padding
+
+            $rs = new QRrsItem();
+            $rs->mm = $symsize;
+            $rs->nn = (1<<$symsize)-1;
+            $rs->pad = $pad;
+
+            $rs->alpha_to = array_fill(0, $rs->nn+1, 0);
+            $rs->index_of = array_fill(0, $rs->nn+1, 0);
+          
+            // PHP style macro replacement ;)
+            $NN =& $rs->nn;
+            $A0 =& $NN;
+            
+            // Generate Galois field lookup tables
+            $rs->index_of[0] = $A0; // log(zero) = -inf
+            $rs->alpha_to[$A0] = 0; // alpha**-inf = 0
+            $sr = 1;
+          
+            for($i=0; $i<$rs->nn; $i++) {
+                $rs->index_of[$sr] = $i;
+                $rs->alpha_to[$i] = $sr;
+                $sr <<= 1;
+                if($sr & (1<<$symsize)) {
+                    $sr ^= $gfpoly;
+                }
+                $sr &= $rs->nn;
+            }
+            
+            if($sr != 1){
+                // field generator polynomial is not primitive!
+                $rs = NULL;
+                return $rs;
+            }
+
+            /* Form RS code generator polynomial from its roots */
+            $rs->genpoly = array_fill(0, $nroots+1, 0);
+        
+            $rs->fcr = $fcr;
+            $rs->prim = $prim;
+            $rs->nroots = $nroots;
+            $rs->gfpoly = $gfpoly;
+
+            /* Find prim-th root of 1, used in decoding */
+            for($iprim=1;($iprim % $prim) != 0;$iprim += $rs->nn)
+            ; // intentional empty-body loop!
+            
+            $rs->iprim = (int)($iprim / $prim);
+            $rs->genpoly[0] = 1;
+            
+            for ($i = 0,$root=$fcr*$prim; $i < $nroots; $i++, $root += $prim) {
+                $rs->genpoly[$i+1] = 1;
+
+                // Multiply rs->genpoly[] by  @**(root + x)
+                for ($j = $i; $j > 0; $j--) {
+                    if ($rs->genpoly[$j] != 0) {
+                        $rs->genpoly[$j] = $rs->genpoly[$j-1] ^ $rs->alpha_to[$rs->modnn($rs->index_of[$rs->genpoly[$j]] + $root)];
+                    } else {
+                        $rs->genpoly[$j] = $rs->genpoly[$j-1];
+                    }
+                }
+                // rs->genpoly[0] can never be zero
+                $rs->genpoly[0] = $rs->alpha_to[$rs->modnn($rs->index_of[$rs->genpoly[0]] + $root)];
+            }
+            
+            // convert rs->genpoly[] to index form for quicker encoding
+            for ($i = 0; $i <= $nroots; $i++)
+                $rs->genpoly[$i] = $rs->index_of[$rs->genpoly[$i]];
+
+            return $rs;
+        }
+        
+        //----------------------------------------------------------------------
+        public function encode_rs_char($data, &$parity)
+        {
+            $MM       =& $this->mm;
+            $NN       =& $this->nn;
+            $ALPHA_TO =& $this->alpha_to;
+            $INDEX_OF =& $this->index_of;
+            $GENPOLY  =& $this->genpoly;
+            $NROOTS   =& $this->nroots;
+            $FCR      =& $this->fcr;
+            $PRIM     =& $this->prim;
+            $IPRIM    =& $this->iprim;
+            $PAD      =& $this->pad;
+            $A0       =& $NN;
+
+            $parity = array_fill(0, $NROOTS, 0);
+
+            for($i=0; $i< ($NN-$NROOTS-$PAD); $i++) {
+                
+                $feedback = $INDEX_OF[$data[$i] ^ $parity[0]];
+                if($feedback != $A0) {      
+                    // feedback term is non-zero
+            
+                    // This line is unnecessary when GENPOLY[NROOTS] is unity, as it must
+                    // always be for the polynomials constructed by init_rs()
+                    $feedback = $this->modnn($NN - $GENPOLY[$NROOTS] + $feedback);
+            
+                    for($j=1;$j<$NROOTS;$j++) {
+                        $parity[$j] ^= $ALPHA_TO[$this->modnn($feedback + $GENPOLY[$NROOTS-$j])];
+                    }
+                }
+                
+                // Shift 
+                array_shift($parity);
+                if($feedback != $A0) {
+                    array_push($parity, $ALPHA_TO[$this->modnn($feedback + $GENPOLY[0])]);
+                } else {
+                    array_push($parity, 0);
+                }
+            }
+        }
+    }
+    
+    //##########################################################################
+    
+    class QRrs {
+    
+        public static $items = array();
+        
+        //----------------------------------------------------------------------
+        public static function init_rs($symsize, $gfpoly, $fcr, $prim, $nroots, $pad)
+        {
+            foreach(self::$items as $rs) {
+                if($rs->pad != $pad)       continue;
+                if($rs->nroots != $nroots) continue;
+                if($rs->mm != $symsize)    continue;
+                if($rs->gfpoly != $gfpoly) continue;
+                if($rs->fcr != $fcr)       continue;
+                if($rs->prim != $prim)     continue;
+
+                return $rs;
+            }
+
+            $rs = QRrsItem::init_rs_char($symsize, $gfpoly, $fcr, $prim, $nroots, $pad);
+            array_unshift(self::$items, $rs);
+
+            return $rs;
+        }
+    }

app/lib/phpqrcode/qrspec.php

@@ -0,0 +1,592 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * QR Code specifications
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * The following data / specifications are taken from
+ * "Two dimensional symbol -- QR-code -- Basic Specification" (JIS X0510:2004)
+ *  or
+ * "Automatic identification and data capture techniques -- 
+ *  QR Code 2005 bar code symbology specification" (ISO/IEC 18004:2006)
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+    define('QRSPEC_VERSION_MAX', 40);
+    define('QRSPEC_WIDTH_MAX',   177);
+
+    define('QRCAP_WIDTH',        0);
+    define('QRCAP_WORDS',        1);
+    define('QRCAP_REMINDER',     2);
+    define('QRCAP_EC',           3);
+
+    class QRspec {
+    
+        public static $capacity = array(
+            array(  0,    0, 0, array(   0,    0,    0,    0)),
+            array( 21,   26, 0, array(   7,   10,   13,   17)), // 1
+            array( 25,   44, 7, array(  10,   16,   22,   28)),
+            array( 29,   70, 7, array(  15,   26,   36,   44)),
+            array( 33,  100, 7, array(  20,   36,   52,   64)),
+            array( 37,  134, 7, array(  26,   48,   72,   88)), // 5
+            array( 41,  172, 7, array(  36,   64,   96,  112)),
+            array( 45,  196, 0, array(  40,   72,  108,  130)),
+            array( 49,  242, 0, array(  48,   88,  132,  156)),
+            array( 53,  292, 0, array(  60,  110,  160,  192)),
+            array( 57,  346, 0, array(  72,  130,  192,  224)), //10
+            array( 61,  404, 0, array(  80,  150,  224,  264)),
+            array( 65,  466, 0, array(  96,  176,  260,  308)),
+            array( 69,  532, 0, array( 104,  198,  288,  352)),
+            array( 73,  581, 3, array( 120,  216,  320,  384)),
+            array( 77,  655, 3, array( 132,  240,  360,  432)), //15
+            array( 81,  733, 3, array( 144,  280,  408,  480)),
+            array( 85,  815, 3, array( 168,  308,  448,  532)),
+            array( 89,  901, 3, array( 180,  338,  504,  588)),
+            array( 93,  991, 3, array( 196,  364,  546,  650)),
+            array( 97, 1085, 3, array( 224,  416,  600,  700)), //20
+            array(101, 1156, 4, array( 224,  442,  644,  750)),
+            array(105, 1258, 4, array( 252,  476,  690,  816)),
+            array(109, 1364, 4, array( 270,  504,  750,  900)),
+            array(113, 1474, 4, array( 300,  560,  810,  960)),
+            array(117, 1588, 4, array( 312,  588,  870, 1050)), //25
+            array(121, 1706, 4, array( 336,  644,  952, 1110)),
+            array(125, 1828, 4, array( 360,  700, 1020, 1200)),
+            array(129, 1921, 3, array( 390,  728, 1050, 1260)),
+            array(133, 2051, 3, array( 420,  784, 1140, 1350)),
+            array(137, 2185, 3, array( 450,  812, 1200, 1440)), //30
+            array(141, 2323, 3, array( 480,  868, 1290, 1530)),
+            array(145, 2465, 3, array( 510,  924, 1350, 1620)),
+            array(149, 2611, 3, array( 540,  980, 1440, 1710)),
+            array(153, 2761, 3, array( 570, 1036, 1530, 1800)),
+            array(157, 2876, 0, array( 570, 1064, 1590, 1890)), //35
+            array(161, 3034, 0, array( 600, 1120, 1680, 1980)),
+            array(165, 3196, 0, array( 630, 1204, 1770, 2100)),
+            array(169, 3362, 0, array( 660, 1260, 1860, 2220)),
+            array(173, 3532, 0, array( 720, 1316, 1950, 2310)),
+            array(177, 3706, 0, array( 750, 1372, 2040, 2430)) //40
+        );
+        
+        //----------------------------------------------------------------------
+        public static function getDataLength($version, $level)
+        {
+            return self::$capacity[$version][QRCAP_WORDS] - self::$capacity[$version][QRCAP_EC][$level];
+        }
+        
+        //----------------------------------------------------------------------
+        public static function getECCLength($version, $level)
+        {
+            return self::$capacity[$version][QRCAP_EC][$level];
+        }
+        
+        //----------------------------------------------------------------------
+        public static function getWidth($version)
+        {
+            return self::$capacity[$version][QRCAP_WIDTH];
+        }
+        
+        //----------------------------------------------------------------------
+        public static function getRemainder($version)
+        {
+            return self::$capacity[$version][QRCAP_REMINDER];
+        }
+        
+        //----------------------------------------------------------------------
+        public static function getMinimumVersion($size, $level)
+        {
+
+            for($i=1; $i<= QRSPEC_VERSION_MAX; $i++) {
+                $words  = self::$capacity[$i][QRCAP_WORDS] - self::$capacity[$i][QRCAP_EC][$level];
+                if($words >= $size) 
+                    return $i;
+            }
+
+            return -1;
+        }
+    
+        //######################################################################
+        
+        public static $lengthTableBits = array(
+            array(10, 12, 14),
+            array( 9, 11, 13),
+            array( 8, 16, 16),
+            array( 8, 10, 12)
+        );
+        
+        //----------------------------------------------------------------------
+        public static function lengthIndicator($mode, $version)
+        {
+            if ($mode == QR_MODE_STRUCTURE)
+                return 0;
+                
+            if ($version <= 9) {
+                $l = 0;
+            } else if ($version <= 26) {
+                $l = 1;
+            } else {
+                $l = 2;
+            }
+
+            return self::$lengthTableBits[$mode][$l];
+        }
+        
+        //----------------------------------------------------------------------
+        public static function maximumWords($mode, $version)
+        {
+            if($mode == QR_MODE_STRUCTURE) 
+                return 3;
+                
+            if($version <= 9) {
+                $l = 0;
+            } else if($version <= 26) {
+                $l = 1;
+            } else {
+                $l = 2;
+            }
+
+            $bits = self::$lengthTableBits[$mode][$l];
+            $words = (1 << $bits) - 1;
+            
+            if($mode == QR_MODE_KANJI) {
+                $words *= 2; // the number of bytes is required
+            }
+
+            return $words;
+        }
+
+        // Error correction code -----------------------------------------------
+        // Table of the error correction code (Reed-Solomon block)
+        // See Table 12-16 (pp.30-36), JIS X0510:2004.
+
+        public static $eccTable = array(
+            array(array( 0,  0), array( 0,  0), array( 0,  0), array( 0,  0)),
+            array(array( 1,  0), array( 1,  0), array( 1,  0), array( 1,  0)), // 1
+            array(array( 1,  0), array( 1,  0), array( 1,  0), array( 1,  0)),
+            array(array( 1,  0), array( 1,  0), array( 2,  0), array( 2,  0)),
+            array(array( 1,  0), array( 2,  0), array( 2,  0), array( 4,  0)),
+            array(array( 1,  0), array( 2,  0), array( 2,  2), array( 2,  2)), // 5
+            array(array( 2,  0), array( 4,  0), array( 4,  0), array( 4,  0)),
+            array(array( 2,  0), array( 4,  0), array( 2,  4), array( 4,  1)),
+            array(array( 2,  0), array( 2,  2), array( 4,  2), array( 4,  2)),
+            array(array( 2,  0), array( 3,  2), array( 4,  4), array( 4,  4)),
+            array(array( 2,  2), array( 4,  1), array( 6,  2), array( 6,  2)), //10
+            array(array( 4,  0), array( 1,  4), array( 4,  4), array( 3,  8)),
+            array(array( 2,  2), array( 6,  2), array( 4,  6), array( 7,  4)),
+            array(array( 4,  0), array( 8,  1), array( 8,  4), array(12,  4)),
+            array(array( 3,  1), array( 4,  5), array(11,  5), array(11,  5)),
+            array(array( 5,  1), array( 5,  5), array( 5,  7), array(11,  7)), //15
+            array(array( 5,  1), array( 7,  3), array(15,  2), array( 3, 13)),
+            array(array( 1,  5), array(10,  1), array( 1, 15), array( 2, 17)),
+            array(array( 5,  1), array( 9,  4), array(17,  1), array( 2, 19)),
+            array(array( 3,  4), array( 3, 11), array(17,  4), array( 9, 16)),
+            array(array( 3,  5), array( 3, 13), array(15,  5), array(15, 10)), //20
+            array(array( 4,  4), array(17,  0), array(17,  6), array(19,  6)),
+            array(array( 2,  7), array(17,  0), array( 7, 16), array(34,  0)),
+            array(array( 4,  5), array( 4, 14), array(11, 14), array(16, 14)),
+            array(array( 6,  4), array( 6, 14), array(11, 16), array(30,  2)),
+            array(array( 8,  4), array( 8, 13), array( 7, 22), array(22, 13)), //25
+            array(array(10,  2), array(19,  4), array(28,  6), array(33,  4)),
+            array(array( 8,  4), array(22,  3), array( 8, 26), array(12, 28)),
+            array(array( 3, 10), array( 3, 23), array( 4, 31), array(11, 31)),
+            array(array( 7,  7), array(21,  7), array( 1, 37), array(19, 26)),
+            array(array( 5, 10), array(19, 10), array(15, 25), array(23, 25)), //30
+            array(array(13,  3), array( 2, 29), array(42,  1), array(23, 28)),
+            array(array(17,  0), array(10, 23), array(10, 35), array(19, 35)),
+            array(array(17,  1), array(14, 21), array(29, 19), array(11, 46)),
+            array(array(13,  6), array(14, 23), array(44,  7), array(59,  1)),
+            array(array(12,  7), array(12, 26), array(39, 14), array(22, 41)), //35
+            array(array( 6, 14), array( 6, 34), array(46, 10), array( 2, 64)),
+            array(array(17,  4), array(29, 14), array(49, 10), array(24, 46)),
+            array(array( 4, 18), array(13, 32), array(48, 14), array(42, 32)),
+            array(array(20,  4), array(40,  7), array(43, 22), array(10, 67)),
+            array(array(19,  6), array(18, 31), array(34, 34), array(20, 61)),//40
+        );                                                                       
+
+        //----------------------------------------------------------------------
+        // CACHEABLE!!!
+        
+        public static function getEccSpec($version, $level, array &$spec)
+        {
+            if (count($spec) < 5) {
+                $spec = array(0,0,0,0,0);
+            }
+
+            $b1   = self::$eccTable[$version][$level][0];
+            $b2   = self::$eccTable[$version][$level][1];
+            $data = self::getDataLength($version, $level);
+            $ecc  = self::getECCLength($version, $level);
+
+            if($b2 == 0) {
+                $spec[0] = $b1;
+                $spec[1] = (int)($data / $b1);
+                $spec[2] = (int)($ecc / $b1);
+                $spec[3] = 0; 
+                $spec[4] = 0;
+            } else {
+                $spec[0] = $b1;
+                $spec[1] = (int)($data / ($b1 + $b2));
+                $spec[2] = (int)($ecc  / ($b1 + $b2));
+                $spec[3] = $b2;
+                $spec[4] = $spec[1] + 1;
+            }
+        }
+
+        // Alignment pattern ---------------------------------------------------
+
+        // Positions of alignment patterns.
+        // This array includes only the second and the third position of the 
+        // alignment patterns. Rest of them can be calculated from the distance 
+        // between them.
+         
+        // See Table 1 in Appendix E (pp.71) of JIS X0510:2004.
+         
+        public static $alignmentPattern = array(      
+            array( 0,  0),
+            array( 0,  0), array(18,  0), array(22,  0), array(26,  0), array(30,  0), // 1- 5
+            array(34,  0), array(22, 38), array(24, 42), array(26, 46), array(28, 50), // 6-10
+            array(30, 54), array(32, 58), array(34, 62), array(26, 46), array(26, 48), //11-15
+            array(26, 50), array(30, 54), array(30, 56), array(30, 58), array(34, 62), //16-20
+            array(28, 50), array(26, 50), array(30, 54), array(28, 54), array(32, 58), //21-25
+            array(30, 58), array(34, 62), array(26, 50), array(30, 54), array(26, 52), //26-30
+            array(30, 56), array(34, 60), array(30, 58), array(34, 62), array(30, 54), //31-35
+            array(24, 50), array(28, 54), array(32, 58), array(26, 54), array(30, 58), //35-40
+        );                                                                                  
+
+        
+        /** --------------------------------------------------------------------
+         * Put an alignment marker.
+         * @param frame
+         * @param width
+         * @param ox,oy center coordinate of the pattern
+         */
+        public static function putAlignmentMarker(array &$frame, $ox, $oy)
+        {
+            $finder = array(
+                "\xa1\xa1\xa1\xa1\xa1",
+                "\xa1\xa0\xa0\xa0\xa1",
+                "\xa1\xa0\xa1\xa0\xa1",
+                "\xa1\xa0\xa0\xa0\xa1",
+                "\xa1\xa1\xa1\xa1\xa1"
+            );                        
+            
+            $yStart = $oy-2;         
+            $xStart = $ox-2;
+            
+            for($y=0; $y<5; $y++) {
+                QRstr::set($frame, $xStart, $yStart+$y, $finder[$y]);
+            }
+        }
+
+        //----------------------------------------------------------------------
+        public static function putAlignmentPattern($version, &$frame, $width)
+        {
+            if($version < 2)
+                return;
+
+            $d = self::$alignmentPattern[$version][1] - self::$alignmentPattern[$version][0];
+            if($d < 0) {
+                $w = 2;
+            } else {
+                $w = (int)(($width - self::$alignmentPattern[$version][0]) / $d + 2);
+            }
+
+            if($w * $w - 3 == 1) {
+                $x = self::$alignmentPattern[$version][0];
+                $y = self::$alignmentPattern[$version][0];
+                self::putAlignmentMarker($frame, $x, $y);
+                return;
+            }
+
+            $cx = self::$alignmentPattern[$version][0];
+            for($x=1; $x<$w - 1; $x++) {
+                self::putAlignmentMarker($frame, 6, $cx);
+                self::putAlignmentMarker($frame, $cx,  6);
+                $cx += $d;
+            }
+
+            $cy = self::$alignmentPattern[$version][0];
+            for($y=0; $y<$w-1; $y++) {
+                $cx = self::$alignmentPattern[$version][0];
+                for($x=0; $x<$w-1; $x++) {
+                    self::putAlignmentMarker($frame, $cx, $cy);
+                    $cx += $d;
+                }
+                $cy += $d;
+            }
+        }
+
+        // Version information pattern -----------------------------------------
+
+		// Version information pattern (BCH coded).
+        // See Table 1 in Appendix D (pp.68) of JIS X0510:2004.
+        
+		// size: [QRSPEC_VERSION_MAX - 6]
+		
+        public static $versionPattern = array(
+            0x07c94, 0x085bc, 0x09a99, 0x0a4d3, 0x0bbf6, 0x0c762, 0x0d847, 0x0e60d,
+            0x0f928, 0x10b78, 0x1145d, 0x12a17, 0x13532, 0x149a6, 0x15683, 0x168c9,
+            0x177ec, 0x18ec4, 0x191e1, 0x1afab, 0x1b08e, 0x1cc1a, 0x1d33f, 0x1ed75,
+            0x1f250, 0x209d5, 0x216f0, 0x228ba, 0x2379f, 0x24b0b, 0x2542e, 0x26a64,
+            0x27541, 0x28c69
+        );
+
+        //----------------------------------------------------------------------
+        public static function getVersionPattern($version)
+        {
+            if($version < 7 || $version > QRSPEC_VERSION_MAX)
+                return 0;
+
+            return self::$versionPattern[$version -7];
+        }
+
+        // Format information --------------------------------------------------
+        // See calcFormatInfo in tests/test_qrspec.c (orginal qrencode c lib)
+        
+        public static $formatInfo = array(
+            array(0x77c4, 0x72f3, 0x7daa, 0x789d, 0x662f, 0x6318, 0x6c41, 0x6976),
+            array(0x5412, 0x5125, 0x5e7c, 0x5b4b, 0x45f9, 0x40ce, 0x4f97, 0x4aa0),
+            array(0x355f, 0x3068, 0x3f31, 0x3a06, 0x24b4, 0x2183, 0x2eda, 0x2bed),
+            array(0x1689, 0x13be, 0x1ce7, 0x19d0, 0x0762, 0x0255, 0x0d0c, 0x083b)
+        );
+
+        public static function getFormatInfo($mask, $level)
+        {
+            if($mask < 0 || $mask > 7)
+                return 0;
+                
+            if($level < 0 || $level > 3)
+                return 0;                
+
+            return self::$formatInfo[$level][$mask];
+        }
+
+        // Frame ---------------------------------------------------------------
+        // Cache of initial frames.
+         
+        public static $frames = array();
+
+        /** --------------------------------------------------------------------
+         * Put a finder pattern.
+         * @param frame
+         * @param width
+         * @param ox,oy upper-left coordinate of the pattern
+         */
+        public static function putFinderPattern(&$frame, $ox, $oy)
+        {
+            $finder = array(
+                "\xc1\xc1\xc1\xc1\xc1\xc1\xc1",
+                "\xc1\xc0\xc0\xc0\xc0\xc0\xc1",
+                "\xc1\xc0\xc1\xc1\xc1\xc0\xc1",
+                "\xc1\xc0\xc1\xc1\xc1\xc0\xc1",
+                "\xc1\xc0\xc1\xc1\xc1\xc0\xc1",
+                "\xc1\xc0\xc0\xc0\xc0\xc0\xc1",
+                "\xc1\xc1\xc1\xc1\xc1\xc1\xc1"
+            );                            
+            
+            for($y=0; $y<7; $y++) {
+                QRstr::set($frame, $ox, $oy+$y, $finder[$y]);
+            }
+        }
+
+        //----------------------------------------------------------------------
+        public static function createFrame($version)
+        {
+            $width = self::$capacity[$version][QRCAP_WIDTH];
+            $frameLine = str_repeat ("\0", $width);
+            $frame = array_fill(0, $width, $frameLine);
+
+            // Finder pattern
+            self::putFinderPattern($frame, 0, 0);
+            self::putFinderPattern($frame, $width - 7, 0);
+            self::putFinderPattern($frame, 0, $width - 7);
+            
+            // Separator
+            $yOffset = $width - 7;
+            
+            for($y=0; $y<7; $y++) {
+                $frame[$y][7] = "\xc0";
+                $frame[$y][$width - 8] = "\xc0";
+                $frame[$yOffset][7] = "\xc0";
+                $yOffset++;
+            }
+            
+            $setPattern = str_repeat("\xc0", 8);
+            
+            QRstr::set($frame, 0, 7, $setPattern);
+            QRstr::set($frame, $width-8, 7, $setPattern);
+            QRstr::set($frame, 0, $width - 8, $setPattern);
+        
+            // Format info
+            $setPattern = str_repeat("\x84", 9);
+            QRstr::set($frame, 0, 8, $setPattern);
+            QRstr::set($frame, $width - 8, 8, $setPattern, 8);
+            
+            $yOffset = $width - 8;
+
+            for($y=0; $y<8; $y++,$yOffset++) {
+                $frame[$y][8] = "\x84";
+                $frame[$yOffset][8] = "\x84";
+            }
+
+            // Timing pattern  
+            
+            for($i=1; $i<$width-15; $i++) {
+                $frame[6][7+$i] = chr(0x90 | ($i & 1));
+                $frame[7+$i][6] = chr(0x90 | ($i & 1));
+            }
+            
+            // Alignment pattern  
+            self::putAlignmentPattern($version, $frame, $width);
+            
+            // Version information 
+            if($version >= 7) {
+                $vinf = self::getVersionPattern($version);
+
+                $v = $vinf;
+                
+                for($x=0; $x<6; $x++) {
+                    for($y=0; $y<3; $y++) {
+                        $frame[($width - 11)+$y][$x] = chr(0x88 | ($v & 1));
+                        $v = $v >> 1;
+                    }
+                }
+
+                $v = $vinf;
+                for($y=0; $y<6; $y++) {
+                    for($x=0; $x<3; $x++) {
+                        $frame[$y][$x+($width - 11)] = chr(0x88 | ($v & 1));
+                        $v = $v >> 1;
+                    }
+                }
+            }
+    
+            // and a little bit...  
+            $frame[$width - 8][8] = "\x81";
+            
+            return $frame;
+        }
+
+        //----------------------------------------------------------------------
+        public static function debug($frame, $binary_mode = false)
+        {
+            if ($binary_mode) {
+            
+                    foreach ($frame as &$frameLine) {
+                        $frameLine = join('<span class="m">&nbsp;&nbsp;</span>', explode('0', $frameLine));
+                        $frameLine = join('&#9608;&#9608;', explode('1', $frameLine));
+                    }
+                    
+                    ?>
+                <style>
+                    .m { background-color: white; }
+                </style>
+                <?php
+                    echo '<pre><tt><br/ ><br/ ><br/ >&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;';
+                    echo join("<br/ >&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;", $frame);
+                    echo '</tt></pre><br/ ><br/ ><br/ ><br/ ><br/ ><br/ >';
+            
+            } else {
+            
+                foreach ($frame as &$frameLine) {
+                    $frameLine = join('<span class="m">&nbsp;</span>',  explode("\xc0", $frameLine));
+                    $frameLine = join('<span class="m">&#9618;</span>', explode("\xc1", $frameLine));
+                    $frameLine = join('<span class="p">&nbsp;</span>',  explode("\xa0", $frameLine));
+                    $frameLine = join('<span class="p">&#9618;</span>', explode("\xa1", $frameLine));
+                    $frameLine = join('<span class="s">&#9671;</span>', explode("\x84", $frameLine)); //format 0
+                    $frameLine = join('<span class="s">&#9670;</span>', explode("\x85", $frameLine)); //format 1
+                    $frameLine = join('<span class="x">&#9762;</span>', explode("\x81", $frameLine)); //special bit
+                    $frameLine = join('<span class="c">&nbsp;</span>',  explode("\x90", $frameLine)); //clock 0
+                    $frameLine = join('<span class="c">&#9719;</span>', explode("\x91", $frameLine)); //clock 1
+                    $frameLine = join('<span class="f">&nbsp;</span>',  explode("\x88", $frameLine)); //version
+                    $frameLine = join('<span class="f">&#9618;</span>', explode("\x89", $frameLine)); //version
+                    $frameLine = join('&#9830;', explode("\x01", $frameLine));
+                    $frameLine = join('&#8901;', explode("\0", $frameLine));
+                }
+                
+                ?>
+                <style>
+                    .p { background-color: yellow; }
+                    .m { background-color: #00FF00; }
+                    .s { background-color: #FF0000; }
+                    .c { background-color: aqua; }
+                    .x { background-color: pink; }
+                    .f { background-color: gold; }
+                </style>
+                <?php
+                echo "<pre><tt>";
+                echo join("<br/ >", $frame);
+                echo "</tt></pre>";
+            
+            }
+        }
+
+        //----------------------------------------------------------------------
+        public static function serial($frame)
+        {
+            return gzcompress(join("\n", $frame), 9);
+        }
+        
+        //----------------------------------------------------------------------
+        public static function unserial($code)
+        {
+            return explode("\n", gzuncompress($code));
+        }
+        
+        //----------------------------------------------------------------------
+        public static function newFrame($version)
+        {
+            if($version < 1 || $version > QRSPEC_VERSION_MAX) 
+                return null;
+
+            if(!isset(self::$frames[$version])) {
+                
+                $fileName = QR_CACHE_DIR.'frame_'.$version.'.dat';
+                
+                if (QR_CACHEABLE) {
+                    if (file_exists($fileName)) {
+                        self::$frames[$version] = self::unserial(file_get_contents($fileName));
+                    } else {
+                        self::$frames[$version] = self::createFrame($version);
+                        file_put_contents($fileName, self::serial(self::$frames[$version]));
+                    }
+                } else {
+                    self::$frames[$version] = self::createFrame($version);
+                }
+            }
+            
+            if(is_null(self::$frames[$version]))
+                return null;
+
+            return self::$frames[$version];
+        }
+
+        //----------------------------------------------------------------------
+        public static function rsBlockNum($spec)     { return $spec[0] + $spec[3]; }
+        public static function rsBlockNum1($spec)    { return $spec[0]; }
+        public static function rsDataCodes1($spec)   { return $spec[1]; }
+        public static function rsEccCodes1($spec)    { return $spec[2]; }
+        public static function rsBlockNum2($spec)    { return $spec[3]; }
+        public static function rsDataCodes2($spec)   { return $spec[4]; }
+        public static function rsEccCodes2($spec)    { return $spec[2]; }
+        public static function rsDataLength($spec)   { return ($spec[0] * $spec[1]) + ($spec[3] * $spec[4]);    }
+        public static function rsEccLength($spec)    { return ($spec[0] + $spec[3]) * $spec[2]; }
+        
+    }

app/lib/phpqrcode/qrsplit.php

@@ -0,0 +1,311 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Input splitting classes
+ *
+ * Based on libqrencode C library distributed under LGPL 2.1
+ * Copyright (C) 2006, 2007, 2008, 2009 Kentaro Fukuchi <fukuchi@megaui.net>
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * The following data / specifications are taken from
+ * "Two dimensional symbol -- QR-code -- Basic Specification" (JIS X0510:2004)
+ *  or
+ * "Automatic identification and data capture techniques -- 
+ *  QR Code 2005 bar code symbology specification" (ISO/IEC 18004:2006)
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+    class QRsplit {
+
+        public $dataStr = '';
+        public $input;
+        public $modeHint;
+
+        //----------------------------------------------------------------------
+        public function __construct($dataStr, $input, $modeHint) 
+        {
+            $this->dataStr  = $dataStr;
+            $this->input    = $input;
+            $this->modeHint = $modeHint;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function isdigitat($str, $pos)
+        {    
+            if ($pos >= strlen($str))
+                return false;
+            
+            return ((ord($str[$pos]) >= ord('0'))&&(ord($str[$pos]) <= ord('9')));
+        }
+        
+        //----------------------------------------------------------------------
+        public static function isalnumat($str, $pos)
+        {
+            if ($pos >= strlen($str))
+                return false;
+                
+            return (QRinput::lookAnTable(ord($str[$pos])) >= 0);
+        }
+
+        //----------------------------------------------------------------------
+        public function identifyMode($pos)
+        {
+            if ($pos >= strlen($this->dataStr)) 
+                return QR_MODE_NUL;
+                
+            $c = $this->dataStr[$pos];
+            
+            if(self::isdigitat($this->dataStr, $pos)) {
+                return QR_MODE_NUM;
+            } else if(self::isalnumat($this->dataStr, $pos)) {
+                return QR_MODE_AN;
+            } else if($this->modeHint == QR_MODE_KANJI) {
+            
+                if ($pos+1 < strlen($this->dataStr)) 
+                {
+                    $d = $this->dataStr[$pos+1];
+                    $word = (ord($c) << 8) | ord($d);
+                    if(($word >= 0x8140 && $word <= 0x9ffc) || ($word >= 0xe040 && $word <= 0xebbf)) {
+                        return QR_MODE_KANJI;
+                    }
+                }
+            }
+
+            return QR_MODE_8;
+        } 
+        
+        //----------------------------------------------------------------------
+        public function eatNum()
+        {
+            $ln = QRspec::lengthIndicator(QR_MODE_NUM, $this->input->getVersion());
+
+            $p = 0;
+            while(self::isdigitat($this->dataStr, $p)) {
+                $p++;
+            }
+            
+            $run = $p;
+            $mode = $this->identifyMode($p);
+            
+            if($mode == QR_MODE_8) {
+                $dif = QRinput::estimateBitsModeNum($run) + 4 + $ln
+                     + QRinput::estimateBitsMode8(1)         // + 4 + l8
+                     - QRinput::estimateBitsMode8($run + 1); // - 4 - l8
+                if($dif > 0) {
+                    return $this->eat8();
+                }
+            }
+            if($mode == QR_MODE_AN) {
+                $dif = QRinput::estimateBitsModeNum($run) + 4 + $ln
+                     + QRinput::estimateBitsModeAn(1)        // + 4 + la
+                     - QRinput::estimateBitsModeAn($run + 1);// - 4 - la
+                if($dif > 0) {
+                    return $this->eatAn();
+                }
+            }
+            
+            $ret = $this->input->append(QR_MODE_NUM, $run, str_split($this->dataStr));
+            if($ret < 0)
+                return -1;
+
+            return $run;
+        }
+        
+        //----------------------------------------------------------------------
+        public function eatAn()
+        {
+            $la = QRspec::lengthIndicator(QR_MODE_AN,  $this->input->getVersion());
+            $ln = QRspec::lengthIndicator(QR_MODE_NUM, $this->input->getVersion());
+
+            $p = 0;
+            
+            while(self::isalnumat($this->dataStr, $p)) {
+                if(self::isdigitat($this->dataStr, $p)) {
+                    $q = $p;
+                    while(self::isdigitat($this->dataStr, $q)) {
+                        $q++;
+                    }
+                    
+                    $dif = QRinput::estimateBitsModeAn($p) // + 4 + la
+                         + QRinput::estimateBitsModeNum($q - $p) + 4 + $ln
+                         - QRinput::estimateBitsModeAn($q); // - 4 - la
+                         
+                    if($dif < 0) {
+                        break;
+                    } else {
+                        $p = $q;
+                    }
+                } else {
+                    $p++;
+                }
+            }
+
+            $run = $p;
+
+            if(!self::isalnumat($this->dataStr, $p)) {
+                $dif = QRinput::estimateBitsModeAn($run) + 4 + $la
+                     + QRinput::estimateBitsMode8(1) // + 4 + l8
+                      - QRinput::estimateBitsMode8($run + 1); // - 4 - l8
+                if($dif > 0) {
+                    return $this->eat8();
+                }
+            }
+
+            $ret = $this->input->append(QR_MODE_AN, $run, str_split($this->dataStr));
+            if($ret < 0)
+                return -1;
+
+            return $run;
+        }
+        
+        //----------------------------------------------------------------------
+        public function eatKanji()
+        {
+            $p = 0;
+            
+            while($this->identifyMode($p) == QR_MODE_KANJI) {
+                $p += 2;
+            }
+            
+            $ret = $this->input->append(QR_MODE_KANJI, $p, str_split($this->dataStr));
+            if($ret < 0)
+                return -1;
+
+            return $run;
+        }
+
+        //----------------------------------------------------------------------
+        public function eat8()
+        {
+            $la = QRspec::lengthIndicator(QR_MODE_AN, $this->input->getVersion());
+            $ln = QRspec::lengthIndicator(QR_MODE_NUM, $this->input->getVersion());
+
+            $p = 1;
+            $dataStrLen = strlen($this->dataStr);
+            
+            while($p < $dataStrLen) {
+                
+                $mode = $this->identifyMode($p);
+                if($mode == QR_MODE_KANJI) {
+                    break;
+                }
+                if($mode == QR_MODE_NUM) {
+                    $q = $p;
+                    while(self::isdigitat($this->dataStr, $q)) {
+                        $q++;
+                    }
+                    $dif = QRinput::estimateBitsMode8($p) // + 4 + l8
+                         + QRinput::estimateBitsModeNum($q - $p) + 4 + $ln
+                         - QRinput::estimateBitsMode8($q); // - 4 - l8
+                    if($dif < 0) {
+                        break;
+                    } else {
+                        $p = $q;
+                    }
+                } else if($mode == QR_MODE_AN) {
+                    $q = $p;
+                    while(self::isalnumat($this->dataStr, $q)) {
+                        $q++;
+                    }
+                    $dif = QRinput::estimateBitsMode8($p)  // + 4 + l8
+                         + QRinput::estimateBitsModeAn($q - $p) + 4 + $la
+                         - QRinput::estimateBitsMode8($q); // - 4 - l8
+                    if($dif < 0) {
+                        break;
+                    } else {
+                        $p = $q;
+                    }
+                } else {
+                    $p++;
+                }
+            }
+
+            $run = $p;
+            $ret = $this->input->append(QR_MODE_8, $run, str_split($this->dataStr));
+            
+            if($ret < 0)
+                return -1;
+
+            return $run;
+        }
+
+        //----------------------------------------------------------------------
+        public function splitString()
+        {
+            while (strlen($this->dataStr) > 0)
+            {
+                if($this->dataStr == '')
+                    return 0;
+
+                $mode = $this->identifyMode(0);
+                
+                switch ($mode) {
+                    case QR_MODE_NUM: $length = $this->eatNum(); break;
+                    case QR_MODE_AN:  $length = $this->eatAn(); break;
+                    case QR_MODE_KANJI:
+                        if ($hint == QR_MODE_KANJI)
+                                $length = $this->eatKanji();
+                        else    $length = $this->eat8();
+                        break;
+                    default: $length = $this->eat8(); break;
+                
+                }
+
+                if($length == 0) return 0;
+                if($length < 0)  return -1;
+                
+                $this->dataStr = substr($this->dataStr, $length);
+            }
+        }
+
+        //----------------------------------------------------------------------
+        public function toUpper()
+        {
+            $stringLen = strlen($this->dataStr);
+            $p = 0;
+            
+            while ($p<$stringLen) {
+                $mode = self::identifyMode(substr($this->dataStr, $p), $this->modeHint);
+                if($mode == QR_MODE_KANJI) {
+                    $p += 2;
+                } else {
+                    if (ord($this->dataStr[$p]) >= ord('a') && ord($this->dataStr[$p]) <= ord('z')) {
+                        $this->dataStr[$p] = chr(ord($this->dataStr[$p]) - 32);
+                    }
+                    $p++;
+                }
+            }
+
+            return $this->dataStr;
+        }
+
+        //----------------------------------------------------------------------
+        public static function splitStringToQRinput($string, QRinput $input, $modeHint, $casesensitive = true)
+        {
+            if(is_null($string) || $string == '\0' || $string == '') {
+                throw new Exception('empty string!!!');
+            }
+
+            $split = new QRsplit($string, $input, $modeHint);
+            
+            if(!$casesensitive)
+                $split->toUpper();
+                
+            return $split->splitString();
+        }
+    }

app/lib/phpqrcode/qrtools.php

@@ -0,0 +1,172 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Toolset, handy and debug utilites.
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+
+    class QRtools {
+    
+        //----------------------------------------------------------------------
+        public static function binarize($frame)
+        {
+            $len = count($frame);
+            foreach ($frame as &$frameLine) {
+                
+                for($i=0; $i<$len; $i++) {
+                    $frameLine[$i] = (ord($frameLine[$i])&1)?'1':'0';
+                }
+            }
+            
+            return $frame;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function tcpdfBarcodeArray($code, $mode = 'QR,L', $tcPdfVersion = '4.5.037')
+        {
+            $barcode_array = array();
+            
+            if (!is_array($mode))
+                $mode = explode(',', $mode);
+                
+            $eccLevel = 'L';
+                
+            if (count($mode) > 1) {
+                $eccLevel = $mode[1];
+            }
+                
+            $qrTab = QRcode::text($code, false, $eccLevel);
+            $size = count($qrTab);
+                
+            $barcode_array['num_rows'] = $size;
+            $barcode_array['num_cols'] = $size;
+            $barcode_array['bcode'] = array();
+                
+            foreach ($qrTab as $line) {
+                $arrAdd = array();
+                foreach(str_split($line) as $char)
+                    $arrAdd[] = ($char=='1')?1:0;
+                $barcode_array['bcode'][] = $arrAdd;
+            }
+                    
+            return $barcode_array;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function clearCache()
+        {
+            self::$frames = array();
+        }
+        
+        //----------------------------------------------------------------------
+        public static function buildCache()
+        {
+			QRtools::markTime('before_build_cache');
+			
+			$mask = new QRmask();
+            for ($a=1; $a <= QRSPEC_VERSION_MAX; $a++) {
+                $frame = QRspec::newFrame($a);
+                if (QR_IMAGE) {
+                    $fileName = QR_CACHE_DIR.'frame_'.$a.'.png';
+                    QRimage::png(self::binarize($frame), $fileName, 1, 0);
+                }
+				
+				$width = count($frame);
+				$bitMask = array_fill(0, $width, array_fill(0, $width, 0));
+				for ($maskNo=0; $maskNo<8; $maskNo++)
+					$mask->makeMaskNo($maskNo, $width, $frame, $bitMask, true);
+            }
+			
+			QRtools::markTime('after_build_cache');
+        }
+
+        //----------------------------------------------------------------------
+        public static function log($outfile, $err)
+        {
+            if (QR_LOG_DIR !== false) {
+                if ($err != '') {
+                    if ($outfile !== false) {
+                        file_put_contents(QR_LOG_DIR.basename($outfile).'-errors.txt', date('Y-m-d H:i:s').': '.$err, FILE_APPEND);
+                    } else {
+                        file_put_contents(QR_LOG_DIR.'errors.txt', date('Y-m-d H:i:s').': '.$err, FILE_APPEND);
+                    }
+                }    
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public static function dumpMask($frame) 
+        {
+            $width = count($frame);
+            for($y=0;$y<$width;$y++) {
+                for($x=0;$x<$width;$x++) {
+                    echo ord($frame[$y][$x]).',';
+                }
+            }
+        }
+        
+        //----------------------------------------------------------------------
+        public static function markTime($markerId)
+        {
+            list($usec, $sec) = explode(" ", microtime());
+            $time = ((float)$usec + (float)$sec);
+            
+            if (!isset($GLOBALS['qr_time_bench']))
+                $GLOBALS['qr_time_bench'] = array();
+            
+            $GLOBALS['qr_time_bench'][$markerId] = $time;
+        }
+        
+        //----------------------------------------------------------------------
+        public static function timeBenchmark()
+        {
+            self::markTime('finish');
+        
+            $lastTime = 0;
+            $startTime = 0;
+            $p = 0;
+
+            echo '<table cellpadding="3" cellspacing="1">
+                    <thead><tr style="border-bottom:1px solid silver"><td colspan="2" style="text-align:center">BENCHMARK</td></tr></thead>
+                    <tbody>';
+
+            foreach($GLOBALS['qr_time_bench'] as $markerId=>$thisTime) {
+                if ($p > 0) {
+                    echo '<tr><th style="text-align:right">till '.$markerId.': </th><td>'.number_format($thisTime-$lastTime, 6).'s</td></tr>';
+                } else {
+                    $startTime = $thisTime;
+                }
+                
+                $p++;
+                $lastTime = $thisTime;
+            }
+            
+            echo '</tbody><tfoot>
+                <tr style="border-top:2px solid black"><th style="text-align:right">TOTAL: </th><td>'.number_format($lastTime-$startTime, 6).'s</td></tr>
+            </tfoot>
+            </table>';
+        }
+        
+    }
+    
+    //##########################################################################
+    
+    QRtools::markTime('start');
+    

app/lib/phpqrcode/tools/merge.bat

@@ -0,0 +1,2 @@
+php ./merge.php
+pause

app/lib/phpqrcode/tools/merge.php

@@ -0,0 +1,70 @@
+<?php
+
+/*
+ * PHP QR Code encoder
+ *
+ * Tool for merging all library files into one, simpler to incorporate.
+ * 
+ * MAKE SURE THAT RESULTING PHPQRCode.php (and its dir) ARE WRITABLE!
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+    $QR_BASEDIR = dirname(__FILE__).DIRECTORY_SEPARATOR.'..'.DIRECTORY_SEPARATOR;
+    $QR_TOOLSDIR = dirname(__FILE__).DIRECTORY_SEPARATOR;
+    
+    $outputFile = $QR_BASEDIR.'phpqrcode.php';
+    
+    // Required libs
+    
+    $fileList = array(
+        $QR_BASEDIR.'qrconst.php',
+        $QR_TOOLSDIR.'merged_config.php',
+        $QR_BASEDIR.'qrtools.php',
+        $QR_BASEDIR.'qrspec.php',
+        $QR_BASEDIR.'qrimage.php',
+        $QR_BASEDIR.'qrinput.php',
+        $QR_BASEDIR.'qrbitstream.php',
+        $QR_BASEDIR.'qrsplit.php',
+        $QR_BASEDIR.'qrrscode.php',
+        $QR_BASEDIR.'qrmask.php',
+        $QR_BASEDIR.'qrencode.php'
+    );
+    
+    $headerFile = $QR_TOOLSDIR.'merged_header.php';
+    $versionFile = $QR_BASEDIR.'VERSION';
+    
+    $outputCode = '';
+    
+    foreach($fileList as $fileName) {
+        $outputCode .= "\n\n".'//---- '.basename($fileName).' -----------------------------'."\n\n";
+        $anotherCode = file_get_contents($fileName);
+        $anotherCode = preg_replace ('/^<\?php/', '', $anotherCode);
+        $anotherCode = preg_replace ('/\?>\*$/', '', $anotherCode);
+        $outputCode .= "\n\n".$anotherCode."\n\n";
+    }
+    
+	$versionDataEx = explode("\n", file_get_contents($versionFile));
+	
+    $outputContents = file_get_contents($headerFile);
+    $outputContents .= "\n\n/*\n * Version: ".trim($versionDataEx[0])."\n * Build: ".trim($versionDataEx[1])."\n */\n\n";
+    $outputContents .= $outputCode;
+    
+    file_put_contents($outputFile, $outputContents);
+    
+    

app/lib/phpqrcode/tools/merge.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+php ./merge.php

app/lib/phpqrcode/tools/merged_config.php

@@ -0,0 +1,17 @@
+<?php
+/*
+ * PHP QR Code encoder
+ *
+ * Config file, tuned-up for merged verion
+ */
+     
+    define('QR_CACHEABLE', false);       // use cache - more disk reads but less CPU power, masks and format templates are stored there
+    define('QR_CACHE_DIR', false);       // used when QR_CACHEABLE === true
+    define('QR_LOG_DIR', false);         // default error logs dir   
+    
+    define('QR_FIND_BEST_MASK', true);                                                          // if true, estimates best mask (spec. default, but extremally slow; set to false to significant performance boost but (propably) worst quality code
+    define('QR_FIND_FROM_RANDOM', 2);                                                       // if false, checks all masks available, otherwise value tells count of masks need to be checked, mask id are got randomly
+    define('QR_DEFAULT_MASK', 2);                                                               // when QR_FIND_BEST_MASK === false
+                                                  
+    define('QR_PNG_MAXIMUM_SIZE',  1024);                                                       // maximum allowed png image width (in pixels), tune to make sure GD and PHP can handle such big images
+                                                  

app/lib/phpqrcode/tools/merged_header.php

@@ -0,0 +1,36 @@
+<?php
+
+/*
+ * PHP QR Code encoder
+ *
+ * This file contains MERGED version of PHP QR Code library.
+ * It was auto-generated from full version for your convenience.
+ *
+ * This merged version was configured to not requre any external files,
+ * with disabled cache, error loging and weker but faster mask matching.
+ * If you need tune it up please use non-merged version.
+ *
+ * For full version, documentation, examples of use please visit:
+ *
+ *    http://phpqrcode.sourceforge.net/
+ *    https://sourceforge.net/projects/phpqrcode/
+ *
+ * PHP QR Code is distributed under LGPL 3
+ * Copyright (C) 2010 Dominik Dzienia <deltalab at poczta dot fm>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+ 
+ 

app/models/StationtypeModel.inc

@@ -0,0 +1,165 @@
+<?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 StationtypeModel.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    abstract class StationtypeModel extends \hhu\z\Model
+    {
+
+
+
+
+        /**
+         * Load a Model.
+         *
+         * @static
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @param   string  $modelName  Name of the StationtypeModel 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\StationtypeModelNotValidException($e->getClassName());
+            }
+            catch(\nre\exceptions\ClassNotFoundException $e) {
+                throw new \hhu\z\exceptions\StationtypeModelNotFoundException($e->getClassName());
+            }
+        }
+
+
+        /**
+         * Instantiate a StationtypeModel (Factory Pattern).
+         *
+         * @static
+         * @param   string  $stationtypeName    Name of the StationtypeModel to instantiate
+         */
+        public static function factory($stationtypeName)
+        {
+            // Determine full classname
+            $className = self::getClassName($stationtypeName);
+
+            // Construct and return Model
+            return new $className();
+        }
+
+
+        /**
+         * Determine the Model-classname for the given Stationtype-name.
+         *
+         * @static
+         * @param   string  $stationtypeName    Stationtype-name to get Model-classname of
+         * @return  string                      Classname for the Stationtype-name
+         */
+        private static function getClassName($stationtypeName)
+        {
+            $className = \nre\core\ClassLoader::concatClassNames(
+                $stationtypeName,
+                \nre\core\ClassLoader::stripClassType(
+                    \nre\core\ClassLoader::stripNamespace(
+                        get_class()
+                    )
+                ),
+                'model'
+            );
+
+
+            return \nre\configs\AppConfig::$app['namespace']."stationtypes\\$className";
+        }
+
+
+        /**
+         * Load the class of a StationtypeModel.
+         *
+         * @static
+         * @throws  \nre\exceptions\ClassNotFoundException
+         * @param   string  $stationtypeName    Name of the StationtypeModel to load
+         * @param   string  $fullClassName      Name of the class to load
+         */
+        private static function loadClass($stationtypeName, $fullClassName)
+        {
+            // Determine folder to look in
+            $className = explode('\\', $fullClassName);
+            $className = array_pop($className);
+
+            // Determine filename
+            $fileName = ROOT.DS.
+                \nre\configs\AppConfig::$dirs['stationtypes'].DS.
+                strtolower($stationtypeName).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 StationtypeModel-class.
+         *
+         * @static
+         * @throws  \nre\exceptions\ClassNotValidException
+         * @param   string  $className          Name of the class to check
+         * @param   string  $parentClassName    Name of the parent class
+         */
+        public static function checkClass($className, $parentClassName)
+        {
+            // Check if class is subclass of parent class
+            if(!is_subclass_of($className, $parentClassName)) {
+                throw new \nre\exceptions\ClassNotValidException(
+                    $className
+                );
+            }
+        }
+
+
+
+
+        /**
+         * Construct a new StationtypeModel.
+         *
+         * @throws  \nre\exceptions\DatamodelException
+         * @throws  \nre\exceptions\DriverNotFoundException
+         * @throws  \nre\exceptions\DriverNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotValidException
+         * @throws  \hhu\z\exceptions\StationtypeModelNotFoundException
+         */
+        public function __construct()
+        {
+            parent::__construct();
+        }
+
+    }
+
+?>

app/views/StationtypeView.inc

@@ -0,0 +1,79 @@
+<?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 StationtypeView.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class StationtypeView extends \nre\core\View
+    {
+
+
+
+
+        /**
+         * Load and instantiate the StationtypeView of a StationtypeAgent.
+         *
+         * @throws  \nre\exceptions\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 StationtypeView($layoutName, $agentName, $action, $isToplevel);
+        }
+
+
+
+
+        /**
+         * Construct a new StationtypeView.
+         *
+         * @throws  \nre\exceptions\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['stationtypes'].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;
+        }
+
+    }
+
+?>

configs/AppConfig.inc

@@ -71,6 +71,7 @@
             'media'             => 'media',
             'seminarymedia'     => 'seminarymedia',
             'questtypes'        => 'questtypes',
+            'stationtypes'      => 'stationtypes',
             'temporary'         => 'tmp',
             'uploads'           => 'uploads',
             'seminaryuploads'   => 'seminaryuploads'
@@ -304,6 +305,10 @@
             array('^charactergroupsquests/([^/]+)/([^/]+)/create/?$',                       'charactergroupsquests/create/$1/$2',   true),
             array('^charactergroupsquests/([^/]+)/([^/]+)/([^/]+)/?$',                      'charactergroupsquests/quest/$1/$2/$3', true),
             array('^charactergroupsquests/([^/]+)/([^/]+)/([^/]+)/(edit|delete|manage)/?$', 'charactergroupsquests/$4/$1/$2/$3',    true),
+            array('^charactergroupsqueststations/([^/]+)/([^/]+)/([^/]+)/?$',                                   'charactergroupsqueststations/index/$1/$2/$3?layout=ajax',  true),
+            array('^charactergroupsqueststations/([^/]+)/([^/]+)/([^/]+)/create/?$',                            'charactergroupsqueststations/create/$1/$2/$3',             true),
+            array('^charactergroupsqueststations/([^/]+)/([^/]+)/([^/]+)/([^/]+)/(edit|edittask|delete)/?$',    'charactergroupsqueststations/$5/$1/$2/$3/$4',              true),
+            array('^charactergroupsqueststations/([^/]+)/([^/]+)/([^/]+)/([^/]+)/?$',                           'charactergroupsqueststations/station/$1/$2/$3/$4',         true),
             array('^achievements/([^/]+)/(create|manage)/?$',                                   'achievements/$2/$1',       true),
             array('^achievements/([^/]+)/([^/]+)/(edit|conditions|moveup|movedown|delete)/?$',  'achievements/$3/$1/$2',    true),
             array('^achievements/([^/]+)/?$',                                                   'achievements/index/$1',    true),
@@ -316,7 +321,8 @@
             array('^pages/([^/]+)/(edit|delete)$',          'pages/$2/$1',      true),
             array('^pages/(?!(create|edit|delete))/?',      'pages/page/$1',    true),
             array('^media/(.*)$',   'media/$1?layout=binary',   false),
-            array('^uploads/(.*)$', 'uploads/$1?layout=binary', false)
+            array('^uploads/(.*)$', 'uploads/$1?layout=binary', false),
+            array('^qrcodes/(.*)$', 'qrcodes/$1?layout=binary', false)
         );
 
 
@@ -358,6 +364,9 @@
             array('^charactergroupsquests/create/([^/]+)/([^/]+)/?$',                       'charactergroupsquests/$1/$2/create',   true),
             array('^charactergroupsquests/quest/(.*)$',                                     'charactergroupsquests/$1',             true),
             array('^charactergroupsquests/(edit|delete|manage)/([^/]+)/([^/]+)/([^/]+)$',   'charactergroupsquests/$2/$3/$4/$1',    true),
+            array('^charactergroupsqueststations/index/(.*)$',                          'charactergroupsqueststations/$1',      true),
+            array('^charactergroupsqueststations/station/(.*)$',                        'charactergroupsqueststations/$1',      true),
+            array('^charactergroupsqueststations/(create|edit|edittask|delete)/(.*)$',  'charactergroupsqueststations/$2/$1',   true),
             array('^achievements/index/(.*)$',                                      'achievements/$1',      true),
             array('^achievements/(create|manage)/(.*)$',                            'achievements/$2/$1',   true),
             array('^achievements/(edit|conditions|moveup|movedown|delete)/(.*)$',   'achievements/$2/$1',   true),

controllers/CharactergroupsquestsController.inc

@@ -25,7 +25,7 @@
          *
          * @var array
          */
-        public $models = array('seminaries', 'charactergroups', 'charactergroupsquests', 'media', 'questgroups', 'uploads');
+        public $models = array('seminaries', 'charactergroups', 'charactergroupsquests', 'charactergroupsqueststations', 'media', 'questgroups', 'uploads');
         /**
          * Required components
          *
@@ -78,6 +78,30 @@
             $questgroup = $this->Questgroups->getQuestgroupById($quest['questgroups_id']);
             $questgroup['entered'] = $this->Questgroups->hasCharacterEnteredQuestgroup($questgroup['id'], self::$character['id']);
 
+            // Get Character group
+            $charactergroup = null;
+            $character = $this->Characters->getCharacterForUserAndSeminary($this->Auth->getUserId(), $seminary['id']);
+            $charactergroups = $this->Charactergroups->getGroupsForCharacter($character['id']);
+            if(!empty($charactergroups)) {
+                // TODO Multiple Character groups
+                $charactergroup = $charactergroups[0];
+            }
+
+            // Get Stations
+            $stations = null;
+            if(count(array_intersect(array('admin', 'moderator'), \hhu\z\controllers\SeminaryController::$character['characterroles'])) > 0) {
+                $stations = $this->Charactergroupsqueststations->getStationsForQuest($quest['id']);
+            }
+            elseif(!is_null($charactergroup)) {
+                $stations = $this->Charactergroupsqueststations->getStationsForQuestAndGroup($quest['id'], $charactergroup['id']);
+                foreach($stations as &$station) {
+                    $station['solved'] = $this->Charactergroupsqueststations->hasCharactergroupSolvedStation(
+                        $station['id'],
+                        $charactergroup['id']
+                    );
+                }
+            }
+
             // Get Character groups-groups
             $groups = $this->Charactergroups->getGroupsForQuest($quest['id']);
 
@@ -98,6 +122,7 @@
             $this->set('groupsgroup', $groupsgroup);
             $this->set('quest', $quest);
             $this->set('questgroup', $questgroup);
+            $this->set('stations', $stations);
             $this->set('groups', $groups);
             $this->set('uploads', $uploads);
         }

controllers/CharactergroupsqueststationsController.inc

@@ -0,0 +1,937 @@
+<?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;
+
+
+    /**
+     * Controller of the CharactergroupsqueststationAgent to display Character
+     * groups Quest stations.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class CharactergroupsqueststationsController extends \hhu\z\controllers\SeminaryController
+    {
+        /**
+         * Required models
+         *
+         * @var array
+         */
+        public $models = array('seminaries', 'charactergroups', 'charactergroupsquests', 'charactergroupsqueststations', 'stationtypes', 'media');
+        /**
+         * Required components
+         *
+         * @var array
+         */
+        public $components = array('validation');
+        /**
+         * User permissions
+         *
+         * @var array
+         */
+        public $permissions = array(
+            'index'     => array('admin', 'moderator', 'user'),
+            'station'   => array('admin', 'moderator', 'user')
+        );
+        /**
+         * User seminary permissions
+         *
+         * @var array
+         */
+        public $seminaryPermissions = array(
+            'index'     => array('admin', 'moderator', 'user'),
+            'station'   => array('admin', 'moderator', 'user')
+        );
+
+
+
+
+        /**
+         * Action: index.
+         * 
+         * Show all stations of a Character groups Quest.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         */
+        public function index($seminaryUrl, $groupsgroupUrl, $questUrl)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups-group Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get Character group
+            $charactergroup = null;
+            $character = $this->Characters->getCharacterForUserAndSeminary($this->Auth->getUserId(), $seminary['id']);
+            $charactergroups = $this->Charactergroups->getGroupsForCharacter($character['id']);
+            if(!empty($charactergroups)) {
+                // TODO Multiple Character groups
+                $charactergroup = $charactergroups[0];
+            }
+
+            // Get Stations
+            $stations = null;
+            if(count(array_intersect(array('admin', 'moderator'), \hhu\z\controllers\SeminaryController::$character['characterroles'])) > 0) {
+                $stations = $this->Charactergroupsqueststations->getStationsForQuest($quest['id']);
+            }
+            elseif(!is_null($charactergroup)) {
+                $stations = $this->Charactergroupsqueststations->getStationsForQuestAndGroup($quest['id'], $charactergroup['id']);
+            }
+
+
+            // Pass data to view
+            $this->set('stations', $stations);
+            $this->set('hasgroup', !is_null($charactergroup));
+        }
+
+
+        /**
+         * Action: station.
+         *
+         * Show a station of a Character groups Quest.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         * @param   string  $stationUrl     URL of station
+         */
+        public function station($seminaryUrl, $groupsgroupUrl, $questUrl, $stationUrl)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups-group Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get Station
+            $station = $this->Charactergroupsqueststations->getStationByUrl($quest['id'], $stationUrl);
+            if(!is_null($station['stationpicture_id'])) {
+                $station['picture'] = $this->Media->getSeminaryMediaById($station['stationpicture_id']);
+            }
+
+            // Get Character group
+            $charactergroup = null;
+            $character = $this->Characters->getCharacterForUserAndSeminary($this->Auth->getUserId(), $seminary['id']);
+            $charactergroups = $this->Charactergroups->getGroupsForCharacter($character['id']);
+            if(!empty($charactergroups)) {
+                // TODO Multiple Character groups
+                $charactergroup = $charactergroups[0];
+            }
+
+            // TODO Check permissions
+
+            // Set status “entered”
+            if(!is_null($charactergroup)) {
+                $this->Charactergroupsqueststations->setStationEntered($station['id'], $charactergroup['id']);
+            }
+
+            // Get Character groups-groups
+            $groups = null;
+            if(count(array_intersect(array('admin', 'moderator'), \hhu\z\controllers\SeminaryController::$character['characterroles'])) > 0)
+            {
+                $groups = $this->Charactergroups->getGroupsForQueststation($station['id']);
+                foreach($groups as &$group) {
+                    $group['solved'] = $this->Charactergroupsqueststations->hasCharactergroupSolvedStation(
+                        $station['id'],
+                        $group['id']
+                    );
+                }
+            }
+
+            // Task
+            $task = null;
+            $stationtype = $this->Stationtypes->getStationtypeById($station['stationtype_id']);
+            if(!is_null($stationtype['classname'])) {
+                $task = $this->renderTask($stationtype['classname'], $seminary, $groupsgroup, $quest, $station, $charactergroup);
+            }
+            else
+            {
+                // Mark Station as solved
+                if(!is_null($charactergroup)) {
+                    $this->Charactergroupsqueststations->setStationSolved($station['id'], $charactergroup['id']);
+                }
+            }
+
+            // Status
+            $solved = false;
+            $tried = false;
+            if(!is_null($charactergroup)) {
+                $solved = $this->Charactergroupsqueststations->hasCharactergroupSolvedStation($station['id'], $charactergroup['id']);
+                if(!$solved) {
+                    $tried = $this->Charactergroupsqueststations->hasCharactergroupTriedStation($station['id'], $charactergroup['id']);
+                }
+            }
+
+
+            // Set title
+            $this->addTitle($station['title']);
+            $this->addTitle($quest['title']);
+            $this->addTitle($groupsgroup['name']);
+            $this->addTitle($seminary['title']);
+
+            // Pass data to view
+            $this->set('seminary', $seminary);
+            $this->set('groupsgroup', $groupsgroup);
+            $this->set('quest', $quest);
+            $this->set('station', $station);
+            $this->set('task', $task);
+            $this->set('groups', $groups);
+            $this->set('solved', $solved);
+            $this->set('tried', $tried);
+        }
+
+
+        /**
+         * Action: create.
+         *
+         * Create a new Character groups Quest Station for a Character
+         * groups Quest.
+         *
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         */
+        public function create($seminaryUrl, $groupsgroupUrl, $questUrl)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups-group Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get Quest types
+            $stationtypes = $this->Stationtypes->getStationtypes();
+            foreach($stationtypes as &$stationtype) {
+                $stationtype['selected'] = false;
+            }
+
+            // Get allowed mimetypes
+            $mimetypes = \nre\configs\AppConfig::$mimetypes['icons'];
+
+            // Values
+            $title = '';
+            $prolog = '';
+            $task = '';
+            $longitude = null;
+            $latitude = null;
+            $rightText = '';
+            $wrongText = '';
+            $fields = array('title');
+            $validation = array();
+
+            // Create a new Station
+            if($this->request->getRequestMethod() == 'POST' && !is_null($this->request->getPostParam('create')))
+            {
+                // Get params and validate them
+                $validation = $this->Validation->validateParams($this->request->getPostParams(), $fields);
+                $title = $this->request->getPostParam('title');
+                if($this->Charactergroupsqueststations->stationTitleExists($quest['id'], $title)) {
+                    $validation = $this->Validation->addValidationResult($validation, 'title', 'exist', true);
+                }
+                $prolog = $this->request->getPostParam('prolog');
+                $task = $this->request->getPostParam('task');
+                $longitude = $this->request->getPostParam('longitude');
+                $latitude = $this->request->getPostParam('latitude');
+                $rightText = $this->request->getPostParam('rightText');
+                $wrongText = $this->request->getPostParam('wrongText');
+
+                // Validate Stationtype
+                $stationtypeIndex = null;
+                foreach($stationtypes as $index => &$stationtype)
+                {
+                    $stationtype['selected'] = ($stationtype['url'] == $this->request->getPostParam('stationtype'));
+                    if($stationtype['selected']) {
+                        $stationtypeIndex = $index;
+                    }
+                }
+                if(is_null($stationtypeIndex)) {
+                    throw new \nre\exceptions\ParamsNotValidException($stationtype);
+                }
+
+                // Validate icon
+                $icon = null;
+                if(!empty($_FILES) && array_key_exists('icon', $_FILES) && $_FILES['icon']['error'] != UPLOAD_ERR_NO_FILE)
+                {
+                    $icon = $_FILES['icon'];
+
+                    // Check error
+                    if($icon['error'] !== UPLOAD_ERR_OK) {
+                        $validation = $this->Validation->addValidationResult($validation, 'icon', 'error', $icon['error']);
+                    }
+
+                    // Check mimetype
+                    $mediaMimetype = null;
+                    $icon['mimetype'] = \hhu\z\Utils::getMimetype($icon['tmp_name'], $icon['type']);
+                    foreach($mimetypes as &$mimetype) {
+                        if($mimetype['mimetype'] == $icon['mimetype']) {
+                            $mediaMimetype = $mimetype;
+                            break;
+                        }
+                    }
+                    if(is_null($mediaMimetype)) {
+                        $validation = $this->Validation->addValidationResult($validation, 'icon', 'mimetype', $icon['mimetype']);
+                    }
+                    elseif($icon['size'] > $mediaMimetype['size']) {
+                        $validation = $this->Validation->addValidationResult($validation, 'icon', 'size', $mediaMimetype['size']);
+                    }
+                }
+
+                // Create new Station
+                if($validation === true)
+                {
+                    $stationId = $this->Charactergroupsqueststations->createStation(
+                        $quest['id'],
+                        $stationtypes[$stationtypeIndex]['id'],
+                        $title,
+                        $prolog,
+                        $task,
+                        $latitude,
+                        $longitude,
+                        $rightText,
+                        $wrongText
+                    );
+                    $station = $this->Charactergroupsqueststations->getStationById($stationId);
+
+                    // Upload icon
+                    if(!is_null($icon))
+                    {
+                        $mediaId = $this->Media->createQuestMedia(
+                            $this->Auth->getUserId(),
+                            $seminary['id'],
+                            sprintf('charactergroupsqueststation-%s', $station['url']),
+                            '',
+                            $icon['mimetype'],
+                            $icon['tmp_name']
+                        );
+                        if($mediaId !== false) {
+                            $this->Charactergroupsqueststations->setPictureForStation($station['id'], $mediaId);
+                        }
+                    }
+
+                    // Redirect to Station page
+                    $this->redirect(
+                        $this->linker->link(
+                            array(
+                                'station',
+                                $seminary['url'],
+                                $groupsgroup['url'],
+                                $quest['url'],
+                                $station['url']
+                            ),
+                            1
+                        )
+                    );
+                }
+            }
+
+
+            // Set title
+            $this->addTitleLocalized('Create Station');
+            $this->addTitle($quest['title']);
+            $this->addTitle($groupsgroup['name']);
+            $this->addTitle($seminary['title']);
+
+            // Pass data to view
+            $this->set('seminary', $seminary);
+            $this->set('groupsgroup', $groupsgroup);
+            $this->set('quest', $quest);
+            $this->set('title', $title);
+            $this->set('prolog', $prolog);
+            $this->set('task', $task);
+            $this->set('longitude', $longitude);
+            $this->set('latitude', $latitude);
+            $this->set('righttext', $rightText);
+            $this->set('wrongtext', $wrongText);
+            $this->set('mimetypes', $mimetypes);
+            $this->set('stationtypes', $stationtypes);
+            $this->set('validation', $validation);
+        }
+
+
+        /**
+         * Action: edit.
+         *
+         * Edit a Station of a Character groups Quest.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         * @param   string  $stationUrl     URL of station
+         */
+        public function edit($seminaryUrl, $groupsgroupUrl, $questUrl, $stationUrl)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups-group Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get Station
+            $station = $this->Charactergroupsqueststations->getStationByUrl($quest['id'], $stationUrl);
+
+            // Get Quest types
+            $stationtypes = $this->Stationtypes->getStationtypes();
+            foreach($stationtypes as &$stationtype) {
+                $stationtype['selected'] = ($stationtype['id'] == $station['stationtype_id']);
+            }
+
+            // Get allowed mimetypes
+            $mimetypes = \nre\configs\AppConfig::$mimetypes['icons'];
+
+            // Values
+            $title = $station['title'];
+            $prolog = $station['prolog'];
+            $task = $station['task'];
+            $longitude = $station['longitude'];
+            $latitude = $station['latitude'];
+            $rightText = $station['righttext'];
+            $wrongText = $station['wrongtext'];
+            $fields = array('title');
+            $validation = array();
+
+            // Check request method
+            if($this->request->getRequestMethod() == 'POST' && (!is_null($this->request->getPostParam('edit')) || !is_null($this->request->getPostParam('edit-task'))))
+            {
+                // Get params and validate them
+                $validation = $this->Validation->validateParams($this->request->getPostParams(), $fields);
+                $title = $this->request->getPostParam('title');
+                if($this->Charactergroupsqueststations->stationTitleExists($quest['id'], $title, $station['id'])) {
+                    $validation = $this->Validation->addValidationResult($validation, 'title', 'exist', true);
+                }
+                $prolog = $this->request->getPostParam('prolog');
+                $task = $this->request->getPostParam('task');
+                $longitude = $this->request->getPostParam('longitude');
+                $latitude = $this->request->getPostParam('latitude');
+                $rightText = $this->request->getPostParam('rightText');
+                $wrongText = $this->request->getPostParam('wrongText');
+
+                // Validate Stationtype
+                $stationtypeIndex = null;
+                foreach($stationtypes as $index => &$stationtype)
+                {
+                    $stationtype['selected'] = ($stationtype['url'] == $this->request->getPostParam('stationtype'));
+                    if($stationtype['selected']) {
+                        $stationtypeIndex = $index;
+                    }
+                }
+                if(is_null($stationtypeIndex)) {
+                    throw new \nre\exceptions\ParamsNotValidException($stationtype);
+                }
+
+                // Validate icon
+                $icon = null;
+                if(!empty($_FILES) && array_key_exists('icon', $_FILES) && $_FILES['icon']['error'] != UPLOAD_ERR_NO_FILE)
+                {
+                    $icon = $_FILES['icon'];
+
+                    // Check error
+                    if($icon['error'] !== UPLOAD_ERR_OK) {
+                        $validation = $this->Validation->addValidationResult($validation, 'icon', 'error', $icon['error']);
+                    }
+
+                    // Check mimetype
+                    $mediaMimetype = null;
+                    $icon['mimetype'] = \hhu\z\Utils::getMimetype($icon['tmp_name'], $icon['type']);
+                    foreach($mimetypes as &$mimetype) {
+                        if($mimetype['mimetype'] == $icon['mimetype']) {
+                            $mediaMimetype = $mimetype;
+                            break;
+                        }
+                    }
+                    if(is_null($mediaMimetype)) {
+                        $validation = $this->Validation->addValidationResult($validation, 'icon', 'mimetype', $icon['mimetype']);
+                    }
+                    elseif($icon['size'] > $mediaMimetype['size']) {
+                        $validation = $this->Validation->addValidationResult($validation, 'icon', 'size', $mediaMimetype['size']);
+                    }
+                }
+
+                // Edit Station
+                if($validation === true)
+                {
+                    $this->Charactergroupsqueststations->editStation(
+                        $station['id'],
+                        $stationtypes[$stationtypeIndex]['id'],
+                        $title,
+                        $prolog,
+                        $task,
+                        $latitude,
+                        $longitude,
+                        $rightText,
+                        $wrongText
+                    );
+                    $station = $this->Charactergroupsqueststations->getStationById($station['id']);
+
+                    // Upload icon
+                    if(!is_null($icon))
+                    {
+                        $mediaId = $this->Media->createQuestMedia(
+                            $this->Auth->getUserId(),
+                            $seminary['id'],
+                            sprintf('charactergroupsqueststation-%s', $station['url']),
+                            '',
+                            $icon['mimetype'],
+                            $icon['tmp_name']
+                        );
+                        if($mediaId !== false) {
+                            $this->Charactergroupsqueststations->setPictureForStation($station['id'], $mediaId);
+                        }
+                    }
+
+                    // Redirect
+                    if(!is_null($this->request->getPostParam('edit-task'))) {
+                        // To task editing
+                        $this->redirect(
+                            $this->linker->link(
+                                array(
+                                    'edittask',
+                                    $seminary['url'],
+                                    $groupsgroup['url'],
+                                    $quest['url'],
+                                    $station['url']
+                                ),
+                                1
+                            )
+                        );
+                    }
+                    else {
+                        // To Station page
+                        $this->redirect(
+                            $this->linker->link(
+                                array(
+                                    'station',
+                                    $seminary['url'],
+                                    $groupsgroup['url'],
+                                    $quest['url'],
+                                    $station['url']
+                                ),
+                                1
+                            )
+                        );
+                    }
+                }
+            }
+
+
+            // Set title
+            $this->addTitleLocalized('Edit Station');
+            $this->addTitle($station['title']);
+            $this->addTitle($quest['title']);
+            $this->addTitle($groupsgroup['name']);
+            $this->addTitle($seminary['title']);
+
+            // Pass data to view
+            $this->set('seminary', $seminary);
+            $this->set('groupsgroup', $groupsgroup);
+            $this->set('quest', $quest);
+            $this->set('title', $title);
+            $this->set('prolog', $prolog);
+            $this->set('task', $task);
+            $this->set('longitude', $longitude);
+            $this->set('latitude', $latitude);
+            $this->set('righttext', $rightText);
+            $this->set('wrongtext', $wrongText);
+            $this->set('mimetypes', $mimetypes);
+            $this->set('stationtypes', $stationtypes);
+            $this->set('validation', $validation);
+        }
+
+
+        /**
+         * TODO Action: edittask.
+         *
+         * Edit the task of a Character groups Quest Station.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         * @param   string  $stationUrl     URL of station
+         */
+        public function edittask($seminaryUrl, $groupsgroupUrl, $questUrl, $stationUrl)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups-group Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get Station
+            $station = $this->Charactergroupsqueststations->getStationByUrl($quest['id'], $stationUrl);
+
+            // Render editing task
+            $task = null;
+            $stationtype = $this->Stationtypes->getStationtypeById($station['stationtype_id']);
+            if(!is_null($stationtype['classname'])) {
+                $task = $this->renderTaskEditing($stationtype['classname'], $seminary, $groupsgroup, $quest, $station);
+            }
+
+
+            // Set title
+            $this->addTitleLocalized('Edit Station task');
+            $this->addTitle($station['title']);
+            $this->addTitle($quest['title']);
+            $this->addTitle($groupsgroup['name']);
+            $this->addTitle($seminary['title']);
+
+            // Pass data to view
+            $this->set('seminary', $seminary);
+            $this->set('groupsgroup', $groupsgroup);
+            $this->set('quest', $quest);
+            $this->set('task', $task);
+        }
+
+
+        /**
+         * Action: delete.
+         *
+         * Delete a Station of a Character groups Quest.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         * @param   string  $stationUrl     URL of station
+         */
+        public function delete($seminaryUrl, $groupsgroupUrl, $questUrl, $stationUrl)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups-group Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get Station
+            $station = $this->Charactergroupsqueststations->getStationByUrl($quest['id'], $stationUrl);
+
+            // Check request method
+            if($this->request->getRequestMethod() == 'POST')
+            {
+                // Check confirmation
+                if(!is_null($this->request->getPostParam('delete')))
+                {
+                    // Delete seminary
+                    $this->Charactergroupsqueststations->deleteStation(
+                        $station['id']
+                    );
+
+                    // Redirect to overview
+                    $this->redirect(
+                        $this->linker->link(
+                            array(
+                                'charactergroupsquests',
+                                'quest',
+                                $seminary['url'],
+                                $groupsgroup['url'],
+                                $quest['url']
+                            ),
+                            0, true, null, true, 'stations'
+                        )
+                    );
+                }
+
+                // Redirect to entry
+                $this->redirect(
+                    $this->linker->link(
+                        array(
+                            'station',
+                            $seminary['url'],
+                            $groupsgroup['url'],
+                            $quest['url'],
+                            $station['url']
+                        ),
+                        1
+                    )
+                );
+            }
+
+
+            // Set title
+            $this->addTitleLocalized('Delete Station');
+            $this->addTitle($station['title']);
+            $this->addTitle($quest['title']);
+            $this->addTitle($groupsgroup['name']);
+            $this->addTitle($seminary['title']);
+
+            // Pass data to view
+            $this->set('seminary', $seminary);
+            $this->set('groupsgroup', $groupsgroup);
+            $this->set('quest', $quest);
+            $this->set('station', $station);
+        }
+
+
+
+
+        /**
+         * Render and handle the task of a Station.
+         *
+         * @param   string  $stationtypeClassname   Name of the class for the Stationtype of a Station
+         * @param   array   $seminary               Seminary data
+         * @param   array   $questgroup             Questgroup data
+         * @param   array   $quest                  Quest data
+         * @param   array   $station                Station data
+         * @param   array   $charactergroup         Charactergroup data
+         * @return  string                          Rendered output
+         */
+        private function renderTask($stationtypeClassname, $seminary, $groupsgroup, $quest, $station, $charactergroup)
+        {
+            $task = null;
+            try {
+                // Generate request and response
+                $request = clone $this->request;
+                $response = $this->createStationtypeResponse('quest', $seminary, $groupsgroup, $quest, $station, $charactergroup);
+
+                // Load Stationtype Agent
+                $stationtypeAgent = $this->loadStationtypeAgent($stationtypeClassname, $request, $response);
+
+                // Solve Quest
+                if($this->request->getRequestMethod() == 'POST' && !is_null($this->request->getPostParam('submit')))
+                {
+                    // Get user answers
+                    $answer = $this->request->getPostParam('answer');
+
+                    // Save answers in database
+                    try {
+                        // save answer
+                        if(!is_null($charactergroup)) {
+                            if(!$this->Charactergroupsqueststations->hasCharactergroupSolvedStation($station['id'], $charactergroup['id'])) {
+                                $stationtypeAgent->saveAnswer($seminary, $groupsgroup, $quest, $station, $charactergroup, $answer);
+                            }
+                        }
+
+                        // Match answer with correct one
+                        $status = $stationtypeAgent->matchAnswer(
+                            $seminary,
+                            $groupsgroup,
+                            $quest,
+                            $station,
+                            $charactergroup,
+                            $answer
+                        );
+                        if($status === true)
+                        {
+                            if(!is_null($charactergroup))
+                            {
+                                // Mark Station as solved
+                                $this->Charactergroupsqueststations->setStationSolved($station['id'], $charactergroup['id']);
+                            }
+
+                            // Redirect
+                            $this->redirect($this->linker->link(array(), 6, true, null, false, 'task'));
+                        }
+                        elseif($status === false)
+                        {
+                            if(!is_null($charactergroup)) {
+                                // Mark Station as unsolved
+                                $this->Charactergroupsqueststations->setStationUnsolved(
+                                    $station['id'],
+                                    $charactergroup['id']
+                                );
+                            }
+
+                            // Redirect
+                            $this->redirect($this->linker->link(array(), 6, true, null, false, 'task'));
+                        }
+                        else {
+                            // Redirect
+                            $this->redirect($this->linker->link(array(), 6, true, null, false, 'task'));
+                        }
+                    }
+                    catch(\hhu\z\exceptions\SubmissionNotValidException $e) {
+                        $response->addParam($e);
+                    }
+                }
+
+                // Render Task
+                $task = $this->runStationtypeAgent($stationtypeAgent, $request, $response);
+            }
+            catch(\nre\exceptions\ViewNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\nre\exceptions\ActionNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeModelNotValidException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeModelNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeControllerNotValidException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeControllerNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeAgentNotValidException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\stationtypeAgentNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+
+
+            // Return rendered output
+            return $task;
+        }
+
+
+        /**
+         * Render editing of a Station task.
+         *
+         * @param   string  $stationtypeClassname   Name of the class for the Stationtype of a Station
+         * @param   array   $seminary               Seminary data
+         * @param   array   $groupsgroup            Groupsgroup data
+         * @param   array   $quest                  Quest data
+         * @param   array   $station                Station data
+         * @return  string                          Rendered output
+         */
+        private function renderTaskEditing($stationtypeClassname, $seminary, $groupsgroup, $quest, $station)
+        {
+            $task = null;
+            try {
+                // Generate request and response
+                $request = clone $this->request;
+                $response = $this->createStationtypeResponse('edittask', $seminary, $groupsgroup, $quest, $station);
+
+                // Load Stationtype Agent
+                $stationtypeAgent = $this->loadStationtypeAgent($stationtypeClassname, $request, $response);
+
+                // Render Task
+                $task = $this->runStationtypeAgent($stationtypeAgent, $request, $response);
+            }
+            catch(\nre\exceptions\ViewNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\nre\exceptions\ActionNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeModelNotValidException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeModelNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeControllerNotValidException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeControllerNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\StationtypeAgentNotValidException $e) {
+                $task = $e->getMessage();
+            }
+            catch(\hhu\z\exceptions\stationtypeAgentNotFoundException $e) {
+                $task = $e->getMessage();
+            }
+
+
+            // Return rendered output
+            return $task;
+        }
+
+
+        /**
+         * Create a response for the Stationtype rendering.
+         *
+         * @param   string  $action     Action to run
+         * @param   mixed   $param      Additional parameters to add to the response
+         * @return  \nre\core\Response  Generated response
+         */
+        private function createStationtypeResponse($action, $param1)
+        {
+            // Clone current response
+            $response = clone $this->response;
+            // Clear parameters
+            $response->clearParams(1);
+
+            // Add Action
+            $response->addParams(
+                null,
+                $action
+            );
+
+            // Add additional parameters
+            foreach(array_slice(func_get_args(), 1) as $param) {
+                $response->addParam($param);
+            }
+
+
+            // Return response
+            return $response;
+        }
+
+
+        /**
+         * Load and construct the StationtypeAgent for a Stationtype.
+         *
+         * @param   string                  $stationtypeClassname   Name of the class for the Stationtype of a Station
+         * @param   \nre\core\Request       $request                Request
+         * @param   \nre\core\Response      $response               Response
+         * @return  \hhu\z\agents\StationtypeAgent                    Stationtype Agent
+         */
+        private function loadStationtypeAgent($stationtypeClassname, $request, $response)
+        {
+            // Load Agent
+            \hhu\z\agents\StationtypeAgent::load($stationtypeClassname);
+
+
+            // Construct and return Agent
+            return \hhu\z\agents\StationtypeAgent::factory($stationtypeClassname, $request, $response);
+        }
+
+
+        /**
+         * Run and render the Agent for a StationtypeAgent and return ist output.
+         *
+         * @param   \nre\core\Agent     $stationtypeAgent   StationtypeAgent to run and render
+         * @param   \nre\core\Request   $request            Request
+         * @param   \nre\core\Response  $response           Response
+         * @return  string                                  Rendered output
+         */
+        private function runStationtypeAgent($stationtypeAgent, $request, $response)
+        {
+            // Run Agent
+            $stationtypeAgent->run($request, $response);
+
+
+            // Render and return output
+            return $stationtypeAgent->render();
+        }
+
+    }
+
+?>

controllers/QrController.inc

@@ -0,0 +1,67 @@
+<?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;
+
+
+    /**
+     * Controller of the QrAgent to redirect to a page from a (short) QR-code
+     * link.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class QrController extends \hhu\z\controllers\SeminaryController
+    {
+        /**
+         * Required models
+         *
+         * @var array
+         */
+        public $models = array('seminaries', 'charactergroups', 'charactergroupsquests', 'charactergroupsqueststations');
+
+
+
+
+        /**
+         * Action: cgqs.
+         *
+         * Redirect to a Character groups Quest Station.
+         *
+         * @param   int $stationId  ID of Character groups Quest Station
+         */
+        public function cgqs($stationId)
+        {
+            // Get station
+            $station = $this->Charactergroupsqueststations->getStationById($stationId);
+
+            // Get Character groups Quests
+            $quest = $this->Charactergroupsquests->getQuestById($station['charactergroupsquest_id']);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupById($quest['charactergroupsgroup_id']);
+
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryById($groupsgroup['seminary_id']);
+
+            // Redirect
+            $this->redirect($this->linker->link(array(
+                'charactergroupsqueststations',
+                'station',
+                $seminary['url'],
+                $groupsgroup['url'],
+                $quest['url'],
+                $station['url']
+            )));
+        }
+
+    }
+
+?>

controllers/QrcodesController.inc

@@ -0,0 +1,269 @@
+<?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;
+
+
+    /**
+     * Controller of the QrcodeAgent to generate and show QR-codes.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class QrcodesController extends \hhu\z\controllers\SeminaryController
+    {
+        /**
+         * Required models
+         *
+         * @var array
+         */
+        public $models = array('seminaries', 'charactergroups', 'charactergroupsquests', 'charactergroupsqueststations');
+
+
+
+
+        /**
+         * Prefilter.
+         *
+         * @param   \nre\core\Request   $request    Current request
+         * @param   \nre\core\Response  $response   Current response
+         */
+        public function preFilter(\nre\core\Request $request, \nre\core\Response $response)
+        {
+            parent::preFilter($request, $response);
+
+            // Set headers for caching control
+            $response->addHeader("Pragma: public");
+            $response->addHeader("Cache-control: must-revalidate");
+            $response->addHeader("Date: ".gmdate(\DateTime::RFC822));
+        }
+
+
+        /**
+         * Action: charactergroupsqueststation
+         *
+         * Display a QR-code for a Character groups Quest station.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   string  $seminaryUrl    URL-Title of a Seminary
+         * @param   string  $groupsgroupUrl URL-Title of a Character groups-group
+         * @param   string  $questUrl       URL-Title of a Character groups Quest
+         * @param   string  $stationUrl     URL of Character groups Quest station
+         */
+        public function charactergroupsqueststation($seminaryUrl, $groupsgroupUrl, $questUrl, $stationUrl, $size=1)
+        {
+            // Get seminary
+            $seminary = $this->Seminaries->getSeminaryByUrl($seminaryUrl);
+
+            // Get Character groups-group
+            $groupsgroup = $this->Charactergroups->getGroupsgroupByUrl($seminary['id'], $groupsgroupUrl);
+
+            // Get Character groups Quests
+            $quest = $this->Charactergroupsquests->getQuestByUrl($groupsgroup['id'], $questUrl);
+
+            // Get station
+            $station = $this->Charactergroupsqueststations->getStationByUrl($quest['id'], $stationUrl);
+
+            // Generate QR-code
+            $url = $this->linker->link(array('qr', 'cgqs', $station['id']), 0, true, null, true, null, true);
+            $file = $this->generateQRcode($url, $size);
+            if(is_null($file)) {
+                return;
+            }
+
+
+            // Pass data to view
+            $this->set('file', $file);
+        }
+
+
+
+
+        /**
+         * Determine file information and set the HTTP-header for
+         * caching accordingly.
+         *
+         * @param   string  $fileName   Filename
+         * @return  boolean         HTTP-status 304 was set (in cache)
+         */
+        private function setCacheHeaders($fileName)
+        {
+            // Determine last change of file
+            $fileLastModified = gmdate('r', filemtime($fileName));
+
+            // Generate E-Tag
+            $fileEtag = hash('sha256', $fileLastModified.$fileName);
+
+
+            // Set header
+            $this->response->addHeader("Last-Modified: ".$fileLastModified);
+            $this->response->addHeader("Etag: ".$fileEtag);
+            // HTTP-status
+            $headerModifiedSince = $this->request->getServerParam('HTTP_IF_MODIFIED_SINCE');
+            $headerNoneMatch = $this->request->getServerParam('HTTP_IF_NONE_MATCH');
+            if(
+                !is_null($headerModifiedSince) && strtotime($fileLastModified) <= strtotime($headerModifiedSince) &&
+                !is_null($headerNoneMatch) && $headerNoneMatch == $fileEtag
+            ) {
+                $this->response->setExit(true);
+                $this->response->addHeader(\nre\core\WebUtils::getHttpHeader(304));
+
+                return true;
+            }
+
+
+            return false;
+        }
+
+
+        private function generateQRcode($text, $size)
+        {
+            \hhu\z\lib\Phpqrcode::load();
+            \QRcode::png($text, false, QR_ECLEVEL_L, intval($size), 1);
+
+
+            return null;
+        }
+
+
+        /**
+         * Determine the file for a medium and process it if necessary.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @throws  \nre\exceptions\ParamsNotValidException
+         * @param   array   $media  Medium to get file for
+         * @param   string  $action Action for processing the media
+         * @return  object      File for the medium (or null if medium is cached)
+         */
+        private function getMediaFile($media, $action=null)
+        {
+            // Get format
+            $format = explode('/', $media['mimetype']);
+            $format = $format[1];
+
+            // Set content-type
+            $this->response->addHeader("Content-type: ".$media['mimetype']."");
+
+            // Set filename
+            $media['filename'] = ROOT.DS.\nre\configs\AppConfig::$dirs['seminarymedia'].DS.$media['id'];
+            if(!file_exists($media['filename'])) {
+                throw new \nre\exceptions\IdNotFoundException($media['id'].': '.$media['url']);
+            }
+
+            // Cache
+            if($this->setCacheHeaders($media['filename'])) {
+                return null;
+            }
+
+            // Load and process file
+            $file = null;
+            if(is_null($action) || !in_array(strtoupper($format), self::getImageTypes()))
+            {
+                // Do not process the file
+                $file = file_get_contents($media['filename']);
+            }
+            else
+            {
+                // Process file
+                switch($action)
+                {
+                    case 'questgroup':
+                    case 'quest':
+                    case 'avatar':
+                    case 'charactergroup':
+                    case 'charactergroupsquest':
+                        $file = self::resizeImage(
+                            $media['filename'],
+                            $format,
+                            \nre\configs\AppConfig::$media[$action]['width'],
+                            \nre\configs\AppConfig::$media[$action]['height']
+                        );
+                    break;
+                    default:
+                        throw new ParamsNotValidException($action);
+                    break;
+                }
+            }
+
+
+            // Return file
+            return $file;
+        }
+
+
+        /**
+         * Get supported image types.
+         *
+         * @return  array   List of supported image types
+         */
+        private static function getImageTypes()
+        {
+            $im = new \Imagick();
+
+
+            return $im->queryFormats();
+        }
+
+
+        /**
+         * Resize an image.
+         *
+         * @param   string  $fileName   Absolute pathname of image to resize
+         * @param   string  $mimeType   Mimetype of target image
+         * @param   int $width      Max. width to resize to
+         * @param   int $height     Max. height to resize to
+         * @return  mixed           Resized image
+         */
+        private static function resizeImage($fileName, $mimeType, $width, $height)
+        {
+            // Read image from cache
+            $tempFileName = ROOT.DS.\nre\configs\AppConfig::$dirs['temporary'].DS.'media-'.basename($fileName).'-'.$width.'x'.$height;
+            if(file_exists($tempFileName))
+            {
+                // Check age of file
+                if(filemtime($fileName) > filemtime($tempFileName)) {
+                    // Too old, delete
+                    unlink($tempFileName);
+                }
+                else {
+                    // Valid, read and return
+                    return file_get_contents($tempFileName);
+                }
+            }
+
+
+            // ImageMagick
+            $im = new \Imagick($fileName);
+
+            // Calculate new size
+            $geometry = $im->getImageGeometry();
+            if($geometry['width'] < $width) {
+                $width = $geometry['width'];
+            }
+            if($geometry['height'] < $height) {
+                $height = $geometry['width'];
+            }
+
+            // Process
+            $im->thumbnailImage($width, $height, true);
+            $im->contrastImage(1);
+            $im->setImageFormat($mimeType);
+
+            // Save temporary file
+            $im->writeImage($tempFileName);
+
+
+            // Return resized image
+            return $im;
+        }
+
+    }
+
+?>

db/create.sql

@@ -1,8 +1,8 @@
--- MySQL dump 10.15  Distrib 10.0.22-MariaDB, for Linux (x86_64)
+-- MySQL dump 10.16  Distrib 10.1.10-MariaDB, for Linux (x86_64)
 --
 -- Host: localhost    Database: z
 -- ------------------------------------------------------
--- Server version	10.0.22-MariaDB-log
+-- Server version	10.1.10-MariaDB-log
 
 /*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
 /*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
@@ -568,6 +568,61 @@ CREATE TABLE `charactergroupsquests_seminaryuploads` (
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
 /*!40101 SET character_set_client = @saved_cs_client */;
 
+--
+-- Table structure for table `charactergroupsqueststations`
+--
+
+DROP TABLE IF EXISTS `charactergroupsqueststations`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `charactergroupsqueststations` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `charactergroupsquest_id` int(11) NOT NULL,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `stationtype_id` int(11) NOT NULL,
+  `title` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL,
+  `url` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL,
+  `pos` int(10) unsigned NOT NULL,
+  `stationpicture_id` int(11) DEFAULT NULL,
+  `prolog` text COLLATE utf8mb4_unicode_ci NOT NULL,
+  `task` text COLLATE utf8mb4_unicode_ci NOT NULL,
+  `latitude` decimal(10,6) DEFAULT NULL,
+  `longitude` decimal(10,6) DEFAULT NULL,
+  `righttext` text COLLATE utf8mb4_unicode_ci NOT NULL,
+  `wrongtext` text COLLATE utf8mb4_unicode_ci NOT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `charactergroupsquest_id_2` (`charactergroupsquest_id`,`url`),
+  UNIQUE KEY `charactergroupsquest_id_3` (`charactergroupsquest_id`,`pos`),
+  KEY `charactergroupsquest_id` (`charactergroupsquest_id`),
+  KEY `charactergroupsqueststationtype_id` (`stationtype_id`),
+  KEY `stationpicture_id` (`stationpicture_id`) USING BTREE,
+  CONSTRAINT `charactergroupsqueststations_ibfk_1` FOREIGN KEY (`charactergroupsquest_id`) REFERENCES `charactergroupsquests` (`id`) ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT `charactergroupsqueststations_ibfk_2` FOREIGN KEY (`stationpicture_id`) REFERENCES `seminarymedia` (`id`) ON DELETE SET NULL ON UPDATE SET NULL,
+  CONSTRAINT `charactergroupsqueststations_ibfk_3` FOREIGN KEY (`stationtype_id`) REFERENCES `stationtypes` (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
+--
+-- Table structure for table `charactergroupsqueststations_charactergroups`
+--
+
+DROP TABLE IF EXISTS `charactergroupsqueststations_charactergroups`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `charactergroupsqueststations_charactergroups` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `charactergroupsqueststation_id` int(11) NOT NULL,
+  `charactergroup_id` int(11) NOT NULL,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `status` tinyint(3) unsigned NOT NULL,
+  PRIMARY KEY (`id`),
+  KEY `charactergroupsqueststation_id` (`charactergroupsqueststation_id`),
+  KEY `charactergroup_id` (`charactergroup_id`),
+  CONSTRAINT `charactergroupsqueststations_charactergroups_ibfk_1` FOREIGN KEY (`charactergroupsqueststation_id`) REFERENCES `charactergroupsqueststations` (`id`) ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT `charactergroupsqueststations_charactergroups_ibfk_2` FOREIGN KEY (`charactergroup_id`) REFERENCES `charactergroups` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
 --
 -- Table structure for table `characterroles`
 --
@@ -1915,6 +1970,105 @@ CREATE TABLE `seminaryuploads` (
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
 /*!40101 SET character_set_client = @saved_cs_client */;
 
+--
+-- Table structure for table `stationtypes`
+--
+
+DROP TABLE IF EXISTS `stationtypes`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `stationtypes` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `title` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL,
+  `url` varchar(64) COLLATE utf8mb4_unicode_ci NOT NULL,
+  `classname` varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `title` (`title`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
+--
+-- Table structure for table `stationtypes_keyword`
+--
+
+DROP TABLE IF EXISTS `stationtypes_keyword`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `stationtypes_keyword` (
+  `station_id` int(11) NOT NULL,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `created_user_id` int(11) NOT NULL,
+  `keyword_regex` varchar(256) COLLATE utf8mb4_unicode_ci NOT NULL,
+  PRIMARY KEY (`station_id`),
+  KEY `created_user_id` (`created_user_id`),
+  CONSTRAINT `stationtypes_keyword_ibfk_1` FOREIGN KEY (`station_id`) REFERENCES `charactergroupsqueststations` (`id`) ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT `stationtypes_keyword_ibfk_2` FOREIGN KEY (`created_user_id`) REFERENCES `users` (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
+--
+-- Table structure for table `stationtypes_keyword_charactergroups`
+--
+
+DROP TABLE IF EXISTS `stationtypes_keyword_charactergroups`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `stationtypes_keyword_charactergroups` (
+  `station_id` int(11) NOT NULL,
+  `charactergroup_id` int(11) NOT NULL,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `keyword` varchar(32) COLLATE utf8mb4_unicode_ci NOT NULL,
+  PRIMARY KEY (`station_id`,`charactergroup_id`),
+  KEY `charactergroup_id` (`charactergroup_id`),
+  CONSTRAINT `stationtypes_keyword_charactergroups_ibfk_1` FOREIGN KEY (`station_id`) REFERENCES `charactergroupsqueststations` (`id`) ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT `stationtypes_keyword_charactergroups_ibfk_2` FOREIGN KEY (`charactergroup_id`) REFERENCES `charactergroups` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
+--
+-- Table structure for table `stationtypes_multiplechoice`
+--
+
+DROP TABLE IF EXISTS `stationtypes_multiplechoice`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `stationtypes_multiplechoice` (
+  `id` int(11) NOT NULL AUTO_INCREMENT,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `created_user_id` int(11) NOT NULL,
+  `station_id` int(11) NOT NULL,
+  `pos` int(11) NOT NULL,
+  `answer` text COLLATE utf8mb4_unicode_ci NOT NULL,
+  `tick` tinyint(1) DEFAULT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `questtypes_multiplechoice_id_2` (`station_id`,`pos`),
+  KEY `created_user_id` (`created_user_id`),
+  KEY `questtypes_multiplechoice_id` (`station_id`),
+  CONSTRAINT `stationtypes_multiplechoice_ibfk_1` FOREIGN KEY (`created_user_id`) REFERENCES `users` (`id`),
+  CONSTRAINT `stationtypes_multiplechoice_ibfk_2` FOREIGN KEY (`station_id`) REFERENCES `charactergroupsqueststations` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
+--
+-- Table structure for table `stationtypes_multiplechoice_charactergroups`
+--
+
+DROP TABLE IF EXISTS `stationtypes_multiplechoice_charactergroups`;
+/*!40101 SET @saved_cs_client     = @@character_set_client */;
+/*!40101 SET character_set_client = utf8 */;
+CREATE TABLE `stationtypes_multiplechoice_charactergroups` (
+  `stationtypes_multiplechoice_id` int(11) NOT NULL,
+  `charactergroup_id` int(11) NOT NULL,
+  `created` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `ticked` tinyint(1) NOT NULL,
+  PRIMARY KEY (`stationtypes_multiplechoice_id`,`charactergroup_id`),
+  KEY `character_id` (`charactergroup_id`),
+  CONSTRAINT `stationtypes_multiplechoice_charactergroups_ibfk_1` FOREIGN KEY (`stationtypes_multiplechoice_id`) REFERENCES `stationtypes_multiplechoice` (`id`) ON DELETE CASCADE ON UPDATE CASCADE,
+  CONSTRAINT `stationtypes_multiplechoice_charactergroups_ibfk_2` FOREIGN KEY (`charactergroup_id`) REFERENCES `charactergroups` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+/*!40101 SET character_set_client = @saved_cs_client */;
+
 --
 -- Table structure for table `userroles`
 --
@@ -2317,4 +2471,4 @@ DELIMITER ;
 /*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
 /*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;
 
--- Dump completed on 2015-10-30 22:27:53
+-- Dump completed on 2016-01-15 13:19:51

db/import.sql

@@ -1,13 +1,13 @@
--- MySQL dump 10.15  Distrib 10.0.17-MariaDB, for Linux (x86_64)
+-- MySQL dump 10.16  Distrib 10.1.9-MariaDB, for Linux (x86_64)
 --
--- Host: localhost    Database: z_default
+-- Host: localhost    Database: z
 -- ------------------------------------------------------
--- Server version	10.0.17-MariaDB-log
+-- Server version	10.1.9-MariaDB-log
 
 /*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
 /*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
 /*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
-/*!40101 SET NAMES utf8 */;
+/*!40101 SET NAMES utf8mb4 */;
 /*!40103 SET @OLD_TIME_ZONE=@@TIME_ZONE */;
 /*!40103 SET TIME_ZONE='+00:00' */;
 /*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */;
@@ -20,7 +20,7 @@
 
 LOCK TABLES `achievementconditions` WRITE;
 /*!40000 ALTER TABLE `achievementconditions` DISABLE KEYS */;
-INSERT INTO `achievementconditions` VALUES (1,'2014-04-16 19:36:54','date'),(2,'2014-04-16 19:36:54','character'),(3,'2014-04-16 19:36:59','quest'),(4,'2014-04-16 19:36:59','achievement');
+INSERT INTO `achievementconditions` (`id`, `created`, `condition`) VALUES (1,'2014-04-16 19:36:54','date'),(2,'2014-04-16 19:36:54','character'),(3,'2014-04-16 19:36:59','quest'),(4,'2014-04-16 19:36:59','achievement');
 /*!40000 ALTER TABLE `achievementconditions` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -177,13 +177,31 @@ LOCK TABLES `charactergroupsquests_seminaryuploads` WRITE;
 /*!40000 ALTER TABLE `charactergroupsquests_seminaryuploads` ENABLE KEYS */;
 UNLOCK TABLES;
 
+--
+-- Dumping data for table `charactergroupsqueststations`
+--
+
+LOCK TABLES `charactergroupsqueststations` WRITE;
+/*!40000 ALTER TABLE `charactergroupsqueststations` DISABLE KEYS */;
+/*!40000 ALTER TABLE `charactergroupsqueststations` ENABLE KEYS */;
+UNLOCK TABLES;
+
+--
+-- Dumping data for table `charactergroupsqueststations_charactergroups`
+--
+
+LOCK TABLES `charactergroupsqueststations_charactergroups` WRITE;
+/*!40000 ALTER TABLE `charactergroupsqueststations_charactergroups` DISABLE KEYS */;
+/*!40000 ALTER TABLE `charactergroupsqueststations_charactergroups` ENABLE KEYS */;
+UNLOCK TABLES;
+
 --
 -- Dumping data for table `characterroles`
 --
 
 LOCK TABLES `characterroles` WRITE;
 /*!40000 ALTER TABLE `characterroles` DISABLE KEYS */;
-INSERT INTO `characterroles` VALUES (1,'2014-04-16 14:42:54','admin'),(2,'2014-04-16 14:42:54','moderator'),(3,'2014-04-16 14:43:00','user'),(4,'2014-04-16 14:43:00','guest');
+INSERT INTO `characterroles` (`id`, `created`, `name`) VALUES (1,'2014-04-16 14:42:54','admin'),(2,'2014-04-16 14:42:54','moderator'),(3,'2014-04-16 14:43:00','user'),(4,'2014-04-16 14:43:00','guest');
 /*!40000 ALTER TABLE `characterroles` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -250,6 +268,15 @@ LOCK TABLES `media` WRITE;
 /*!40000 ALTER TABLE `media` ENABLE KEYS */;
 UNLOCK TABLES;
 
+--
+-- Dumping data for table `pages`
+--
+
+LOCK TABLES `pages` WRITE;
+/*!40000 ALTER TABLE `pages` DISABLE KEYS */;
+/*!40000 ALTER TABLE `pages` ENABLE KEYS */;
+UNLOCK TABLES;
+
 --
 -- Dumping data for table `questgroups`
 --
@@ -382,7 +409,7 @@ UNLOCK TABLES;
 
 LOCK TABLES `questtexttypes` WRITE;
 /*!40000 ALTER TABLE `questtexttypes` DISABLE KEYS */;
-INSERT INTO `questtexttypes` VALUES (1,'2014-04-17 09:24:21','Prolog','Prolog'),(2,'2014-04-17 09:24:21','Hint','Hint'),(3,'2014-04-17 09:24:27','Epilog','Epilog');
+INSERT INTO `questtexttypes` (`id`, `created`, `type`, `url`) VALUES (1,'2014-04-17 09:24:21','Prolog','Prolog'),(2,'2014-04-17 09:24:21','Hint','Hint'),(3,'2014-04-17 09:24:27','Epilog','Epilog');
 /*!40000 ALTER TABLE `questtexttypes` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -401,7 +428,7 @@ UNLOCK TABLES;
 
 LOCK TABLES `questtypes` WRITE;
 /*!40000 ALTER TABLE `questtypes` DISABLE KEYS */;
-INSERT INTO `questtypes` VALUES (1,'2014-04-16 18:44:44','Empty','Empty',NULL),(2,'2014-04-16 18:44:44','Boss Fight','Boss-Fight','bossfight'),(3,'2014-04-16 18:45:19','Choice Input','Choice-Input','choiceinput'),(4,'2014-04-16 18:46:02','Crossword','Crossword','crossword'),(5,'2014-04-16 18:46:02','Drag&Drop','Drag&Drop','dragndrop'),(6,'2014-04-16 18:46:23','Multiple Choice','Multiple-Choice','multiplechoice'),(7,'2014-04-16 18:46:23','Submit','Submit','submit'),(8,'2014-04-16 18:46:43','Text Input','Text-Input','textinput');
+INSERT INTO `questtypes` (`id`, `created`, `title`, `url`, `classname`) VALUES (1,'2014-04-16 18:44:44','Empty','Empty',NULL),(2,'2014-04-16 18:44:44','Boss Fight','Boss-Fight','bossfight'),(3,'2014-04-16 18:45:19','Choice Input','Choice-Input','choiceinput'),(4,'2014-04-16 18:46:02','Crossword','Crossword','crossword'),(5,'2014-04-16 18:46:02','Drag&Drop','Drag&Drop','dragndrop'),(6,'2014-04-16 18:46:23','Multiple Choice','Multiple-Choice','multiplechoice'),(7,'2014-04-16 18:46:23','Submit','Submit','submit'),(8,'2014-04-16 18:46:43','Text Input','Text-Input','textinput');
 /*!40000 ALTER TABLE `questtypes` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -645,7 +672,7 @@ UNLOCK TABLES;
 
 LOCK TABLES `seminarycharacterfieldtypes` WRITE;
 /*!40000 ALTER TABLE `seminarycharacterfieldtypes` DISABLE KEYS */;
-INSERT INTO `seminarycharacterfieldtypes` VALUES (1,'2014-04-16 18:50:16','Number','Number'),(2,'2014-04-16 18:50:16','Varchar','Varchar'),(3,'2014-04-16 18:50:24','Text','Text'),(4,'2014-04-16 18:50:24','List','List');
+INSERT INTO `seminarycharacterfieldtypes` (`id`, `created`, `title`, `url`) VALUES (1,'2014-04-16 18:50:16','Number','Number'),(2,'2014-04-16 18:50:16','Varchar','Varchar'),(3,'2014-04-16 18:50:24','Text','Text'),(4,'2014-04-16 18:50:24','List','List');
 /*!40000 ALTER TABLE `seminarycharacterfieldtypes` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -667,13 +694,59 @@ LOCK TABLES `seminaryuploads` WRITE;
 /*!40000 ALTER TABLE `seminaryuploads` ENABLE KEYS */;
 UNLOCK TABLES;
 
+--
+-- Dumping data for table `stationtypes`
+--
+
+LOCK TABLES `stationtypes` WRITE;
+/*!40000 ALTER TABLE `stationtypes` DISABLE KEYS */;
+INSERT INTO `stationtypes` (`id`, `created`, `title`, `url`, `classname`) VALUES (1,'2015-12-25 15:50:52','Empty','Empty',NULL),(2,'2015-12-25 15:50:52','Keyword','Keyword','keyword'),(3,'2015-12-25 15:51:16','Multiple Choice','Multiple-Choice','multiplechoice');
+/*!40000 ALTER TABLE `stationtypes` ENABLE KEYS */;
+UNLOCK TABLES;
+
+--
+-- Dumping data for table `stationtypes_keyword`
+--
+
+LOCK TABLES `stationtypes_keyword` WRITE;
+/*!40000 ALTER TABLE `stationtypes_keyword` DISABLE KEYS */;
+/*!40000 ALTER TABLE `stationtypes_keyword` ENABLE KEYS */;
+UNLOCK TABLES;
+
+--
+-- Dumping data for table `stationtypes_keyword_charactergroups`
+--
+
+LOCK TABLES `stationtypes_keyword_charactergroups` WRITE;
+/*!40000 ALTER TABLE `stationtypes_keyword_charactergroups` DISABLE KEYS */;
+/*!40000 ALTER TABLE `stationtypes_keyword_charactergroups` ENABLE KEYS */;
+UNLOCK TABLES;
+
+--
+-- Dumping data for table `stationtypes_multiplechoice`
+--
+
+LOCK TABLES `stationtypes_multiplechoice` WRITE;
+/*!40000 ALTER TABLE `stationtypes_multiplechoice` DISABLE KEYS */;
+/*!40000 ALTER TABLE `stationtypes_multiplechoice` ENABLE KEYS */;
+UNLOCK TABLES;
+
+--
+-- Dumping data for table `stationtypes_multiplechoice_charactergroups`
+--
+
+LOCK TABLES `stationtypes_multiplechoice_charactergroups` WRITE;
+/*!40000 ALTER TABLE `stationtypes_multiplechoice_charactergroups` DISABLE KEYS */;
+/*!40000 ALTER TABLE `stationtypes_multiplechoice_charactergroups` ENABLE KEYS */;
+UNLOCK TABLES;
+
 --
 -- Dumping data for table `userroles`
 --
 
 LOCK TABLES `userroles` WRITE;
 /*!40000 ALTER TABLE `userroles` DISABLE KEYS */;
-INSERT INTO `userroles` VALUES (1,'2014-04-16 14:42:54','admin'),(2,'2014-04-16 14:42:54','moderator'),(3,'2014-04-16 14:43:00','user'),(4,'2014-04-16 14:43:00','guest');
+INSERT INTO `userroles` (`id`, `created`, `name`) VALUES (1,'2014-04-16 14:42:54','admin'),(2,'2014-04-16 14:42:54','moderator'),(3,'2014-04-16 14:43:00','user'),(4,'2014-04-16 14:43:00','guest');
 /*!40000 ALTER TABLE `userroles` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -683,7 +756,7 @@ UNLOCK TABLES;
 
 LOCK TABLES `users` WRITE;
 /*!40000 ALTER TABLE `users` DISABLE KEYS */;
-INSERT INTO `users` VALUES (1,'2015-04-26 11:24:04','admin','admin','Admin','Admin','','$2y$10$1zCozXcIGak552mkv/K3vOPddrisvPlokJvUjHtHj6VBBRcmznXCG',1);
+INSERT INTO `users` (`id`, `created`, `username`, `url`, `surname`, `prename`, `email`, `password`, `mailing`) VALUES (1,'2015-04-26 11:24:04','admin','admin','Admin','Admin','','$2y$10$1zCozXcIGak552mkv/K3vOPddrisvPlokJvUjHtHj6VBBRcmznXCG',1);
 /*!40000 ALTER TABLE `users` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -693,7 +766,7 @@ UNLOCK TABLES;
 
 LOCK TABLES `users_userroles` WRITE;
 /*!40000 ALTER TABLE `users_userroles` DISABLE KEYS */;
-INSERT INTO `users_userroles` VALUES (1,1,'2015-04-26 11:33:36');
+INSERT INTO `users_userroles` (`user_id`, `userrole_id`, `created`) VALUES (1,1,'2015-04-26 11:33:36');
 /*!40000 ALTER TABLE `users_userroles` ENABLE KEYS */;
 UNLOCK TABLES;
 
@@ -714,4 +787,4 @@ UNLOCK TABLES;
 /*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
 /*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;
 
--- Dump completed on 2015-04-26 13:34:20
+-- Dump completed on 2015-12-25 16:51:58

models/CharactergroupsModel.inc

@@ -95,7 +95,7 @@
         public function getGroupsgroupById($groupsgroupId)
         {
             $data = $this->db->query(
-                'SELECT id, name, url, preferred '.
+                'SELECT id, seminary_id, name, url, preferred '.
                 'FROM charactergroupsgroups '.
                 'WHERE id = ?',
                 'i',
@@ -400,6 +400,28 @@
         }
 
 
+        /**
+         * Get Character groups that have entered a Character groups Quest
+         * station.
+         *
+         * @param   int     $stationId  ID of station
+         * @return  array               List of groups
+         */
+        public function getGroupsForQueststation($stationId)
+        {
+            return $this->db->query(
+                'SELECT charactergroups.id, charactergroups.name, charactergroups.url, charactergroupsqueststations_charactergroups.created '.
+                'FROM charactergroupsqueststations_charactergroups '.
+                'INNER JOIN charactergroups ON charactergroups.id = charactergroupsqueststations_charactergroups.charactergroup_id '.
+                'WHERE charactergroupsqueststations_charactergroups.charactergroupsqueststation_id = ? AND status = ? '.
+                'ORDER BY charactergroupsqueststations_charactergroups.created ASC',
+                'ii',
+                $stationId,
+                CharactergroupsqueststationsModel::STATUS_ENTERED
+            );
+        }
+
+
         /**
          * Check if a Character group name already exists.
          *

models/CharactergroupsquestsModel.inc

@@ -97,7 +97,7 @@
         public function getQuestById($questId)
         {
             $data = $this->db->query(
-                'SELECT id, questgroups_id, title, url, description, xps, rules, won_text, lost_text, questsmedia_id '.
+                'SELECT id, charactergroupsgroup_id, questgroups_id, title, url, description, xps, rules, won_text, lost_text, questsmedia_id '.
                 'FROM charactergroupsquests '.
                 'WHERE id = ?',
                 'i',

models/CharactergroupsqueststationsModel.inc

@@ -0,0 +1,415 @@
+<?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;
+
+
+    /**
+     * Model of the CharactergroupsqueststationsAgent to interact with
+     * Charactergroupsqueststations-table.
+     *
+     * @author  Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+     */
+    class CharactergroupsqueststationsModel extends \hhu\z\Model
+    {
+        /**
+         * Status: Entered
+         *
+         * @var int;
+         */
+        const STATUS_ENTERED = 0;
+        /**
+         * Status: Unsolved
+         *
+         * @var int;
+         */
+        const STATUS_UNSOLVED = 2;
+        /**
+         * Status: Solved
+         *
+         * @var int;
+         */
+        const STATUS_SOLVED = 3;
+
+
+
+
+        /**
+         * Construct a new CharactergroupsqueststationsModel.
+         */
+        public function __construct()
+        {
+            parent::__construct();
+        }
+
+
+
+
+        /**
+         * Get a Station by its ID.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   int $stationId  ID of Station to get
+         * @return  array           Station data
+         */
+        public function getStationById($stationId)
+        {
+            $data = $this->db->query(
+                'SELECT id, charactergroupsquest_id, stationtype_id, title, url, stationpicture_id, prolog, task, latitude, longitude, righttext, wrongtext '.
+                'FROM charactergroupsqueststations '.
+                'WHERE id = ?',
+                'i',
+                $stationId
+            );
+            if(empty($data)) {
+                throw new \nre\exceptions\IdNotFoundException($stationId);
+            }
+
+
+            return $data[0];
+        }
+
+
+        /**
+         * Get a Station by its ID.
+         *
+         * @throws  \nre\exceptions\IdNotFoundException
+         * @param   int $stationId  ID of Station to get
+         * @return  array           Station data
+         */
+        public function getStationByUrl($groupsquestId, $stationUrl)
+        {
+            $data = $this->db->query(
+                'SELECT id, charactergroupsquest_id, stationtype_id, title, url, stationpicture_id, prolog, task, latitude, longitude, righttext, wrongtext '.
+                'FROM charactergroupsqueststations '.
+                'WHERE charactergroupsquest_id = ? AND url = ?',
+                'is',
+                $groupsquestId,
+                $stationUrl
+            );
+            if(empty($data)) {
+                throw new \nre\exceptions\IdNotFoundException($stationUrl);
+            }
+
+
+            return $data[0];
+        }
+
+        /**
+         * Get all Stations for a Character groups Quest.
+         *
+         * @param   int     $questId    ID of the Character groups Quest
+         * @return  array               List of Stations
+         */
+        public function getStationsForQuest($questId)
+        {
+            return $this->db->query(
+                'SELECT id, title, url, stationpicture_id, latitude, longitude '.
+                'FROM charactergroupsqueststations '.
+                'WHERE charactergroupsquest_id = ? '.
+                'ORDER BY pos ASC',
+                'i',
+                $questId
+            );
+        }
+
+
+        /**
+         * Get all Stations for a Character groups Quest and a Character group.
+         *
+         * @param   int     $questId    ID of Character groups Quest
+         * @param   int     $groupId    ID of Character group
+         * @return  array               List of Station
+         */
+        public function getStationsForQuestAndGroup($questId, $groupId)
+        {
+            return $this->db->query(
+                'SELECT charactergroupsqueststations.id, charactergroupsqueststations_charactergroups.created, title, url, stationpicture_id, latitude, longitude '.
+                'FROM charactergroupsqueststations_charactergroups '.
+                'INNER JOIN charactergroupsqueststations ON charactergroupsqueststations.id = charactergroupsqueststations_charactergroups.charactergroupsqueststation_id '.
+                'WHERE '.
+                    'charactergroupsqueststations_charactergroups.charactergroup_id = ? AND '.
+                    'charactergroupsqueststations_charactergroups.status = ? AND '.
+                    'charactergroupsquest_id = ? '.
+                'ORDER BY charactergroupsqueststations_charactergroups.created ASC',
+                'iii',
+                $groupId,
+                self::STATUS_ENTERED,
+                $questId
+            );
+        }
+
+
+        /**
+         * Mark a Station as entered for a Character group.
+         *
+         * @param   int $stationId  ID of Station to mark
+         * @param   int $groupId    ID of Character group
+         */
+        public function setStationEntered($stationId, $groupId)
+        {
+            $this->setStatus($stationId, $groupId, self::STATUS_ENTERED);
+        }
+
+
+        /**
+         * Mark a Station as solved for a Character group.
+         *
+         * @param   int $stationId  ID of Station to mark
+         * @param   int $groupId    ID of Character group
+         */
+        public function setStationSolved($stationId, $groupId)
+        {
+            $this->setStatus($stationId, $groupId, self::STATUS_SOLVED);
+        }
+
+
+        /**
+         * Mark a Station as unsolved for a Character group.
+         *
+         * @param   int $stationId  ID of Station to mark
+         * @param   int $groupId    ID of Character group
+         */
+        public function setStationUnsolved($stationId, $groupId)
+        {
+            $this->setStatus($stationId, $groupId, self::STATUS_UNSOLVED);
+        }
+
+
+        /**
+         * Check if a Character group has tried to solve a Station.
+         *
+         * @param   int     $stationId  ID of Station to check
+         * @param   int     $groupId    ID of Character group to check
+         * @return  bool                Whether the group has tried the station or not
+         */
+        public function hasCharactergroupTriedStation($stationId, $groupId)
+        {
+            $data = $this->db->query(
+                'SELECT created '.
+                'FROM charactergroupsqueststations_charactergroups '.
+                'WHERE charactergroupsqueststation_id = ? AND charactergroup_id = ? AND (status = ? OR status = ?)',
+                'iiii',
+                $stationId,
+                $groupId,
+                self::STATUS_UNSOLVED,
+                self::STATUS_SOLVED
+            );
+            if(!empty($data)) {
+                return $data[0]['created'];
+            }
+
+
+            return false;
+        }
+
+
+        /**
+         * Check if a Character group has solved a Station.
+         *
+         * @param   int $questId    ID of Quest to check
+         * @param   int $groupId    ID of Character to check
+         * @result  boolean         Whether Character has solved the Quest or not
+         */
+        public function hasCharactergroupSolvedStation($stationId, $groupId)
+        {
+            $data = $this->db->query(
+                'SELECT created '.
+                'FROM charactergroupsqueststations_charactergroups '.
+                'WHERE charactergroupsqueststation_id = ? AND charactergroup_id = ? AND status = ?',
+                'iii',
+                $stationId,
+                $groupId,
+                self::STATUS_SOLVED
+            );
+            if(!empty($data)) {
+                return $data[0]['created'];
+            }
+
+
+            return false;
+        }
+
+
+        /**
+         * Check if a Character groups Quest Station title already exists.
+         *
+         * @param   int     $questId    ID of Character groups Quest
+         * @param   string  $title      Station title to check
+         * @param   int     $stationId  Do not check this ID (for editing)
+         * @return  boolean             Whether Station title exists or not
+         */
+        public function stationTitleExists($questId, $title, $stationId=null)
+        {
+            $data = $this->db->query(
+                'SELECT id '.
+                'FROM charactergroupsqueststations '.
+                'WHERE charactergroupsquest_id = ? AND (title = ? OR url = ?)',
+                'iss',
+                $questId,
+                $title,
+                \nre\core\Linker::createLinkParam($title)
+            );
+
+            return (!empty($data) && (is_null($stationId) || $stationId != $data[0]['id']));
+        }
+
+
+        /**
+         * Set the media for a Character groups Quest Station.
+         *
+         * @param   int $stationId  ID of Station to upload media for
+         * @param   int $mediaId    ID of Station media
+         */
+        public function setPictureForStation($station, $mediaId)
+        {
+            $this->db->query(
+                'UPDATE charactergroupsqueststations '.
+                'SET stationpicture_id = ? '.
+                'WHERE id = ?',
+                'ii',
+                $mediaId,
+                $station
+            );
+        }
+
+
+        /**
+         * Create a new Character groups Quest Station.
+         *
+         * @param   int     $questId        ID of Quest to create the Station for
+         * @param   int     $stationtypeId  ID of Station type
+         * @param   string  $title          Title
+         * @param   string  $prolog         Prolog
+         * @param   string  $task           Task description
+         * @param   int     $latitude       GPS latitude
+         * @param   int     $longitude      GPS longitude
+         * @param   string  $righttext      Text for correctly solved task
+         * @param   string  $wrongtext      Text for failed task
+         * @return  int                     ID of newly created station
+         */
+        public function createStation($questId, $stationtypeId, $title, $prolog, $task, $latitude, $longitude, $righttext, $wrongtext)
+        {
+            // Get position
+            $pos = $this->db->query(
+                'SELECT COALESCE(MAX(pos),0)+1 AS pos '.
+                'FROM charactergroupsqueststations '.
+                'WHERE charactergroupsquest_id = ?',
+                'i',
+                $questId
+            );
+            $pos = $pos[0]['pos'];
+
+            // Create Station
+            $this->db->query(
+                'INSERT INTO charactergroupsqueststations '.
+                '(charactergroupsquest_id, stationtype_id, title, url, pos, prolog, task, latitude, longitude, righttext, wrongtext) '.
+                'VALUES '.
+                '(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+                'iississddss',
+                $questId, $stationtypeId, $title,
+                \nre\core\Linker::createLinkParam($title), $pos,
+                $prolog, $task, $latitude, $longitude, $righttext, $wrongtext
+            );
+
+            
+            // Return ID of newly created Station
+            return $this->db->getInsertId();
+        }
+
+
+        /**
+         * Edit a Character groups Quest Station.
+         *
+         * @param   int     $stationId      ID of Station to edit
+         * @param   int     $stationtypeId  ID of Station type
+         * @param   string  $title          Title
+         * @param   string  $prolog         Prolog
+         * @param   string  $task           Task description
+         * @param   int     $latitude       GPS latitude
+         * @param   int     $longitude      GPS longitude
+         * @param   string  $righttext      Text for correctly solved task
+         * @param   string  $wrongtext      Text for failed task
+         */
+        public function editStation($stationId, $stationtypeId, $title, $prolog, $task, $latitude, $longitude, $righttext, $wrongtext)
+        {
+            $this->db->query(
+                'UPDATE charactergroupsqueststations '.