Using the question engine from module - Revision history

Finns: /* Outputting the questions */

2023-03-19T10:14:36Z

Outputting the questions

← Older revision		Revision as of 10:14, 19 March 2023
Line 122:		Line 122:
	</syntaxhighlight>		</syntaxhighlight>

	Here <tt>$displaynumber</tt> is the 'question number' you want printed next to each question. This is not necessarily the same as the slot number. For example, in the quiz, Description 'questions' are not numbered, although they take up a slot. It does not have to be a single integer ~~(once MDL-62358 is fixed)~~ if you have some other scheme for ~~identifiying quesitions~~ in your activity. For example you could pass '4.3.1' or '7 of 10' if that is what your activity needs. If you don't pass in a number to display, that is, if you pass null, then the question is printed without a Question X heading.		Here <tt>$displaynumber</tt> is the 'question number' you want printed next to each question. This is not necessarily the same as the slot number. For example, in the quiz, Description 'questions' are not numbered, although they take up a slot. It does not have to be a single integer and can also be combined with alphabetic glyphs if you have some other scheme for identifying questions in your activity. For example you could pass '4.3.1', '2a)' '2b)', or '7 of 10' if that is what your activity needs. If you don't pass in a number to display, that is, if you pass null, then the question is printed without a Question X heading.

	==Processing responses==		==Processing responses==

Finns: /* Adding questions */

2023-03-19T09:53:53Z

Adding questions

← Older revision		Revision as of 09:53, 19 March 2023
Line 35:		Line 35:
	Once you have a <tt>question_definition</tt> object, you add it to the usage by calling the <tt>add_question</tt> method passing the question definition, and also the score you want this question marked out of. You get back the slot number that has been assigned to this question. The slot numbers are allocated in order, starting from 1. You can rely on that numbering convention. For example, the quiz module uses the slot numbers to make sure the grade for each question lines up properly in the reports.		Once you have a <tt>question_definition</tt> object, you add it to the usage by calling the <tt>add_question</tt> method passing the question definition, and also the score you want this question marked out of. You get back the slot number that has been assigned to this question. The slot numbers are allocated in order, starting from 1. You can rely on that numbering convention. For example, the quiz module uses the slot numbers to make sure the grade for each question lines up properly in the reports.

	Here is the applicable code from the quiz module (some code to handle random questions and ~~answer~~ shuffling omitted)		Here is the applicable code from the quiz module (some code to handle random questions and question shuffling omitted)
	<syntaxhighlight lang="php">		<syntaxhighlight lang="php">
	$slot = 0;		$slot = 0;

Finns: /* Adding questions */

2023-03-19T09:51:37Z

Adding questions

