hide map for Character groups Quest Stations when there are no stations

This commit is contained in:
oliver 2016-04-09 13:44:37 +02:00
commit df14dfafc3
4371 changed files with 1220224 additions and 0 deletions

View file

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

View file

@ -0,0 +1,293 @@
<?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\questtypes;
/**
* Controller of the BossfightQuesttypeAgent for a boss-fight.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class BossfightQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Required models
*
* @var array
*/
public $models = array('media');
/**
* Save the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Prepare session
$this->prepareSession($quest['id']);
// Remove previous answers
$this->Bossfight->clearCharacterSubmissions($quest['id'], $character['id']);
// Save answers
foreach($_SESSION['quests'][$quest['id']]['stages'] as &$stage) {
$this->Bossfight->setCharacterSubmission($stage['id'], $character['id']);
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
return true;
}
/**
* Action: quest.
*
* Display a stage with a text and the answers for the following
* stages.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Get Boss-Fight
$fight = $this->Bossfight->getBossFight($quest['id']);
if(!is_null($fight['boss_seminarymedia_id'])) {
$fight['bossmedia'] = $this->Media->getSeminaryMediaById($fight['boss_seminarymedia_id']);
}
// Prepare session
$this->prepareSession($quest['id']);
// Get Stage
if($this->request->getRequestMethod() == 'POST' && !is_null($this->request->getPostParam('submit_stages')))
{
$stages = $this->request->getPostParam('submit_stages');
$stageId = array_keys($stages)[0];
$stage = $this->Bossfight->getStageById($stageId);
}
else
{
$_SESSION['quests'][$quest['id']]['stages'] = array();
$stage = $this->Bossfight->getFirstStage($quest['id']);
}
// Store Stage in session
if(count($_SESSION['quests'][$quest['id']]['stages']) == 0 || $_SESSION['quests'][$quest['id']]['stages'][count($_SESSION['quests'][$quest['id']]['stages'])-1]['id'] != $stage['id']) {
$_SESSION['quests'][$quest['id']]['stages'][] = $stage;
}
// Calculate lives
$lives = array(
'character' => $fight['lives_character'],
'boss' => $fight['lives_boss']
);
foreach($_SESSION['quests'][$quest['id']]['stages'] as &$stage)
{
$lives['character'] += $stage['livedrain_character'];
$lives['boss'] += $stage['livedrain_boss'];
}
// Get Child-Stages
$childStages = $this->Bossfight->getChildStages($stage['id']);
// Get answer of Character
if($this->request->getGetParam('show-answer') == 'true') {
foreach($childStages as &$childStage) {
$childStage['answer'] = $this->Bossfight->getCharacterSubmission($childStage['id'], $character['id']);
}
}
// Pass data to view
$this->set('seminary', $seminary);
$this->set('character', $character);
$this->set('fight', $fight);
$this->set('stage', $stage);
$this->set('lives', $lives);
$this->set('childStages', $childStages);
}
/**
* Action: submission.
*
* Display all stages with the answers the character has
* choosen.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get Boss-Fight
$fight = $this->Bossfight->getBossFight($quest['id']);
if(!is_null($fight['boss_seminarymedia_id'])) {
$fight['bossmedia'] = $this->Media->getSeminaryMediaById($fight['boss_seminarymedia_id']);
}
// Get stages
$stages = array();
$stage = $this->Bossfight->getFirstStage($quest['id']);
while(!is_null($stage))
{
$stages[] = $stage;
$childStages = $this->Bossfight->getChildStages($stage['id']);
$stage = null;
foreach($childStages as &$childStage)
{
if($this->Bossfight->getCharacterSubmission($childStage['id'], $character['id']))
{
$stage = $childStage;
break;
}
}
}
// Calculate lives
$stages[0]['lives'] = array(
'character' => $fight['lives_character'],
'boss' => $fight['lives_boss']
);
for($i=1; $i<count($stages); $i++)
{
$stages[$i]['lives'] = array(
'character' => $stages[$i-1]['lives']['character'] + $stages[$i]['livedrain_character'],
'boss' => $stages[$i-1]['lives']['boss'] + $stages[$i]['livedrain_boss'],
);
}
// Pass data to view
$this->set('seminary', $seminary);
$this->set('character', $character);
$this->set('fight', $fight);
$this->set('stages', $stages);
}
/**
* TODO Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
$fight = $this->Bossfight->getBossFight($quest['id']);
/*
if(!is_null($fight['boss_seminarymedia_id'])) {
$fight['bossmedia'] = $this->Media->getSeminaryMediaById($fight['boss_seminarymedia_id']);
}
*/
// Get stages
$stage = $this->Bossfight->getFirstStage($quest['id']);
$stage['childs'] = $this->getChildStages($stage['id']);
// Pass data to view
$this->set('seminary', $seminary);
$this->set('fight', $fight);
$this->set('stages', $stage);
//print_r($stage);
}
/**
* Prepare the session to store stage information in
*
* @param int $questId ID of Quest
*/
private function prepareSession($questId)
{
if(!array_key_exists('quests', $_SESSION)) {
$_SESSION['quests'] = array();
}
if(!array_key_exists($questId, $_SESSION['quests'])) {
$_SESSION['quests'][$questId] = array();
}
if(!array_key_exists('stages', $_SESSION['quests'][$questId])) {
$_SESSION['quests'][$questId]['stages'] = array();
}
}
/**
* Get all child-stages of a parent-stage.
*
* @param int $stageId ID of parent-stage
* @return array List of child-stages
*/
private function getChildStages($stageId)
{
$childStages = $this->Bossfight->getChildStages($stageId);
if(!empty($childStages)) {
foreach($childStages as &$stage) {
$stage['childs'] = $this->getChildStages($stage['id']);
}
}
return $childStages;
}
}
?>

View file

@ -0,0 +1,184 @@
<?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\questtypes;
/**
* Model of the BossfightQuesttypeAgent for a boss-fight.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class BossfightQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Get a Boss-Fight.
*
* @throws \nre\exceptions\IdNotFoundException
* @param int $questId ID of Quest
* @return array Boss-Fight data
*/
public function getBossFight($questId)
{
$data = $this->db->query(
'SELECT bossname, boss_seminarymedia_id, lives_character, lives_boss '.
'FROM questtypes_bossfight '.
'WHERE quest_id = ?',
'i',
$questId
);
if(empty($data)) {
throw new \nre\exceptions\IdNotFoundException($questId);
}
return $data[0];
}
/**
* Get the first Stage to begin the Boss-Fight with.
*
* @param int $questId ID of Quest
* @return array Data of first Stage
*/
public function getFirstStage($questId)
{
$data = $this->db->query(
'SELECT id, text, question, livedrain_character, livedrain_boss '.
'FROM questtypes_bossfight_stages '.
'WHERE questtypes_bossfight_quest_id = ? AND parent_stage_id IS NULL',
'i',
$questId
);
if(!empty($data)) {
return $data[0];
}
return null;
}
/**
* Get a Stage by its ID.
*
* @param int $stageId ID of Stage
* @return array Stage data or null
*/
public function getStageById($stageId)
{
$data = $this->db->query(
'SELECT id, text, question, livedrain_character, livedrain_boss '.
'FROM questtypes_bossfight_stages '.
'WHERE id = ?',
'i',
$stageId
);
if(!empty($data)) {
return $data[0];
}
return null;
}
/**
* Get the follow-up Stages for a Stage.
*
* @param int $parentStageId ID of Stage to get follow-up Stages for
* @return array List of follow-up Stages
*/
public function getChildStages($parentStageId)
{
return $this->db->query(
'SELECT id, text, question, livedrain_character, livedrain_boss '.
'FROM questtypes_bossfight_stages '.
'WHERE parent_stage_id = ?',
'i',
$parentStageId
);
}
/**
* Reset all Character submissions of a Boss-Fight.
*
* @param int $questId ID of Quest
* @param int $characterId ID of Character
*/
public function clearCharacterSubmissions($questId, $characterId)
{
$this->db->query(
'DELETE FROM questtypes_bossfight_stages_characters '.
'WHERE questtypes_bossfight_stage_id IN ('.
'SELECT id '.
'FROM questtypes_bossfight_stages '.
'WHERE questtypes_bossfight_quest_id = ?'.
') AND character_id = ?',
'ii',
$questId,
$characterId
);
}
/**
* Save Characters submitted answer for one Boss-Fight-Stage.
*
* @param int $regexId ID of list
* @param int $characterId ID of Character
*/
public function setCharacterSubmission($stageId, $characterId)
{
$this->db->query(
'INSERT INTO questtypes_bossfight_stages_characters '.
'(questtypes_bossfight_stage_id, character_id) '.
'VALUES '.
'(?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'questtypes_bossfight_stage_id = ?',
'iii',
$stageId, $characterId, $stageId
);
}
/**
* Get answer of one Boss-Fight-Stage submitted by Character.
*
* @param int $regexId ID of list
* @param int $characterId ID of Character
* @return boolean Stage taken
*/
public function getCharacterSubmission($stageId, $characterId)
{
$data = $this->db->query(
'SELECT questtypes_bossfight_stage_id '.
'FROM questtypes_bossfight_stages_characters '.
'WHERE questtypes_bossfight_stage_id = ? AND character_id = ? ',
'ii',
$stageId, $characterId
);
return (!empty($data));
}
}
?>

