function quiz_admin_settings in Quiz 7.6
Same name and namespace in other branches
- 5.2 quiz.module \quiz_admin_settings()
- 5 quiz.module \quiz_admin_settings()
- 6.6 quiz.admin.inc \quiz_admin_settings()
- 6.2 quiz.admin.inc \quiz_admin_settings()
- 6.3 quiz.admin.inc \quiz_admin_settings()
- 6.4 quiz.admin.inc \quiz_admin_settings()
- 6.5 quiz.admin.inc \quiz_admin_settings()
- 7 quiz.admin.inc \quiz_admin_settings()
- 7.4 quiz.admin.inc \quiz_admin_settings()
- 7.5 quiz.admin.inc \quiz_admin_settings()
This builds the main settings form for the quiz module.
1 string reference to 'quiz_admin_settings'
- quiz_menu in ./
quiz.module - Implements hook_menu().
File
- ./
quiz.admin.inc, line 14 - Administrator interface for Quiz module.
Code
function quiz_admin_settings($form, &$form_state) {
$form = array();
$form['quiz_global_settings'] = array(
'#type' => 'fieldset',
'#title' => t('Global configuration'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
'#description' => t('Control aspects of the Quiz module\'s display'),
);
$form['quiz_global_settings']['quiz_auto_revisioning'] = array(
'#type' => 'checkbox',
'#title' => t('Auto revisioning'),
'#default_value' => variable_get('quiz_auto_revisioning', 1),
'#description' => t('It is strongly recommended that auto revisioning is always on. It makes sure that when a question or quiz is changed a new revision is created if the current revision has been answered. If this feature is switched off result reports might be broken because a users saved answer might be connected to a wrong version of the quiz and/or question she was answering. All sorts of errors might appear.'),
);
$form['quiz_global_settings']['quiz_durod'] = array(
'#type' => 'checkbox',
'#title' => t('Delete results when a user is deleted'),
'#default_value' => variable_get('quiz_durod', 0),
'#description' => t('When a user is deleted delete any and all results for that user.'),
);
$form['quiz_global_settings']['quiz_index_questions'] = array(
'#type' => 'checkbox',
'#title' => t('Index questions'),
'#default_value' => variable_get('quiz_index_questions', 1),
'#description' => t('If you turn this off, questions will not show up in search results.'),
);
$form['quiz_global_settings']['quiz_default_close'] = array(
'#type' => 'textfield',
'#title' => t('Default number of days before a @quiz is closed', array(
'@quiz' => QUIZ_NAME,
)),
'#default_value' => variable_get('quiz_default_close', 30),
'#size' => 4,
'#maxlength' => 4,
'#description' => t('Supply a number of days to calculate the default close date for new quizzes.'),
);
$form['quiz_global_settings']['quiz_use_passfail'] = array(
'#type' => 'checkbox',
'#title' => t('Allow quiz creators to set a pass/fail option when creating a @quiz.', array(
'@quiz' => strtolower(QUIZ_NAME),
)),
'#default_value' => variable_get('quiz_use_passfail', 1),
'#description' => t('Check this to display the pass/fail options in the @quiz form. If you want to prohibit other quiz creators from changing the default pass/fail percentage, uncheck this option.', array(
'@quiz' => QUIZ_NAME,
)),
);
$form['quiz_global_settings']['quiz_max_result_options'] = array(
'#type' => 'textfield',
'#title' => t('Maximum result options'),
'#description' => t('Set the maximum number of result options (categorizations for scoring a quiz). Set to 0 to disable result options.'),
'#default_value' => variable_get('quiz_max_result_options', 5),
'#size' => 2,
'#maxlength' => 2,
'#required' => FALSE,
);
$form['quiz_global_settings']['quiz_remove_partial_quiz_record'] = array(
'#type' => 'select',
'#title' => t('Remove incomplete quiz records (older than)'),
'#options' => quiz_remove_partial_quiz_record_value(),
'#description' => t('Number of days to keep incomplete quiz attempts.'),
'#default_value' => variable_get('quiz_remove_partial_quiz_record', quiz_remove_partial_quiz_record_value()),
);
$form['quiz_global_settings']['quiz_autotitle_length'] = array(
'#type' => 'textfield',
'#title' => t('Length of automatically set question titles'),
'#size' => 3,
'#maxlength' => 3,
'#description' => t('Integer between 0 and 128. If the question creator doesn\'t set a question title the system will make a title automatically. Here you can decide how long the autotitle can be.'),
'#default_value' => variable_get('quiz_autotitle_length', 50),
);
$form['quiz_global_settings']['quiz_pager_start'] = array(
'#type' => 'textfield',
'#title' => t('Pager start'),
'#size' => 3,
'#maxlength' => 3,
'#description' => t('If a quiz has this many questions, a pager will be displayed instead of a select box.'),
'#default_value' => variable_get('quiz_pager_start', 100),
);
$form['quiz_global_settings']['quiz_pager_siblings'] = array(
'#type' => 'textfield',
'#title' => t('Pager siblings'),
'#size' => 3,
'#maxlength' => 3,
'#description' => t('Number of siblings to show.'),
'#default_value' => variable_get('quiz_pager_siblings', 5),
);
$target = array(
'attributes' => array(
'target' => '_blank',
),
);
$links = array(
'!jquery_countdown' => l(t('JQuery Countdown'), 'http://drupal.org/project/jquery_countdown', $target),
'!userpoints' => l(t('UserPoints'), 'http://drupal.org/project/userpoints', $target),
);
$form['quiz_addons'] = array(
'#type' => 'fieldset',
'#title' => t('Addons configuration'),
'#description' => t('Quiz has built in integration with some other modules. Disabled checkboxes indicates that modules are not enabled.', $links),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$form['quiz_addons']['quiz_has_userpoints'] = array(
'#type' => 'checkbox',
'#title' => t('User Points'),
'#default_value' => variable_get('quiz_has_userpoints', 0),
'#description' => t('!userpoints is an <strong>optional</strong> module for Quiz. It provides ways for users to gain or lose points for performing certain actions on your site like completing a Quiz.', $links),
'#disabled' => !module_exists('userpoints'),
);
$form['quiz_addons']['quiz_has_timer'] = array(
'#type' => 'checkbox',
'#title' => t('Display timer'),
'#default_value' => variable_get('quiz_has_timer', 0),
'#description' => t("!jquery_countdown is an <strong>optional</strong> module for Quiz. It is used to display a timer when taking a quiz. Without this timer, the user will not know how much time they have left to complete the Quiz", $links),
'#disabled' => !function_exists('jquery_countdown_add'),
);
$form['quiz_look_feel'] = array(
'#type' => 'fieldset',
'#title' => t('Look and feel'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
'#description' => t('Control aspects of the Quiz module\'s display'),
);
$form['quiz_look_feel']['quiz_name'] = array(
'#type' => 'textfield',
'#title' => t('Display name'),
'#default_value' => QUIZ_NAME,
'#description' => t('Change the name of the quiz type. Do you call it <em>test</em> or <em>assessment</em> instead? Change the display name of the module to something else. By default, it is called <em>Quiz</em>.'),
'#required' => TRUE,
);
$form['quiz_email_settings'] = array(
'#type' => 'fieldset',
'#title' => t('Notifications'),
'#description' => t('Send results to quiz author/attendee via email. Configure email subject and body.'),
'#collapsible' => TRUE,
'#collapsed' => TRUE,
);
$form['quiz_email_settings']['taker'] = array(
'#type' => 'fieldset',
'#title' => t('Email for Quiz takers'),
'#collapsible' => FALSE,
);
$form['quiz_email_settings']['taker']['quiz_email_results'] = array(
'#type' => 'checkbox',
'#title' => t('Email results to quiz takers'),
'#default_value' => variable_get('quiz_email_results', 0),
'#description' => t('Check this to send users their results at the end of a quiz.'),
);
$form['quiz_email_settings']['taker']['quiz_email_results_subject_taker'] = array(
'#type' => 'textfield',
'#title' => t('Configure email subject'),
'#description' => t('This format will be used when sending quiz results at the end of a quiz.'),
'#default_value' => variable_get('quiz_email_results_subject_taker', quiz_email_results_format('subject', 'taker')),
);
$form['quiz_email_settings']['taker']['quiz_email_results_body_taker'] = array(
'#type' => 'textarea',
'#title' => t('Configure email format'),
'#description' => t('This format will be used when sending quiz results at the end of a quiz. !title(quiz title), !sitename, !taker(quiz takers username), !date(time when quiz was finished), !minutes(How many minutes the quiz taker spent taking the quiz), !desc(description of the quiz), !correct(points attained), !total(max score for the quiz), !percentage(percentage score), !url(url to the result page) and !author are placeholders.'),
'#default_value' => variable_get('quiz_email_results_body_taker', quiz_email_results_format('body', 'taker')),
);
$form['quiz_email_settings']['author'] = array(
'#type' => 'fieldset',
'#title' => t('Email for Quiz authors'),
'#collapsible' => FALSE,
);
$form['quiz_email_settings']['author']['quiz_results_to_quiz_author'] = array(
'#type' => 'checkbox',
'#title' => t('Email all results to quiz author'),
'#default_value' => variable_get('quiz_results_to_quiz_author', 0),
'#description' => t('Check this to send quiz results for all users to the quiz author.'),
);
$form['quiz_email_settings']['author']['quiz_email_results_subject'] = array(
'#type' => 'textfield',
'#title' => t('Configure email subject'),
'#description' => t('This format will be used when sending quiz results at the end of a quiz. Authors and quiz takers gets the same format.'),
'#default_value' => variable_get('quiz_email_results_subject', quiz_email_results_format('subject', 'author')),
);
$form['quiz_email_settings']['author']['quiz_email_results_body'] = array(
'#type' => 'textarea',
'#title' => t('Configure email format'),
'#description' => t('This format will be used when sending @quiz results at the end of a quiz. !title(quiz title), !sitename, !taker(quiz takers username), !date(time when quiz was finished), !minutes(How many minutes the quiz taker spent taking the quiz), !desc(description of the quiz), !correct(points attained), !total(max score for the quiz), !percentage(percentage score), !url(url to the result page) and !author are placeholders.'),
'#default_value' => variable_get('quiz_email_results_body', quiz_email_results_format('body', 'author')),
);
$form['#validate'][] = 'quiz_settings_form_validate';
$form['#submit'][] = 'quiz_settings_form_submit';
return system_settings_form($form);
}