← Older revision		Revision as of 09:51, 19 March 2023
Line 35:		Line 35:
	Once you have a <tt>question_definition</tt> object, you add it to the usage by calling the <tt>add_question</tt> method passing the question definition, and also the score you want this question marked out of. You get back the slot number that has been assigned to this question. The slot numbers are allocated in order, starting from 1. You can rely on that numbering convention. For example, the quiz module uses the slot numbers to make sure the grade for each question lines up properly in the reports.		Once you have a <tt>question_definition</tt> object, you add it to the usage by calling the <tt>add_question</tt> method passing the question definition, and also the score you want this question marked out of. You get back the slot number that has been assigned to this question. The slot numbers are allocated in order, starting from 1. You can rely on that numbering convention. For example, the quiz module uses the slot numbers to make sure the grade for each question lines up properly in the reports.

	Here is the applicable code from the quiz module		Here is the applicable code from the quiz module (some code to handle random questions and answer shuffling omitted)
	<syntaxhighlight lang="php">		<syntaxhighlight lang="php">
	foreach ($quizobj->get_questions() as ~~$i =>~~ $questiondata) {		$slot = 0;
	$~~question~~ = ~~question_bank::make_question(~~$questiondata);		$questions = [];
	$~~idstoslots~~[$i] = $~~quba~~->~~add_question~~(~~$question,~~ $questiondata~~->maxmark~~);		$maxmark = [];
			$page = [];
			foreach ($quizobj->get_questions() as $questiondata) {
			$slot += 1;
			$maxmark[$slot] = $questiondata->maxmark;
			$page[$slot] = $questiondata->page;
			$questions[$slot] = question_bank::make_question($questiondata);
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Finns: /* Creating the usage */

2023-03-19T09:44:25Z

Creating the usage

← Older revision		Revision as of 09:44, 19 March 2023
Line 24:		Line 24:
	<syntaxhighlight lang="php">		<syntaxhighlight lang="php">
	$quba = question_engine::make_questions_usage_by_activity('mod_quiz', $quizobj->get_context());		$quba = question_engine::make_questions_usage_by_activity('mod_quiz', $quizobj->get_context());
	$quba->set_preferred_behaviour($~~quiz~~->preferredbehaviour);		$quba->set_preferred_behaviour($quizobj->get_quiz()->preferredbehaviour);
	</syntaxhighlight>		</syntaxhighlight>

Mudrd8mz: Text replacement - "`" to ""`


2021-07-14T20:39:21Z
Text replacement - "<code php>" to "<syntaxhighlight lang="php">"
Show changes

`Mudrd8mz: Text replacement - "`" to ""

2021-07-14T20:26:55Z

Text replacement - "</code>" to "</syntaxhighlight>"

Show changes

TimHunt at 10:57, 15 April 2019

2019-04-15T10:57:41Z

← Older revision		Revision as of 10:57, 15 April 2019
Line 4:		Line 4:
	Previous section: [[Developing_a_Question_Type\|Developing a Question Type]]		Previous section: [[Developing_a_Question_Type\|Developing a Question Type]]

	The first example of a module that uses the question engine is the quiz module. Looking at how the quiz code works will let you see a real working example of what is explained on this page. Another, much simpler example to look at is <tt>question/preview.php</tt>.		The first example of a module that uses the question engine is the quiz module. Looking at how the quiz code works will let you see a real working example of what is explained on this page. Another, much simpler example to look at is <tt>question/preview.php</tt>, and https://github.com/moodleou/moodle-filter_embedquestion/blob/master/showquestion.php is simpler still.

	Note that all the question engine code has extensive PHP documentor comments that should explain the purpose of every class and method. This document is supposed to provide an overview of the key points to get you started. It does not attempt to duplicate all the details in the PHPdocs.		Note that all the question engine code has extensive PHP documentor comments that should explain the purpose of every class and method. This document is supposed to provide an overview of the key points to get you started. It does not attempt to duplicate all the details in the PHPdocs.

TimHunt: /* See also */

2019-04-15T10:56:42Z

TimHunt: /* Outputting the questions */

2018-06-11T16:35:36Z

Outputting the questions

← Older revision		Revision as of 16:35, 11 June 2018
Line 116:		Line 116:
	</code>		</code>

	Here <tt>$displaynumber</tt> is the 'question number' you want printed next to each question. This is not necessarily the same as the slot number. For example, in the quiz, Description 'questions' are not numbered, although they take up a slot. If you don't pass in a number to display, then the question is ~~just~~ printed without ~~one~~.		Here <tt>$displaynumber</tt> is the 'question number' you want printed next to each question. This is not necessarily the same as the slot number. For example, in the quiz, Description 'questions' are not numbered, although they take up a slot. It does not have to be a single integer (once MDL-62358 is fixed) if you have some other scheme for identifiying quesitions in your activity. For example you could pass '4.3.1' or '7 of 10' if that is what your activity needs. If you don't pass in a number to display, that is, if you pass null, then the question is printed without a Question X heading.


	==Processing responses==		==Processing responses==

Onnoschuit at 13:50, 4 July 2016

2016-07-04T13:50:38Z

← Older revision		Revision as of 13:50, 4 July 2016
Line 4:		Line 4:
	Previous section: [[Developing_a_Question_Type\|Developing a Question Type]]		Previous section: [[Developing_a_Question_Type\|Developing a Question Type]]

	The first example of a module that uses the question engine is the quiz module. Looking at how the quiz code works will let you see a real working example of what explained on this page. Another, much simpler example to look at is <tt>question/preview.php</tt>.		The first example of a module that uses the question engine is the quiz module. Looking at how the quiz code works will let you see a real working example of what is explained on this page. Another, much simpler example to look at is <tt>question/preview.php</tt>.

	Note that all the question engine code has extensive PHP documentor comments that should explain the purpose of every class and method. This document is supposed to provide an overview of the key points to get you started. It does not attempt to duplicate all the details in the PHPdocs.		Note that all the question engine code has extensive PHP documentor comments that should explain the purpose of every class and method. This document is supposed to provide an overview of the key points to get you started. It does not attempt to duplicate all the details in the PHPdocs.

← Older revision		Revision as of 10:56, 15 April 2019
Line 259:		Line 259:

	In the next section, [[Question Engine 2:Implementation plan\|Implementation plan]] outlines how I will implement this proposal.		In the next section, [[Question Engine 2:Implementation plan\|Implementation plan]] outlines how I will implement this proposal.

			* https://github.com/moodleou/moodle-filter_embedquestion/blob/master/showquestion.php is probably the simplest example code that displays a question and lets a user interact with it.

	* The PHP documenter comments that explain the purposes of every method in the question engine code.		* The PHP documenter comments that explain the purposes of every method in the question engine code.
	* Back to [[Question_Engine_2\|Question Engine 2]]		* Back to [[Question_Engine_2\|Question Engine 2]]

Using the question engine from module - Revision history

Finns: /* Outputting the questions */

Finns: /* Adding questions */

Finns: /* Adding questions */

Finns: /* Creating the usage */

Mudrd8mz: Text replacement - "" to ""

Mudrd8mz: Text replacement - "" to ""

TimHunt at 10:57, 15 April 2019

TimHunt: /* See also */

TimHunt: /* Outputting the questions */

Onnoschuit at 13:50, 4 July 2016

Mudrd8mz: Text replacement - "`" to ""`

`Mudrd8mz: Text replacement - "`" to ""