View file

@ -0,0 +1,25 @@
<?php
/**
* The Legend of Z
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
* @copyright 2014 Heinrich-Heine-Universität Düsseldorf
* @license http://www.gnu.org/licenses/gpl.html
* @link https://bitbucket.org/coderkun/the-legend-of-z
*/
namespace hhu\z\questtypes;
/**
* QuesttypeAgent for choosing between predefined input values.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class ChoiceinputQuesttypeAgent extends \hhu\z\agents\QuesttypeAgent
{
}
?>

View file

@ -0,0 +1,300 @@
<?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\questtypes;
/**
* Controller of the ChoiceinputQuesttypeAgent for choosing between
* predefined input values.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class ChoiceinputQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Required components
*
* @var array
*/
public $components = array('validation');
/**
* Save the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get lists
$choiceLists = $this->Choiceinput->getChoiceinputLists($quest['id']);
// Save answers
foreach($choiceLists as &$list)
{
$pos = intval($list['number']) - 1;
$answer = (array_key_exists($pos, $answers)) ? $answers[$pos] : null;
$this->Choiceinput->setCharacterSubmission($list['id'], $character['id'], $answer);
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get lists
$choiceLists = $this->Choiceinput->getChoiceinputLists($quest['id']);
// Match lists with user answers
foreach($choiceLists as &$list)
{
$pos = intval($list['number']) - 1;
if(!array_key_exists($pos, $answers)) {
return false;
}
if($list['questtypes_choiceinput_choice_id'] != $answers[$pos]) {
return false;
}
}
// All answers right
return true;
}
/**
* Action: quest.
*
* Display a text with lists with predefined values.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Get Task
$task = $this->Choiceinput->getChoiceinputQuest($quest['id']);
// Get lists
$choiceLists = $this->Choiceinput->getChoiceinputLists($quest['id']);
foreach($choiceLists as &$list) {
$list['values'] = $this->Choiceinput->getChoiceinputChoices($list['id']);
}
// Get Character answers
if($this->request->getGetParam('show-answer') == 'true' || !$this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']) || $this->request->getGetParam('status') == 'solved') {
foreach($choiceLists as &$list) {
$list['answer'] = $this->Choiceinput->getCharacterSubmission($list['id'], $character['id']);
}
}
// Pass data to view
$this->set('task', $task);
$this->set('choiceLists', $choiceLists);
}
/**
* Action: submission.
*
* Show the submission of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get Task
$task = $this->Choiceinput->getChoiceinputQuest($quest['id']);
// Get lists
$choiceLists = $this->Choiceinput->getChoiceinputLists($quest['id']);
foreach($choiceLists as &$list)
{
$list['values'] = $this->Choiceinput->getChoiceinputChoices($list['id']);
$list['answer'] = $this->Choiceinput->getCharacterSubmission($list['id'], $character['id']);
$list['right'] = ($list['questtypes_choiceinput_choice_id'] == $list['answer']);
}
// Pass data to view
$this->set('task', $task);
$this->set('choiceLists', $choiceLists);
}
/**
* Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
// Get Task
$task = $this->Choiceinput->getChoiceinputQuest($quest['id']);
$text = $task['text'];
// Get lists
$choiceLists = $this->Choiceinput->getChoiceinputLists($quest['id']);
foreach($choiceLists as &$list)
{
$list['choices'] = $this->Choiceinput->getChoiceinputChoices($list['id']);
foreach($list['choices'] as $index => &$choice) {
//$choice['correct'] = ($choice['id'] == $list['questtypes_choiceinput_choice_id']);
if($choice['id'] == $list['questtypes_choiceinput_choice_id']) {
$list['answer'] = $index;
}
$choice = $choice['text'];
}
//$list = $list['choices'];
}
// Values
$validations = array();
// Save data
if($this->request->getRequestMethod() == 'POST')
{
if(!is_null($this->request->getPostParam('preview')) || !is_null($this->request->getPostParam('save')))
{
// Get params and validate them
if(is_null($this->request->getPostParam('text'))) {
throw new \nre\exceptions\ParamsNotValidException('text');
}
$text = $this->request->getPostParam('text');
if(is_null($this->request->getPostParam('lists'))) {
throw new \nre\exceptions\ParamsNotValidException('lists');
}
$choiceLists = $this->request->getPostParam('lists');
$choiceLists = array_values($choiceLists);
foreach($choiceLists as $listIndex => &$list)
{
// Validate choices
if(!array_key_exists('choices', $list)) {
throw new \nre\exceptions\ParamsNotValidException('choices');
}
$choiceIndex = 0;
$answer = null;
foreach($list['choices'] as $index => &$choice)
{
// Validate choice
$choiceValidation = $this->Validation->validate($choice, \nre\configs\AppConfig::$validation['choice']);
if($choiceValidation !== true)
{
if(!array_key_exists($listIndex, $validations) || !is_array($validations[$listIndex])) {
$validations[$listIndex] = array();
}
if(!array_key_exists('choices', $validations[$listIndex])) {
$validations[$listIndex]['choices'] = array();
}
$validations[$listIndex]['choices'][$choiceIndex] = $choiceValidation;
}
$choiceIndex++;
if(array_key_exists('answer', $list) && $list['answer'] == $index) {
$answer = $choiceIndex;
}
}
// Validate correct answer
if(is_null($answer))
{
if(!array_key_exists($listIndex, $validations) || !is_array($validations[$listIndex])) {
$validations[$listIndex] = array();
}
if(!array_key_exists('answer', $validations[$listIndex])) {
$validations[$listIndex]['answer'] = array();
}
$validations[$listIndex] = $this->Validation->addValidationResult($validations[$listIndex], 'answer', 'exist', true);
}
}
// Save and redirect
if(!is_null($this->request->getPostParam('save')) && empty($validations))
{
// Save text
$this->Choiceinput->setTextForQuest(
$this->Auth->getUserId(),
$quest['id'],
$text
);
// Save lists and choices
foreach($choiceLists as $listIndex => &$list)
{
// Save list
$this->Choiceinput->setListForText(
$quest['id'],
$listIndex + 1,
$list['choices'],
$list['answer'] + 1
);
}
// Redirect
$this->redirect($this->linker->link(array('quest', $seminary['url'], $questgroup['url'], $quest['url']), 1));
}
}
}
// Pass data to view
$this->set('task', $task);
$this->set('text', $text);
$this->set('choiceLists', $choiceLists);
$this->set('validations', $validations);
}
}
?>

View file

@ -0,0 +1,296 @@
<?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\questtypes;
/**
* Model of the ChoiceinputQuesttypeAgent for choosing between
* predefined input values.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class ChoiceinputQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Get choiceinput-text for a Quest.
*
* @param int $questId ID of Quest
* @return array Choiceinput-text
*/
public function getChoiceinputQuest($questId)
{
$data = $this->db->query(
'SELECT text '.
'FROM questtypes_choiceinput '.
'WHERE quest_id = ?',
'i',
$questId
);
if(!empty($data)) {
return $data[0];
}
return null;
}
/**
* Get all lists of input values for a choiceinput-text.
*
* @param int $questId ID of Quest
* @return array List
*/
public function getChoiceinputLists($questId)
{
return $this->db->query(
'SELECT id, number, questtypes_choiceinput_choice_id '.
'FROM questtypes_choiceinput_lists '.
'WHERE questtypes_choiceinput_quest_id = ? '.
'ORDER BY number ASC',
'i',
$questId
);
}
/**
* Get the list of values for a choiceinput-list.
*
* @param int $listId ID of list
* @return array Input values
*/
public function getChoiceinputChoices($listId)
{
return $this->db->query(
'SELECT id, pos, text '.
'FROM questtypes_choiceinput_choices '.
'WHERE questtypes_choiceinput_list_id = ? '.
'ORDER BY pos ASC',
'i',
$listId
);
}
/**
* Save Characters submitted answer for one choiceinput-list.
*
* @param int $regexId ID of list
* @param int $characterId ID of Character
* @param string $answer Submitted answer for this list
*/
public function setCharacterSubmission($listId, $characterId, $answer)
{
if(is_null($answer))
{
$this->db->query(
'INSERT INTO questtypes_choiceinput_lists_characters '.
'(questtypes_choiceinput_list_id, character_id, questtypes_choiceinput_choice_id) '.
'VALUES '.
'(?, ?, NULL) '.
'ON DUPLICATE KEY UPDATE '.
'questtypes_choiceinput_choice_id = NULL',
'ii',
$listId, $characterId
);
}
else
{
$this->db->query(
'INSERT INTO questtypes_choiceinput_lists_characters '.
'(questtypes_choiceinput_list_id, character_id, questtypes_choiceinput_choice_id) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'questtypes_choiceinput_choice_id = ?',
'iiii',
$listId, $characterId, $answer, $answer
);
}
}
/**
* Get answer of one choiceinput-list submitted by Character.
*
* @param int $regexId ID of list
* @param int $characterId ID of Character
* @return int Submitted answer for this list or null
*/
public function getCharacterSubmission($listId, $characterId)
{
$data = $this->db->query(
'SELECT questtypes_choiceinput_choice_id '.
'FROM questtypes_choiceinput_lists_characters '.
'WHERE questtypes_choiceinput_list_id = ? AND character_id = ? ',
'ii',
$listId, $characterId
);
if(!empty($data)) {
return $data[0]['questtypes_choiceinput_choice_id'];
}
return null;
}
/**
* Set the text for a Quest and correct choice input lists count.
*
* @param int $userId ID of user setting text
* @param int $questId ID of Quest to set text for
* @param string $text Text for Quest
*/
public function setTextForQuest($userId, $questId, $text)
{
$this->db->setAutocommit(false);
try {
// Set text
$this->db->query(
'INSERT INTO questtypes_choiceinput '.
'(quest_id, created_user_id, text) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'text = ?',
'iiss',
$questId,
$userId,
$text,
$text
);
// Count fields
$listCount = substr_count($text, '[choiceinput]');
// Remove fields
$this->db->query(
'DELETE FROM questtypes_choiceinput_lists '.
'WHERE questtypes_choiceinput_quest_id = ? AND number > ?',
'ii',
$questId,
$listCount
);
// Add fields
for($i=1; $i<=$listCount; $i++)
{
$this->db->query(
'INSERT IGNORE INTO questtypes_choiceinput_lists '.
'(questtypes_choiceinput_quest_id, number, questtypes_choiceinput_choice_id) '.
'VALUES '.
'(?, ?, NULL) ',
'ii',
$questId,
$i
);
}
$this->db->commit();
}
catch(\Exception $e) {
$this->db->rollback();
$this->db->setAutocommit(true);
throw $e;
}
$this->db->setAutocommit(true);
}
/**
* Set list of choices for a text.
*
* @param int $questId ID of Quest to set choices for
* @param int $number List number
* @param array $choices List of choices
* @param int $correctPos Position of correct answer
*/
public function setListForText($questId, $number, $choices, $correctPos)
{
// Get ID of list
$listId = $this->db->query(
'SELECT id '.
'FROM questtypes_choiceinput_lists '.
'WHERE questtypes_choiceinput_quest_id = ? AND number = ?',
'ii',
$questId,
$number
);
$listId = $listId[0]['id'];
// Manage choices
$this->db->setAutocommit(false);
try {
// Remove choices
$this->db->query(
'DELETE FROM questtypes_choiceinput_choices '.
'WHERE questtypes_choiceinput_list_id = ? AND pos > ?',
'ii',
$listId,
count($choices)
);
// Add choices
foreach($choices as $index => &$choice)
{
$this->db->query(
'INSERT INTO questtypes_choiceinput_choices '.
'(questtypes_choiceinput_list_id, pos, text) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'text = ?',
'iiss',
$listId,
$index + 1,
$choice,
$choice
);
}
// Set correct choice for list
$this->db->query(
'UPDATE questtypes_choiceinput_lists '.
'SET questtypes_choiceinput_choice_id = ('.
'SELECT id '.
'FROM questtypes_choiceinput_choices '.
'WHERE questtypes_choiceinput_list_id = ? AND pos = ?'.
') '.
'WHERE id = ?',
'iii',
$listId,
$correctPos,
$listId
);
$this->db->commit();
}
catch(\Exception $e) {
$this->db->rollback();
$this->db->setAutocommit(true);
throw $e;
}
$this->db->setAutocommit(true);
}
}
?>

