class MultichoiceQuestion in Quiz 8.6
Same name and namespace in other branches
- 8.5 question_types/quiz_multichoice/src/Plugin/quiz/QuizQuestion/MultichoiceQuestion.php \Drupal\quiz_multichoice\Plugin\quiz\QuizQuestion\MultichoiceQuestion
- 6.x question_types/quiz_multichoice/src/Plugin/quiz/QuizQuestion/MultichoiceQuestion.php \Drupal\quiz_multichoice\Plugin\quiz\QuizQuestion\MultichoiceQuestion
@QuizQuestion ( id = "multichoice", label =
Plugin annotation
@Translation("Multiple choice question"),
handlers = {
"response" = "\Drupal\quiz_multichoice\Plugin\quiz\QuizQuestion\MultichoiceResponse"
}
)
Hierarchy
- class \Drupal\Core\Entity\EntityBase implements EntityInterface uses RefinableCacheableDependencyTrait, DependencySerializationTrait
- class \Drupal\Core\Entity\ContentEntityBase implements \Drupal\Core\Entity\IteratorAggregate, ContentEntityInterface, TranslationStatusInterface uses EntityChangesDetectionTrait, SynchronizableEntityTrait
- class \Drupal\Core\Entity\EditorialContentEntityBase implements EntityChangedInterface, EntityPublishedInterface, RevisionLogInterface uses EntityChangedTrait, EntityPublishedTrait, RevisionLogEntityTrait
- class \Drupal\quiz\Entity\QuizQuestion uses QuizQuestionEntityTrait
- class \Drupal\quiz_multichoice\Plugin\quiz\QuizQuestion\MultichoiceQuestion
- class \Drupal\quiz\Entity\QuizQuestion uses QuizQuestionEntityTrait
- class \Drupal\Core\Entity\EditorialContentEntityBase implements EntityChangedInterface, EntityPublishedInterface, RevisionLogInterface uses EntityChangedTrait, EntityPublishedTrait, RevisionLogEntityTrait
- class \Drupal\Core\Entity\ContentEntityBase implements \Drupal\Core\Entity\IteratorAggregate, ContentEntityInterface, TranslationStatusInterface uses EntityChangesDetectionTrait, SynchronizableEntityTrait
Expanded class hierarchy of MultichoiceQuestion
File
- question_types/
quiz_multichoice/ src/ Plugin/ quiz/ QuizQuestion/ MultichoiceQuestion.php, line 27
Namespace
Drupal\quiz_multichoice\Plugin\quiz\QuizQuestionView source
class MultichoiceQuestion extends QuizQuestion {
function save() {
// Before we save we forgive some possible user errors.
// @todo fix for D8
//$this->forgive();
return parent::save();
}
/**
* Forgive some possible logical flaws in the user input.
*/
private function forgive() {
if ($this->node->choice_multi == 1) {
for ($i = 0; isset($this->node->alternatives[$i]); $i++) {
$short =& $this->node->alternatives[$i];
// If the scoring data doesn't make sense, use the data from the
// "correct" checkbox to set the score data.
if ($short['score_if_chosen'] == $short['score_if_not_chosen'] || !is_numeric($short['score_if_chosen']) || !is_numeric($short['score_if_not_chosen'])) {
if (!empty($short['correct'])) {
$short['score_if_chosen'] = 1;
$short['score_if_not_chosen'] = 0;
}
else {
if (variable_get('multichoice_def_scoring', 0) == 0) {
$short['score_if_chosen'] = -1;
$short['score_if_not_chosen'] = 0;
}
elseif (variable_get('multichoice_def_scoring', 0) == 1) {
$short['score_if_chosen'] = 0;
$short['score_if_not_chosen'] = 1;
}
}
}
}
}
else {
// For questions with one, and only one, correct answer, there will be
// no points awarded for alternatives not chosen.
for ($i = 0; isset($this->node->alternatives[$i]); $i++) {
$short =& $this->node->alternatives[$i];
$short['score_if_not_chosen'] = 0;
if (isset($short['correct']) && $short['correct'] == 1 && !_quiz_is_int($short['score_if_chosen'], 1)) {
$short['score_if_chosen'] = 1;
}
}
}
}
/**
* Warn the user about possible user errors.
*/
private function warn() {
// Count the number of correct answers.
$num_corrects = 0;
for ($i = 0; isset($this->node->alternatives[$i]); $i++) {
$alt =& $this->node->alternatives[$i];
if ($alt['score_if_chosen'] > $alt['score_if_not_chosen']) {
$num_corrects++;
}
}
if ($num_corrects == 1 && $this->node->choice_multi == 1 || $num_corrects > 1 && $this->node->choice_multi == 0) {
$link_options = array();
if (isset($_GET['destination'])) {
$link_options['query'] = array(
'destination' => $_GET['destination'],
);
}
$go_back = l(t('go back'), 'quiz/' . $this->node->nid . '/edit', $link_options);
if ($num_corrects == 1) {
Drupal::messenger()
->addWarning(t("Your question allows multiple answers. Only one of the alternatives have been marked as correct. If this wasn't intended please !go_back and correct it.", array(
'!go_back' => $go_back,
)), 'warning');
}
else {
Drupal::messenger()
->addWarning(t("Your question doesn't allow multiple answers. More than one of the alternatives have been marked as correct. If this wasn't intended please !go_back and correct it.", array(
'!go_back' => $go_back,
)), 'warning');
}
}
}
/**
* Run check_markup() on the field of the specified choice alternative.
*
* @param string $alternativeIndex
* The index of the alternative in the alternatives array.
* @param string $field
* The name of the field we want to check markup on.
* @param bool $check_user_access
* Whether or not to check for user access to the filter we're trying to
* apply.
*
* @return string
* The filtered text.
*/
private function checkMarkup($alternativeIndex, $field, $check_user_access = FALSE) {
$alternative = $this->node->alternatives[$alternativeIndex];
return check_markup($alternative[$field]['value'], $alternative[$field]['format']);
}
/**
* Implementation of saveNodeProperties().
*
* @see QuizQuestion::saveNodeProperties()
*/
public function saveNodeProperties($is_new = FALSE) {
$is_new = $is_new || !empty($this->node->revision);
// We also add warnings on other possible user errors.
$this
->warn();
if ($is_new) {
$id = db_insert('quiz_multichoice_properties')
->fields(array(
'nid' => $this->node->nid,
'vid' => $this->node->vid,
'choice_multi' => $this->node->choice_multi,
'choice_random' => $this->node->choice_random,
'choice_boolean' => $this->node->choice_boolean,
))
->execute();
// TODO: utilize the benefit of multiple insert of DBTNG.
for ($i = 0; isset($this->node->alternatives[$i]); $i++) {
if (drupal_strlen($this->node->alternatives[$i]['answer']['value']) > 0) {
$this
->insertAlternative($i);
}
}
}
else {
db_update('quiz_multichoice_properties')
->fields(array(
'choice_multi' => $this->node->choice_multi,
'choice_random' => $this->node->choice_random,
'choice_boolean' => $this->node->choice_boolean,
))
->condition('nid', $this->node->nid)
->condition('vid', $this->node->vid)
->execute();
// We fetch ids for the existing answers belonging to this question.
// We need to figure out if an existing alternative has been changed or
// deleted.
$res = db_query('SELECT id FROM {quiz_multichoice_answers}
WHERE question_nid = :nid AND question_vid = :vid', array(
':nid' => $this->node->nid,
':vid' => $this->node->vid,
));
// We start by assuming that all existing alternatives needs to be
// deleted.
$ids_to_delete = array();
while ($res_o = $res
->fetch()) {
$ids_to_delete[] = $res_o->id;
}
for ($i = 0; isset($this->node->alternatives[$i]); $i++) {
$short = $this->node->alternatives[$i];
if (drupal_strlen($this->node->alternatives[$i]['answer']['value']) > 0) {
// If new alternative.
if (!is_numeric($short['id'])) {
$this
->insertAlternative($i);
}
else {
$this
->updateAlternative($i);
// Make sure this alternative isn't deleted.
$key = array_search($short['id'], $ids_to_delete);
$ids_to_delete[$key] = FALSE;
}
}
}
foreach ($ids_to_delete as $id_to_delete) {
if ($id_to_delete) {
db_delete('quiz_multichoice_answers')
->condition('id', $id_to_delete)
->execute();
}
}
}
$this
->saveUserSettings();
}
/**
* Helper function. Normalizes alternatives.
*
* @param array $alternatives
*
* @return array
*/
private function _normalizeAlternative($alternatives) {
$copy = $alternatives;
// Answer and answer format.
if (is_array($alternatives['answer'])) {
$copy['answer'] = array_key_exists('value', $alternatives['answer']) ? $alternatives['answer']['value'] : NULL;
$copy['answer_format'] = array_key_exists('format', $alternatives['answer']) ? $alternatives['answer']['format'] : NULL;
}
// Feedback if chosen and feedback if chosen format.
if (is_array($alternatives['feedback_if_chosen'])) {
$copy['feedback_if_chosen'] = array_key_exists('value', $alternatives['feedback_if_chosen']) ? $alternatives['feedback_if_chosen']['value'] : NULL;
$copy['feedback_if_chosen_format'] = array_key_exists('format', $alternatives['feedback_if_chosen']) ? $alternatives['feedback_if_chosen']['format'] : NULL;
}
// Feedback if not chosen and feedback if not chosen format.
if (is_array($alternatives['feedback_if_not_chosen'])) {
$copy['feedback_if_not_chosen'] = array_key_exists('value', $alternatives['feedback_if_not_chosen']) ? $alternatives['feedback_if_not_chosen']['value'] : NULL;
$copy['feedback_if_not_chosen_format'] = array_key_exists('format', $alternatives['feedback_if_not_chosen']) ? $alternatives['feedback_if_not_chosen']['format'] : NULL;
}
return $copy;
}
/**
* Helper function. Saves new alternatives.
*
* @param int $i
* The alternative index.
*/
private function insertAlternative($i) {
$alternatives = $this
->_normalizeAlternative($this->node->alternatives[$i]);
db_insert('quiz_multichoice_answers')
->fields(array(
'answer' => $alternatives['answer'],
'answer_format' => $alternatives['answer_format'],
'feedback_if_chosen' => $alternatives['feedback_if_chosen'],
'feedback_if_chosen_format' => $alternatives['feedback_if_chosen_format'],
'feedback_if_not_chosen' => $alternatives['feedback_if_not_chosen'],
'feedback_if_not_chosen_format' => $alternatives['feedback_if_not_chosen_format'],
'score_if_chosen' => $alternatives['score_if_chosen'],
'score_if_not_chosen' => $alternatives['score_if_not_chosen'],
'question_nid' => $this->node->nid,
'question_vid' => $this->node->vid,
'weight' => isset($alternatives['weight']) ? $alternatives['weight'] : $i,
))
->execute();
}
/**
* Helper function. Updates existing alternatives.
*
* @param $i
* The alternative index.
*/
private function updateAlternative($i) {
$alternatives = $this
->_normalizeAlternative($this->node->alternatives[$i]);
db_update('quiz_multichoice_answers')
->fields(array(
'answer' => $alternatives['answer'],
'answer_format' => $alternatives['answer_format'],
'feedback_if_chosen' => $alternatives['feedback_if_chosen'],
'feedback_if_chosen_format' => $alternatives['feedback_if_chosen_format'],
'feedback_if_not_chosen' => $alternatives['feedback_if_not_chosen'],
'feedback_if_not_chosen_format' => $alternatives['feedback_if_not_chosen_format'],
'score_if_chosen' => $alternatives['score_if_chosen'],
'score_if_not_chosen' => $alternatives['score_if_not_chosen'],
'weight' => isset($alternatives['weight']) ? $alternatives['weight'] : $i,
))
->condition('id', $alternatives['id'])
->condition('question_nid', $this->node->nid)
->condition('question_vid', $this->node->vid)
->execute();
}
/**
* Implementation of validateNode().
*
* @see QuizQuestion::validateNode()
*/
public function validateNode(array &$form) {
if ($this->node->choice_multi == 0) {
$found_one_correct = FALSE;
for ($i = 0; isset($this->node->alternatives[$i]) && is_array($this->node->alternatives[$i]); $i++) {
$short = $this->node->alternatives[$i];
if (drupal_strlen($this
->checkMarkup($i, 'answer')) < 1) {
continue;
}
if ($short['correct'] == 1) {
if ($found_one_correct) {
// We don't display an error message here since we allow
// alternatives to be partially correct.
}
else {
$found_one_correct = TRUE;
}
}
}
if (!$found_one_correct) {
form_set_error('choice_multi', t('You have not marked any alternatives as correct. If there are no correct alternatives you should allow multiple answers.'));
}
}
else {
for ($i = 0; isset($this->node->alternatives[$i]); $i++) {
$short = $this->node->alternatives[$i];
if (strlen($this
->checkMarkup($i, 'answer')) < 1) {
continue;
}
if ($short['score_if_chosen'] < $short['score_if_not_chosen'] && $short['correct']) {
form_set_error("alternatives][{$i}][score_if_not_chosen", t("The alternative is marked as correct, but gives more points if you don't select it."));
}
elseif ($short['score_if_chosen'] > $short['score_if_not_chosen'] && !$short['correct']) {
form_set_error("alternatives][{$i}][score_if_chosen", t('The alternative is not marked as correct, but gives more points if you select it.'));
}
}
}
}
/**
* Implementation of delete().
*
* @see QuizQuestion::delete()
*/
public function delete($only_this_version = FALSE) {
$delete_properties = db_delete('quiz_multichoice_properties')
->condition('nid', $this->node->nid);
$delete_answers = db_delete('quiz_multichoice_answers')
->condition('question_nid', $this->node->nid);
if ($only_this_version) {
$delete_properties
->condition('vid', $this->node->vid);
$delete_answers
->condition('question_vid', $this->node->vid);
}
$delete_properties
->execute();
$delete_answers
->execute();
parent::delete($only_this_version);
}
/**
* Implementation of getNodeProperties().
*
* @see QuizQuestion::getNodeProperties()
*/
public function getNodeProperties() {
if (isset($this->nodeProperties) && !empty($this->nodeProperties)) {
return $this->nodeProperties;
}
$props = parent::getNodeProperties();
$res_a = db_query('SELECT choice_multi, choice_random, choice_boolean FROM {quiz_multichoice_properties}
WHERE nid = :nid AND vid = :vid', array(
':nid' => $this->node->nid,
':vid' => $this->node->vid,
))
->fetchAssoc();
if (is_array($res_a)) {
$props = array_merge($props, $res_a);
}
// Load the answers.
$res = db_query('SELECT id, answer, answer_format, feedback_if_chosen, feedback_if_chosen_format,
feedback_if_not_chosen, feedback_if_not_chosen_format, score_if_chosen, score_if_not_chosen, weight
FROM {quiz_multichoice_answers}
WHERE question_nid = :question_nid AND question_vid = :question_vid
ORDER BY weight', array(
':question_nid' => $this->node->nid,
':question_vid' => $this->node->vid,
));
// Init array so it can be iterated even if empty.
$props['alternatives'] = array();
while ($res_arr = $res
->fetchAssoc()) {
$props['alternatives'][] = array(
'id' => $res_arr['id'],
'answer' => array(
'value' => $res_arr['answer'],
'format' => $res_arr['answer_format'],
),
'feedback_if_chosen' => array(
'value' => $res_arr['feedback_if_chosen'],
'format' => $res_arr['feedback_if_chosen_format'],
),
'feedback_if_not_chosen' => array(
'value' => $res_arr['feedback_if_not_chosen'],
'format' => $res_arr['feedback_if_not_chosen_format'],
),
'score_if_chosen' => $res_arr['score_if_chosen'],
'score_if_not_chosen' => $res_arr['score_if_not_chosen'],
'weight' => $res_arr['weight'],
);
}
$this->nodeProperties = $props;
return $props;
}
/**
* Implementation of getNodeView().
*
* @see QuizQuestion::getNodeView()
*/
public function getNodeView() {
$content = parent::getNodeView();
if ($this->node->choice_random) {
$this
->shuffle($this->node->alternatives);
}
$content['answers'] = array(
'#markup' => theme('multichoice_answer_node_view', array(
'alternatives' => $this->node->alternatives,
'show_correct' => $this
->viewCanRevealCorrect(),
)),
'#weight' => 2,
);
return $content;
}
/**
* {@inheritdoc}
*/
public function getAnsweringForm(FormStateInterface $form_state, QuizResultAnswer $quizQuestionResultAnswer) {
$element = parent::getAnsweringForm($form_state, $quizQuestionResultAnswer);
foreach ($this
->get('alternatives')
->referencedEntities() as $alternative) {
/* @var $alternative Paragraph */
$uuid = $alternative
->get('uuid')
->getString();
$alternatives[$uuid] = $alternative;
}
// Build options list.
$element['user_answer'] = [
'#type' => 'tableselect',
'#header' => [
'answer' => t('Answer'),
],
'#js_select' => FALSE,
'#multiple' => $this
->get('choice_multi')
->getString(),
];
// @todo see https://www.drupal.org/project/drupal/issues/2986517
// There is some way to label the elements.
foreach ($alternatives as $uuid => $alternative) {
$vid = $alternative
->getRevisionId();
$answer_markup = check_markup($alternative
->get('multichoice_answer')
->getValue()[0]['value'], $alternative
->get('multichoice_answer')
->getValue()[0]['format']);
$element['user_answer']['#options'][$vid]['title']['data']['#title'] = $answer_markup;
$element['user_answer']['#options'][$vid]['answer'] = $answer_markup;
}
if ($this
->get('choice_random')
->getString()) {
// We save the choice order so that the order will be the same in the
// answer report.
$element['choice_order'] = array(
'#type' => 'hidden',
'#value' => implode(',', $this
->shuffle($element['user_answer']['#options'])),
);
}
if ($quizQuestionResultAnswer
->isAnswered()) {
$choices = $quizQuestionResultAnswer
->getResponse();
if ($this
->get('choice_multi')
->getString()) {
foreach ($choices as $choice) {
$element['user_answer']['#default_value'][$choice] = TRUE;
}
}
else {
$element['user_answer']['#default_value'] = reset($choices);
}
}
return $element;
}
/**
* Custom shuffle function.
*
* It keeps the array key - value relationship intact.
*
* @param array $array
*
* @return array
*/
private function shuffle(array &$array) {
$newArray = array();
$toReturn = array_keys($array);
shuffle($toReturn);
foreach ($toReturn as $key) {
$newArray[$key] = $array[$key];
}
$array = $newArray;
return $toReturn;
}
/**
* Implementation of getCreationForm().
*
* @see QuizQuestion::getCreationForm()
*/
public function getCreationForm(array &$form_state = NULL) {
$form = array();
$type = node_type_get_type($this->node);
// We add #action to the form because of the use of ajax.
$options = array();
$get = $_GET;
unset($get['q']);
if (!empty($get)) {
$options['query'] = $get;
}
$action = url('quiz/add/' . $type->type, $options);
if (isset($this->node->nid)) {
$action = url('quiz/' . $this->node->nid . '/edit', $options);
}
$form['#action'] = $action;
drupal_add_tabledrag('multichoice-alternatives-table', 'order', 'sibling', 'multichoice-alternative-weight');
$form['alternatives'] = array(
'#type' => 'fieldset',
'#title' => t('Answer'),
'#collapsible' => TRUE,
'#collapsed' => FALSE,
'#weight' => -4,
'#tree' => TRUE,
);
// Get the nodes settings, users settings or default settings.
$default_settings = $this
->getDefaultAltSettings();
$form['alternatives']['settings'] = array(
'#type' => 'fieldset',
'#title' => t('Settings'),
'#collapsible' => TRUE,
'#collapsed' => FALSE,
'#description' => t('Your settings will be remembered.'),
'#weight' => 30,
);
$form['alternatives']['settings']['choice_multi'] = array(
'#type' => 'checkbox',
'#title' => t('Multiple answers'),
'#description' => t('Allow any number of answers(checkboxes are used). If this box is not checked, one, and only one answer is allowed(radiobuttons are used).'),
'#default_value' => $default_settings['choice_multi'],
'#parents' => array(
'choice_multi',
),
);
$form['alternatives']['settings']['choice_random'] = array(
'#type' => 'checkbox',
'#title' => t('Random order'),
'#description' => t('Present alternatives in random order when @quiz is being taken.', array(
'@quiz' => _quiz_get_quiz_name(),
)),
'#default_value' => $default_settings['choice_random'],
'#parents' => array(
'choice_random',
),
);
$form['alternatives']['settings']['choice_boolean'] = array(
'#type' => 'checkbox',
'#title' => t('Simple scoring'),
'#description' => t('Give max score if everything is correct. Zero points otherwise.'),
'#default_value' => $default_settings['choice_boolean'],
'#parents' => array(
'choice_boolean',
),
);
$form['alternatives']['#theme'][] = 'multichoice_creation_form';
$i = 0;
// choice_count might be stored in the form_state after an ajax callback.
if (isset($form_state['values']['op']) && $form_state['values']['op'] == t('Add choice')) {
$form_state['choice_count']++;
}
else {
$form_state['choice_count'] = max(variable_get('multichoice_def_num_of_alts', 2), isset($this->node->alternatives) ? count($this->node->alternatives) : 0);
}
$form['alternatives']['#prefix'] = '<div class="clear-block" id="multichoice-alternatives-wrapper">';
$form['alternatives']['#suffix'] = '</div>';
$form['alternatives']['#theme'] = array(
'multichoice_alternative_creation_table',
);
for ($i = 0; $i < $form_state['choice_count']; $i++) {
$short = isset($this->node->alternatives[$i]) ? $this->node->alternatives[$i] : NULL;
$form['alternatives'][$i] = array(
'#type' => 'container',
'#collapsible' => TRUE,
'#collapsed' => FALSE,
);
if (is_array($short)) {
if ($short['score_if_chosen'] == $short['score_if_not_chosen']) {
$correct_default = isset($short['correct']) ? $short['correct'] : FALSE;
}
else {
$correct_default = $short['score_if_chosen'] > $short['score_if_not_chosen'];
}
}
else {
$correct_default = FALSE;
}
$form['alternatives'][$i]['correct'] = array(
'#type' => 'checkbox',
'#title' => t('Correct'),
'#default_value' => $correct_default,
'#attributes' => array(
'onchange' => 'Multichoice.refreshScores(this, ' . variable_get('multichoice_def_scoring', 0) . ')',
),
);
// We add id to be able to update the correct alternatives if the node
// is updated, without destroying existing answer reports.
$form['alternatives'][$i]['id'] = array(
'#type' => 'value',
'#value' => $short['id'],
);
$form['alternatives'][$i]['answer'] = array(
'#type' => 'text_format',
'#default_value' => $short['answer']['value'],
'#required' => $i < 2,
'#format' => isset($short['answer']['format']) ? $short['answer']['format'] : NULL,
'#rows' => 3,
);
$form['alternatives'][$i]['advanced'] = array(
'#type' => 'fieldset',
'#title' => t('Advanced options'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$form['alternatives'][$i]['advanced']['feedback_if_chosen'] = array(
'#type' => 'text_format',
'#title' => t('Feedback if chosen'),
'#description' => t('This feedback is given to users who chooses this alternative.'),
'#parents' => array(
'alternatives',
$i,
'feedback_if_chosen',
),
'#default_value' => $short['feedback_if_chosen']['value'],
'#format' => isset($short['feedback_if_chosen']['format']) ? $short['feedback_if_chosen']['format'] : NULL,
'#rows' => 3,
);
// We add 'helper' to trick the current version of the wysiwyg module to
// add an editor to several textareas in the same fieldset.
$form['alternatives'][$i]['advanced']['helper']['feedback_if_not_chosen'] = array(
'#type' => 'text_format',
'#title' => t('Feedback if not chosen'),
'#description' => t("This feedback is given to users who doesn't choose this alternative."),
'#parents' => array(
'alternatives',
$i,
'feedback_if_not_chosen',
),
'#default_value' => $short['feedback_if_not_chosen']['value'],
'#format' => isset($short['feedback_if_not_chosen']['format']) ? $short['feedback_if_not_chosen']['format'] : NULL,
'#rows' => 3,
);
$default_value = isset($this->node->alternatives[$i]['score_if_chosen']) ? $this->node->alternatives[$i]['score_if_chosen'] : 0;
$form['alternatives'][$i]['advanced']['score_if_chosen'] = array(
'#type' => 'textfield',
'#title' => t('Score if chosen'),
'#size' => 4,
'#default_value' => $default_value,
'#description' => t("This score is added to the user's total score if the user chooses this alternative."),
'#attributes' => array(
'onkeypress' => 'Multichoice.refreshCorrect(this)',
'onkeyup' => 'Multichoice.refreshCorrect(this)',
'onchange' => 'Multichoice.refreshCorrect(this)',
),
'#parents' => array(
'alternatives',
$i,
'score_if_chosen',
),
);
$default_value = $short['score_if_not_chosen'];
if (!isset($default_value)) {
$default_value = '0';
}
$form['alternatives'][$i]['advanced']['score_if_not_chosen'] = array(
'#type' => 'textfield',
'#title' => t('Score if not chosen'),
'#size' => 4,
'#default_value' => $default_value,
'#description' => t("This score is added to the user's total score if the user doesn't choose this alternative. Only used if multiple answers are allowed."),
'#attributes' => array(
'onkeypress' => 'Multichoice.refreshCorrect(this)',
'onkeyup' => 'Multichoice.refreshCorrect(this)',
'onchange' => 'Multichoice.refreshCorrect(this)',
),
'#parents' => array(
'alternatives',
$i,
'score_if_not_chosen',
),
);
$form['alternatives'][$i]['weight'] = array(
'#type' => 'textfield',
'#size' => 2,
'#attributes' => array(
'class' => array(
'multichoice-alternative-weight',
),
),
'#default_value' => isset($this->node->alternatives[$i]['weight']) ? $this->node->alternatives[$i]['weight'] : $i,
);
// Add remove button.
$form['alternatives'][$i]['remove_button'] = array(
'#delta' => $i,
'#name' => 'alternatives__' . $i . '__remove_button',
'#type' => 'submit',
'#value' => t('Remove'),
'#validate' => array(),
'#submit' => array(
'multichoice_remove_alternative_submit',
),
'#limit_validation_errors' => array(),
'#ajax' => array(
'callback' => 'multichoice_remove_alternative_ajax_callback',
'effect' => 'fade',
'wrapper' => 'multichoice-alternatives-wrapper',
),
'#weight' => 1000,
);
}
$form['alternatives']['multichoice_add_alternative'] = array(
'#type' => 'button',
'#value' => t('Add choice'),
'#ajax' => array(
'method' => 'replace',
'wrapper' => 'multichoice-alternatives-wrapper',
'callback' => 'multichoice_add_alternative_ajax_callback',
),
'#weight' => 20,
'#limit_validation_errors' => array(),
);
//$form['#attached']['js'] = array(
// @todo not allowed
//drupal_get_path('module', 'multichoice') . '/multichoice.js',
//);
return $form;
}
/**
* Helper function providing the default settings for the creation form.
*
* @return array
* Array with the default settings.
*/
private function getDefaultAltSettings() {
// If the node is being updated the default settings are those stored in the
// node.
if (isset($this->node->nid)) {
$settings['choice_multi'] = $this->node->choice_multi;
$settings['choice_random'] = $this->node->choice_random;
$settings['choice_boolean'] = $this->node->choice_boolean;
}
elseif ($settings = $this
->getUserSettings()) {
}
else {
$settings['choice_multi'] = 0;
$settings['choice_random'] = 0;
$settings['choice_boolean'] = 0;
}
return $settings;
}
/**
* Fetches the users default settings for the creation form.
*
* @return array|false
* The users default node settings or FALSE if nothing found.
*/
private function getUserSettings() {
$user = \Drupal::currentUser();
$res = db_query('SELECT choice_multi, choice_boolean, choice_random
FROM {quiz_multichoice_user_settings}
WHERE uid = :uid', array(
':uid' => $user
->id(),
))
->fetchAssoc();
if ($res) {
return $res;
}
else {
return FALSE;
}
}
/**
* Save the users default settings to the database.
*/
private function saveUserSettings() {
$user = \Drupal::currentUser();
db_merge('quiz_multichoice_user_settings')
->key(array(
'uid' => $user
->id(),
))
->fields(array(
'choice_random' => $this->node->choice_random,
'choice_multi' => $this->node->choice_multi,
'choice_boolean' => $this->node->choice_boolean,
))
->execute();
}
/**
* {@inheritdoc}
*/
public function getMaximumScore() {
if ($this
->get('choice_boolean')
->getString()) {
// Simple scoring - can only be worth 1 point.
return 1;
}
$maxes = [
0,
];
foreach ($this
->get('alternatives')
->referencedEntities() as $alternative) {
// "Not chosen" could have a positive point amount.
$maxes[] = max($alternative
->get('multichoice_score_chosen')
->getString(), $alternative
->get('multichoice_score_not_chosen')
->getString());
}
if ($this
->get('choice_multi')
->getString()) {
// For multiple answers, return the maximum possible points of all
// positively pointed answers.
return array_sum($maxes);
}
else {
// For a single answer, return the highest pointed amount.
return max($maxes);
}
}
/**
* {@inheritdoc}
*/
public static function getAnsweringFormValidate(array &$element, FormStateInterface $form_state) {
$mcq = $form_state
->getBuildInfo()['args'][0];
if (!$mcq
->get('choice_multi')
->getString() && empty($element['user_answer']['#value'])) {
$form_state
->setError($element, t('You must provide an answer.'));
}
parent::getAnsweringFormValidate($element, $form_state);
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CacheableDependencyTrait:: |
protected | property | Cache contexts. | |
CacheableDependencyTrait:: |
protected | property | Cache max-age. | |
CacheableDependencyTrait:: |
protected | property | Cache tags. | |
CacheableDependencyTrait:: |
protected | function | Sets cacheability; useful for value object constructors. | |
ContentEntityBase:: |
protected | property | Language code identifying the entity active language. | |
ContentEntityBase:: |
protected | property | Local cache for the default language code. | |
ContentEntityBase:: |
protected | property | The default langcode entity key. | |
ContentEntityBase:: |
protected | property | Whether the revision translation affected flag has been enforced. | |
ContentEntityBase:: |
protected | property | Holds untranslatable entity keys such as the ID, bundle, and revision ID. | |
ContentEntityBase:: |
protected | property | Local cache for field definitions. | |
ContentEntityBase:: |
protected | property | The array of fields, each being an instance of FieldItemListInterface. | |
ContentEntityBase:: |
protected static | property | Local cache for fields to skip from the checking for translation changes. | |
ContentEntityBase:: |
protected | property | Indicates whether this is the default revision. | |
ContentEntityBase:: |
protected | property | The language entity key. | |
ContentEntityBase:: |
protected | property | Local cache for the available language objects. | |
ContentEntityBase:: |
protected | property | The loaded revision ID before the new revision was set. | |
ContentEntityBase:: |
protected | property | Boolean indicating whether a new revision should be created on save. | |
ContentEntityBase:: |
protected | property | The revision translation affected entity key. | |
ContentEntityBase:: |
protected | property | Holds translatable entity keys such as the label. | |
ContentEntityBase:: |
protected | property | A flag indicating whether a translation object is being initialized. | |
ContentEntityBase:: |
protected | property | An array of entity translation metadata. | |
ContentEntityBase:: |
protected | property | Whether entity validation was performed. | |
ContentEntityBase:: |
protected | property | Whether entity validation is required before saving the entity. | |
ContentEntityBase:: |
protected | property | The plain data values of the contained fields. | |
ContentEntityBase:: |
public | function |
Checks data value access. Overrides EntityBase:: |
1 |
ContentEntityBase:: |
public | function |
Adds a new translation to the translatable object. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the bundle of the entity. Overrides EntityBase:: |
|
ContentEntityBase:: |
public static | function |
Provides field definitions for a specific bundle. Overrides FieldableEntityInterface:: |
4 |
ContentEntityBase:: |
protected | function | Clear entity translation object cache to remove stale references. | |
ContentEntityBase:: |
public | function |
Creates a duplicate of the entity. Overrides EntityBase:: |
1 |
ContentEntityBase:: |
public | function |
Gets a field item list. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Gets the value of the given entity key, if defined. | 1 |
ContentEntityBase:: |
public | function |
Gets the definition of a contained field. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of field definitions of all contained fields. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of all field item lists. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Returns an array of field names to skip in ::hasTranslationChanges. | 1 |
ContentEntityBase:: |
public | function | ||
ContentEntityBase:: |
protected | function | ||
ContentEntityBase:: |
public | function |
Gets the loaded Revision ID of the entity. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the revision identifier of the entity. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of field item lists for translatable fields. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Gets a translated field. | |
ContentEntityBase:: |
public | function |
Gets a translation of the data. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the languages the data is translated to. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the translation status. Overrides TranslationStatusInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the translatable object referring to the original language. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Determines whether the entity has a field with the given name. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Checks there is a translation for the given language code. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Determines if the current translation of the entity has unsaved changes. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the identifier. Overrides EntityBase:: |
|
ContentEntityBase:: |
protected | function | Instantiates a translation object for an existing translation. | |
ContentEntityBase:: |
public | function |
Checks if this entity is the default revision. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the translation is the default one. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks if untranslatable fields should affect only the default translation. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks if this entity is the latest revision. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether this is the latest revision affecting this translation. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Determines whether a new revision should be created on save. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the translation is new. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the current translation is affected by the current revision. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks if the revision translation affected flag value has been enforced. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Returns the translation support status. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether entity validation is required before saving the entity. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets the label of the entity. Overrides EntityBase:: |
2 |
ContentEntityBase:: |
public | function |
Gets the language of the entity. Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function |
Reacts to changes to a field. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Acts on a created entity before hooks are invoked. Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function |
Acts on a saved entity before the insert or update hook is invoked. Overrides EntityBase:: |
5 |
ContentEntityBase:: |
public | function |
Acts on an entity before the presave hook is invoked. Overrides EntityBase:: |
5 |
ContentEntityBase:: |
public | function |
Acts on a revision before it gets saved. Overrides RevisionableInterface:: |
2 |
ContentEntityBase:: |
public | function |
Gets a list of entities referenced by this entity. Overrides EntityBase:: |
1 |
ContentEntityBase:: |
public | function |
Removes the translation identified by the given language code. Overrides TranslatableInterface:: |
|
ContentEntityBase:: |
public | function |
Sets a field value. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
protected | function | Populates the local cache for the default language code. | |
ContentEntityBase:: |
public | function |
Enforces an entity to be saved as a new revision. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Marks the current revision translation as affected. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Enforces the revision translation affected flag value. Overrides TranslatableRevisionableInterface:: |
|
ContentEntityBase:: |
public | function |
Sets whether entity validation is required before saving the entity. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Gets an array of all property values. Overrides EntityBase:: |
|
ContentEntityBase:: |
protected | function | Updates language for already instantiated fields. | |
ContentEntityBase:: |
public | function |
Updates the loaded Revision ID with the revision ID. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function | Updates the original values with the interim changes. | |
ContentEntityBase:: |
public | function |
Gets the entity UUID (Universally Unique Identifier). Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function |
Validates the currently set values. Overrides FieldableEntityInterface:: |
|
ContentEntityBase:: |
public | function |
Checks whether the entity object was a default revision when it was saved. Overrides RevisionableInterface:: |
|
ContentEntityBase:: |
public | function | Magic method: Implements a deep clone. | |
ContentEntityBase:: |
public | function |
Constructs an Entity object. Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function | Implements the magic method for getting object properties. | |
ContentEntityBase:: |
public | function | Implements the magic method for isset(). | |
ContentEntityBase:: |
public | function | Implements the magic method for setting object properties. | |
ContentEntityBase:: |
public | function |
Overrides EntityBase:: |
|
ContentEntityBase:: |
public | function | Implements the magic method for unset(). | |
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | Aliased as: traitSleep | 1 |
DependencySerializationTrait:: |
public | function | 2 | |
EntityBase:: |
protected | property | Boolean indicating whether the entity should be forced to be new. | |
EntityBase:: |
protected | property | The entity type. | |
EntityBase:: |
protected | property | A typed data object wrapping this entity. | |
EntityBase:: |
public static | function |
Constructs a new entity object, without permanently saving it. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Enforces an entity to be new. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | Gets the entity manager. | |
EntityBase:: |
protected | function | Gets the entity type bundle info service. | |
EntityBase:: |
protected | function | Gets the entity type manager. | |
EntityBase:: |
public | function |
The cache contexts associated with this object. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
The maximum age for which this object may be cached. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
The cache tags associated with this object. Overrides CacheableDependencyTrait:: |
|
EntityBase:: |
public | function |
Returns the cache tags that should be used to invalidate caches. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Gets the key that is used to store configuration dependencies. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the configuration dependency name. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Gets the configuration target identifier for the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Gets the entity type definition. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the ID of the type of the entity. Overrides EntityInterface:: |
|
EntityBase:: |
protected | function | The list cache tags to invalidate for this entity. | |
EntityBase:: |
public | function |
Gets the original ID. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Gets a typed data object for this entity object. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Indicates if a link template exists for a given key. Overrides EntityInterface:: |
|
EntityBase:: |
protected static | function | Invalidates an entity's cache tags upon delete. | 1 |
EntityBase:: |
protected | function | Invalidates an entity's cache tags upon save. | 1 |
EntityBase:: |
public | function |
Determines whether the entity is new. Overrides EntityInterface:: |
2 |
EntityBase:: |
protected | function | Gets the language manager. | |
EntityBase:: |
public | function |
Deprecated way of generating a link to the entity. See toLink(). Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets an array link templates. | 1 |
EntityBase:: |
public static | function |
Loads an entity. Overrides EntityInterface:: |
|
EntityBase:: |
public static | function |
Loads one or more entities. Overrides EntityInterface:: |
|
EntityBase:: |
public static | function |
Acts on deleted entities before the delete hook is invoked. Overrides EntityInterface:: |
16 |
EntityBase:: |
public static | function |
Acts on loaded entities. Overrides EntityInterface:: |
2 |
EntityBase:: |
public static | function |
Changes the values of an entity before it is created. Overrides EntityInterface:: |
5 |
EntityBase:: |
public static | function |
Acts on entities before they are deleted and before hooks are invoked. Overrides EntityInterface:: |
4 |
EntityBase:: |
public | function |
Sets the original ID. Overrides EntityInterface:: |
1 |
EntityBase:: |
public | function |
Generates the HTML for a link to this entity. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Gets a list of URI relationships supported by this entity. Overrides EntityInterface:: |
|
EntityBase:: |
public | function |
Gets the public URL for this entity. Overrides EntityInterface:: |
2 |
EntityBase:: |
public | function |
Gets the URL object for the entity. Overrides EntityInterface:: |
1 |
EntityBase:: |
protected | function | Gets an array of placeholders for this entity. | 2 |
EntityBase:: |
protected | function | Gets the UUID generator. | |
EntityChangedTrait:: |
public | function | Gets the timestamp of the last entity change for the current translation. | |
EntityChangedTrait:: |
public | function | Returns the timestamp of the last entity change across all translations. | |
EntityChangedTrait:: |
public | function | Sets the timestamp of the last entity change for the current translation. | |
EntityChangesDetectionTrait:: |
protected | function | Returns an array of field names to skip when checking for changes. Aliased as: traitGetFieldsToSkipFromTranslationChangesCheck | |
EntityPublishedTrait:: |
public | function | ||
EntityPublishedTrait:: |
public static | function | Returns an array of base field definitions for publishing status. | |
EntityPublishedTrait:: |
public | function | ||
EntityPublishedTrait:: |
public | function | ||
MultichoiceQuestion:: |
private | function | Run check_markup() on the field of the specified choice alternative. | |
MultichoiceQuestion:: |
public | function |
Implementation of delete(). Overrides EntityBase:: |
|
MultichoiceQuestion:: |
private | function | Forgive some possible logical flaws in the user input. | |
MultichoiceQuestion:: |
public | function |
Get the form through which the user will answer the question. Overrides QuizQuestionEntityTrait:: |
|
MultichoiceQuestion:: |
public static | function |
Validate a user's answer. Overrides QuizQuestionEntityTrait:: |
|
MultichoiceQuestion:: |
public | function | Implementation of getCreationForm(). | |
MultichoiceQuestion:: |
private | function | Helper function providing the default settings for the creation form. | |
MultichoiceQuestion:: |
public | function |
Get the maximum possible score for this question. Overrides QuizQuestionEntityTrait:: |
|
MultichoiceQuestion:: |
public | function | Implementation of getNodeProperties(). | |
MultichoiceQuestion:: |
public | function |
Implementation of getNodeView(). Overrides QuizQuestionEntityTrait:: |
|
MultichoiceQuestion:: |
private | function | Fetches the users default settings for the creation form. | |
MultichoiceQuestion:: |
private | function | Helper function. Saves new alternatives. | |
MultichoiceQuestion:: |
function |
Saves an entity permanently. Overrides QuizQuestion:: |
||
MultichoiceQuestion:: |
public | function | Implementation of saveNodeProperties(). | |
MultichoiceQuestion:: |
private | function | Save the users default settings to the database. | |
MultichoiceQuestion:: |
private | function | Custom shuffle function. | |
MultichoiceQuestion:: |
private | function | Helper function. Updates existing alternatives. | |
MultichoiceQuestion:: |
public | function | Implementation of validateNode(). | |
MultichoiceQuestion:: |
private | function | Warn the user about possible user errors. | |
MultichoiceQuestion:: |
private | function | Helper function. Normalizes alternatives. | |
QuizQuestion:: |
public static | function |
Provides base field definitions for an entity type. Overrides EditorialContentEntityBase:: |
|
QuizQuestionEntityTrait:: |
protected | function | This may be overridden in subclasses. If it returns true, it means the max_score is updated for all occurrences of this question in quizzes. | |
QuizQuestionEntityTrait:: |
public | function | Allow question types to override the body field title. | |
QuizQuestionEntityTrait:: |
protected | function | Utility function that returns the format of the node body. | |
QuizQuestionEntityTrait:: |
public | function | Returns a node form to quiz_question_form. | |
QuizQuestionEntityTrait:: |
public | function | Get the response to this question in a quiz result. | |
QuizQuestionEntityTrait:: |
public | function | Finds out if a question has been answered or not. | |
QuizQuestionEntityTrait:: |
public | function | Does this question type give feedback? | 2 |
QuizQuestionEntityTrait:: |
public | function | Is this question graded? | 2 |
QuizQuestionEntityTrait:: |
public | function | Is this "question" an actual question? | 2 |
QuizQuestionEntityTrait:: |
public | function | Determines if the user can view the correct answers. | |
RefinableCacheableDependencyTrait:: |
public | function | 1 | |
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::getRevisionCreationTime(). | 1 |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::getRevisionLogMessage(). | 1 |
RevisionLogEntityTrait:: |
protected static | function | Gets the name of a revision metadata field. | |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::getRevisionUser(). | 1 |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::getRevisionUserId(). | 1 |
RevisionLogEntityTrait:: |
public static | function | Provides revision-related base field definitions for an entity type. | |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::setRevisionCreationTime(). | 1 |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::setRevisionLogMessage(). | 1 |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::setRevisionUser(). | 1 |
RevisionLogEntityTrait:: |
public | function | Implements \Drupal\Core\Entity\RevisionLogInterface::setRevisionUserId(). | 1 |
SynchronizableEntityTrait:: |
protected | property | Whether this entity is being created, updated or deleted through a synchronization process. | |
SynchronizableEntityTrait:: |
public | function | ||
SynchronizableEntityTrait:: |
public | function | ||
TranslationStatusInterface:: |
constant | Status code identifying a newly created translation. | ||
TranslationStatusInterface:: |
constant | Status code identifying an existing translation. | ||
TranslationStatusInterface:: |
constant | Status code identifying a removed translation. |