View file

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

View file

@ -0,0 +1,381 @@
<?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\questtypes;
/**
* Controller of the CrosswordQuesttypeAgent for solving a crossword.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class CrosswordQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Save the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get words
$words = $this->Crossword->getWordsForQuest($quest['id']);
// Iterate words
foreach($words as &$word)
{
// Assemble answer for word
$answer = '';
if($word['vertical'])
{
$x = $word['pos_x'];
$startY = $word['pos_y'];
$endY = $startY + mb_strlen($word['word'], 'UTF-8') - 1;
foreach(range($startY, $endY) as $y)
{
if(array_key_exists($x, $answers) && array_key_exists($y, $answers[$x]) && !empty($answers[$x][$y])) {
$answer .= $answers[$x][$y];
}
else {
$answer .= ' ';
}
}
}
else
{
$startX = $word['pos_x'];
$endX = $startX + mb_strlen($word['word'], 'UTF-8') - 1;
$y = $word['pos_y'];
foreach(range($startX, $endX) as $x)
{
if(array_key_exists($x, $answers) && array_key_exists($y, $answers[$x]) && !empty($answers[$x][$y])) {
$answer .= $answers[$x][$y];
}
else {
$answer .= ' ';
}
}
}
// Save answer
$this->Crossword->setCharacterSubmission($word['id'], $character['id'], $answer);
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get words
$words = $this->Crossword->getWordsForQuest($quest['id']);
// Iterate words
foreach($words as &$word)
{
// Assemble answer for word
$answer = '';
if($word['vertical'])
{
$x = $word['pos_x'];
$startY = $word['pos_y'];
$endY = $startY + mb_strlen($word['word'], 'UTF-8') - 1;
foreach(range($startY, $endY) as $y)
{
if(array_key_exists($x, $answers) && array_key_exists($y, $answers[$x]) && !empty($answers[$x][$y])) {
$answer .= $answers[$x][$y];
}
else {
$answer .= ' ';
}
}
}
else
{
$startX = $word['pos_x'];
$endX = $startX + mb_strlen($word['word'], 'UTF-8') - 1;
$y = $word['pos_y'];
foreach(range($startX, $endX) as $x)
{
if(array_key_exists($x, $answers) && array_key_exists($y, $answers[$x]) && !empty($answers[$x][$y])) {
$answer .= $answers[$x][$y];
}
else {
$answer .= ' ';
}
}
}
// Check answer
if(mb_strtolower($word['word'], 'UTF-8') != mb_strtolower($answer, 'UTF-8')) {
return false;
}
}
// All answer right
return true;
}
/**
* Action: quest.
*
* Display a text with lists with predefined values.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Get words
$words = $this->Crossword->getWordsForQuest($quest['id']);
// Create 2D-matrix
$matrix = array();
$maxX = 0;
$maxY = 0;
foreach($words as $index => &$word)
{
if($this->request->getGetParam('show-answer') == 'true' || !$this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']) || $this->request->getGetParam('status') == 'solved') {
$word['answer'] = $this->Crossword->getCharacterSubmission($word['id'], $character['id']);
}
// Insert word
if($word['vertical'])
{
$x = $word['pos_x'];
$startY = $word['pos_y'];
$endY = $startY + mb_strlen($word['word'], 'UTF-8') - 1;
$matrix = array_pad($matrix, $x+1, array());
$matrix[$x] = array_pad($matrix[$x], $endY+1, null);
$maxX = max($maxX, $x);
$maxY = max($maxY, $endY);
foreach(range($startY, $endY) as $y)
{
$matrix[$x][$y] = array(
'char' => mb_substr($word['word'], $y-$startY, 1, 'UTF-8'),
'indices' => (array_key_exists($x, $matrix) && array_key_exists($y, $matrix[$x]) && !is_null($matrix[$x][$y]) && array_key_exists('indices', $matrix[$x][$y])) ? $matrix[$x][$y]['indices'] : array(),
'answer' => null
);
if($y == $startY) {
$matrix[$x][$y]['indices'][] = $index;
}
if(array_key_exists('answer', $word))
{
$answer = mb_substr($word['answer'], $y-$startY, 1, 'UTF-8');
if($answer != ' ') {
$matrix[$x][$y]['answer'] = $answer;
}
}
}
}
else
{
$startX = $word['pos_x'];
$endX = $startX + mb_strlen($word['word'], 'UTF-8') - 1;
$y = $word['pos_y'];
$matrix = array_pad($matrix, $endX+1, array());
$maxX = max($maxX, $endX);
$maxY = max($maxY, $y);
foreach(range($startX, $endX) as $x)
{
$matrix[$x] = array_pad($matrix[$x], $y+1, null);
$matrix[$x][$y] = array(
'char' => mb_substr($word['word'], $x-$startX, 1, 'UTF-8'),
'indices' => (array_key_exists($x, $matrix) && array_key_exists($y, $matrix[$x]) && !is_null($matrix[$x][$y]) && array_key_exists('indices', $matrix[$x][$y])) ? $matrix[$x][$y]['indices'] : array(),
'answer' => null
);
if($x == $startX) {
$matrix[$x][$y]['indices'][] = $index;
}
if(array_key_exists('answer', $word))
{
$answer = mb_substr($word['answer'], $x-$startX, 1, 'UTF-8');
if($answer != ' ') {
$matrix[$x][$y]['answer'] = $answer;
}
}
}
}
}
// Pass data to view
$this->set('words', $words);
$this->set('maxX', $maxX);
$this->set('maxY', $maxY);
$this->set('matrix', $matrix);
}
/**
* Action: submission.
*
* Show the submission of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get words
$words = $this->Crossword->getWordsForQuest($quest['id']);
// Create 2D-matrix
$matrix = array();
$maxX = 0;
$maxY = 0;
foreach($words as $index => &$word)
{
// Character answer
$word['answer'] = $this->Crossword->getCharacterSubmission($word['id'], $character['id']);
// Insert word
if($word['vertical'])
{
$x = $word['pos_x'];
$startY = $word['pos_y'];
$endY = $startY + mb_strlen($word['word'], 'UTF-8') - 1;
$matrix = array_pad($matrix, $x+1, array());
$matrix[$x] = array_pad($matrix[$x], $endY+1, null);
$maxX = max($maxX, $x);
$maxY = max($maxY, $endY);
foreach(range($startY, $endY) as $y)
{
$matrix[$x][$y] = array(
'char' => mb_substr($word['word'], $y-$startY, 1, 'UTF-8'),
'indices' => (array_key_exists($x, $matrix) && array_key_exists($y, $matrix[$x]) && !is_null($matrix[$x][$y]) && array_key_exists('indices', $matrix[$x][$y])) ? $matrix[$x][$y]['indices'] : array(),
'answer' => null,
'right' => false
);
if($y == $startY) {
$matrix[$x][$y]['indices'][] = $index;
}
if(!is_null($word['answer']))
{
$answer = mb_substr($word['answer'], $y-$startY, 1, 'UTF-8');
if($answer != ' ')
{
$matrix[$x][$y]['answer'] = $answer;
$matrix[$x][$y]['right'] = (mb_strtolower($matrix[$x][$y]['char'], 'UTF-8') == mb_strtolower($answer, 'UTF-8'));
}
}
}
}
else
{
$startX = $word['pos_x'];
$endX = $startX + mb_strlen($word['word'], 'UTF-8') - 1;
$y = $word['pos_y'];
$matrix = array_pad($matrix, $endX+1, array());
$maxX = max($maxX, $endX);
$maxY = max($maxY, $y);
foreach(range($startX, $endX) as $x)
{
$matrix[$x] = array_pad($matrix[$x], $y+1, null);
$matrix[$x][$y] = array(
'char' => mb_substr($word['word'], $x-$startX, 1, 'UTF-8'),
'indices' => (array_key_exists($x, $matrix) && array_key_exists($y, $matrix[$x]) && !is_null($matrix[$x][$y]) && array_key_exists('indices', $matrix[$x][$y])) ? $matrix[$x][$y]['indices'] : array(),
'answer' => null,
'right' => false
);
if($x == $startX) {
$matrix[$x][$y]['indices'][] = $index;
}
if(!is_null($word['answer']))
{
$answer = mb_substr($word['answer'], $x-$startX, 1, 'UTF-8');
if($answer != ' ')
{
$matrix[$x][$y]['answer'] = $answer;
$matrix[$x][$y]['right'] = (mb_strtolower($matrix[$x][$y]['char'], 'UTF-8') == mb_strtolower($answer, 'UTF-8'));
}
}
}
}
}
// Pass data to view
$this->set('words', $words);
$this->set('maxX', $maxX);
$this->set('maxY', $maxY);
$this->set('matrix', $matrix);
}
/**
* TODO Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
}
}
?>

View file

@ -0,0 +1,94 @@
<?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\questtypes;
/**
* Model of the CrosswordQuesttypeAgent for solving a crossword.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class CrosswordQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Get all words for a crossword-Quest.
*
* @param int $questId ID of Quest
* @return array Words
*/
public function getWordsForQuest($questId)
{
return $this->db->query(
'SELECT id, question, word, vertical, pos_x, pos_y '.
'FROM questtypes_crossword_words '.
'WHERE quest_id = ? ',
'i',
$questId
);
}
/**
* Save Characters submitted answer for one crossword-word.
*
* @param int $regexId ID of word
* @param int $characterId ID of Character
* @param string $answer Submitted answer for this word
*/
public function setCharacterSubmission($wordId, $characterId, $answer)
{
$this->db->query(
'INSERT INTO questtypes_crossword_words_characters '.
'(questtypes_crossword_word_id, character_id, answer) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'answer = ?',
'iiss',
$wordId, $characterId, $answer,
$answer
);
}
/**
* Get answer of one crossword-word submitted by Character.
*
* @param int $regexId ID of lisword
* @param int $characterId ID of Character
* @return int Submitted answer for this word or null
*/
public function getCharacterSubmission($wordId, $characterId)
{
$data = $this->db->query(
'SELECT answer '.
'FROM questtypes_crossword_words_characters '.
'WHERE questtypes_crossword_word_id = ? AND character_id = ? ',
'ii',
$wordId, $characterId
);
if(!empty($data)) {
return $data[0]['answer'];
}
return null;
}
}
?>

View file

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

View file

@ -0,0 +1,233 @@
<?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\questtypes;
/**
* Controller of the DragndropQuesttypeAgent for Drag&Drop.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class DragndropQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Required models
*
* @var array
*/
public $models = array('media');
/**
* Save the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get Drag&Drop field
$dndField = $this->Dragndrop->getDragndrop($quest['id']);
// Get Drops
$drops = $this->Dragndrop->getDrops($dndField['quest_id']);
// Save user answers
foreach($drops as &$drop)
{
// Determine user answer
$answer = null;
if(array_key_exists($drop['id'], $answers) && !empty($answers[$drop['id']]))
{
$a = intval(substr($answers[$drop['id']], 4));
if($a !== false && $a > 0) {
$answer = $a;
}
}
// Update database record
$this->Dragndrop->setCharacterSubmission($drop['id'], $character['id'], $answer);
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get Drag&Drop field
$dndField = $this->Dragndrop->getDragndrop($quest['id']);
// Get Drags
$drags = $this->Dragndrop->getDrags($dndField['quest_id'], true);
// Match drags with user answers
foreach($drags as &$drag)
{
$founds = array_keys($answers, 'drag'.$drag['id']);
if(count($founds) != 1) {
return false;
}
if(!$this->Dragndrop->dragMatchesDrop($drag['id'], $founds[0])) {
return false;
}
}
// Set status
return true;
}
/**
* Action: quest.
*
* Display a text with input fields and evaluate if user input
* matches with stored regular expressions.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Get Drag&Drop field
$dndField = $this->Dragndrop->getDragndrop($quest['id']);
$dndField['media'] = $this->Media->getSeminaryMediaById($dndField['questmedia_id']);
// Get Drags
$drags = array();
$dragsByIndex = $this->Dragndrop->getDrags($dndField['quest_id']);
foreach($dragsByIndex as &$drag) {
$drag['media'] = $this->Media->getSeminaryMediaById($drag['questmedia_id']);
$drags[$drag['id']] = $drag;
}
// Get Drops
$drops = $this->Dragndrop->getDrops($dndField['quest_id']);
// Get Character answers
if($this->request->getGetParam('show-answer') == 'true' || !$this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']) || $this->request->getGetParam('status') == 'solved')
{
foreach($drops as &$drop)
{
$drop['answer'] = $this->Dragndrop->getCharacterSubmission($drop['id'], $character['id']);
if(!is_null($drop['answer']))
{
$drop['answer'] = $drags[$drop['answer']];
unset($drags[$drop['answer']['id']]);
}
}
}
// Pass data to view
$this->set('seminary', $seminary);
$this->set('field', $dndField);
$this->set('drops', $drops);
$this->set('drags', $drags);
}
/**
* Action: submission.
*
* Show the submission of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get Drag&Drop field
$dndField = $this->Dragndrop->getDragndrop($quest['id']);
$dndField['media'] = $this->Media->getSeminaryMediaById($dndField['questmedia_id']);
// Get Drags
$drags = array();
$dragsByIndex = $this->Dragndrop->getDrags($dndField['quest_id']);
foreach($dragsByIndex as &$drag) {
$drag['media'] = $this->Media->getSeminaryMediaById($drag['questmedia_id']);
$drags[$drag['id']] = $drag;
}
// Get Drops
$drops = $this->Dragndrop->getDrops($dndField['quest_id']);
// Get Character answers
foreach($drops as &$drop)
{
$drop['answer'] = $this->Dragndrop->getCharacterSubmission($drop['id'], $character['id']);
if(!is_null($drop['answer']))
{
$drop['answer'] = $drags[$drop['answer']];
unset($drags[$drop['answer']['id']]);
}
}
// Pass data to view
$this->set('seminary', $seminary);
$this->set('field', $dndField);
$this->set('drops', $drops);
$this->set('drags', $drags);
}
/**
* TODO Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
}
}
?>

View file

@ -0,0 +1,181 @@
<?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\questtypes;
/**
* Model of the DragndropQuesttypeAgent for Drag&Drop.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class DragndropQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Get Drag&Drop-field.
*
* @param int $questId ID of Quest
* @return array Drag&Drop-field
*/
public function getDragndrop($questId)
{
$data = $this->db->query(
'SELECT quest_id, questmedia_id, width, height '.
'FROM questtypes_dragndrop '.
'WHERE quest_id = ?',
'i',
$questId
);
if(!empty($data)) {
return $data[0];
}
return null;
}
/**
* Get Drop-items.
*
* @param int $dragndropId ID of Drag&Drop-field
* @return array Drop-items
*/
public function getDrops($dragndropId)
{
return $this->db->query(
'SELECT id, top, `left`, width, height '. //, questtypes_dragndrop_drag_id '.
'FROM questtypes_dragndrop_drops '.
'WHERE questtypes_dragndrop_id = ?',
'i',
$dragndropId
);
}
/**
* Get Drag-items.
*
* @param int $dragndropId ID of Drag&Drop-field
* @param boolean $onlyUsed Only Drag-items that are used for a Drop-item
* @return array Drag-items
*/
public function getDrags($dragndropId, $onlyUsed=false)
{
return $this->db->query(
'SELECT id, questmedia_id '.
'FROM questtypes_dragndrop_drags '.
'WHERE questtypes_dragndrop_id = ?'.
($onlyUsed
? ' AND EXISTS ('.
'SELECT questtypes_dragndrop_drag_id '.
'FROM questtypes_dragndrop_drops_drags '.
'WHERE questtypes_dragndrop_drag_id = questtypes_dragndrop_drags.id'.
')'
: null
),
'i',
$dragndropId
);
}
/**
* Check if a Drag-item mathes a Drop-item.
*
* @param int $dragId ID of Drag-field
* @param int $dropId ID of Drop-field
* @return boolean Drag-item is valid for Drop-item
*/
public function dragMatchesDrop($dragId, $dropId)
{
$data = $this->db->query(
'SELECT count(*) AS c '.
'FROM questtypes_dragndrop_drops_drags '.
'WHERE questtypes_dragndrop_drop_id = ? AND questtypes_dragndrop_drag_id = ?',
'ii',
$dropId, $dragId
);
if(!empty($data)) {
return ($data[0]['c'] > 0);
}
return false;
}
/**
* Save Characters submitted answer for one Drop-field.
*
* @param int $dropId ID of Drop-field
* @param int $characterId ID of Character
* @param string $answer Submitted Drag-field-ID for this field
*/
public function setCharacterSubmission($dropId, $characterId, $answer)
{
if(is_null($answer))
{
$this->db->query(
'DELETE FROM questtypes_dragndrop_drops_characters '.
'WHERE questtypes_dragndrop_drop_id = ? AND character_id = ?',
'ii',
$dropId, $characterId
);
}
else
{
$this->db->query(
'INSERT INTO questtypes_dragndrop_drops_characters '.
'(questtypes_dragndrop_drop_id, character_id, questtypes_dragndrop_drag_id) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'questtypes_dragndrop_drag_id = ?',
'iiii',
$dropId, $characterId, $answer, $answer
);
}
}
/**
* Get Characters saved answer for one Drop-field.
*
* @param int $dropId ID of Drop-field
* @param int $characterId ID of Character
* @return int ID of Drag-field or null
*/
public function getCharacterSubmission($dropId, $characterId)
{
$data = $this->db->query(
'SELECT questtypes_dragndrop_drag_id '.
'FROM questtypes_dragndrop_drops_characters '.
'WHERE questtypes_dragndrop_drop_id = ? AND character_id = ?',
'ii',
$dropId, $characterId
);
if(!empty($data)) {
return $data[0]['questtypes_dragndrop_drag_id'];
}
return null;
}
}
?>

View file

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

View file

@ -0,0 +1,386 @@
<?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\questtypes;
/**
* Controller of the MultiplechoiceQuesttypeAgent multiple choice.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class MultiplechoiceQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Required components
*
* @var array
*/
public $components = array('validation');
/**
* Save the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Save temporary user answer of last question
$answers = (!is_array($answers)) ? array() : $answers;
$pos = $this->Multiplechoice->getQuestionsCountOfQuest($quest['id']);
$question = $this->Multiplechoice->getQuestionOfQuest($quest['id'], $pos);
$this->saveUserAnswers($quest['id'], $question['id'], $answers);
// Save answers
$questions = $this->Multiplechoice->getQuestionsOfQuest($quest['id']);
foreach($questions as &$question)
{
$userAnswers = $this->getUserAnswers($quest['id'], $question['id']);
$answers = $this->Multiplechoice->getAnswersOfQuestion($question['id']);
foreach($answers as &$answer)
{
$userAnswer = (array_key_exists($answer['pos']-1, $userAnswers)) ? true : false;
$this->Multiplechoice->setCharacterSubmission($answer['id'], $character['id'], $userAnswer);
}
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Save temporary user answer of last question
$answers = (!is_array($answers)) ? array() : $answers;
$pos = $this->Multiplechoice->getQuestionsCountOfQuest($quest['id']);
$question = $this->Multiplechoice->getQuestionOfQuest($quest['id'], $pos);
$this->saveUserAnswers($quest['id'], $question['id'], $answers);
// Get questions
$questions = $this->Multiplechoice->getQuestionsOfQuest($quest['id']);
// Iterate questions
foreach($questions as &$question)
{
// Get answers
$userAnswers = $this->getUserAnswers($quest['id'], $question['id']);
$answers = $this->Multiplechoice->getAnswersOfQuestion($question['id']);
// Match answers with user answers
foreach($answers as &$answer)
{
if(is_null($answer['tick'])) {
continue;
}
if($answer['tick']) {
if(!array_key_exists($answer['pos']-1, $userAnswers)) {
return false;
}
}
else {
if(array_key_exists($answer['pos']-1, $userAnswers)) {
return false;
}
}
}
}
// All questions correct answerd
return true;
}
/**
* Action: quest.
*
* Display questions with a checkbox to let the user choose the
* right ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Get count of questions
$count = $this->Multiplechoice->getQuestionsCountOfQuest($quest['id']);
// Get position
$pos = 1;
if($this->request->getRequestMethod() == 'POST' && !is_null($this->request->getPostParam('submit-answer')))
{
if(!is_null($this->request->getPostParam('question')))
{
// Get current position
$pos = intval($this->request->getPostParam('question'));
if($pos < 0 || $pos > $count) {
throw new \nre\exceptions\ParamsNotValidException($pos);
}
// Save temporary answer of user
$question = $this->Multiplechoice->getQuestionOfQuest($quest['id'], $pos);
$answers = ($this->request->getRequestMethod() == 'POST' && !is_null($this->request->getPostParam('answers'))) ? $this->request->getPostParam('answers') : array();
$this->saveUserAnswers($quest['id'], $question['id'], $answers);
// Go to next position
$pos++;
}
else {
throw new \nre\exceptions\ParamsNotValidException('pos');
}
}
// Get current question
$question = $this->Multiplechoice->getQuestionOfQuest($quest['id'], $pos);
// Get answers
$question['answers'] = $this->Multiplechoice->getAnswersOfQuestion($question['id']);
// Get previous user answers
if($this->request->getGetParam('show-answer') == 'true' || !$this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']) || $this->request->getGetParam('status') == 'solved')
{
foreach($question['answers'] as &$answer) {
$answer['useranswer'] = $this->Multiplechoice->getCharacterSubmission($answer['id'], $character['id']);
}
}
// Pass data to view
$this->set('question', $question);
$this->set('pos', $pos);
$this->set('count', $count);
}
/**
* Action: submission.
*
* Show the submission of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get questions
$questions = $this->Multiplechoice->getQuestionsOfQuest($quest['id']);
// Get answers
foreach($questions as &$question)
{
$question['answers'] = $this->Multiplechoice->getAnswersOfQuestion($question['id']);
// Get user answers
foreach($question['answers'] as &$answer) {
$answer['useranswer'] = $this->Multiplechoice->getCharacterSubmission($answer['id'], $character['id']);
}
}
// Pass data to view
$this->set('questions', $questions);
}
/**
* Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
// Get questions
$questions = $this->Multiplechoice->getQuestionsOfQuest($quest['id']);
foreach($questions as &$question) {
$question['answers'] = $this->Multiplechoice->getAnswersOfQuestion($question['id']);
}
// Values
$validations = array();
// Save data
if($this->request->getRequestMethod() == 'POST' && !is_null($this->request->getPostParam('save')))
{
// Get params and validate them
$questions = $this->request->getPostParam('questions');
if(is_null($questions)) {
$questions = array();
}
$questions = array_values($questions);
foreach($questions as $questionIndex => &$question)
{
// Validate answers
$question['answers'] = array_values($question['answers']);
foreach($question['answers'] as $answerIndex => &$answer)
{
$answerValidation = $this->Validation->validate($answer['answer'], \nre\configs\AppConfig::$validation['answer']);
if($answerValidation !== true)
{
if(!array_key_exists($questionIndex, $validations) || !is_array($validations[$questionIndex])) {
$validations[$questionIndex] = array();
}
if(!array_key_exists('answers', $validations[$questionIndex])) {
$validations[$questionIndex]['answers'] = array();
}
$validations[$questionIndex]['answers'][$answerIndex] = $answerValidation;
}
}
}
// Save and redirect
if(empty($validations))
{
// Save questions
foreach($questions as $questionIndex => &$question)
{
// Save question
$this->Multiplechoice->setQuestionForQuest(
$this->Auth->getUserId(),
$quest['id'],
$questionIndex + 1,
$question['question']
);
// Save answers
foreach($question['answers'] as $answerIndex => &$answer)
{
$this->Multiplechoice->setAnswerForQuestion(
$this->Auth->getUserId(),
$quest['id'],
$questionIndex + 1,
$answerIndex + 1,
$answer['answer'],
array_key_exists('tick', $answer)
);
}
// Delete deleted answers
$this->Multiplechoice->deleteAnswersOfQuestion(
$quest['id'],
$questionIndex + 1,
count($question['answers'])
);
}
// Delete deleted questions
$this->Multiplechoice->deleteQuestionsOfQuest(
$quest['id'],
count($questions)
);
// Redirect
$this->redirect($this->linker->link(array('quest', $seminary['url'], $questgroup['url'], $quest['url']), 1));
}
}
// Pass data to view
$this->set('questions', $questions);
$this->set('validations', $validations);
}
/**
* Save the answers of a user for a question temporary in the
* session.
*
* @param int $questId ID of Quest
* @param int $questionId ID of multiple choice question
* @param array $userAnswers Answers of user for the question
*/
private function saveUserAnswers($questId, $questionId, $userAnswers)
{
// Ensure session structure
if(!array_key_exists('answers', $_SESSION)) {
$_SESSION['answers'] = array();
}
if(!array_key_exists($questId, $_SESSION['answers'])) {
$_SESSION['answers'][$questId] = array();
}
$_SESSION['answers'][$questId][$questionId] = array();
// Save answres
foreach($userAnswers as $pos => &$answer) {
$_SESSION['answers'][$questId][$questionId][$pos] = $answer;
}
}
/**
* Get the temporary saved answers of a user for a question.
*
* @param int $questId ID of Quest
* @param int $questionId ID of multiple choice question
* @return array Answers of user for the question
*/
private function getUserAnswers($questId, $questionId)
{
// Ensure session structure
if(!array_key_exists('answers', $_SESSION)) {
$_SESSION['answers'] = array();
}
if(!array_key_exists($questId, $_SESSION['answers'])) {
$_SESSION['answers'][$questId] = array();
}
if(!array_key_exists($questionId, $_SESSION['answers'][$questId])) {
$_SESSION['answers'][$questId][$questionId] = array();
}
// Return answers
return $_SESSION['answers'][$questId][$questionId];
}
}
?>

View file

@ -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\questtypes;
/**
* Model of the MultiplechoiceQuesttypeAgent for multiple choice.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class MultiplechoiceQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Get the count of multiple choice questions for a Quest.
*
* @param int $questId ID of Quest to get count for
* @return int Conut of questions
*/
public function getQuestionsCountOfQuest($questId)
{
$data = $this->db->query(
'SELECT count(id) AS c '.
'FROM questtypes_multiplechoice '.
'WHERE quest_id = ?',
'i',
$questId
);
if(!empty($data)) {
return $data[0]['c'];
}
return 0;
}
/**
* Get all multiple choice questions of a Quest.
*
* @param int $questId ID of Quest
* @return array Multiple choice questions
*/
public function getQuestionsOfQuest($questId)
{
return $this->db->query(
'SELECT id, pos, question '.
'FROM questtypes_multiplechoice '.
'WHERE quest_id = ?',
'i',
$questId
);
}
/**
* Get one multiple choice question of a Quest.
*
* @param int $questId ID of Quest
* @param int $pos Position of question
* @return array Question data
*/
public function getQuestionOfQuest($questId, $pos)
{
$data = $this->db->query(
'SELECT id, pos, question '.
'FROM questtypes_multiplechoice '.
'WHERE quest_id = ? AND pos = ?',
'ii',
$questId, $pos
);
if(!empty($data)) {
return $data[0];
}
return null;
}
/**
* Get all answers of a multiple choice question.
*
* @param int $questionId ID of multiple choice question
* @return array Answers of question
*/
public function getAnswersOfQuestion($questionId)
{
return $this->db->query(
'SELECT id, pos, answer, tick '.
'FROM questtypes_multiplechoice_answers '.
'WHERE questtypes_multiplechoice_id = ?',
'i',
$questionId
);
}
/**
* Save Characters submitted answer for one option.
*
* @param int $answerId ID of multiple choice answer
* @param int $characterId ID of Character
* @param boolean $answer Submitted answer for this option
*/
public function setCharacterSubmission($answerId, $characterId, $answer)
{
$this->db->query(
'INSERT INTO questtypes_multiplechoice_characters '.
'(questtypes_multiplechoice_answer_id, character_id, ticked) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'ticked = ?',
'iiii',
$answerId, $characterId, $answer, $answer
);
}
/**
* Get answer of one option submitted by Character.
*
* @param int $answerId ID of multiple choice answer
* @param int $characterId ID of Character
* @return boolean Submitted answer of Character or false
*/
public function getCharacterSubmission($answerId, $characterId)
{
$data = $this->db->query(
'SELECT ticked '.
'FROM questtypes_multiplechoice_characters '.
'WHERE questtypes_multiplechoice_answer_id = ? AND character_id = ? ',
'ii',
$answerId, $characterId
);
if(!empty($data)) {
return $data[0]['ticked'];
}
return false;
}
/**
* Set a question for a multiplechoice Quest.
*
* @param int $userId ID of user
* @param int $questId ID of Quest to set question for
* @param int $pos Position of question
* @param string $question Question text
*/
public function setQuestionForQuest($userId, $questId, $pos, $question)
{
$this->db->query(
'INSERT INTO questtypes_multiplechoice '.
'(created_user_id, quest_id, pos, question) '.
'VALUES '.
'(?, ?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'question = ?',
'iiiss',
$userId,
$questId,
$pos,
$question,
$question
);
}
/**
* Delete questions of a Quest.
*
* @param int $questId ID of Quest to delete question of
* @param int $offset Only delete questions after this position
*/
public function deleteQuestionsOfQuest($questId, $offset)
{
$this->db->query(
'DELETE FROM questtypes_multiplechoice '.
'WHERE quest_id = ? AND pos > ?',
'ii',
$questId,
$offset
);
}
/**
* Set an answer for a question.
*
* @param int $userId ID of user
* @param int $questId ID of Quest to set answer for
* @param int $questionPos Position of question
* @param int $answerPos Position of answer
* @param string $answer Answer text
* @param boolean $tick Whether answer is correct or not
*/
public function setAnswerForQuestion($userId, $questId, $questionPos, $answerPos, $answer, $tick)
{
// Get question
$question = $this->getQuestionOfQuest($questId, $questionPos);
if(is_null($question)) {
return;
}
// Add answer
$this->db->query(
'INSERT INTO questtypes_multiplechoice_answers '.
'(created_user_id, questtypes_multiplechoice_id, pos, answer, tick) '.
'VALUES '.
'(?, ?, ?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'answer = ?, tick = ?',
'iiisisi',
$userId,
$question['id'],
$answerPos,
$answer,
$tick,
$answer,
$tick
);
}
/**
* Delete answers of a question.
*
* @param int $questId ID of Quest to delete answers for
* @param int $questionPos Position of question
* @param int $offset Only delete answers after this position
*/
public function deleteAnswersOfQuestion($questId, $questionPos, $offset)
{
// Get question
$question = $this->getQuestionOfQuest($questId, $questionPos);
if(is_null($question)) {
return;
}
// Delete answer
$this->db->query(
'DELETE FROM questtypes_multiplechoice_answers '.
'WHERE questtypes_multiplechoice_id = ? AND pos > ?',
'ii',
$question['id'],
$offset
);
}
}
?>

View file

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

View file

@ -0,0 +1,242 @@
<?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\questtypes;
/**
* Controller of the SubmitQuesttypeAgent for a submit task.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class SubmitQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Required models
*
* @var array
*/
public $models = array('quests', 'uploads', 'users');
/**
* Save the answers of a Character for a Quest.
*
* @throws \hhu\z\exceptions\SubmissionNotValidException
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Save answer
if(array_key_exists('answers', $_FILES))
{
$answer = $_FILES['answers'];
// Check error
if($answer['error'] !== 0) {
throw new \hhu\z\exceptions\SubmissionNotValidException(
new \hhu\z\exceptions\FileUploadException($answer['error'])
);
}
// Check mimetype
$mimetypes = $this->Submit->getAllowedMimetypes($seminary['id']);
$answerMimetype = null;
$answer['mimetype'] = \hhu\z\Utils::getMimetype($answer['tmp_name'], $answer['type']);
foreach($mimetypes as &$mimetype) {
if($mimetype['mimetype'] == $answer['mimetype']) {
$answerMimetype = $mimetype;
break;
}
}
if(is_null($answerMimetype)) {
throw new \hhu\z\exceptions\SubmissionNotValidException(
new \hhu\z\exceptions\WrongFiletypeException($answer['mimetype'])
);
}
// Check file size
if($answer['size'] > $answerMimetype['size']) {
throw new \hhu\z\exceptions\SubmissionNotValidException(
new \hhu\z\exceptions\MaxFilesizeException()
);
}
// Create filename
$filename = sprintf(
'%s,%s,%s.%s',
$character['url'],
mb_substr($quest['url'], 0, 32),
date('Ymd-His'),
mb_substr(mb_substr($answer['name'], strrpos($answer['name'], '.')+1), 0, 4)
);
// Save file
if(!$this->Submit->setCharacterSubmission($seminary['id'], $quest['id'], $this->Auth->getUserId(), $character['id'], $answer, $filename)) {
throw new \hhu\z\exceptions\SubmissionNotValidException(
new \hhu\z\exceptions\FileUploadException(error_get_last()['message'])
);
}
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
$this->Submit->addCommentForCharacterAnswer($this->Auth->getUserId(), $data['submission_id'], $data['comment']);
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// A moderator has to evaluate the answer
return null;
}
/**
* Action: quest.
*
* Display a big textbox to let the user enter a text that has
* to be evaluated by a moderator.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Answers (Submissions)
$characterSubmissions = $this->Submit->getCharacterSubmissions($quest['id'], $character['id']);
foreach($characterSubmissions as &$submission)
{
$submission['upload'] = $this->Uploads->getSeminaryuploadById($submission['upload_id']);
$submission['comments'] = $this->Submit->getCharacterSubmissionComments($submission['id']);
foreach($submission['comments'] as &$comment)
{
try {
$comment['user'] = $this->Users->getUserById($comment['created_user_id']);
$comment['user']['character'] = $this->Characters->getCharacterForUserAndSeminary($comment['user']['id'], $seminary['id']);
}
catch(\nre\exceptions\IdNotFoundException $e) {
}
}
}
// Show answer of Character
if($this->request->getGetParam('show-answer') == 'true') {
$this->redirect($this->linker->link(array('uploads','seminary',$seminary['url'], $characterSubmissions[count($characterSubmissions)-1]['upload']['url'])));
}
// Has Character already solved Quest?
$solved = $this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']);
// Last Quest status for Character
$lastStatus = $this->Quests->getLastQuestStatus($quest['id'], $character['id']);
// Get allowed mimetypes
$mimetypes = $this->Submit->getAllowedMimetypes($seminary['id']);
// Pass data to view
$this->set('seminary', $seminary);
$this->set('submissions', $characterSubmissions);
$this->set('solved', $solved);
$this->set('lastStatus', $lastStatus);
$this->set('mimetypes', $mimetypes);
$this->set('exception', $exception);
}
/**
* Action: submission.
*
* Show the submission of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get Character submissions
$submissions = $this->Submit->getCharacterSubmissions($quest['id'], $character['id']);
foreach($submissions as &$submission)
{
$submission['upload'] = $this->Uploads->getSeminaryuploadById($submission['upload_id']);
$submission['comments'] = $this->Submit->getCharacterSubmissionComments($submission['id']);
foreach($submission['comments'] as &$comment)
{
try {
$comment['user'] = $this->Users->getUserById($comment['created_user_id']);
$comment['user']['character'] = $this->Characters->getCharacterForUserAndSeminary($comment['user']['id'], $seminary['id']);
}
catch(\nre\exceptions\IdNotFoundException $e) {
}
}
}
// Status
$solved = $this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']);
// Pass data to view
$this->set('seminary', $seminary);
$this->set('submissions', $submissions);
$this->set('solved', $solved);
}
/**
* TODO Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
}
}
?>

View file

@ -0,0 +1,145 @@
<?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\questtypes;
/**
* Model of the SubmitQuesttypeAgent for a submit task.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class SubmitQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Required models
*
* @var array
*/
public $models = array('uploads');
/**
* Save Characters submitted upload.
*
* @param int $seminaryId ID of Seminary
* @param int $questId ID of Quest
* @param int $userId ID of user
* @param int $characterId ID of Character
* @param array $file Submitted upload
* @param string $filename Name of submitted file
*/
public function setCharacterSubmission($seminaryId, $questId, $userId, $characterId, $file, $filename)
{
// Save file on harddrive
$uploadId = $this->Uploads->uploadSeminaryFile($userId, $seminaryId, $file['name'], $filename, $file['tmp_name'], $file['type']);
if($uploadId === false) {
return false;
}
// Create database record
$this->db->query(
'INSERT INTO questtypes_submit_characters '.
'(quest_id, character_id, upload_id) '.
'VALUES '.
'(?, ?, ?) ',
'iii',
$questId, $characterId, $uploadId
);
return true;
}
/**
* Add a comment for the answer of a Character.
*
* @param int $userId ID of user that comments
* @param int $submissionId ID of Character answer to comment
* @param string $comment Comment text
*/
public function addCommentForCharacterAnswer($userId, $submissionId, $comment)
{
$this->db->query(
'INSERT INTO questtypes_submit_characters_comments '.
'(created_user_id, questtypes_submit_character_id, comment) '.
'VALUES '.
'(?, ?, ?)',
'iis',
$userId,
$submissionId,
$comment
);
}
/**
* Get all uploads submitted by Character.
*
* @param int $questId ID of Quest
* @param int $characterId ID of Character
* @return array Text submitted by Character or NULL
*/
public function getCharacterSubmissions($questId, $characterId)
{
return $this->db->query(
'SELECT id, created, upload_id '.
'FROM questtypes_submit_characters '.
'WHERE quest_id = ? AND character_id = ? '.
'ORDER BY created ASC',
'ii',
$questId, $characterId
);
}
/**
* Get allowed mimetypes for uploading a file.
*
* @param int $seminaryId ID of Seminary
* @return array Allowed mimetypes
*/
public function getAllowedMimetypes($seminaryId)
{
return $this->db->query(
'SELECT id, mimetype, size '.
'FROM questtypes_submit_mimetypes '.
'WHERE seminary_id = ?',
'i',
$seminaryId
);
}
/**
* Get all comments for a Character submission.
*
* @param int $characterSubmissionId ID of Character submission
* @return array Comments for this submission
*/
public function getCharacterSubmissionComments($characterSubmissionId)
{
return $this->db->query(
'SELECT id, created, created_user_id, comment '.
'FROM questtypes_submit_characters_comments '.
'WHERE questtypes_submit_character_id = ?',
'i',
$characterSubmissionId
);
}
}
?>

View file

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

View file

@ -0,0 +1,308 @@
<?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\questtypes;
/**
* Controller of the TextinputQuesttypeAgent for for inserting text.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class TextinputQuesttypeController extends \hhu\z\controllers\QuesttypeController
{
/**
* Required components
*
* @var array
*/
public $components = array('validation');
/**
* Save the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
*/
public function saveAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get fields
$fields = $this->Textinput->getTextinputFields($quest['id']);
// Save answers
foreach($fields as &$field)
{
$pos = intval($field['number']) - 1;
$answer = (array_key_exists($pos, $answers)) ? $answers[$pos] : '';
$this->Textinput->setCharacterSubmission($field['id'], $character['id'], $answer);
}
}
/**
* Save additional data for the answers of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $data Additional (POST-) data
*/
public function saveDataForCharacterAnswers($seminary, $questgroup, $quest, $character, $data)
{
}
/**
* Check if answers of a Character for a Quest match the correct ones.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param array $answers Character answers for the Quest
* @return boolean True/false for a right/wrong answer or null for moderator evaluation
*/
public function matchAnswersOfCharacter($seminary, $questgroup, $quest, $character, $answers)
{
// Get right answers
$fields = $this->Textinput->getTextinputFields($quest['id']);
// Match regexs with user answers
foreach($fields as &$field)
{
$pos = intval($field['number']) - 1;
if(!array_key_exists($pos, $answers)) {
return false;
}
if(!$this->isMatching($field['regex'], $answers[$pos])) {
return false;
}
}
// All answers right
return true;
}
/**
* Action: quest.
*
* Display a text with input fields and evaluate if user input
* matches with stored regular expressions.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
* @param \Exception $exception Character submission exception
*/
public function quest($seminary, $questgroup, $quest, $character, $exception)
{
// Get Task
$task = $this->Textinput->getTextinputQuest($quest['id']);
// Get fields
$fields = $this->Textinput->getTextinputFields($quest['id']);
// Has Character already solved Quest?
$solved = $this->Quests->hasCharacterSolvedQuest($quest['id'], $character['id']);
// Get Character answers
if(!$solved || $this->request->getGetParam('show-answer') == 'true' || $this->request->getGetParam('status') == 'solved') {
foreach($fields as &$field) {
$field['answer'] = $this->Textinput->getCharacterSubmission($field['id'], $character['id']);
}
}
// Pass data to view
$this->set('task', $task);
$this->set('fields', $fields);
}
/**
* Action: submission.
*
* Show the submission of a Character for a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
* @param array $character Current Character data
*/
public function submission($seminary, $questgroup, $quest, $character)
{
// Get Task
$task = $this->Textinput->getTextinputQuest($quest['id']);
// Process text
$textParts = preg_split('/(\$\$)/', ' '.$task['text'].' ');
// Get fields
$fields = $this->Textinput->getTextinputFields($quest['id']);
// Get Character answers
foreach($fields as &$field)
{
$field['answer'] = $this->Textinput->getCharacterSubmission($field['id'], $character['id']);
$field['right'] = $this->isMatching($field['regex'], $field['answer']);
}
// Pass data to view
$this->set('task', $task);
$this->set('fields', $fields);
}
/**
* Action: edittask.
*
* Edit the task of a Quest.
*
* @param array $seminary Current Seminary data
* @param array $questgroup Current Questgroup data
* @param array $quest Current Quest data
*/
public function edittask($seminary, $questgroup, $quest)
{
// Get Task
$task = $this->Textinput->getTextinputQuest($quest['id']);
$text = $task['text'];
// Get fields
$fields = $this->Textinput->getTextinputFields($quest['id']);
// Get field sizes
$fieldSizes = $this->Textinput->getFieldSizes();
// Values
$validations = array();
// Save data
if($this->request->getRequestMethod() == 'POST')
{
if(!is_null($this->request->getPostParam('preview')) || !is_null($this->request->getPostParam('save')))
{
// Get params and validate them
if(is_null($this->request->getPostParam('text'))) {
throw new \nre\exceptions\ParamsNotValidException('text');
}
$text = $this->request->getPostParam('text');
if(is_null($this->request->getPostParam('fields'))) {
throw new \nre\exceptions\ParamsNotValidException('fields');
}
$fields = $this->request->getPostParam('fields');
$fields = array_values($fields);
$fieldIndex = 0;
foreach($fields as &$field)
{
// Validate regex
$regex = $field['regex'];
$fieldValidation = @preg_match($regex, '') !== false;
if($fieldValidation !== true)
{
if(!array_key_exists($fieldIndex, $validations) || !is_array($validations[$fieldIndex])) {
$validations[$fieldIndex] = array();
}
$validations[$fieldIndex] = $this->Validation->addValidationResults($validations[$fieldIndex], 'regex', $fieldValidation);
}
// Validate size
foreach($fieldSizes as $sizeIndex => &$size)
{
if($size['size'] == $field['size'])
{
$field['sizeIndex'] = $sizeIndex;
break;
}
}
if(!array_key_exists('sizeIndex', $field)) {
throw new \nre\exceptions\ParamsNotValidException($fieldIndex);
}
$fieldIndex++;
}
// Save and redirect
if(!is_null($this->request->getPostParam('save')) && empty($validations))
{
// Save text
$this->Textinput->setTextForQuest(
$this->Auth->getUserId(),
$quest['id'],
$text
);
// Save field
foreach($fields as $index => &$field)
{
// Add regex modifiers
$modifiers = substr($field['regex'], strrpos($field['regex'], $field['regex'][0]) + 1);
if(strpos($modifiers, 'u') === false) {
$field['regex'] .= 'u';
}
// Save field
$this->Textinput->setFieldForText(
$quest['id'],
$index + 1,
$fieldSizes[$field['sizeIndex']]['id'],
$field['regex']
);
}
// Redirect
$this->redirect($this->linker->link(array('quest', $seminary['url'], $questgroup['url'], $quest['url']), 1));
}
}
}
// Pass data to view
$this->set('task', $task);
$this->set('text', $text);
$this->set('fields', $fields);
$this->set('fieldSizes', $fieldSizes);
$this->set('validations', $validations);
}
/**
* Check if an Character answer matches a Regex.
*
* @param string $regex Regex to match against
* @param string $answer Character answer to match
* @return boolean Whether answer matches Regex or not
*/
private function isMatching($regex, $answer)
{
$score = preg_match($regex, trim($answer));
return ($score !== false && $score > 0);
}
}
?>

View file

@ -0,0 +1,222 @@
<?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\questtypes;
/**
* Model of the TextinputQuesttypeAgent for inserting text.
*
* @author Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
*/
class TextinputQuesttypeModel extends \hhu\z\models\QuesttypeModel
{
/**
* Get textinput-text for a Quest.
*
* @param int $questId ID of Quest
* @return array Textinput-text
*/
public function getTextinputQuest($questId)
{
$data = $this->db->query(
'SELECT text '.
'FROM questtypes_textinput '.
'WHERE quest_id = ?',
'i',
$questId
);
if(!empty($data)) {
return $data[0];
}
return null;
}
/**
* Get fields for a textinput-text.
*
* @param int $questId ID of Quest
* @return array Fields
*/
public function getTextinputFields($questId)
{
return $this->db->query(
'SELECT fields.id, fields.number, fields.regex, fieldsizes.id AS fieldsize_id, fieldsizes.size '.
'FROM questtypes_textinput_fields AS fields '.
'LEFT JOIN questtypes_textinput_fieldsizes AS fieldsizes ON fieldsizes.id = fields.questtypes_textinput_fieldsize_id '.
'WHERE fields.questtypes_textinput_quest_id = ? '.
'ORDER BY fields.number ASC',
'i',
$questId
);
}
/**
* Save Characters submitted answer for one textinput field.
*
* @param int $fieldId ID of field
* @param int $characterId ID of Character
* @param string $answer Submitted answer for this field
*/
public function setCharacterSubmission($fieldId, $characterId, $answer)
{
$this->db->query(
'INSERT INTO questtypes_textinput_fields_characters '.
'(questtypes_textinput_field_id, character_id, value) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'value = ?',
'iiss',
$fieldId, $characterId, $answer, $answer
);
}
/**
* Get answer of one input field submitted by Character.
*
* @param int $fieldId ID of field
* @param int $characterId ID of Character
* @return string Submitted answer for this field or empty string
*/
public function getCharacterSubmission($fieldId, $characterId)
{
$data = $this->db->query(
'SELECT value '.
'FROM questtypes_textinput_fields_characters '.
'WHERE questtypes_textinput_field_id = ? AND character_id = ? ',
'ii',
$fieldId, $characterId
);
if(!empty($data)) {
return $data[0]['value'];
}
return '';
}
/**
* Set the text for a Quest and correct fields count.
*
* @param int $userId ID of user setting text
* @param int $questId ID of Quest to set text for
* @param string $text Text for Quest
*/
public function setTextForQuest($userId, $questId, $text)
{
$this->db->setAutocommit(false);
try {
// Set text
$this->db->query(
'INSERT INTO questtypes_textinput '.
'(quest_id, created_user_id, text) '.
'VALUES '.
'(?, ?, ?) '.
'ON DUPLICATE KEY UPDATE '.
'text = ?',
'iiss',
$questId,
$userId,
$text,
$text
);
// Count fields
$fieldCount = substr_count($text, '[textinput]');
// Remove fields
$this->db->query(
'DELETE FROM questtypes_textinput_fields '.
'WHERE questtypes_textinput_quest_id = ? AND number > ?',
'ii',
$questId,
$fieldCount
);
// Add fields
for($i=1; $i<=$fieldCount; $i++)
{
$this->db->query(
'INSERT IGNORE INTO questtypes_textinput_fields '.
'(questtypes_textinput_quest_id, number, regex) '.
'VALUES '.
'(?, ?, ?) ',
'iis',
$questId,
$i,
''
);
}
$this->db->commit();
}
catch(\Exception $e) {
$this->db->rollback();
$this->db->setAutocommit(true);
throw $e;
}
$this->db->setAutocommit(true);
}
/**
* Set values for a field of a text.
*
* @param int $questId ID of Quest to set field for
* @param int $number Field number
* @param int $sizeId ID of field size
* @param string $regex RegEx for field
*/
public function setFieldForText($questId, $number, $sizeId, $regex)
{
$this->db->query(
'UPDATE questtypes_textinput_fields '.
'SET questtypes_textinput_fieldsize_id = ?, regex = ? '.
'WHERE questtypes_textinput_quest_id = ? AND number = ?',
'isii',
$sizeId,
$regex,
$questId,
$number
);
}
/**
* Get all registered field sizes.
*
* @return List of field sizes
*/
public function getFieldSizes()
{
return $this->db->query(
'SELECT id, size '.
'FROM questtypes_textinput_fieldsizes '.
'ORDER BY size'
);
}
}
?>