Halaman utama Jelajahi Bantuan
Daftar Masuk
Ayuda_Virtual
/
sloodle_website
2
0
Fork 0
Berkas Masalah 0 Permintaan Tarik 0 Wiki
Cabang: master
Ranting Tag
sloodle_webs...
/
webroot
/
phpdocs
/
0.3-alpha-03
/
__filesource
/
fsource_quiz__sloodlemodquiz-1.0locallib.1.9.php.html

fsource_quiz__sloodlemodquiz-1.0locallib.1.9.php.html 232 KB
Permalink Riwayat Mentahan

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960 
  1. <?xml version="1.0" encoding="iso-8859-1"?>
    2. 

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3.   <html xmlns="http://www.w3.org/1999/xhtml">
    4. 

  4. 		<head>
    5. 

  5. 			<!-- template designed by Marco Von Ballmoos  -->
    6. 

  6. 			<title>File Source for locallib.1.9.php</title>
    7. 

  7. 			<link rel="stylesheet" href="../media/stylesheet.css" />
    8. 

  8. 											</head>
    9. 

  9. 		<body>
    10. 

  10. 						
<h1>Source for file locallib.1.9.php</h1>
    11. 

  11. <p>Documentation is available at <a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html">locallib.1.9.php</a></p>
    12. 

  12. <div class="src-code">
    13. 

  13. <div class="src-code"><ol><li><div class="src-line"><a name="a1"></a><span class="src-php">&lt;?php&nbsp;&nbsp;</span><span class="src-comm">//&nbsp;$Id:&nbsp;locallib.php,v&nbsp;1.127.2.10&nbsp;2008/02/29&nbsp;16:22:13&nbsp;tjhunt&nbsp;Exp&nbsp;$</span></div></li>
    14. 

  14. <li><div class="src-line"><a name="a2"></a><span class="src-doc">/**</span></div></li>
    15. 

  15. <li><div class="src-line"><a name="a3"></a><span class="src-doc">&nbsp;*&nbsp;Library&nbsp;of&nbsp;functions&nbsp;used&nbsp;by&nbsp;the&nbsp;quiz&nbsp;module.</span></div></li>
    16. 

  16. <li><div class="src-line"><a name="a4"></a><span class="src-doc">&nbsp;*</span></div></li>
    17. 

  17. <li><div class="src-line"><a name="a5"></a><span class="src-doc">&nbsp;*&nbsp;This&nbsp;contains&nbsp;functions&nbsp;that&nbsp;are&nbsp;called&nbsp;from&nbsp;within&nbsp;the&nbsp;quiz&nbsp;module&nbsp;only</span></div></li>
    18. 

  18. <li><div class="src-line"><a name="a6"></a><span class="src-doc">&nbsp;*&nbsp;Functions&nbsp;that&nbsp;are&nbsp;also&nbsp;called&nbsp;by&nbsp;core&nbsp;Moodle&nbsp;are&nbsp;in&nbsp;</span><span class="src-doc-inlinetag">{@link&nbsp;lib.php}</span></div></li>
    19. 

  19. <li><div class="src-line"><a name="a7"></a><span class="src-doc">&nbsp;*&nbsp;This&nbsp;script&nbsp;also&nbsp;loads&nbsp;the&nbsp;code&nbsp;in&nbsp;</span><span class="src-doc-inlinetag">{@link&nbsp;questionlib.php}</span><span class="src-doc">&nbsp;which&nbsp;holds</span></div></li>
    20. 

  20. <li><div class="src-line"><a name="a8"></a><span class="src-doc">&nbsp;*&nbsp;the&nbsp;module-indpendent&nbsp;code&nbsp;for&nbsp;handling&nbsp;questions&nbsp;and&nbsp;which&nbsp;in&nbsp;turn</span></div></li>
    21. 

  21. <li><div class="src-line"><a name="a9"></a><span class="src-doc">&nbsp;*&nbsp;initialises&nbsp;all&nbsp;the&nbsp;questiontype&nbsp;classes.</span></div></li>
    22. 

  22. <li><div class="src-line"><a name="a10"></a><span class="src-doc">&nbsp;*</span></div></li>
    23. 

  23. <li><div class="src-line"><a name="a11"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@author</span><span class="src-doc">&nbsp;Martin&nbsp;Dougiamas&nbsp;and&nbsp;many&nbsp;others.&nbsp;This&nbsp;has&nbsp;recently&nbsp;been&nbsp;completely</span></div></li>
    24. 

  24. <li><div class="src-line"><a name="a12"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rewritten&nbsp;by&nbsp;Alex&nbsp;Smith,&nbsp;Julian&nbsp;Sedding&nbsp;and&nbsp;Gustav&nbsp;Delius&nbsp;as&nbsp;part&nbsp;of</span></div></li>
    25. 

  25. <li><div class="src-line"><a name="a13"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;Serving&nbsp;Mathematics&nbsp;project</span></div></li>
    26. 

  26. <li><div class="src-line"><a name="a14"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="src-doc-inlinetag">{@link&nbsp;http://maths.york.ac.uk/serving_maths}</span></div></li>
    27. 

  27. <li><div class="src-line"><a name="a15"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@license</span><span class="src-doc">&nbsp;http://www.gnu.org/copyleft/gpl.html&nbsp;GNU&nbsp;Public&nbsp;License</span></div></li>
    28. 

  28. <li><div class="src-line"><a name="a16"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@package</span><span class="src-doc">&nbsp;quiz</span></div></li>
    29. 

  29. <li><div class="src-line"><a name="a17"></a><span class="src-doc">&nbsp;*/</span></div></li>
    30. 

  30. <li><div class="src-line"><a name="a18"></a>&nbsp;</div></li>
    31. 

  31. <li><div class="src-line"><a name="a19"></a><span class="src-doc">/**</span></div></li>
    32. 

  32. <li><div class="src-line"><a name="a20"></a><span class="src-doc">&nbsp;*&nbsp;Include&nbsp;those&nbsp;library&nbsp;functions&nbsp;that&nbsp;are&nbsp;also&nbsp;used&nbsp;by&nbsp;core&nbsp;Moodle&nbsp;or&nbsp;other&nbsp;modules</span></div></li>
    33. 

  33. <li><div class="src-line"><a name="a21"></a><span class="src-doc">&nbsp;*/</span></div></li>
    34. 

  34. <li><div class="src-line"><a name="a22"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-var">$CFG</span><span class="src-sym">-&gt;</span><span class="src-id">dirroot&nbsp;</span>.&nbsp;<span class="src-str">'/mod/quiz/lib.php'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    35. 

  35. <li><div class="src-line"><a name="a23"></a><span class="src-inc">require_once</span><span class="src-sym">(</span><span class="src-var">$CFG</span><span class="src-sym">-&gt;</span><span class="src-id">dirroot&nbsp;</span>.&nbsp;<span class="src-str">'/question/editlib.php'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    36. 

  36. <li><div class="src-line"><a name="a24"></a>&nbsp;</div></li>
    37. 

  37. <li><div class="src-line"><a name="a25"></a><span class="src-comm">///&nbsp;Constants&nbsp;///////////////////////////////////////////////////////////////////</span></div></li>
    38. 

  38. <li><div class="src-line"><a name="a26"></a>&nbsp;</div></li>
    39. 

  39. <li><div class="src-line"><a name="a27"></a><span class="src-comm">/**#@+</span></div></li>
    40. 

  40. <li><div class="src-line"><a name="a28"></a><span class="src-comm">&nbsp;*&nbsp;Options&nbsp;determining&nbsp;how&nbsp;the&nbsp;grades&nbsp;from&nbsp;individual&nbsp;attempts&nbsp;are&nbsp;combined&nbsp;to&nbsp;give</span></div></li>
    41. 

  41. <li><div class="src-line"><a name="a29"></a><span class="src-comm">&nbsp;*&nbsp;the&nbsp;overall&nbsp;grade&nbsp;for&nbsp;a&nbsp;user</span></div></li>
    42. 

  42. <li><div class="src-line"><a name="a30"></a><span class="src-comm">&nbsp;*/</span></div></li>
    43. 

  43. <li><div class="src-line"><a name="a31"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">&quot;QUIZ_GRADEHIGHEST&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-str">&quot;1&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    44. 

  44. <li><div class="src-line"><a name="a32"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">&quot;QUIZ_GRADEAVERAGE&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-str">&quot;2&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    45. 

  45. <li><div class="src-line"><a name="a33"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">&quot;QUIZ_ATTEMPTFIRST&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-str">&quot;3&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    46. 

  46. <li><div class="src-line"><a name="a34"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">&quot;QUIZ_ATTEMPTLAST&quot;</span><span class="src-sym">,&nbsp;&nbsp;</span><span class="src-str">&quot;4&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    47. 

  47. <li><div class="src-line"><a name="a35"></a><span class="src-comm">/**#@-*/</span></div></li>
    48. 

  48. <li><div class="src-line"><a name="a36"></a>&nbsp;</div></li>
    49. 

  49. <li><div class="src-line"><a name="a37"></a><span class="src-comm">/**#@+</span></div></li>
    50. 

  50. <li><div class="src-line"><a name="a38"></a><span class="src-comm">&nbsp;*&nbsp;Constants&nbsp;to&nbsp;describe&nbsp;the&nbsp;various&nbsp;states&nbsp;a&nbsp;quiz&nbsp;attempt&nbsp;can&nbsp;be&nbsp;in.</span></div></li>
    51. 

  51. <li><div class="src-line"><a name="a39"></a><span class="src-comm">&nbsp;*/</span></div></li>
    52. 

  52. <li><div class="src-line"><a name="a40"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">'QUIZ_STATE_DURING'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'during'</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span></div></li>
    53. 

  53. <li><div class="src-line"><a name="a41"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">'QUIZ_STATE_IMMEDIATELY'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'immedately'</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span></div></li>
    54. 

  54. <li><div class="src-line"><a name="a42"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">'QUIZ_STATE_OPEN'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'open'</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span></div></li>
    55. 

  55. <li><div class="src-line"><a name="a43"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">'QUIZ_STATE_CLOSED'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'closed'</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span></div></li>
    56. 

  56. <li><div class="src-line"><a name="a44"></a><a href="http://www.php.net/define">define</a><span class="src-sym">(</span><span class="src-str">'QUIZ_STATE_TEACHERACCESS'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'teacheraccess'</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span><span class="src-comm">//&nbsp;State&nbsp;only&nbsp;relevant&nbsp;if&nbsp;you&nbsp;are&nbsp;in&nbsp;a&nbsp;studenty&nbsp;role.</span></div></li>
    57. 

  57. <li><div class="src-line"><a name="a45"></a><span class="src-comm">/**#@-*/</span></div></li>
    58. 

  58. <li><div class="src-line"><a name="a46"></a>&nbsp;</div></li>
    59. 

  59. <li><div class="src-line"><a name="a47"></a><span class="src-comm">///&nbsp;Functions&nbsp;related&nbsp;to&nbsp;attempts&nbsp;/////////////////////////////////////////</span></div></li>
    60. 

  60. <li><div class="src-line"><a name="a48"></a>&nbsp;</div></li>
    61. 

  61. <li><div class="src-line"><a name="a49"></a><span class="src-doc">/**</span></div></li>
    62. 

  62. <li><div class="src-line"><a name="a50"></a><span class="src-doc">&nbsp;*&nbsp;Creates&nbsp;an&nbsp;object&nbsp;to&nbsp;represent&nbsp;a&nbsp;new&nbsp;attempt&nbsp;at&nbsp;a&nbsp;quiz</span></div></li>
    63. 

  63. <li><div class="src-line"><a name="a51"></a><span class="src-doc">&nbsp;*</span></div></li>
    64. 

  64. <li><div class="src-line"><a name="a52"></a><span class="src-doc">&nbsp;*&nbsp;Creates&nbsp;an&nbsp;attempt&nbsp;object&nbsp;to&nbsp;represent&nbsp;an&nbsp;attempt&nbsp;at&nbsp;the&nbsp;quiz&nbsp;by&nbsp;the&nbsp;current</span></div></li>
    65. 

  65. <li><div class="src-line"><a name="a53"></a><span class="src-doc">&nbsp;*&nbsp;user&nbsp;starting&nbsp;at&nbsp;the&nbsp;current&nbsp;time.&nbsp;The&nbsp;-&gt;id&nbsp;field&nbsp;is&nbsp;not&nbsp;set.&nbsp;The&nbsp;object&nbsp;is</span></div></li>
    66. 

  66. <li><div class="src-line"><a name="a54"></a><span class="src-doc">&nbsp;*&nbsp;NOT&nbsp;written&nbsp;to&nbsp;the&nbsp;database.</span></div></li>
    67. 

  67. <li><div class="src-line"><a name="a55"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="src-doc-type">The&nbsp;</span><span class="src-doc">newly&nbsp;created&nbsp;attempt&nbsp;object.</span></div></li>
    68. 

  68. <li><div class="src-line"><a name="a56"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;quiz&nbsp;to&nbsp;create&nbsp;an&nbsp;attempt&nbsp;for.</span></div></li>
    69. 

  69. <li><div class="src-line"><a name="a57"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$attemptnumber&nbsp;</span><span class="src-doc">The&nbsp;sequence&nbsp;number&nbsp;for&nbsp;the&nbsp;attempt.</span></div></li>
    70. 

  70. <li><div class="src-line"><a name="a58"></a><span class="src-doc">&nbsp;*/</span></div></li>
    71. 

  71. <li><div class="src-line"><a name="a59"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_create_attempt">quiz_create_attempt</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attemptnumber</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    72. 

  72. <li><div class="src-line"><a name="a60"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">,&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">;</span></div></li>
    73. 

  73. <li><div class="src-line"><a name="a61"></a>&nbsp;</div></li>
    74. 

  74. <li><div class="src-line"><a name="a62"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$attemptnumber&nbsp;</span>&gt;&nbsp;<span class="src-num">1&nbsp;</span><span class="src-key">or&nbsp;</span><span class="src-sym">!</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">attemptonlast&nbsp;</span><span class="src-key">or&nbsp;</span><span class="src-sym">!</span><span class="src-var">$attempt&nbsp;</span>=&nbsp;<span class="src-id">get_record</span><span class="src-sym">(</span><span class="src-str">'quiz_attempts'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">,&nbsp;</span><span class="src-str">'userid'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">,&nbsp;</span><span class="src-str">'attempt'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attemptnumber</span>-<span class="src-num">1</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    75. 

  75. <li><div class="src-line"><a name="a63"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;we&nbsp;are&nbsp;not&nbsp;building&nbsp;on&nbsp;last&nbsp;attempt&nbsp;so&nbsp;create&nbsp;a&nbsp;new&nbsp;attempt</span></div></li>
    76. 

  76. <li><div class="src-line"><a name="a64"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">quiz&nbsp;</span>=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    77. 

  77. <li><div class="src-line"><a name="a65"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">userid&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    78. 

  78. <li><div class="src-line"><a name="a66"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">preview&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    79. 

  79. <li><div class="src-line"><a name="a67"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">shufflequestions</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    80. 

  80. <li><div class="src-line"><a name="a68"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">layout&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_repaginate">quiz_repaginate</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">questions</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">questionsperpage</span><span class="src-sym">,&nbsp;</span><span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    81. 

  81. <li><div class="src-line"><a name="a69"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    82. 

  82. <li><div class="src-line"><a name="a70"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">layout&nbsp;</span>=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">questions</span><span class="src-sym">;</span></div></li>
    83. 

  83. <li><div class="src-line"><a name="a71"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    84. 

  84. <li><div class="src-line"><a name="a72"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    85. 

  85. <li><div class="src-line"><a name="a73"></a>&nbsp;</div></li>
    86. 

  86. <li><div class="src-line"><a name="a74"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$timenow&nbsp;</span>=&nbsp;<a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    87. 

  87. <li><div class="src-line"><a name="a75"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">attempt&nbsp;</span>=&nbsp;<span class="src-var">$attemptnumber</span><span class="src-sym">;</span></div></li>
    88. 

  88. <li><div class="src-line"><a name="a76"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades&nbsp;</span>=&nbsp;<span class="src-num">0.0</span><span class="src-sym">;</span></div></li>
    89. 

  89. <li><div class="src-line"><a name="a77"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timestart&nbsp;</span>=&nbsp;<span class="src-var">$timenow</span><span class="src-sym">;</span></div></li>
    90. 

  90. <li><div class="src-line"><a name="a78"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    91. 

  91. <li><div class="src-line"><a name="a79"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timemodified&nbsp;</span>=&nbsp;<span class="src-var">$timenow</span><span class="src-sym">;</span></div></li>
    92. 

  92. <li><div class="src-line"><a name="a80"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">uniqueid&nbsp;</span>=&nbsp;<span class="src-id">question_new_attempt_uniqueid</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    93. 

  93. <li><div class="src-line"><a name="a81"></a>&nbsp;</div></li>
    94. 

  94. <li><div class="src-line"><a name="a82"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">;</span></div></li>
    95. 

  95. <li><div class="src-line"><a name="a83"></a><span class="src-sym">}</span></div></li>
    96. 

  96. <li><div class="src-line"><a name="a84"></a>&nbsp;</div></li>
    97. 

  97. <li><div class="src-line"><a name="a85"></a><span class="src-doc">/**</span></div></li>
    98. 

  98. <li><div class="src-line"><a name="a86"></a><span class="src-doc">&nbsp;*&nbsp;Returns&nbsp;an&nbsp;unfinished&nbsp;attempt&nbsp;(if&nbsp;there&nbsp;is&nbsp;one)&nbsp;for&nbsp;the&nbsp;given</span></div></li>
    99. 

  99. <li><div class="src-line"><a name="a87"></a><span class="src-doc">&nbsp;*&nbsp;user&nbsp;on&nbsp;the&nbsp;given&nbsp;quiz.&nbsp;This&nbsp;function&nbsp;does&nbsp;not&nbsp;return&nbsp;preview&nbsp;attempts.</span></div></li>
    100. 

  100. <li><div class="src-line"><a name="a88"></a><span class="src-doc">&nbsp;*</span></div></li>
    101. 

  101. <li><div class="src-line"><a name="a89"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$quizid&nbsp;</span><span class="src-doc">the&nbsp;id&nbsp;of&nbsp;the&nbsp;quiz.</span></div></li>
    102. 

  102. <li><div class="src-line"><a name="a90"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$userid&nbsp;</span><span class="src-doc">the&nbsp;id&nbsp;of&nbsp;the&nbsp;user.</span></div></li>
    103. 

  103. <li><div class="src-line"><a name="a91"></a><span class="src-doc">&nbsp;*</span></div></li>
    104. 

  104. <li><div class="src-line"><a name="a92"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">mixed&nbsp;</span><span class="src-doc">the&nbsp;unfinished&nbsp;attempt&nbsp;if&nbsp;there&nbsp;is&nbsp;one,&nbsp;false&nbsp;if&nbsp;not.</span></div></li>
    105. 

  105. <li><div class="src-line"><a name="a93"></a><span class="src-doc">&nbsp;*/</span></div></li>
    106. 

  106. <li><div class="src-line"><a name="a94"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_user_attempt_unfinished">quiz_get_user_attempt_unfinished</a><span class="src-sym">(</span><span class="src-var">$quizid</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    107. 

  107. <li><div class="src-line"><a name="a95"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attempts&nbsp;</span>=&nbsp;<span class="src-id">quiz_get_user_attempts</span><span class="src-sym">(</span><span class="src-var">$quizid</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">,&nbsp;</span><span class="src-str">'unfinished'</span><span class="src-sym">,&nbsp;</span><span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    108. 

  108. <li><div class="src-line"><a name="a96"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    109. 

  109. <li><div class="src-line"><a name="a97"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><a href="http://www.php.net/array_shift">array_shift</a><span class="src-sym">(</span><span class="src-var">$attempts</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    110. 

  110. <li><div class="src-line"><a name="a98"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    111. 

  111. <li><div class="src-line"><a name="a99"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
    112. 

  112. <li><div class="src-line"><a name="a100"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    113. 

  113. <li><div class="src-line"><a name="a101"></a><span class="src-sym">}</span></div></li>
    114. 

  114. <li><div class="src-line"><a name="a102"></a>&nbsp;</div></li>
    115. 

  115. <li><div class="src-line"><a name="a103"></a><span class="src-doc">/**</span></div></li>
    116. 

  116. <li><div class="src-line"><a name="a104"></a><span class="src-doc">&nbsp;*&nbsp;Delete&nbsp;a&nbsp;quiz&nbsp;attempt.</span></div></li>
    117. 

  117. <li><div class="src-line"><a name="a105"></a><span class="src-doc">&nbsp;*/</span></div></li>
    118. 

  118. <li><div class="src-line"><a name="a106"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_delete_attempt">quiz_delete_attempt</a><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    119. 

  119. <li><div class="src-line"><a name="a107"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><a href="http://www.php.net/is_numeric">is_numeric</a><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    120. 

  120. <li><div class="src-line"><a name="a108"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$attempt&nbsp;</span>=&nbsp;<span class="src-id">get_record</span><span class="src-sym">(</span><span class="src-str">'quiz_attempts'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'id'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    121. 

  121. <li><div class="src-line"><a name="a109"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return</span><span class="src-sym">;</span></div></li>
    122. 

  122. <li><div class="src-line"><a name="a110"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    123. 

  123. <li><div class="src-line"><a name="a111"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    124. 

  124. <li><div class="src-line"><a name="a112"></a>&nbsp;</div></li>
    125. 

  125. <li><div class="src-line"><a name="a113"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">quiz&nbsp;</span>!=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    126. 

  126. <li><div class="src-line"><a name="a114"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">debugging</span><span class="src-sym">(</span><span class="src-str">&quot;</span><span class="src-str">Trying&nbsp;to&nbsp;delete&nbsp;attempt&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">id</span>&nbsp;which&nbsp;belongs&nbsp;to&nbsp;quiz&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">quiz</span>&nbsp;</span><span class="src-str">&quot;&nbsp;</span>.</div></li>
    127. 

  127. <li><div class="src-line"><a name="a115"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-str">&quot;</span><span class="src-str">but&nbsp;was&nbsp;passed&nbsp;quiz&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span>.</span><span class="src-str">&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    128. 

  128. <li><div class="src-line"><a name="a116"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return</span><span class="src-sym">;</span></div></li>
    129. 

  129. <li><div class="src-line"><a name="a117"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    130. 

  130. <li><div class="src-line"><a name="a118"></a>&nbsp;</div></li>
    131. 

  131. <li><div class="src-line"><a name="a119"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">delete_records</span><span class="src-sym">(</span><span class="src-str">'quiz_attempts'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'id'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    132. 

  132. <li><div class="src-line"><a name="a120"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">delete_attempt</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">uniqueid</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    133. 

  133. <li><div class="src-line"><a name="a121"></a>&nbsp;</div></li>
    134. 

  134. <li><div class="src-line"><a name="a122"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Search&nbsp;quiz_attempts&nbsp;for&nbsp;other&nbsp;instances&nbsp;by&nbsp;this&nbsp;user.</span></div></li>
    135. 

  135. <li><div class="src-line"><a name="a123"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;If&nbsp;none,&nbsp;then&nbsp;delete&nbsp;record&nbsp;for&nbsp;this&nbsp;quiz,&nbsp;this&nbsp;user&nbsp;from&nbsp;quiz_grades</span></div></li>
    136. 

  136. <li><div class="src-line"><a name="a124"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;else&nbsp;recalculate&nbsp;best&nbsp;grade</span></div></li>
    137. 

  137. <li><div class="src-line"><a name="a125"></a>&nbsp;</div></li>
    138. 

  138. <li><div class="src-line"><a name="a126"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$userid&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">userid</span><span class="src-sym">;</span></div></li>
    139. 

  139. <li><div class="src-line"><a name="a127"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-id">record_exists</span><span class="src-sym">(</span><span class="src-str">'quiz_attempts'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'userid'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    140. 

  140. <li><div class="src-line"><a name="a128"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">delete_records</span><span class="src-sym">(</span><span class="src-str">'quiz_grades'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'userid'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">,</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    141. 

  141. <li><div class="src-line"><a name="a129"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    142. 

  142. <li><div class="src-line"><a name="a130"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_save_best_grade">quiz_save_best_grade</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    143. 

  143. <li><div class="src-line"><a name="a131"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    144. 

  144. <li><div class="src-line"><a name="a132"></a>&nbsp;</div></li>
    145. 

  145. <li><div class="src-line"><a name="a133"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">quiz_update_grades</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    146. 

  146. <li><div class="src-line"><a name="a134"></a><span class="src-sym">}</span></div></li>
    147. 

  147. <li><div class="src-line"><a name="a135"></a>&nbsp;</div></li>
    148. 

  148. <li><div class="src-line"><a name="a136"></a><span class="src-comm">///&nbsp;Functions&nbsp;to&nbsp;do&nbsp;with&nbsp;quiz&nbsp;layout&nbsp;and&nbsp;pages&nbsp;////////////////////////////////</span></div></li>
    149. 

  149. <li><div class="src-line"><a name="a137"></a>&nbsp;</div></li>
    150. 

  150. <li><div class="src-line"><a name="a138"></a><span class="src-doc">/**</span></div></li>
    151. 

  151. <li><div class="src-line"><a name="a139"></a><span class="src-doc">&nbsp;*&nbsp;Returns&nbsp;a&nbsp;comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids&nbsp;for&nbsp;the&nbsp;current&nbsp;page</span></div></li>
    152. 

  152. <li><div class="src-line"><a name="a140"></a><span class="src-doc">&nbsp;*</span></div></li>
    153. 

  153. <li><div class="src-line"><a name="a141"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids</span></div></li>
    154. 

  154. <li><div class="src-line"><a name="a142"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc-var">$layout&nbsp;</span><span class="src-doc">&nbsp;The&nbsp;string&nbsp;representing&nbsp;the&nbsp;quiz&nbsp;layout.&nbsp;Each&nbsp;page&nbsp;is&nbsp;represented&nbsp;as&nbsp;a</span></div></li>
    155. 

  155. <li><div class="src-line"><a name="a143"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids&nbsp;and&nbsp;0&nbsp;indicating&nbsp;page&nbsp;breaks.</span></div></li>
    156. 

  156. <li><div class="src-line"><a name="a144"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;So&nbsp;5,2,0,3,0&nbsp;means&nbsp;questions&nbsp;5&nbsp;and&nbsp;2&nbsp;on&nbsp;page&nbsp;1&nbsp;and&nbsp;question&nbsp;3&nbsp;on&nbsp;page&nbsp;2</span></div></li>
    157. 

  157. <li><div class="src-line"><a name="a145"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$page&nbsp;</span><span class="src-doc">&nbsp;&nbsp;The&nbsp;number&nbsp;of&nbsp;the&nbsp;current&nbsp;page.</span></div></li>
    158. 

  158. <li><div class="src-line"><a name="a146"></a><span class="src-doc">&nbsp;*/</span></div></li>
    159. 

  159. <li><div class="src-line"><a name="a147"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_questions_on_page">quiz_questions_on_page</a><span class="src-sym">(</span><span class="src-var">$layout</span><span class="src-sym">,&nbsp;</span><span class="src-var">$page</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    160. 

  160. <li><div class="src-line"><a name="a148"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$pages&nbsp;</span>=&nbsp;<a href="http://www.php.net/explode">explode</a><span class="src-sym">(</span><span class="src-str">',0'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$layout</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    161. 

  161. <li><div class="src-line"><a name="a149"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><a href="http://www.php.net/trim">trim</a><span class="src-sym">(</span><span class="src-var">$pages</span><span class="src-sym">[</span><span class="src-var">$page</span><span class="src-sym">]</span><span class="src-sym">,&nbsp;</span><span class="src-str">','</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    162. 

  162. <li><div class="src-line"><a name="a150"></a><span class="src-sym">}</span></div></li>
    163. 

  163. <li><div class="src-line"><a name="a151"></a>&nbsp;</div></li>
    164. 

  164. <li><div class="src-line"><a name="a152"></a><span class="src-doc">/**</span></div></li>
    165. 

  165. <li><div class="src-line"><a name="a153"></a><span class="src-doc">&nbsp;*&nbsp;Returns&nbsp;a&nbsp;comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids&nbsp;for&nbsp;the&nbsp;quiz</span></div></li>
    166. 

  166. <li><div class="src-line"><a name="a154"></a><span class="src-doc">&nbsp;*</span></div></li>
    167. 

  167. <li><div class="src-line"><a name="a155"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids</span></div></li>
    168. 

  168. <li><div class="src-line"><a name="a156"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc-var">$layout&nbsp;</span><span class="src-doc">&nbsp;The&nbsp;string&nbsp;representing&nbsp;the&nbsp;quiz&nbsp;layout.&nbsp;Each&nbsp;page&nbsp;is&nbsp;represented&nbsp;as&nbsp;a</span></div></li>
    169. 

  169. <li><div class="src-line"><a name="a157"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids&nbsp;and&nbsp;0&nbsp;indicating&nbsp;page&nbsp;breaks.</span></div></li>
    170. 

  170. <li><div class="src-line"><a name="a158"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;So&nbsp;5,2,0,3,0&nbsp;means&nbsp;questions&nbsp;5&nbsp;and&nbsp;2&nbsp;on&nbsp;page&nbsp;1&nbsp;and&nbsp;question&nbsp;3&nbsp;on&nbsp;page&nbsp;2</span></div></li>
    171. 

  171. <li><div class="src-line"><a name="a159"></a><span class="src-doc">&nbsp;*/</span></div></li>
    172. 

  172. <li><div class="src-line"><a name="a160"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_questions_in_quiz">quiz_questions_in_quiz</a><span class="src-sym">(</span><span class="src-var">$layout</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    173. 

  173. <li><div class="src-line"><a name="a161"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><a href="http://www.php.net/str_replace">str_replace</a><span class="src-sym">(</span><span class="src-str">',0'</span><span class="src-sym">,&nbsp;</span><span class="src-str">''</span><span class="src-sym">,&nbsp;</span><span class="src-var">$layout</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    174. 

  174. <li><div class="src-line"><a name="a162"></a><span class="src-sym">}</span></div></li>
    175. 

  175. <li><div class="src-line"><a name="a163"></a>&nbsp;</div></li>
    176. 

  176. <li><div class="src-line"><a name="a164"></a><span class="src-doc">/**</span></div></li>
    177. 

  177. <li><div class="src-line"><a name="a165"></a><span class="src-doc">&nbsp;*&nbsp;Returns&nbsp;the&nbsp;number&nbsp;of&nbsp;pages&nbsp;in&nbsp;the&nbsp;quiz&nbsp;layout</span></div></li>
    178. 

  178. <li><div class="src-line"><a name="a166"></a><span class="src-doc">&nbsp;*</span></div></li>
    179. 

  179. <li><div class="src-line"><a name="a167"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Comma&nbsp;separated&nbsp;list&nbsp;of&nbsp;question&nbsp;ids</span></div></li>
    180. 

  180. <li><div class="src-line"><a name="a168"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc-var">$layout&nbsp;</span><span class="src-doc">&nbsp;The&nbsp;string&nbsp;representing&nbsp;the&nbsp;quiz&nbsp;layout.</span></div></li>
    181. 

  181. <li><div class="src-line"><a name="a169"></a><span class="src-doc">&nbsp;*/</span></div></li>
    182. 

  182. <li><div class="src-line"><a name="a170"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_number_of_pages">quiz_number_of_pages</a><span class="src-sym">(</span><span class="src-var">$layout</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    183. 

  183. <li><div class="src-line"><a name="a171"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><a href="http://www.php.net/substr_count">substr_count</a><span class="src-sym">(</span><span class="src-var">$layout</span><span class="src-sym">,&nbsp;</span><span class="src-str">',0'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    184. 

  184. <li><div class="src-line"><a name="a172"></a><span class="src-sym">}</span></div></li>
    185. 

  185. <li><div class="src-line"><a name="a173"></a>&nbsp;</div></li>
    186. 

  186. <li><div class="src-line"><a name="a174"></a><span class="src-doc">/**</span></div></li>
    187. 

  187. <li><div class="src-line"><a name="a175"></a><span class="src-doc">&nbsp;*&nbsp;Returns&nbsp;the&nbsp;first&nbsp;question&nbsp;number&nbsp;for&nbsp;the&nbsp;current&nbsp;quiz&nbsp;page</span></div></li>
    188. 

  188. <li><div class="src-line"><a name="a176"></a><span class="src-doc">&nbsp;*</span></div></li>
    189. 

  189. <li><div class="src-line"><a name="a177"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc">&nbsp;The&nbsp;number&nbsp;of&nbsp;the&nbsp;first&nbsp;question</span></div></li>
    190. 

  190. <li><div class="src-line"><a name="a178"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc-var">$quizlayout&nbsp;</span><span class="src-doc">The&nbsp;string&nbsp;representing&nbsp;the&nbsp;layout&nbsp;for&nbsp;the&nbsp;whole&nbsp;quiz</span></div></li>
    191. 

  191. <li><div class="src-line"><a name="a179"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc-var">$pagelayout&nbsp;</span><span class="src-doc">The&nbsp;string&nbsp;representing&nbsp;the&nbsp;layout&nbsp;for&nbsp;the&nbsp;current&nbsp;page</span></div></li>
    192. 

  192. <li><div class="src-line"><a name="a180"></a><span class="src-doc">&nbsp;*/</span></div></li>
    193. 

  193. <li><div class="src-line"><a name="a181"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_first_questionnumber">quiz_first_questionnumber</a><span class="src-sym">(</span><span class="src-var">$quizlayout</span><span class="src-sym">,&nbsp;</span><span class="src-var">$pagelayout</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    194. 

  194. <li><div class="src-line"><a name="a182"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;this&nbsp;works&nbsp;by&nbsp;finding&nbsp;all&nbsp;the&nbsp;questions&nbsp;from&nbsp;the&nbsp;quizlayout&nbsp;that</span></div></li>
    195. 

  195. <li><div class="src-line"><a name="a183"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;come&nbsp;before&nbsp;the&nbsp;current&nbsp;page&nbsp;and&nbsp;then&nbsp;adding&nbsp;up&nbsp;their&nbsp;lengths.</span></div></li>
    196. 

  196. <li><div class="src-line"><a name="a184"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">;</span></div></li>
    197. 

  197. <li><div class="src-line"><a name="a185"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$start&nbsp;</span>=&nbsp;<a href="http://www.php.net/strpos">strpos</a><span class="src-sym">(</span><span class="src-var">$quizlayout</span><span class="src-sym">,&nbsp;</span><span class="src-str">','</span>.<span class="src-var">$pagelayout</span>.<span class="src-str">','</span><span class="src-sym">)</span>-<span class="src-num">2</span><span class="src-sym">;</span></div></li>
    198. 

  198. <li><div class="src-line"><a name="a186"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$start&nbsp;</span>&gt;&nbsp;<span class="src-num">0</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    199. 

  199. <li><div class="src-line"><a name="a187"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$prevlist&nbsp;</span>=&nbsp;<a href="http://www.php.net/substr">substr</a><span class="src-sym">(</span><span class="src-var">$quizlayout</span><span class="src-sym">,&nbsp;</span><span class="src-num">0</span><span class="src-sym">,&nbsp;</span><span class="src-var">$start</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    200. 

  200. <li><div class="src-line"><a name="a188"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">get_field_sql</span><span class="src-sym">(</span><span class="src-str">&quot;</span><span class="src-str">SELECT&nbsp;sum(length)+1&nbsp;FROM&nbsp;{<span class="src-var">$CFG</span></span><span class="src-sym">-&gt;</span><span class="src-id">prefix</span><span class="src-str"></span><span class="src-sym">}</span>question</span></div></li>
    201. 

  201. <li><div class="src-line"><a name="a189"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WHERE&nbsp;id&nbsp;IN&nbsp;(<span class="src-var">$prevlist</span>)</span><span class="src-str">&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    202. 

  202. <li><div class="src-line"><a name="a190"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    203. 

  203. <li><div class="src-line"><a name="a191"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-num">1</span><span class="src-sym">;</span></div></li>
    204. 

  204. <li><div class="src-line"><a name="a192"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    205. 

  205. <li><div class="src-line"><a name="a193"></a><span class="src-sym">}</span></div></li>
    206. 

  206. <li><div class="src-line"><a name="a194"></a>&nbsp;</div></li>
    207. 

  207. <li><div class="src-line"><a name="a195"></a><span class="src-doc">/**</span></div></li>
    208. 

  208. <li><div class="src-line"><a name="a196"></a><span class="src-doc">&nbsp;*&nbsp;Re-paginates&nbsp;the&nbsp;quiz&nbsp;layout</span></div></li>
    209. 

  209. <li><div class="src-line"><a name="a197"></a><span class="src-doc">&nbsp;*</span></div></li>
    210. 

  210. <li><div class="src-line"><a name="a198"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;new&nbsp;layout&nbsp;string</span></div></li>
    211. 

  211. <li><div class="src-line"><a name="a199"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc-var">$layout&nbsp;</span><span class="src-doc">&nbsp;The&nbsp;string&nbsp;representing&nbsp;the&nbsp;quiz&nbsp;layout.</span></div></li>
    212. 

  212. <li><div class="src-line"><a name="a200"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$perpage&nbsp;</span><span class="src-doc">The&nbsp;number&nbsp;of&nbsp;questions&nbsp;per&nbsp;page</span></div></li>
    213. 

  213. <li><div class="src-line"><a name="a201"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">boolean&nbsp;</span><span class="src-doc-var">$shuffle&nbsp;</span><span class="src-doc">Should&nbsp;the&nbsp;questions&nbsp;be&nbsp;reordered&nbsp;randomly?</span></div></li>
    214. 

  214. <li><div class="src-line"><a name="a202"></a><span class="src-doc">&nbsp;*/</span></div></li>
    215. 

  215. <li><div class="src-line"><a name="a203"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_repaginate">quiz_repaginate</a><span class="src-sym">(</span><span class="src-var">$layout</span><span class="src-sym">,&nbsp;</span><span class="src-var">$perpage</span><span class="src-sym">,&nbsp;</span><span class="src-var">$shuffle</span>=<span class="src-id">false</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    216. 

  216. <li><div class="src-line"><a name="a204"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$layout&nbsp;</span>=&nbsp;<a href="http://www.php.net/str_replace">str_replace</a><span class="src-sym">(</span><span class="src-str">',0'</span><span class="src-sym">,&nbsp;</span><span class="src-str">''</span><span class="src-sym">,&nbsp;</span><span class="src-var">$layout</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span><span class="src-comm">//&nbsp;remove&nbsp;existing&nbsp;page&nbsp;breaks</span></div></li>
    217. 

  217. <li><div class="src-line"><a name="a205"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$questions&nbsp;</span>=&nbsp;<a href="http://www.php.net/explode">explode</a><span class="src-sym">(</span><span class="src-str">','</span><span class="src-sym">,&nbsp;</span><span class="src-var">$layout</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    218. 

  218. <li><div class="src-line"><a name="a206"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$shuffle</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    219. 

  219. <li><div class="src-line"><a name="a207"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.php.net/srand">srand</a><span class="src-sym">(</span>(float)<a href="http://www.php.net/microtime">microtime</a><span class="src-sym">(</span><span class="src-sym">)&nbsp;</span>*&nbsp;<span class="src-num">1000000</span><span class="src-sym">)</span><span class="src-sym">;&nbsp;</span><span class="src-comm">//&nbsp;for&nbsp;php&nbsp;&lt;&nbsp;4.2</span></div></li>
    220. 

  220. <li><div class="src-line"><a name="a208"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="http://www.php.net/shuffle">shuffle</a><span class="src-sym">(</span><span class="src-var">$questions</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    221. 

  221. <li><div class="src-line"><a name="a209"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    222. 

  222. <li><div class="src-line"><a name="a210"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$i&nbsp;</span>=&nbsp;<span class="src-num">1</span><span class="src-sym">;</span></div></li>
    223. 

  223. <li><div class="src-line"><a name="a211"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$layout&nbsp;</span>=&nbsp;<span class="src-str">''</span><span class="src-sym">;</span></div></li>
    224. 

  224. <li><div class="src-line"><a name="a212"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$questions&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$question</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    225. 

  225. <li><div class="src-line"><a name="a213"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$perpage&nbsp;</span><span class="src-key">and&nbsp;</span><span class="src-var">$i&nbsp;</span>&gt;&nbsp;<span class="src-var">$perpage</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    226. 

  226. <li><div class="src-line"><a name="a214"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$layout&nbsp;</span>.=&nbsp;<span class="src-str">'0,'</span><span class="src-sym">;</span></div></li>
    227. 

  227. <li><div class="src-line"><a name="a215"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$i&nbsp;</span>=&nbsp;<span class="src-num">1</span><span class="src-sym">;</span></div></li>
    228. 

  228. <li><div class="src-line"><a name="a216"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    229. 

  229. <li><div class="src-line"><a name="a217"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$layout&nbsp;</span>.=&nbsp;<span class="src-var">$question</span>.<span class="src-str">','</span><span class="src-sym">;</span></div></li>
    230. 

  230. <li><div class="src-line"><a name="a218"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$i</span>++<span class="src-sym">;</span></div></li>
    231. 

  231. <li><div class="src-line"><a name="a219"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    232. 

  232. <li><div class="src-line"><a name="a220"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$layout</span>.<span class="src-str">'0'</span><span class="src-sym">;</span></div></li>
    233. 

  233. <li><div class="src-line"><a name="a221"></a><span class="src-sym">}</span></div></li>
    234. 

  234. <li><div class="src-line"><a name="a222"></a>&nbsp;</div></li>
    235. 

  235. <li><div class="src-line"><a name="a223"></a><span class="src-doc">/**</span></div></li>
    236. 

  236. <li><div class="src-line"><a name="a224"></a><span class="src-doc">&nbsp;*&nbsp;Print&nbsp;navigation&nbsp;panel&nbsp;for&nbsp;quiz&nbsp;attempt&nbsp;and&nbsp;review&nbsp;pages</span></div></li>
    237. 

  237. <li><div class="src-line"><a name="a225"></a><span class="src-doc">&nbsp;*</span></div></li>
    238. 

  238. <li><div class="src-line"><a name="a226"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$page&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;number&nbsp;of&nbsp;the&nbsp;current&nbsp;page&nbsp;(counting&nbsp;from&nbsp;0).</span></div></li>
    239. 

  239. <li><div class="src-line"><a name="a227"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$pages&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;The&nbsp;total&nbsp;number&nbsp;of&nbsp;pages.</span></div></li>
    240. 

  240. <li><div class="src-line"><a name="a228"></a><span class="src-doc">&nbsp;*/</span></div></li>
    241. 

  241. <li><div class="src-line"><a name="a229"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_print_navigation_panel">quiz_print_navigation_panel</a><span class="src-sym">(</span><span class="src-var">$page</span><span class="src-sym">,&nbsp;</span><span class="src-var">$pages</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    242. 

  242. <li><div class="src-line"><a name="a230"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//$page++;</span></div></li>
    243. 

  243. <li><div class="src-line"><a name="a231"></a>&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;div&nbsp;class=&quot;paging&nbsp;pagingbar&quot;&gt;'</span><span class="src-sym">;</span></div></li>
    244. 

  244. <li><div class="src-line"><a name="a232"></a>&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;span&nbsp;class=&quot;title&quot;&gt;'&nbsp;</span>.&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'page'</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">':&lt;/span&gt;'</span><span class="src-sym">;</span></div></li>
    245. 

  245. <li><div class="src-line"><a name="a233"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$page&nbsp;</span>&gt;&nbsp;<span class="src-num">0</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    246. 

  246. <li><div class="src-line"><a name="a234"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Print&nbsp;previous&nbsp;link</span></div></li>
    247. 

  247. <li><div class="src-line"><a name="a235"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$strprev&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'previous'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    248. 

  248. <li><div class="src-line"><a name="a236"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;a&nbsp;href=&quot;javascript:navigate('&nbsp;</span>.&nbsp;<span class="src-sym">(</span><span class="src-var">$page&nbsp;</span>-&nbsp;<span class="src-num">1</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">');&quot;&nbsp;title=&quot;'</span></div></li>
    249. 

  249. <li><div class="src-line"><a name="a237"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.&nbsp;<span class="src-var">$strprev&nbsp;</span>.&nbsp;<span class="src-str">'&quot;&gt;('&nbsp;</span>.&nbsp;<span class="src-var">$strprev&nbsp;</span>.&nbsp;<span class="src-str">')&lt;/a&gt;'</span><span class="src-sym">;</span></div></li>
    250. 

  250. <li><div class="src-line"><a name="a238"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    251. 

  251. <li><div class="src-line"><a name="a239"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">for&nbsp;</span><span class="src-sym">(</span><span class="src-var">$i&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;&nbsp;</span><span class="src-var">$i&nbsp;</span>&lt;&nbsp;<span class="src-var">$pages</span><span class="src-sym">;&nbsp;</span><span class="src-var">$i</span>++<span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    252. 

  252. <li><div class="src-line"><a name="a240"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$i&nbsp;</span>==&nbsp;<span class="src-var">$page</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    253. 

  253. <li><div class="src-line"><a name="a241"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;span&nbsp;class=&quot;thispage&quot;&gt;'</span>.<span class="src-sym">(</span><span class="src-var">$i</span>+<span class="src-num">1</span><span class="src-sym">)</span>.<span class="src-str">'&lt;/span&gt;'</span><span class="src-sym">;</span></div></li>
    254. 

  254. <li><div class="src-line"><a name="a242"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    255. 

  255. <li><div class="src-line"><a name="a243"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;a&nbsp;href=&quot;javascript:navigate('&nbsp;</span>.&nbsp;<span class="src-sym">(</span><span class="src-var">$i</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">');&quot;&gt;'</span>.<span class="src-sym">(</span><span class="src-var">$i</span>+<span class="src-num">1</span><span class="src-sym">)</span>.<span class="src-str">'&lt;/a&gt;'</span><span class="src-sym">;</span></div></li>
    256. 

  256. <li><div class="src-line"><a name="a244"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    257. 

  257. <li><div class="src-line"><a name="a245"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    258. 

  258. <li><div class="src-line"><a name="a246"></a>&nbsp;</div></li>
    259. 

  259. <li><div class="src-line"><a name="a247"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$page&nbsp;</span>&lt;&nbsp;<span class="src-var">$pages&nbsp;</span>-&nbsp;<span class="src-num">1</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    260. 

  260. <li><div class="src-line"><a name="a248"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Print&nbsp;next&nbsp;link</span></div></li>
    261. 

  261. <li><div class="src-line"><a name="a249"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$strnext&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'next'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    262. 

  262. <li><div class="src-line"><a name="a250"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;a&nbsp;href=&quot;javascript:navigate('&nbsp;</span>.&nbsp;<span class="src-sym">(</span><span class="src-var">$page&nbsp;</span>+&nbsp;<span class="src-num">1</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">');&quot;&nbsp;title=&quot;'</span></div></li>
    263. 

  263. <li><div class="src-line"><a name="a251"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;.&nbsp;<span class="src-var">$strnext&nbsp;</span>.&nbsp;<span class="src-str">'&quot;&gt;('&nbsp;</span>.&nbsp;<span class="src-var">$strnext&nbsp;</span>.&nbsp;<span class="src-str">')&lt;/a&gt;'</span><span class="src-sym">;</span></div></li>
    264. 

  264. <li><div class="src-line"><a name="a252"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    265. 

  265. <li><div class="src-line"><a name="a253"></a>&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;<span class="src-str">'&lt;/div&gt;'</span><span class="src-sym">;</span></div></li>
    266. 

  266. <li><div class="src-line"><a name="a254"></a><span class="src-sym">}</span></div></li>
    267. 

  267. <li><div class="src-line"><a name="a255"></a>&nbsp;</div></li>
    268. 

  268. <li><div class="src-line"><a name="a256"></a><span class="src-comm">///&nbsp;Functions&nbsp;to&nbsp;do&nbsp;with&nbsp;quiz&nbsp;grades&nbsp;//////////////////////////////////////////</span></div></li>
    269. 

  269. <li><div class="src-line"><a name="a257"></a>&nbsp;</div></li>
    270. 

  270. <li><div class="src-line"><a name="a258"></a><span class="src-doc">/**</span></div></li>
    271. 

  271. <li><div class="src-line"><a name="a259"></a><span class="src-doc">&nbsp;*&nbsp;Creates&nbsp;an&nbsp;array&nbsp;of&nbsp;maximum&nbsp;grades&nbsp;for&nbsp;a&nbsp;quiz</span></div></li>
    272. 

  272. <li><div class="src-line"><a name="a260"></a><span class="src-doc">&nbsp;*</span></div></li>
    273. 

  273. <li><div class="src-line"><a name="a261"></a><span class="src-doc">&nbsp;*&nbsp;The&nbsp;grades&nbsp;are&nbsp;extracted&nbsp;from&nbsp;the&nbsp;quiz_question_instances&nbsp;table.</span></div></li>
    274. 

  274. <li><div class="src-line"><a name="a262"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">array&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Array&nbsp;of&nbsp;grades&nbsp;indexed&nbsp;by&nbsp;question&nbsp;id</span></div></li>
    275. 

  275. <li><div class="src-line"><a name="a263"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;These&nbsp;are&nbsp;the&nbsp;maximum&nbsp;possible&nbsp;grades&nbsp;that</span></div></li>
    276. 

  276. <li><div class="src-line"><a name="a264"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;students&nbsp;can&nbsp;achieve&nbsp;for&nbsp;each&nbsp;of&nbsp;the&nbsp;questions</span></div></li>
    277. 

  277. <li><div class="src-line"><a name="a265"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">The&nbsp;quiz&nbsp;object</span></div></li>
    278. 

  278. <li><div class="src-line"><a name="a266"></a><span class="src-doc">&nbsp;*/</span></div></li>
    279. 

  279. <li><div class="src-line"><a name="a267"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_all_question_grades">quiz_get_all_question_grades</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    280. 

  280. <li><div class="src-line"><a name="a268"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">;</span></div></li>
    281. 

  281. <li><div class="src-line"><a name="a269"></a>&nbsp;</div></li>
    282. 

  282. <li><div class="src-line"><a name="a270"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$questionlist&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_questions_in_quiz">quiz_questions_in_quiz</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">questions</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    283. 

  283. <li><div class="src-line"><a name="a271"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$questionlist</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    284. 

  284. <li><div class="src-line"><a name="a272"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    285. 

  285. <li><div class="src-line"><a name="a273"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    286. 

  286. <li><div class="src-line"><a name="a274"></a>&nbsp;</div></li>
    287. 

  287. <li><div class="src-line"><a name="a275"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$instances&nbsp;</span>=&nbsp;<span class="src-id">get_records_sql</span><span class="src-sym">(</span><span class="src-str">&quot;</span><span class="src-str">SELECT&nbsp;question,grade,id</span></div></li>
    288. 

  288. <li><div class="src-line"><a name="a276"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;FROM&nbsp;{<span class="src-var">$CFG</span></span><span class="src-sym">-&gt;</span><span class="src-id">prefix</span><span class="src-str"></span><span class="src-sym">}</span>quiz_question_instances</span></div></li>
    289. 

  289. <li><div class="src-line"><a name="a277"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WHERE&nbsp;quiz&nbsp;=&nbsp;'<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span>'</span><span class="src-str">&quot;&nbsp;</span>.</div></li>
    290. 

  290. <li><div class="src-line"><a name="a278"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">(</span><a href="http://www.php.net/is_null">is_null</a><span class="src-sym">(</span><span class="src-var">$questionlist</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-str">''&nbsp;</span>:</div></li>
    291. 

  291. <li><div class="src-line"><a name="a279"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-str">&quot;</span><span class="src-str">AND&nbsp;question&nbsp;IN&nbsp;(<span class="src-var">$questionlist</span>)</span><span class="src-str">&quot;</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
    292. 

  292. <li><div class="src-line"><a name="a280"></a>&nbsp;</div></li>
    293. 

  293. <li><div class="src-line"><a name="a281"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$list&nbsp;</span>=&nbsp;<a href="http://www.php.net/explode">explode</a><span class="src-sym">(</span><span class="src-str">&quot;,&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-var">$questionlist</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    294. 

  294. <li><div class="src-line"><a name="a282"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grades&nbsp;</span>=&nbsp;<span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    295. 

  295. <li><div class="src-line"><a name="a283"></a>&nbsp;</div></li>
    296. 

  296. <li><div class="src-line"><a name="a284"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$list&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$qid</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    297. 

  297. <li><div class="src-line"><a name="a285"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span>isset<span class="src-sym">(</span><span class="src-var">$instances</span><span class="src-sym">[</span><span class="src-var">$qid</span><span class="src-sym">]</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    298. 

  298. <li><div class="src-line"><a name="a286"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grades</span><span class="src-sym">[</span><span class="src-var">$qid</span><span class="src-sym">]&nbsp;</span>=&nbsp;<span class="src-var">$instances</span><span class="src-sym">[</span><span class="src-var">$qid</span><span class="src-sym">]</span><span class="src-sym">-&gt;</span><span class="src-id">grade</span><span class="src-sym">;</span></div></li>
    299. 

  299. <li><div class="src-line"><a name="a287"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    300. 

  300. <li><div class="src-line"><a name="a288"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grades</span><span class="src-sym">[</span><span class="src-var">$qid</span><span class="src-sym">]&nbsp;</span>=&nbsp;<span class="src-num">1</span><span class="src-sym">;</span></div></li>
    301. 

  301. <li><div class="src-line"><a name="a289"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    302. 

  302. <li><div class="src-line"><a name="a290"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    303. 

  303. <li><div class="src-line"><a name="a291"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$grades</span><span class="src-sym">;</span></div></li>
    304. 

  304. <li><div class="src-line"><a name="a292"></a><span class="src-sym">}</span></div></li>
    305. 

  305. <li><div class="src-line"><a name="a293"></a>&nbsp;</div></li>
    306. 

  306. <li><div class="src-line"><a name="a294"></a><span class="src-doc">/**</span></div></li>
    307. 

  307. <li><div class="src-line"><a name="a295"></a><span class="src-doc">&nbsp;*&nbsp;Get&nbsp;the&nbsp;best&nbsp;current&nbsp;grade&nbsp;for&nbsp;a&nbsp;particular&nbsp;user&nbsp;in&nbsp;a&nbsp;quiz.</span></div></li>
    308. 

  308. <li><div class="src-line"><a name="a296"></a><span class="src-doc">&nbsp;*</span></div></li>
    309. 

  309. <li><div class="src-line"><a name="a297"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz&nbsp;object.</span></div></li>
    310. 

  310. <li><div class="src-line"><a name="a298"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$userid&nbsp;</span><span class="src-doc">the&nbsp;id&nbsp;of&nbsp;the&nbsp;user.</span></div></li>
    311. 

  311. <li><div class="src-line"><a name="a299"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">float&nbsp;</span><span class="src-doc">the&nbsp;user's&nbsp;current&nbsp;grade&nbsp;for&nbsp;this&nbsp;quiz.</span></div></li>
    312. 

  312. <li><div class="src-line"><a name="a300"></a><span class="src-doc">&nbsp;*/</span></div></li>
    313. 

  313. <li><div class="src-line"><a name="a301"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_best_grade">quiz_get_best_grade</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    314. 

  314. <li><div class="src-line"><a name="a302"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade&nbsp;</span>=&nbsp;<span class="src-id">get_field</span><span class="src-sym">(</span><span class="src-str">'quiz_grades'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'grade'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">,&nbsp;</span><span class="src-str">'userid'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    315. 

  315. <li><div class="src-line"><a name="a303"></a>&nbsp;</div></li>
    316. 

  316. <li><div class="src-line"><a name="a304"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Need&nbsp;to&nbsp;detect&nbsp;errors/no&nbsp;result,&nbsp;without&nbsp;catching&nbsp;0&nbsp;scores.</span></div></li>
    317. 

  317. <li><div class="src-line"><a name="a305"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><a href="http://www.php.net/is_numeric">is_numeric</a><span class="src-sym">(</span><span class="src-var">$grade</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    318. 

  318. <li><div class="src-line"><a name="a306"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><a href="http://www.php.net/round">round</a><span class="src-sym">(</span><span class="src-var">$grade</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">decimalpoints</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    319. 

  319. <li><div class="src-line"><a name="a307"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    320. 

  320. <li><div class="src-line"><a name="a308"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">NULL</span><span class="src-sym">;</span></div></li>
    321. 

  321. <li><div class="src-line"><a name="a309"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    322. 

  322. <li><div class="src-line"><a name="a310"></a><span class="src-sym">}</span></div></li>
    323. 

  323. <li><div class="src-line"><a name="a311"></a>&nbsp;</div></li>
    324. 

  324. <li><div class="src-line"><a name="a312"></a><span class="src-doc">/**</span></div></li>
    325. 

  325. <li><div class="src-line"><a name="a313"></a><span class="src-doc">&nbsp;*&nbsp;Convert&nbsp;the&nbsp;raw&nbsp;grade&nbsp;stored&nbsp;in&nbsp;$attempt&nbsp;into&nbsp;a&nbsp;grade&nbsp;out&nbsp;of&nbsp;the&nbsp;maximum</span></div></li>
    326. 

  326. <li><div class="src-line"><a name="a314"></a><span class="src-doc">&nbsp;*&nbsp;grade&nbsp;for&nbsp;this&nbsp;quiz.</span></div></li>
    327. 

  327. <li><div class="src-line"><a name="a315"></a><span class="src-doc">&nbsp;*</span></div></li>
    328. 

  328. <li><div class="src-line"><a name="a316"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">float&nbsp;</span><span class="src-doc-var">$rawgrade&nbsp;</span><span class="src-doc">the&nbsp;unadjusted&nbsp;grade,&nbsp;fof&nbsp;example&nbsp;$attempt-&gt;sumgrades</span></div></li>
    329. 

  329. <li><div class="src-line"><a name="a317"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz&nbsp;object.&nbsp;Only&nbsp;the&nbsp;fields&nbsp;grade,&nbsp;sumgrades&nbsp;and&nbsp;decimalpoints&nbsp;are&nbsp;used.</span></div></li>
    330. 

  330. <li><div class="src-line"><a name="a318"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">float&nbsp;</span><span class="src-doc">the&nbsp;rescaled&nbsp;grade.</span></div></li>
    331. 

  331. <li><div class="src-line"><a name="a319"></a><span class="src-doc">&nbsp;*/</span></div></li>
    332. 

  332. <li><div class="src-line"><a name="a320"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_rescale_grade">quiz_rescale_grade</a><span class="src-sym">(</span><span class="src-var">$rawgrade</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$round&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    333. 

  333. <li><div class="src-line"><a name="a321"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    334. 

  334. <li><div class="src-line"><a name="a322"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade&nbsp;</span>=&nbsp;<span class="src-var">$rawgrade&nbsp;</span>*&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grade&nbsp;</span>/&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">;</span></div></li>
    335. 

  335. <li><div class="src-line"><a name="a323"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$round</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    336. 

  336. <li><div class="src-line"><a name="a324"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade&nbsp;</span>=&nbsp;<a href="http://www.php.net/round">round</a><span class="src-sym">(</span><span class="src-var">$grade</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">decimalpoints</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    337. 

  337. <li><div class="src-line"><a name="a325"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    338. 

  338. <li><div class="src-line"><a name="a326"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    339. 

  339. <li><div class="src-line"><a name="a327"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    340. 

  340. <li><div class="src-line"><a name="a328"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    341. 

  341. <li><div class="src-line"><a name="a329"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$grade</span><span class="src-sym">;</span></div></li>
    342. 

  342. <li><div class="src-line"><a name="a330"></a><span class="src-sym">}</span></div></li>
    343. 

  343. <li><div class="src-line"><a name="a331"></a>&nbsp;</div></li>
    344. 

  344. <li><div class="src-line"><a name="a332"></a><span class="src-doc">/**</span></div></li>
    345. 

  345. <li><div class="src-line"><a name="a333"></a><span class="src-doc">&nbsp;*&nbsp;Get&nbsp;the&nbsp;feedback&nbsp;text&nbsp;that&nbsp;should&nbsp;be&nbsp;show&nbsp;to&nbsp;a&nbsp;student&nbsp;who</span></div></li>
    346. 

  346. <li><div class="src-line"><a name="a334"></a><span class="src-doc">&nbsp;*&nbsp;got&nbsp;this&nbsp;grade&nbsp;on&nbsp;this&nbsp;quiz.&nbsp;The&nbsp;feedback&nbsp;is&nbsp;processed&nbsp;ready&nbsp;for&nbsp;diplay.</span></div></li>
    347. 

  347. <li><div class="src-line"><a name="a335"></a><span class="src-doc">&nbsp;*</span></div></li>
    348. 

  348. <li><div class="src-line"><a name="a336"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">float&nbsp;</span><span class="src-doc-var">$grade&nbsp;</span><span class="src-doc">a&nbsp;grade&nbsp;on&nbsp;this&nbsp;quiz.</span></div></li>
    349. 

  349. <li><div class="src-line"><a name="a337"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$quizid&nbsp;</span><span class="src-doc">the&nbsp;id&nbsp;of&nbsp;the&nbsp;quiz&nbsp;object.</span></div></li>
    350. 

  350. <li><div class="src-line"><a name="a338"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">string&nbsp;</span><span class="src-doc">the&nbsp;comment&nbsp;that&nbsp;corresponds&nbsp;to&nbsp;this&nbsp;grade&nbsp;(empty&nbsp;string&nbsp;if&nbsp;there&nbsp;is&nbsp;not&nbsp;one.</span></div></li>
    351. 

  351. <li><div class="src-line"><a name="a339"></a><span class="src-doc">&nbsp;*/</span></div></li>
    352. 

  352. <li><div class="src-line"><a name="a340"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_feedback_for_grade">quiz_feedback_for_grade</a><span class="src-sym">(</span><span class="src-var">$grade</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quizid</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    353. 

  353. <li><div class="src-line"><a name="a341"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$feedback&nbsp;</span>=&nbsp;<span class="src-id">get_field_select</span><span class="src-sym">(</span><span class="src-str">'quiz_feedback'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'feedbacktext'</span><span class="src-sym">,</span></div></li>
    354. 

  354. <li><div class="src-line"><a name="a342"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-str">&quot;</span><span class="src-str">quizid&nbsp;=&nbsp;<span class="src-var">$quizid</span>&nbsp;AND&nbsp;mingrade&nbsp;&lt;=&nbsp;<span class="src-var">$grade</span>&nbsp;AND&nbsp;<span class="src-var">$grade</span>&nbsp;&lt;&nbsp;maxgrade</span><span class="src-str">&quot;</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    355. 

  355. <li><div class="src-line"><a name="a343"></a>&nbsp;</div></li>
    356. 

  356. <li><div class="src-line"><a name="a344"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$feedback</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    357. 

  357. <li><div class="src-line"><a name="a345"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$feedback&nbsp;</span>=&nbsp;<span class="src-str">''</span><span class="src-sym">;</span></div></li>
    358. 

  358. <li><div class="src-line"><a name="a346"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    359. 

  359. <li><div class="src-line"><a name="a347"></a>&nbsp;</div></li>
    360. 

  360. <li><div class="src-line"><a name="a348"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Clean&nbsp;the&nbsp;text,&nbsp;ready&nbsp;for&nbsp;display.</span></div></li>
    361. 

  361. <li><div class="src-line"><a name="a349"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$formatoptions&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    362. 

  362. <li><div class="src-line"><a name="a350"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$formatoptions</span><span class="src-sym">-&gt;</span><span class="src-id">noclean&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    363. 

  363. <li><div class="src-line"><a name="a351"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$feedback&nbsp;</span>=&nbsp;<span class="src-id">format_text</span><span class="src-sym">(</span><span class="src-var">$feedback</span><span class="src-sym">,&nbsp;</span><span class="src-id">FORMAT_MOODLE</span><span class="src-sym">,&nbsp;</span><span class="src-var">$formatoptions</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    364. 

  364. <li><div class="src-line"><a name="a352"></a>&nbsp;</div></li>
    365. 

  365. <li><div class="src-line"><a name="a353"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$feedback</span><span class="src-sym">;</span></div></li>
    366. 

  366. <li><div class="src-line"><a name="a354"></a><span class="src-sym">}</span></div></li>
    367. 

  367. <li><div class="src-line"><a name="a355"></a>&nbsp;</div></li>
    368. 

  368. <li><div class="src-line"><a name="a356"></a><span class="src-doc">/**</span></div></li>
    369. 

  369. <li><div class="src-line"><a name="a357"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$quizid&nbsp;</span><span class="src-doc">the&nbsp;id&nbsp;of&nbsp;the&nbsp;quiz&nbsp;object.</span></div></li>
    370. 

  370. <li><div class="src-line"><a name="a358"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">boolean&nbsp;</span><span class="src-doc">Whether&nbsp;this&nbsp;quiz&nbsp;has&nbsp;any&nbsp;non-blank&nbsp;feedback&nbsp;text.</span></div></li>
    371. 

  371. <li><div class="src-line"><a name="a359"></a><span class="src-doc">&nbsp;*/</span></div></li>
    372. 

  372. <li><div class="src-line"><a name="a360"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_has_feedback">quiz_has_feedback</a><span class="src-sym">(</span><span class="src-var">$quizid</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    373. 

  373. <li><div class="src-line"><a name="a361"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">static&nbsp;</span><span class="src-var">$cache&nbsp;</span>=&nbsp;<span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    374. 

  374. <li><div class="src-line"><a name="a362"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-id">array_key_exists</span><span class="src-sym">(</span><span class="src-var">$quizid</span><span class="src-sym">,&nbsp;</span><span class="src-var">$cache</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    375. 

  375. <li><div class="src-line"><a name="a363"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$cache</span><span class="src-sym">[</span><span class="src-var">$quizid</span><span class="src-sym">]&nbsp;</span>=&nbsp;<span class="src-id">record_exists_select</span><span class="src-sym">(</span><span class="src-str">'quiz_feedback'</span><span class="src-sym">,</span></div></li>
    376. 

  376. <li><div class="src-line"><a name="a364"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-str">&quot;</span>quizid&nbsp;=&nbsp;<span class="src-var">$quizid</span>&nbsp;AND&nbsp;<span class="src-str">&quot;&nbsp;</span>.&nbsp;<span class="src-id">sql_isnotempty</span><span class="src-sym">(</span><span class="src-str">'quiz_feedback'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'feedbacktext'</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">,&nbsp;</span><span class="src-id">true</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
    377. 

  377. <li><div class="src-line"><a name="a365"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    378. 

  378. <li><div class="src-line"><a name="a366"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$cache</span><span class="src-sym">[</span><span class="src-var">$quizid</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
    379. 

  379. <li><div class="src-line"><a name="a367"></a><span class="src-sym">}</span></div></li>
    380. 

  380. <li><div class="src-line"><a name="a368"></a>&nbsp;</div></li>
    381. 

  381. <li><div class="src-line"><a name="a369"></a><span class="src-doc">/**</span></div></li>
    382. 

  382. <li><div class="src-line"><a name="a370"></a><span class="src-doc">&nbsp;*&nbsp;The&nbsp;quiz&nbsp;grade&nbsp;is&nbsp;the&nbsp;score&nbsp;that&nbsp;student's&nbsp;results&nbsp;are&nbsp;marked&nbsp;out&nbsp;of.&nbsp;When&nbsp;it</span></div></li>
    383. 

  383. <li><div class="src-line"><a name="a371"></a><span class="src-doc">&nbsp;*&nbsp;changes,&nbsp;the&nbsp;corresponding&nbsp;data&nbsp;in&nbsp;quiz_grades&nbsp;and&nbsp;quiz_feedback&nbsp;needs&nbsp;to&nbsp;be</span></div></li>
    384. 

  384. <li><div class="src-line"><a name="a372"></a><span class="src-doc">&nbsp;*&nbsp;rescaled.</span></div></li>
    385. 

  385. <li><div class="src-line"><a name="a373"></a><span class="src-doc">&nbsp;*</span></div></li>
    386. 

  386. <li><div class="src-line"><a name="a374"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">float&nbsp;</span><span class="src-doc-var">$newgrade&nbsp;</span><span class="src-doc">the&nbsp;new&nbsp;maximum&nbsp;grade&nbsp;for&nbsp;the&nbsp;quiz.</span></div></li>
    387. 

  387. <li><div class="src-line"><a name="a375"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz&nbsp;we&nbsp;are&nbsp;updating.&nbsp;Passed&nbsp;by&nbsp;reference&nbsp;so&nbsp;its&nbsp;grade&nbsp;field&nbsp;can&nbsp;be&nbsp;updated&nbsp;too.</span></div></li>
    388. 

  388. <li><div class="src-line"><a name="a376"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">boolean&nbsp;</span><span class="src-doc">indicating&nbsp;success&nbsp;or&nbsp;failure.</span></div></li>
    389. 

  389. <li><div class="src-line"><a name="a377"></a><span class="src-doc">&nbsp;*/</span></div></li>
    390. 

  390. <li><div class="src-line"><a name="a378"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_set_grade">quiz_set_grade</a><span class="src-sym">(</span><span class="src-var">$newgrade</span><span class="src-sym">,&nbsp;</span><span class="src-sym">&amp;</span><span class="src-var">$quiz</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    391. 

  391. <li><div class="src-line"><a name="a379"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;This&nbsp;is&nbsp;potentially&nbsp;expensive,&nbsp;so&nbsp;only&nbsp;do&nbsp;it&nbsp;if&nbsp;necessary.</span></div></li>
    392. 

  392. <li><div class="src-line"><a name="a380"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><a href="http://www.php.net/abs">abs</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grade&nbsp;</span>-&nbsp;<span class="src-var">$newgrade</span><span class="src-sym">)&nbsp;</span>&lt;&nbsp;<span class="src-num">1e-7</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    393. 

  393. <li><div class="src-line"><a name="a381"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Nothing&nbsp;to&nbsp;do.</span></div></li>
    394. 

  394. <li><div class="src-line"><a name="a382"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">true</span><span class="src-sym">;</span></div></li>
    395. 

  395. <li><div class="src-line"><a name="a383"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    396. 

  396. <li><div class="src-line"><a name="a384"></a>&nbsp;</div></li>
    397. 

  397. <li><div class="src-line"><a name="a385"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Use&nbsp;a&nbsp;transaction,&nbsp;so&nbsp;that&nbsp;on&nbsp;those&nbsp;databases&nbsp;that&nbsp;support&nbsp;it,&nbsp;this&nbsp;is&nbsp;safer.</span></div></li>
    398. 

  398. <li><div class="src-line"><a name="a386"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">begin_sql</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    399. 

  399. <li><div class="src-line"><a name="a387"></a>&nbsp;</div></li>
    400. 

  400. <li><div class="src-line"><a name="a388"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Update&nbsp;the&nbsp;quiz&nbsp;table.</span></div></li>
    401. 

  401. <li><div class="src-line"><a name="a389"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$success&nbsp;</span>=&nbsp;<span class="src-id">set_field</span><span class="src-sym">(</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'grade'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$newgrade</span><span class="src-sym">,&nbsp;</span><span class="src-str">'id'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">instance</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    402. 

  402. <li><div class="src-line"><a name="a390"></a>&nbsp;</div></li>
    403. 

  403. <li><div class="src-line"><a name="a391"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Rescaling&nbsp;the&nbsp;other&nbsp;data&nbsp;is&nbsp;only&nbsp;possible&nbsp;if&nbsp;the&nbsp;old&nbsp;grade&nbsp;was&nbsp;non-zero.</span></div></li>
    404. 

  404. <li><div class="src-line"><a name="a392"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grade&nbsp;</span>&gt;&nbsp;<span class="src-num">1e-7</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    405. 

  405. <li><div class="src-line"><a name="a393"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">;</span></div></li>
    406. 

  406. <li><div class="src-line"><a name="a394"></a>&nbsp;</div></li>
    407. 

  407. <li><div class="src-line"><a name="a395"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$factor&nbsp;</span>=&nbsp;<span class="src-var">$newgrade</span>/<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grade</span><span class="src-sym">;</span></div></li>
    408. 

  408. <li><div class="src-line"><a name="a396"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grade&nbsp;</span>=&nbsp;<span class="src-var">$newgrade</span><span class="src-sym">;</span></div></li>
    409. 

  409. <li><div class="src-line"><a name="a397"></a>&nbsp;</div></li>
    410. 

  410. <li><div class="src-line"><a name="a398"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Update&nbsp;the&nbsp;quiz_grades&nbsp;table.</span></div></li>
    411. 

  411. <li><div class="src-line"><a name="a399"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$timemodified&nbsp;</span>=&nbsp;<a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    412. 

  412. <li><div class="src-line"><a name="a400"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$success&nbsp;</span>=&nbsp;<span class="src-var">$success&nbsp;</span>&amp;&amp;&nbsp;<span class="src-id">execute_sql</span><span class="src-sym">(</span><span class="src-str">&quot;</div></li>
    413. 

  413. <li><div class="src-line"><a name="a401"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;UPDATE&nbsp;{<span class="src-var">$CFG</span></span><span class="src-sym">-&gt;</span><span class="src-id">prefix</span><span class="src-str"></span><span class="src-sym">}</span>quiz_grades</span></div></li>
    414. 

  414. <li><div class="src-line"><a name="a402"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SET&nbsp;grade&nbsp;=&nbsp;<span class="src-var">$factor</span>&nbsp;*&nbsp;grade,&nbsp;timemodified&nbsp;=&nbsp;<span class="src-var">$timemodified</span></span></div></li>
    415. 

  415. <li><div class="src-line"><a name="a403"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WHERE&nbsp;quiz&nbsp;=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span></span></div></li>
    416. 

  416. <li><div class="src-line"><a name="a404"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="src-str">&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    417. 

  417. <li><div class="src-line"><a name="a405"></a>&nbsp;</div></li>
    418. 

  418. <li><div class="src-line"><a name="a406"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Update&nbsp;the&nbsp;quiz_grades&nbsp;table.</span></div></li>
    419. 

  419. <li><div class="src-line"><a name="a407"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$success&nbsp;</span>=&nbsp;<span class="src-var">$success&nbsp;</span>&amp;&amp;&nbsp;<span class="src-id">execute_sql</span><span class="src-sym">(</span><span class="src-str">&quot;</div></li>
    420. 

  420. <li><div class="src-line"><a name="a408"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;UPDATE&nbsp;{<span class="src-var">$CFG</span></span><span class="src-sym">-&gt;</span><span class="src-id">prefix</span><span class="src-str"></span><span class="src-sym">}</span>quiz_feedback</span></div></li>
    421. 

  421. <li><div class="src-line"><a name="a409"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SET&nbsp;mingrade&nbsp;=&nbsp;<span class="src-var">$factor</span>&nbsp;*&nbsp;mingrade,&nbsp;maxgrade&nbsp;=&nbsp;<span class="src-var">$factor</span>&nbsp;*&nbsp;maxgrade</span></div></li>
    422. 

  422. <li><div class="src-line"><a name="a410"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WHERE&nbsp;quizid&nbsp;=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span></span></div></li>
    423. 

  423. <li><div class="src-line"><a name="a411"></a></span><span class="src-str">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="src-str">&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    424. 

  424. <li><div class="src-line"><a name="a412"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    425. 

  425. <li><div class="src-line"><a name="a413"></a>&nbsp;</div></li>
    426. 

  426. <li><div class="src-line"><a name="a414"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;update&nbsp;grade&nbsp;item&nbsp;and&nbsp;send&nbsp;all&nbsp;grades&nbsp;to&nbsp;gradebook</span></div></li>
    427. 

  427. <li><div class="src-line"><a name="a415"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">quiz_grade_item_update</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    428. 

  428. <li><div class="src-line"><a name="a416"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">quiz_update_grades</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    429. 

  429. <li><div class="src-line"><a name="a417"></a>&nbsp;</div></li>
    430. 

  430. <li><div class="src-line"><a name="a418"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$success</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    431. 

  431. <li><div class="src-line"><a name="a419"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">commit_sql</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    432. 

  432. <li><div class="src-line"><a name="a420"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    433. 

  433. <li><div class="src-line"><a name="a421"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">rollback_sql</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    434. 

  434. <li><div class="src-line"><a name="a422"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
    435. 

  435. <li><div class="src-line"><a name="a423"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    436. 

  436. <li><div class="src-line"><a name="a424"></a><span class="src-sym">}</span></div></li>
    437. 

  437. <li><div class="src-line"><a name="a425"></a>&nbsp;</div></li>
    438. 

  438. <li><div class="src-line"><a name="a426"></a><span class="src-doc">/**</span></div></li>
    439. 

  439. <li><div class="src-line"><a name="a427"></a><span class="src-doc">&nbsp;*&nbsp;Save&nbsp;the&nbsp;overall&nbsp;grade&nbsp;for&nbsp;a&nbsp;user&nbsp;at&nbsp;a&nbsp;quiz&nbsp;in&nbsp;the&nbsp;quiz_grades&nbsp;table</span></div></li>
    440. 

  440. <li><div class="src-line"><a name="a428"></a><span class="src-doc">&nbsp;*</span></div></li>
    441. 

  441. <li><div class="src-line"><a name="a429"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">The&nbsp;quiz&nbsp;for&nbsp;which&nbsp;the&nbsp;best&nbsp;grade&nbsp;is&nbsp;to&nbsp;be&nbsp;calculated&nbsp;and&nbsp;then&nbsp;saved.</span></div></li>
    442. 

  442. <li><div class="src-line"><a name="a430"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">integer&nbsp;</span><span class="src-doc-var">$userid&nbsp;</span><span class="src-doc">The&nbsp;userid&nbsp;to&nbsp;calculate&nbsp;the&nbsp;grade&nbsp;for.&nbsp;Defaults&nbsp;to&nbsp;the&nbsp;current&nbsp;user.</span></div></li>
    443. 

  443. <li><div class="src-line"><a name="a431"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">boolean&nbsp;</span><span class="src-doc">Indicates&nbsp;success&nbsp;or&nbsp;failure.</span></div></li>
    444. 

  444. <li><div class="src-line"><a name="a432"></a><span class="src-doc">&nbsp;*/</span></div></li>
    445. 

  445. <li><div class="src-line"><a name="a433"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_save_best_grade">quiz_save_best_grade</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid&nbsp;</span>=&nbsp;<span class="src-id">null</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    446. 

  446. <li><div class="src-line"><a name="a434"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">;</span></div></li>
    447. 

  447. <li><div class="src-line"><a name="a435"></a>&nbsp;</div></li>
    448. 

  448. <li><div class="src-line"><a name="a436"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$userid</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    449. 

  449. <li><div class="src-line"><a name="a437"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$userid&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    450. 

  450. <li><div class="src-line"><a name="a438"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    451. 

  451. <li><div class="src-line"><a name="a439"></a>&nbsp;</div></li>
    452. 

  452. <li><div class="src-line"><a name="a440"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Get&nbsp;all&nbsp;the&nbsp;attempts&nbsp;made&nbsp;by&nbsp;the&nbsp;user</span></div></li>
    453. 

  453. <li><div class="src-line"><a name="a441"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$attempts&nbsp;</span>=&nbsp;<span class="src-id">quiz_get_user_attempts</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    454. 

  454. <li><div class="src-line"><a name="a442"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">notify</span><span class="src-sym">(</span><span class="src-str">'Could&nbsp;not&nbsp;find&nbsp;any&nbsp;user&nbsp;attempts'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    455. 

  455. <li><div class="src-line"><a name="a443"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
    456. 

  456. <li><div class="src-line"><a name="a444"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    457. 

  457. <li><div class="src-line"><a name="a445"></a>&nbsp;</div></li>
    458. 

  458. <li><div class="src-line"><a name="a446"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Calculate&nbsp;the&nbsp;best&nbsp;grade</span></div></li>
    459. 

  459. <li><div class="src-line"><a name="a447"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$bestgrade&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_calculate_best_grade">quiz_calculate_best_grade</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempts</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    460. 

  460. <li><div class="src-line"><a name="a448"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$bestgrade&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_rescale_grade">quiz_rescale_grade</a><span class="src-sym">(</span><span class="src-var">$bestgrade</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    461. 

  461. <li><div class="src-line"><a name="a449"></a>&nbsp;</div></li>
    462. 

  462. <li><div class="src-line"><a name="a450"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Save&nbsp;the&nbsp;best&nbsp;grade&nbsp;in&nbsp;the&nbsp;database</span></div></li>
    463. 

  463. <li><div class="src-line"><a name="a451"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$grade&nbsp;</span>=&nbsp;<span class="src-id">get_record</span><span class="src-sym">(</span><span class="src-str">'quiz_grades'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">,&nbsp;</span><span class="src-str">'userid'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    464. 

  464. <li><div class="src-line"><a name="a452"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade</span><span class="src-sym">-&gt;</span><span class="src-id">grade&nbsp;</span>=&nbsp;<span class="src-var">$bestgrade</span><span class="src-sym">;</span></div></li>
    465. 

  465. <li><div class="src-line"><a name="a453"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade</span><span class="src-sym">-&gt;</span><span class="src-id">timemodified&nbsp;</span>=&nbsp;<a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    466. 

  466. <li><div class="src-line"><a name="a454"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-id">update_record</span><span class="src-sym">(</span><span class="src-str">'quiz_grades'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$grade</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    467. 

  467. <li><div class="src-line"><a name="a455"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">notify</span><span class="src-sym">(</span><span class="src-str">'Could&nbsp;not&nbsp;update&nbsp;best&nbsp;grade'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    468. 

  468. <li><div class="src-line"><a name="a456"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
    469. 

  469. <li><div class="src-line"><a name="a457"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    470. 

  470. <li><div class="src-line"><a name="a458"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    471. 

  471. <li><div class="src-line"><a name="a459"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade</span><span class="src-sym">-&gt;</span><span class="src-id">quiz&nbsp;</span>=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    472. 

  472. <li><div class="src-line"><a name="a460"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade</span><span class="src-sym">-&gt;</span><span class="src-id">userid&nbsp;</span>=&nbsp;<span class="src-var">$userid</span><span class="src-sym">;</span></div></li>
    473. 

  473. <li><div class="src-line"><a name="a461"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade</span><span class="src-sym">-&gt;</span><span class="src-id">grade&nbsp;</span>=&nbsp;<span class="src-var">$bestgrade</span><span class="src-sym">;</span></div></li>
    474. 

  474. <li><div class="src-line"><a name="a462"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$grade</span><span class="src-sym">-&gt;</span><span class="src-id">timemodified&nbsp;</span>=&nbsp;<a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    475. 

  475. <li><div class="src-line"><a name="a463"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-id">insert_record</span><span class="src-sym">(</span><span class="src-str">'quiz_grades'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$grade</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    476. 

  476. <li><div class="src-line"><a name="a464"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">notify</span><span class="src-sym">(</span><span class="src-str">'Could&nbsp;not&nbsp;insert&nbsp;new&nbsp;best&nbsp;grade'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    477. 

  477. <li><div class="src-line"><a name="a465"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
    478. 

  478. <li><div class="src-line"><a name="a466"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    479. 

  479. <li><div class="src-line"><a name="a467"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    480. 

  480. <li><div class="src-line"><a name="a468"></a>&nbsp;</div></li>
    481. 

  481. <li><div class="src-line"><a name="a469"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">quiz_update_grades</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$userid</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    482. 

  482. <li><div class="src-line"><a name="a470"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">true</span><span class="src-sym">;</span></div></li>
    483. 

  483. <li><div class="src-line"><a name="a471"></a><span class="src-sym">}</span></div></li>
    484. 

  484. <li><div class="src-line"><a name="a472"></a>&nbsp;</div></li>
    485. 

  485. <li><div class="src-line"><a name="a473"></a><span class="src-doc">/**</span></div></li>
    486. 

  486. <li><div class="src-line"><a name="a474"></a><span class="src-doc">&nbsp;*&nbsp;Calculate&nbsp;the&nbsp;overall&nbsp;grade&nbsp;for&nbsp;a&nbsp;quiz&nbsp;given&nbsp;a&nbsp;number&nbsp;of&nbsp;attempts&nbsp;by&nbsp;a&nbsp;particular&nbsp;user.</span></div></li>
    487. 

  487. <li><div class="src-line"><a name="a475"></a><span class="src-doc">&nbsp;*</span></div></li>
    488. 

  488. <li><div class="src-line"><a name="a476"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">float&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;overall&nbsp;grade</span></div></li>
    489. 

  489. <li><div class="src-line"><a name="a477"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;The&nbsp;quiz&nbsp;for&nbsp;which&nbsp;the&nbsp;best&nbsp;grade&nbsp;is&nbsp;to&nbsp;be&nbsp;calculated</span></div></li>
    490. 

  490. <li><div class="src-line"><a name="a478"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">array&nbsp;</span><span class="src-doc-var">$attempts&nbsp;</span><span class="src-doc">An&nbsp;array&nbsp;of&nbsp;all&nbsp;the&nbsp;attempts&nbsp;of&nbsp;the&nbsp;user&nbsp;at&nbsp;the&nbsp;quiz</span></div></li>
    491. 

  491. <li><div class="src-line"><a name="a479"></a><span class="src-doc">&nbsp;*/</span></div></li>
    492. 

  492. <li><div class="src-line"><a name="a480"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_calculate_best_grade">quiz_calculate_best_grade</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempts</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    493. 

  493. <li><div class="src-line"><a name="a481"></a>&nbsp;</div></li>
    494. 

  494. <li><div class="src-line"><a name="a482"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">switch&nbsp;</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grademethod</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    495. 

  495. <li><div class="src-line"><a name="a483"></a>&nbsp;</div></li>
    496. 

  496. <li><div class="src-line"><a name="a484"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_ATTEMPTFIRST">QUIZ_ATTEMPTFIRST</a></span>:</div></li>
    497. 

  497. <li><div class="src-line"><a name="a485"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    498. 

  498. <li><div class="src-line"><a name="a486"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">;</span></div></li>
    499. 

  499. <li><div class="src-line"><a name="a487"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    500. 

  500. <li><div class="src-line"><a name="a488"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    501. 

  501. <li><div class="src-line"><a name="a489"></a>&nbsp;</div></li>
    502. 

  502. <li><div class="src-line"><a name="a490"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_ATTEMPTLAST">QUIZ_ATTEMPTLAST</a></span>:</div></li>
    503. 

  503. <li><div class="src-line"><a name="a491"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    504. 

  504. <li><div class="src-line"><a name="a492"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$final&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">;</span></div></li>
    505. 

  505. <li><div class="src-line"><a name="a493"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    506. 

  506. <li><div class="src-line"><a name="a494"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$final</span><span class="src-sym">;</span></div></li>
    507. 

  507. <li><div class="src-line"><a name="a495"></a>&nbsp;</div></li>
    508. 

  508. <li><div class="src-line"><a name="a496"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_GRADEAVERAGE">QUIZ_GRADEAVERAGE</a></span>:</div></li>
    509. 

  509. <li><div class="src-line"><a name="a497"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$sum&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    510. 

  510. <li><div class="src-line"><a name="a498"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$count&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    511. 

  511. <li><div class="src-line"><a name="a499"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    512. 

  512. <li><div class="src-line"><a name="a500"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$sum&nbsp;</span>+=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">;</span></div></li>
    513. 

  513. <li><div class="src-line"><a name="a501"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$count</span>++<span class="src-sym">;</span></div></li>
    514. 

  514. <li><div class="src-line"><a name="a502"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    515. 

  515. <li><div class="src-line"><a name="a503"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span>(float)<span class="src-var">$sum</span>/<span class="src-var">$count</span><span class="src-sym">;</span></div></li>
    516. 

  516. <li><div class="src-line"><a name="a504"></a>&nbsp;</div></li>
    517. 

  517. <li><div class="src-line"><a name="a505"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">default</span>:</div></li>
    518. 

  518. <li><div class="src-line"><a name="a506"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_GRADEHIGHEST">QUIZ_GRADEHIGHEST</a></span>:</div></li>
    519. 

  519. <li><div class="src-line"><a name="a507"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$max&nbsp;</span>=&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    520. 

  520. <li><div class="src-line"><a name="a508"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    521. 

  521. <li><div class="src-line"><a name="a509"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades&nbsp;</span>&gt;&nbsp;<span class="src-var">$max</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    522. 

  522. <li><div class="src-line"><a name="a510"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$max&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">;</span></div></li>
    523. 

  523. <li><div class="src-line"><a name="a511"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    524. 

  524. <li><div class="src-line"><a name="a512"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    525. 

  525. <li><div class="src-line"><a name="a513"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$max</span><span class="src-sym">;</span></div></li>
    526. 

  526. <li><div class="src-line"><a name="a514"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    527. 

  527. <li><div class="src-line"><a name="a515"></a><span class="src-sym">}</span></div></li>
    528. 

  528. <li><div class="src-line"><a name="a516"></a>&nbsp;</div></li>
    529. 

  529. <li><div class="src-line"><a name="a517"></a><span class="src-doc">/**</span></div></li>
    530. 

  530. <li><div class="src-line"><a name="a518"></a><span class="src-doc">&nbsp;*&nbsp;Return&nbsp;the&nbsp;attempt&nbsp;with&nbsp;the&nbsp;best&nbsp;grade&nbsp;for&nbsp;a&nbsp;quiz</span></div></li>
    531. 

  531. <li><div class="src-line"><a name="a519"></a><span class="src-doc">&nbsp;*</span></div></li>
    532. 

  532. <li><div class="src-line"><a name="a520"></a><span class="src-doc">&nbsp;*&nbsp;Which&nbsp;attempt&nbsp;is&nbsp;the&nbsp;best&nbsp;depends&nbsp;on&nbsp;$quiz-&gt;grademethod.&nbsp;If&nbsp;the&nbsp;grade</span></div></li>
    533. 

  533. <li><div class="src-line"><a name="a521"></a><span class="src-doc">&nbsp;*&nbsp;method&nbsp;is&nbsp;GRADEAVERAGE&nbsp;then&nbsp;this&nbsp;function&nbsp;simply&nbsp;returns&nbsp;the&nbsp;last&nbsp;attempt.</span></div></li>
    534. 

  534. <li><div class="src-line"><a name="a522"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="src-doc-type">The&nbsp;</span><span class="src-doc">attempt&nbsp;with&nbsp;the&nbsp;best&nbsp;grade</span></div></li>
    535. 

  535. <li><div class="src-line"><a name="a523"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">&nbsp;&nbsp;&nbsp;The&nbsp;quiz&nbsp;for&nbsp;which&nbsp;the&nbsp;best&nbsp;grade&nbsp;is&nbsp;to&nbsp;be&nbsp;calculated</span></div></li>
    536. 

  536. <li><div class="src-line"><a name="a524"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">array&nbsp;</span><span class="src-doc-var">$attempts&nbsp;</span><span class="src-doc">An&nbsp;array&nbsp;of&nbsp;all&nbsp;the&nbsp;attempts&nbsp;of&nbsp;the&nbsp;user&nbsp;at&nbsp;the&nbsp;quiz</span></div></li>
    537. 

  537. <li><div class="src-line"><a name="a525"></a><span class="src-doc">&nbsp;*/</span></div></li>
    538. 

  538. <li><div class="src-line"><a name="a526"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_calculate_best_attempt">quiz_calculate_best_attempt</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempts</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    539. 

  539. <li><div class="src-line"><a name="a527"></a>&nbsp;</div></li>
    540. 

  540. <li><div class="src-line"><a name="a528"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">switch&nbsp;</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">grademethod</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    541. 

  541. <li><div class="src-line"><a name="a529"></a>&nbsp;</div></li>
    542. 

  542. <li><div class="src-line"><a name="a530"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_ATTEMPTFIRST">QUIZ_ATTEMPTFIRST</a></span>:</div></li>
    543. 

  543. <li><div class="src-line"><a name="a531"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    544. 

  544. <li><div class="src-line"><a name="a532"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">;</span></div></li>
    545. 

  545. <li><div class="src-line"><a name="a533"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    546. 

  546. <li><div class="src-line"><a name="a534"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    547. 

  547. <li><div class="src-line"><a name="a535"></a>&nbsp;</div></li>
    548. 

  548. <li><div class="src-line"><a name="a536"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_GRADEAVERAGE">QUIZ_GRADEAVERAGE</a></span>:&nbsp;<span class="src-comm">//&nbsp;need&nbsp;to&nbsp;do&nbsp;something&nbsp;with&nbsp;it&nbsp;:-)</span></div></li>
    549. 

  549. <li><div class="src-line"><a name="a537"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_ATTEMPTLAST">QUIZ_ATTEMPTLAST</a></span>:</div></li>
    550. 

  550. <li><div class="src-line"><a name="a538"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    551. 

  551. <li><div class="src-line"><a name="a539"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$final&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">;</span></div></li>
    552. 

  552. <li><div class="src-line"><a name="a540"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    553. 

  553. <li><div class="src-line"><a name="a541"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$final</span><span class="src-sym">;</span></div></li>
    554. 

  554. <li><div class="src-line"><a name="a542"></a>&nbsp;</div></li>
    555. 

  555. <li><div class="src-line"><a name="a543"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">default</span>:</div></li>
    556. 

  556. <li><div class="src-line"><a name="a544"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_GRADEHIGHEST">QUIZ_GRADEHIGHEST</a></span>:</div></li>
    557. 

  557. <li><div class="src-line"><a name="a545"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$max&nbsp;</span>=&nbsp;-<span class="src-num">1</span><span class="src-sym">;</span></div></li>
    558. 

  558. <li><div class="src-line"><a name="a546"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    559. 

  559. <li><div class="src-line"><a name="a547"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades&nbsp;</span>&gt;&nbsp;<span class="src-var">$max</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    560. 

  560. <li><div class="src-line"><a name="a548"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$max&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">sumgrades</span><span class="src-sym">;</span></div></li>
    561. 

  561. <li><div class="src-line"><a name="a549"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$maxattempt&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">;</span></div></li>
    562. 

  562. <li><div class="src-line"><a name="a550"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    563. 

  563. <li><div class="src-line"><a name="a551"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    564. 

  564. <li><div class="src-line"><a name="a552"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$maxattempt</span><span class="src-sym">;</span></div></li>
    565. 

  565. <li><div class="src-line"><a name="a553"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    566. 

  566. <li><div class="src-line"><a name="a554"></a><span class="src-sym">}</span></div></li>
    567. 

  567. <li><div class="src-line"><a name="a555"></a>&nbsp;</div></li>
    568. 

  568. <li><div class="src-line"><a name="a556"></a><span class="src-doc">/**</span></div></li>
    569. 

  569. <li><div class="src-line"><a name="a557"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">the&nbsp;</span><span class="src-doc">options&nbsp;for&nbsp;calculating&nbsp;the&nbsp;quiz&nbsp;grade&nbsp;from&nbsp;the&nbsp;individual&nbsp;attempt&nbsp;grades.</span></div></li>
    570. 

  570. <li><div class="src-line"><a name="a558"></a><span class="src-doc">&nbsp;*/</span></div></li>
    571. 

  571. <li><div class="src-line"><a name="a559"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_grading_options">quiz_get_grading_options</a><span class="src-sym">(</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    572. 

  572. <li><div class="src-line"><a name="a560"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-key">array&nbsp;</span><span class="src-sym">(</span></div></li>
    573. 

  573. <li><div class="src-line"><a name="a561"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_GRADEHIGHEST">QUIZ_GRADEHIGHEST</a>&nbsp;</span>=&gt;&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'gradehighest'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
    574. 

  574. <li><div class="src-line"><a name="a562"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_GRADEAVERAGE">QUIZ_GRADEAVERAGE</a>&nbsp;</span>=&gt;&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'gradeaverage'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
    575. 

  575. <li><div class="src-line"><a name="a563"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_ATTEMPTFIRST">QUIZ_ATTEMPTFIRST</a>&nbsp;</span>=&gt;&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'attemptfirst'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">)</span><span class="src-sym">,</span></div></li>
    576. 

  576. <li><div class="src-line"><a name="a564"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_ATTEMPTLAST">QUIZ_ATTEMPTLAST</a>&nbsp;&nbsp;</span>=&gt;&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'attemptlast'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
    577. 

  577. <li><div class="src-line"><a name="a565"></a><span class="src-sym">}</span></div></li>
    578. 

  578. <li><div class="src-line"><a name="a566"></a>&nbsp;</div></li>
    579. 

  579. <li><div class="src-line"><a name="a567"></a><span class="src-doc">/**</span></div></li>
    580. 

  580. <li><div class="src-line"><a name="a568"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">int&nbsp;</span><span class="src-doc-var">$option&nbsp;</span><span class="src-doc">one&nbsp;of&nbsp;the&nbsp;values&nbsp;QUIZ_GRADEHIGHEST,&nbsp;QUIZ_GRADEAVERAGE,&nbsp;QUIZ_ATTEMPTFIRST&nbsp;or&nbsp;QUIZ_ATTEMPTLAST.</span></div></li>
    581. 

  581. <li><div class="src-line"><a name="a569"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">the&nbsp;</span><span class="src-doc">lang&nbsp;string&nbsp;for&nbsp;that&nbsp;option.</span></div></li>
    582. 

  582. <li><div class="src-line"><a name="a570"></a><span class="src-doc">&nbsp;*/</span></div></li>
    583. 

  583. <li><div class="src-line"><a name="a571"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_grading_option_name">quiz_get_grading_option_name</a><span class="src-sym">(</span><span class="src-var">$option</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    584. 

  584. <li><div class="src-line"><a name="a572"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$strings&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_grading_options">quiz_get_grading_options</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    585. 

  585. <li><div class="src-line"><a name="a573"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$strings</span><span class="src-sym">[</span><span class="src-var">$option</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
    586. 

  586. <li><div class="src-line"><a name="a574"></a><span class="src-sym">}</span></div></li>
    587. 

  587. <li><div class="src-line"><a name="a575"></a>&nbsp;</div></li>
    588. 

  588. <li><div class="src-line"><a name="a576"></a><span class="src-comm">///&nbsp;Other&nbsp;quiz&nbsp;functions&nbsp;////////////////////////////////////////////////////</span></div></li>
    589. 

  589. <li><div class="src-line"><a name="a577"></a>&nbsp;</div></li>
    590. 

  590. <li><div class="src-line"><a name="a578"></a><span class="src-doc">/**</span></div></li>
    591. 

  591. <li><div class="src-line"><a name="a579"></a><span class="src-doc">&nbsp;*&nbsp;Parse&nbsp;field&nbsp;names&nbsp;used&nbsp;for&nbsp;the&nbsp;replace&nbsp;options&nbsp;on&nbsp;question&nbsp;edit&nbsp;forms</span></div></li>
    592. 

  592. <li><div class="src-line"><a name="a580"></a><span class="src-doc">&nbsp;*/</span></div></li>
    593. 

  593. <li><div class="src-line"><a name="a581"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_parse_fieldname">quiz_parse_fieldname</a><span class="src-sym">(</span><span class="src-var">$name</span><span class="src-sym">,&nbsp;</span><span class="src-var">$nameprefix</span>=<span class="src-str">'question'</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    594. 

  594. <li><div class="src-line"><a name="a582"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$reg&nbsp;</span>=&nbsp;<span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    595. 

  595. <li><div class="src-line"><a name="a583"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><a href="http://www.php.net/preg_match">preg_match</a><span class="src-sym">(</span><span class="src-str">&quot;</span><span class="src-str">/<span class="src-var">$nameprefix</span>(\\d+)(\w+)/</span><span class="src-str">&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-var">$name</span><span class="src-sym">,&nbsp;</span><span class="src-var">$reg</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    596. 

  596. <li><div class="src-line"><a name="a584"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'mode'&nbsp;</span>=&gt;&nbsp;<span class="src-var">$reg</span><span class="src-sym">[</span><span class="src-num">2</span><span class="src-sym">]</span><span class="src-sym">,&nbsp;</span><span class="src-str">'id'&nbsp;</span>=&gt;&nbsp;(int)<span class="src-var">$reg</span><span class="src-sym">[</span><span class="src-num">1</span><span class="src-sym">]</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    597. 

  597. <li><div class="src-line"><a name="a585"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    598. 

  598. <li><div class="src-line"><a name="a586"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">false</span><span class="src-sym">;</span></div></li>
    599. 

  599. <li><div class="src-line"><a name="a587"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    600. 

  600. <li><div class="src-line"><a name="a588"></a><span class="src-sym">}</span></div></li>
    601. 

  601. <li><div class="src-line"><a name="a589"></a>&nbsp;</div></li>
    602. 

  602. <li><div class="src-line"><a name="a590"></a><span class="src-doc">/**</span></div></li>
    603. 

  603. <li><div class="src-line"><a name="a591"></a><span class="src-doc">&nbsp;*&nbsp;Upgrade&nbsp;states&nbsp;for&nbsp;an&nbsp;attempt&nbsp;to&nbsp;Moodle&nbsp;1.5&nbsp;model</span></div></li>
    604. 

  604. <li><div class="src-line"><a name="a592"></a><span class="src-doc">&nbsp;*</span></div></li>
    605. 

  605. <li><div class="src-line"><a name="a593"></a><span class="src-doc">&nbsp;*&nbsp;Any&nbsp;state&nbsp;that&nbsp;does&nbsp;not&nbsp;yet&nbsp;have&nbsp;its&nbsp;timestamp&nbsp;set&nbsp;to&nbsp;nonzero&nbsp;has&nbsp;not&nbsp;yet&nbsp;been&nbsp;upgraded&nbsp;from&nbsp;Moodle&nbsp;1.4</span></div></li>
    606. 

  606. <li><div class="src-line"><a name="a594"></a><span class="src-doc">&nbsp;*&nbsp;The&nbsp;reason&nbsp;these&nbsp;are&nbsp;still&nbsp;around&nbsp;is&nbsp;that&nbsp;for&nbsp;large&nbsp;sites&nbsp;it&nbsp;would&nbsp;have&nbsp;taken&nbsp;too&nbsp;long&nbsp;to</span></div></li>
    607. 

  607. <li><div class="src-line"><a name="a595"></a><span class="src-doc">&nbsp;*&nbsp;upgrade&nbsp;all&nbsp;states&nbsp;at&nbsp;once.&nbsp;This&nbsp;function&nbsp;sets&nbsp;the&nbsp;timestamp&nbsp;field&nbsp;and&nbsp;creates&nbsp;an&nbsp;entry&nbsp;in&nbsp;the</span></div></li>
    608. 

  608. <li><div class="src-line"><a name="a596"></a><span class="src-doc">&nbsp;*&nbsp;question_sessions&nbsp;table.</span></div></li>
    609. 

  609. <li><div class="src-line"><a name="a597"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$attempt&nbsp;</span><span class="src-doc">&nbsp;The&nbsp;attempt&nbsp;whose&nbsp;states&nbsp;need&nbsp;upgrading</span></div></li>
    610. 

  610. <li><div class="src-line"><a name="a598"></a><span class="src-doc">&nbsp;*/</span></div></li>
    611. 

  611. <li><div class="src-line"><a name="a599"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_upgrade_states">quiz_upgrade_states</a><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    612. 

  612. <li><div class="src-line"><a name="a600"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">;</span></div></li>
    613. 

  613. <li><div class="src-line"><a name="a601"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;The&nbsp;old&nbsp;quiz&nbsp;model&nbsp;only&nbsp;allowed&nbsp;a&nbsp;single&nbsp;response&nbsp;per&nbsp;quiz&nbsp;attempt&nbsp;so&nbsp;that&nbsp;there&nbsp;will&nbsp;be</span></div></li>
    614. 

  614. <li><div class="src-line"><a name="a602"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;only&nbsp;one&nbsp;state&nbsp;record&nbsp;per&nbsp;question&nbsp;for&nbsp;this&nbsp;attempt.</span></div></li>
    615. 

  615. <li><div class="src-line"><a name="a603"></a>&nbsp;</div></li>
    616. 

  616. <li><div class="src-line"><a name="a604"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;We&nbsp;set&nbsp;the&nbsp;timestamp&nbsp;of&nbsp;all&nbsp;states&nbsp;to&nbsp;the&nbsp;timemodified&nbsp;field&nbsp;of&nbsp;the&nbsp;attempt.</span></div></li>
    617. 

  617. <li><div class="src-line"><a name="a605"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">execute_sql</span><span class="src-sym">(</span><span class="src-str">&quot;</span><span class="src-str">UPDATE&nbsp;{<span class="src-var">$CFG</span></span><span class="src-sym">-&gt;</span><span class="src-id">prefix</span><span class="src-str"></span><span class="src-sym">}</span>question_states&nbsp;SET&nbsp;timestamp&nbsp;=&nbsp;'<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timemodified</span>'&nbsp;WHERE&nbsp;attempt&nbsp;=&nbsp;'<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">uniqueid</span>'</span><span class="src-str">&quot;</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    618. 

  618. <li><div class="src-line"><a name="a606"></a>&nbsp;</div></li>
    619. 

  619. <li><div class="src-line"><a name="a607"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;For&nbsp;each&nbsp;state&nbsp;we&nbsp;create&nbsp;an&nbsp;entry&nbsp;in&nbsp;the&nbsp;question_sessions&nbsp;table,&nbsp;with&nbsp;both&nbsp;newest&nbsp;and</span></div></li>
    620. 

  620. <li><div class="src-line"><a name="a608"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;newgraded&nbsp;pointing&nbsp;to&nbsp;this&nbsp;state.</span></div></li>
    621. 

  621. <li><div class="src-line"><a name="a609"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Actually&nbsp;we&nbsp;only&nbsp;do&nbsp;this&nbsp;for&nbsp;states&nbsp;whose&nbsp;question&nbsp;is&nbsp;actually&nbsp;listed&nbsp;in&nbsp;$attempt-&gt;layout.</span></div></li>
    622. 

  622. <li><div class="src-line"><a name="a610"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;We&nbsp;do&nbsp;not&nbsp;do&nbsp;it&nbsp;for&nbsp;states&nbsp;associated&nbsp;to&nbsp;wrapped&nbsp;questions&nbsp;like&nbsp;for&nbsp;example&nbsp;the&nbsp;questions</span></div></li>
    623. 

  623. <li><div class="src-line"><a name="a611"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;used&nbsp;by&nbsp;a&nbsp;RANDOM&nbsp;question</span></div></li>
    624. 

  624. <li><div class="src-line"><a name="a612"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$session&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    625. 

  625. <li><div class="src-line"><a name="a613"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$session</span><span class="src-sym">-&gt;</span><span class="src-id">attemptid&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">uniqueid</span><span class="src-sym">;</span></div></li>
    626. 

  626. <li><div class="src-line"><a name="a614"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$questionlist&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_questions_in_quiz">quiz_questions_in_quiz</a><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">layout</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    627. 

  627. <li><div class="src-line"><a name="a615"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$questionlist&nbsp;</span><span class="src-key">and&nbsp;</span><span class="src-var">$states&nbsp;</span>=&nbsp;<span class="src-id">get_records_select</span><span class="src-sym">(</span><span class="src-str">'question_states'</span><span class="src-sym">,&nbsp;</span><span class="src-str">&quot;</span><span class="src-str">attempt&nbsp;=&nbsp;'<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">uniqueid</span>'&nbsp;AND&nbsp;question&nbsp;IN&nbsp;(<span class="src-var">$questionlist</span>)</span><span class="src-str">&quot;</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    628. 

  628. <li><div class="src-line"><a name="a616"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$states&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$state</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    629. 

  629. <li><div class="src-line"><a name="a617"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$session</span><span class="src-sym">-&gt;</span><span class="src-id">newgraded&nbsp;</span>=&nbsp;<span class="src-var">$state</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    630. 

  630. <li><div class="src-line"><a name="a618"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$session</span><span class="src-sym">-&gt;</span><span class="src-id">newest&nbsp;</span>=&nbsp;<span class="src-var">$state</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    631. 

  631. <li><div class="src-line"><a name="a619"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$session</span><span class="src-sym">-&gt;</span><span class="src-id">questionid&nbsp;</span>=&nbsp;<span class="src-var">$state</span><span class="src-sym">-&gt;</span><span class="src-id">question</span><span class="src-sym">;</span></div></li>
    632. 

  632. <li><div class="src-line"><a name="a620"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">insert_record</span><span class="src-sym">(</span><span class="src-str">'question_sessions'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$session</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    633. 

  633. <li><div class="src-line"><a name="a621"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    634. 

  634. <li><div class="src-line"><a name="a622"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    635. 

  635. <li><div class="src-line"><a name="a623"></a><span class="src-sym">}</span></div></li>
    636. 

  636. <li><div class="src-line"><a name="a624"></a>&nbsp;</div></li>
    637. 

  637. <li><div class="src-line"><a name="a625"></a><span class="src-doc">/**</span></div></li>
    638. 

  638. <li><div class="src-line"><a name="a626"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz</span></div></li>
    639. 

  639. <li><div class="src-line"><a name="a627"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$question&nbsp;</span><span class="src-doc">the&nbsp;question</span></div></li>
    640. 

  640. <li><div class="src-line"><a name="a628"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">the&nbsp;</span><span class="src-doc">HTML&nbsp;for&nbsp;a&nbsp;preview&nbsp;question&nbsp;icon.</span></div></li>
    641. 

  641. <li><div class="src-line"><a name="a629"></a><span class="src-doc">&nbsp;*/</span></div></li>
    642. 

  642. <li><div class="src-line"><a name="a630"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_question_preview_button">quiz_question_preview_button</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$question</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    643. 

  643. <li><div class="src-line"><a name="a631"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">,&nbsp;</span><span class="src-var">$COURSE</span><span class="src-sym">;</span></div></li>
    644. 

  644. <li><div class="src-line"><a name="a632"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-id">question_has_capability_on</span><span class="src-sym">(</span><span class="src-var">$question</span><span class="src-sym">,&nbsp;</span><span class="src-str">'use'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$question</span><span class="src-sym">-&gt;</span><span class="src-id">category</span><span class="src-sym">))</span><span class="src-sym">{</span></div></li>
    645. 

  645. <li><div class="src-line"><a name="a633"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-str">''</span><span class="src-sym">;</span></div></li>
    646. 

  646. <li><div class="src-line"><a name="a634"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    647. 

  647. <li><div class="src-line"><a name="a635"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$strpreview&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'previewquestion'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    648. 

  648. <li><div class="src-line"><a name="a636"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$quizorcourseid&nbsp;</span>=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span>?<span class="src-sym">(</span><span class="src-str">'&amp;amp;quizid='&nbsp;</span>.&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">)</span>:<span class="src-sym">(</span><span class="src-str">'&amp;amp;courseid='&nbsp;</span>.<span class="src-var">$COURSE</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    649. 

  649. <li><div class="src-line"><a name="a637"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">link_to_popup_window</span><span class="src-sym">(</span><span class="src-str">'/question/preview.php?id='&nbsp;</span>.&nbsp;<span class="src-var">$question</span><span class="src-sym">-&gt;</span><span class="src-id">id&nbsp;</span>.&nbsp;<span class="src-var">$quizorcourseid</span><span class="src-sym">,&nbsp;</span><span class="src-str">'questionpreview'</span><span class="src-sym">,</span></div></li>
    650. 

  650. <li><div class="src-line"><a name="a638"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-str">&quot;</span><span class="src-str">&lt;img&nbsp;src=\&quot;<span class="src-var">$CFG</span><span class="src-sym">-&gt;</span><span class="src-id">pixpath</span>/t/preview.gif\&quot;&nbsp;class=\&quot;iconsmall\&quot;&nbsp;alt=\&quot;<span class="src-var">$strpreview</span>\&quot;&nbsp;/&gt;</span><span class="src-str">&quot;</span><span class="src-sym">,</span></div></li>
    651. 

  651. <li><div class="src-line"><a name="a639"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-num">0</span><span class="src-sym">,&nbsp;</span><span class="src-num">0</span><span class="src-sym">,&nbsp;</span><span class="src-var">$strpreview</span><span class="src-sym">,&nbsp;</span><span class="src-id">QUESTION_PREVIEW_POPUP_OPTIONS</span><span class="src-sym">,&nbsp;</span><span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    652. 

  652. <li><div class="src-line"><a name="a640"></a><span class="src-sym">}</span></div></li>
    653. 

  653. <li><div class="src-line"><a name="a641"></a>&nbsp;</div></li>
    654. 

  654. <li><div class="src-line"><a name="a642"></a><span class="src-doc">/**</span></div></li>
    655. 

  655. <li><div class="src-line"><a name="a643"></a><span class="src-doc">&nbsp;*&nbsp;Determine&nbsp;render&nbsp;options</span></div></li>
    656. 

  656. <li><div class="src-line"><a name="a644"></a><span class="src-doc">&nbsp;*</span></div></li>
    657. 

  657. <li><div class="src-line"><a name="a645"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">int&nbsp;</span><span class="src-doc-var">$reviewoptions&nbsp;</span></div></li>
    658. 

  658. <li><div class="src-line"><a name="a646"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$state&nbsp;</span></div></li>
    659. 

  659. <li><div class="src-line"><a name="a647"></a><span class="src-doc">&nbsp;*/</span></div></li>
    660. 

  660. <li><div class="src-line"><a name="a648"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_renderoptions">quiz_get_renderoptions</a><span class="src-sym">(</span><span class="src-var">$reviewoptions</span><span class="src-sym">,&nbsp;</span><span class="src-var">$state</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    661. 

  661. <li><div class="src-line"><a name="a649"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    662. 

  662. <li><div class="src-line"><a name="a650"></a>&nbsp;</div></li>
    663. 

  663. <li><div class="src-line"><a name="a651"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;the&nbsp;question&nbsp;in&nbsp;readonly&nbsp;(review)&nbsp;mode&nbsp;if&nbsp;the&nbsp;question&nbsp;is&nbsp;in</span></div></li>
    664. 

  664. <li><div class="src-line"><a name="a652"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;the&nbsp;closed&nbsp;state</span></div></li>
    665. 

  665. <li><div class="src-line"><a name="a653"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">readonly&nbsp;</span>=&nbsp;<span class="src-id">question_state_is_closed</span><span class="src-sym">(</span><span class="src-var">$state</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    666. 

  666. <li><div class="src-line"><a name="a654"></a>&nbsp;</div></li>
    667. 

  667. <li><div class="src-line"><a name="a655"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;feedback&nbsp;once&nbsp;the&nbsp;question&nbsp;has&nbsp;been&nbsp;graded&nbsp;(if&nbsp;allowed&nbsp;by&nbsp;the&nbsp;quiz)</span></div></li>
    668. 

  668. <li><div class="src-line"><a name="a656"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">feedback&nbsp;</span>=&nbsp;<span class="src-id">question_state_is_graded</span><span class="src-sym">(</span><span class="src-var">$state</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;<span class="src-sym">(</span><span class="src-var">$reviewoptions&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_FEEDBACK&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_IMMEDIATELY</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    669. 

  669. <li><div class="src-line"><a name="a657"></a>&nbsp;</div></li>
    670. 

  670. <li><div class="src-line"><a name="a658"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;validation&nbsp;only&nbsp;after&nbsp;a&nbsp;validation&nbsp;event</span></div></li>
    671. 

  671. <li><div class="src-line"><a name="a659"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">validation&nbsp;</span>=&nbsp;<span class="src-id">QUESTION_EVENTVALIDATE&nbsp;</span>===&nbsp;<span class="src-var">$state</span><span class="src-sym">-&gt;</span><span class="src-id">event</span><span class="src-sym">;</span></div></li>
    672. 

  672. <li><div class="src-line"><a name="a660"></a>&nbsp;</div></li>
    673. 

  673. <li><div class="src-line"><a name="a661"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;correct&nbsp;responses&nbsp;in&nbsp;readonly&nbsp;mode&nbsp;if&nbsp;the&nbsp;quiz&nbsp;allows&nbsp;it</span></div></li>
    674. 

  674. <li><div class="src-line"><a name="a662"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">correct_responses&nbsp;</span>=&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">readonly&nbsp;</span>&amp;&amp;&nbsp;<span class="src-sym">(</span><span class="src-var">$reviewoptions&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_ANSWERS&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_IMMEDIATELY</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    675. 

  675. <li><div class="src-line"><a name="a663"></a>&nbsp;</div></li>
    676. 

  676. <li><div class="src-line"><a name="a664"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;general&nbsp;feedback&nbsp;if&nbsp;the&nbsp;question&nbsp;has&nbsp;been&nbsp;graded&nbsp;and&nbsp;the&nbsp;quiz&nbsp;allows&nbsp;it.</span></div></li>
    677. 

  677. <li><div class="src-line"><a name="a665"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">generalfeedback&nbsp;</span>=&nbsp;<span class="src-id">question_state_is_graded</span><span class="src-sym">(</span><span class="src-var">$state</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;<span class="src-sym">(</span><span class="src-var">$reviewoptions&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_GENERALFEEDBACK&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_IMMEDIATELY</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    678. 

  678. <li><div class="src-line"><a name="a666"></a>&nbsp;</div></li>
    679. 

  679. <li><div class="src-line"><a name="a667"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;overallfeedback&nbsp;once&nbsp;the&nbsp;attempt&nbsp;is&nbsp;over.</span></div></li>
    680. 

  680. <li><div class="src-line"><a name="a668"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">overallfeedback&nbsp;</span>=&nbsp;<span class="src-id">false</span><span class="src-sym">;</span></div></li>
    681. 

  681. <li><div class="src-line"><a name="a669"></a>&nbsp;</div></li>
    682. 

  682. <li><div class="src-line"><a name="a670"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Always&nbsp;show&nbsp;responses&nbsp;and&nbsp;scores</span></div></li>
    683. 

  683. <li><div class="src-line"><a name="a671"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">responses&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    684. 

  684. <li><div class="src-line"><a name="a672"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">scores&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    685. 

  685. <li><div class="src-line"><a name="a673"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">quizstate&nbsp;</span>=&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_STATE_DURING">QUIZ_STATE_DURING</a></span><span class="src-sym">;</span></div></li>
    686. 

  686. <li><div class="src-line"><a name="a674"></a>&nbsp;</div></li>
    687. 

  687. <li><div class="src-line"><a name="a675"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$options</span><span class="src-sym">;</span></div></li>
    688. 

  688. <li><div class="src-line"><a name="a676"></a><span class="src-sym">}</span></div></li>
    689. 

  689. <li><div class="src-line"><a name="a677"></a>&nbsp;</div></li>
    690. 

  690. <li><div class="src-line"><a name="a678"></a><span class="src-doc">/**</span></div></li>
    691. 

  691. <li><div class="src-line"><a name="a679"></a><span class="src-doc">&nbsp;*&nbsp;Determine&nbsp;review&nbsp;options</span></div></li>
    692. 

  692. <li><div class="src-line"><a name="a680"></a><span class="src-doc">&nbsp;*</span></div></li>
    693. 

  693. <li><div class="src-line"><a name="a681"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz&nbsp;instance.</span></div></li>
    694. 

  694. <li><div class="src-line"><a name="a682"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$attempt&nbsp;</span><span class="src-doc">the&nbsp;attempt&nbsp;in&nbsp;question.</span></div></li>
    695. 

  695. <li><div class="src-line"><a name="a683"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">$context&nbsp;</span><span class="src-doc">the&nbsp;roles&nbsp;and&nbsp;permissions&nbsp;context,</span></div></li>
    696. 

  696. <li><div class="src-line"><a name="a684"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;normally&nbsp;the&nbsp;context&nbsp;for&nbsp;the&nbsp;quiz&nbsp;module&nbsp;instance.</span></div></li>
    697. 

  697. <li><div class="src-line"><a name="a685"></a><span class="src-doc">&nbsp;*</span></div></li>
    698. 

  698. <li><div class="src-line"><a name="a686"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-type">an&nbsp;</span><span class="src-doc">object&nbsp;with&nbsp;boolean&nbsp;fields&nbsp;responses,&nbsp;scores,&nbsp;feedback,</span></div></li>
    699. 

  699. <li><div class="src-line"><a name="a687"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;correct_responses,&nbsp;solutions&nbsp;and&nbsp;general&nbsp;feedback</span></div></li>
    700. 

  700. <li><div class="src-line"><a name="a688"></a><span class="src-doc">&nbsp;*/</span></div></li>
    701. 

  701. <li><div class="src-line"><a name="a689"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_reviewoptions">quiz_get_reviewoptions</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span>=<span class="src-id">null</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    702. 

  702. <li><div class="src-line"><a name="a690"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    703. 

  703. <li><div class="src-line"><a name="a691"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">readonly&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    704. 

  704. <li><div class="src-line"><a name="a692"></a>&nbsp;</div></li>
    705. 

  705. <li><div class="src-line"><a name="a693"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Provide&nbsp;the&nbsp;links&nbsp;to&nbsp;the&nbsp;question&nbsp;review&nbsp;and&nbsp;comment&nbsp;script</span></div></li>
    706. 

  706. <li><div class="src-line"><a name="a694"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">questionreviewlink&nbsp;</span>=&nbsp;<span class="src-str">'/mod/quiz/reviewquestion.php'</span><span class="src-sym">;</span></div></li>
    707. 

  707. <li><div class="src-line"><a name="a695"></a>&nbsp;</div></li>
    708. 

  708. <li><div class="src-line"><a name="a696"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Show&nbsp;a&nbsp;link&nbsp;to&nbsp;the&nbsp;comment&nbsp;box&nbsp;only&nbsp;for&nbsp;closed&nbsp;attempts</span></div></li>
    709. 

  709. <li><div class="src-line"><a name="a697"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish&nbsp;</span>&amp;&amp;&nbsp;<span class="src-sym">!</span><a href="http://www.php.net/is_null">is_null</a><span class="src-sym">(</span><span class="src-var">$context</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;<span class="src-id">has_capability</span><span class="src-sym">(</span><span class="src-str">'mod/quiz:grade'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    710. 

  710. <li><div class="src-line"><a name="a698"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">questioncommentlink&nbsp;</span>=&nbsp;<span class="src-str">'/mod/quiz/comment.php'</span><span class="src-sym">;</span></div></li>
    711. 

  711. <li><div class="src-line"><a name="a699"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    712. 

  712. <li><div class="src-line"><a name="a700"></a>&nbsp;</div></li>
    713. 

  713. <li><div class="src-line"><a name="a701"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><a href="http://www.php.net/is_null">is_null</a><span class="src-sym">(</span><span class="src-var">$context</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;<span class="src-id">has_capability</span><span class="src-sym">(</span><span class="src-str">'mod/quiz:viewreports'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;</div></li>
    714. 

  714. <li><div class="src-line"><a name="a702"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">has_capability</span><span class="src-sym">(</span><span class="src-str">'moodle/grade:viewhidden'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;<span class="src-sym">!</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">preview</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    715. 

  715. <li><div class="src-line"><a name="a703"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;People&nbsp;who&nbsp;can&nbsp;see&nbsp;reports&nbsp;and&nbsp;hidden&nbsp;grades&nbsp;should&nbsp;be&nbsp;shown&nbsp;everything,</span></div></li>
    716. 

  716. <li><div class="src-line"><a name="a704"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;except&nbsp;during&nbsp;preview&nbsp;when&nbsp;teachers&nbsp;want&nbsp;to&nbsp;see&nbsp;what&nbsp;students&nbsp;see.</span></div></li>
    717. 

  717. <li><div class="src-line"><a name="a705"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">responses&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    718. 

  718. <li><div class="src-line"><a name="a706"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">scores&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;&nbsp;</span></div></li>
    719. 

  719. <li><div class="src-line"><a name="a707"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">feedback&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    720. 

  720. <li><div class="src-line"><a name="a708"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">correct_responses&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    721. 

  721. <li><div class="src-line"><a name="a709"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">solutions&nbsp;</span>=&nbsp;<span class="src-id">false</span><span class="src-sym">;</span></div></li>
    722. 

  722. <li><div class="src-line"><a name="a710"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">generalfeedback&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    723. 

  723. <li><div class="src-line"><a name="a711"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">overallfeedback&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    724. 

  724. <li><div class="src-line"><a name="a712"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">quizstate&nbsp;</span>=&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_STATE_TEACHERACCESS">QUIZ_STATE_TEACHERACCESS</a></span><span class="src-sym">;</span></div></li>
    725. 

  725. <li><div class="src-line"><a name="a713"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    726. 

  726. <li><div class="src-line"><a name="a714"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;Work&nbsp;out&nbsp;the&nbsp;state&nbsp;of&nbsp;the&nbsp;attempt&nbsp;...</span></div></li>
    727. 

  727. <li><div class="src-line"><a name="a715"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(((</span><a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)&nbsp;</span>-&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish</span><span class="src-sym">)&nbsp;</span>&lt;&nbsp;<span class="src-num">120</span><span class="src-sym">)&nbsp;</span>||&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish</span>==<span class="src-num">0</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    728. 

  728. <li><div class="src-line"><a name="a716"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$quiz_state_mask&nbsp;</span>=&nbsp;<span class="src-id">QUIZ_REVIEW_IMMEDIATELY</span><span class="src-sym">;</span></div></li>
    729. 

  729. <li><div class="src-line"><a name="a717"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">quizstate&nbsp;</span>=&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_STATE_IMMEDIATELY">QUIZ_STATE_IMMEDIATELY</a></span><span class="src-sym">;</span></div></li>
    730. 

  730. <li><div class="src-line"><a name="a718"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">timeclose&nbsp;</span><span class="src-key">or&nbsp;</span><a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)&nbsp;</span>&lt;&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">timeclose</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    731. 

  731. <li><div class="src-line"><a name="a719"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$quiz_state_mask&nbsp;</span>=&nbsp;<span class="src-id">QUIZ_REVIEW_OPEN</span><span class="src-sym">;</span></div></li>
    732. 

  732. <li><div class="src-line"><a name="a720"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">quizstate&nbsp;</span>=&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_STATE_OPEN">QUIZ_STATE_OPEN</a></span><span class="src-sym">;</span></div></li>
    733. 

  733. <li><div class="src-line"><a name="a721"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    734. 

  734. <li><div class="src-line"><a name="a722"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$quiz_state_mask&nbsp;</span>=&nbsp;<span class="src-id">QUIZ_REVIEW_CLOSED</span><span class="src-sym">;</span></div></li>
    735. 

  735. <li><div class="src-line"><a name="a723"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">quizstate&nbsp;</span>=&nbsp;<span class="src-id"><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#defineQUIZ_STATE_CLOSED">QUIZ_STATE_CLOSED</a></span><span class="src-sym">;</span></div></li>
    736. 

  736. <li><div class="src-line"><a name="a724"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    737. 

  737. <li><div class="src-line"><a name="a725"></a>&nbsp;</div></li>
    738. 

  738. <li><div class="src-line"><a name="a726"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;...&nbsp;and&nbsp;hence&nbsp;extract&nbsp;the&nbsp;appropriate&nbsp;review&nbsp;options.&nbsp;</span></div></li>
    739. 

  739. <li><div class="src-line"><a name="a727"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">responses&nbsp;</span>=&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_RESPONSES</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-num">1&nbsp;</span>:&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    740. 

  740. <li><div class="src-line"><a name="a728"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">scores&nbsp;</span>=&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_SCORES</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-num">1&nbsp;</span>:&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    741. 

  741. <li><div class="src-line"><a name="a729"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">feedback&nbsp;</span>=&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_FEEDBACK</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-num">1&nbsp;</span>:&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    742. 

  742. <li><div class="src-line"><a name="a730"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">correct_responses&nbsp;</span>=&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_ANSWERS</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-num">1&nbsp;</span>:&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    743. 

  743. <li><div class="src-line"><a name="a731"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">solutions&nbsp;</span>=&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_SOLUTIONS</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-num">1&nbsp;</span>:&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    744. 

  744. <li><div class="src-line"><a name="a732"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">generalfeedback&nbsp;</span>=&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_GENERALFEEDBACK</span><span class="src-sym">)&nbsp;</span>?&nbsp;<span class="src-num">1&nbsp;</span>:&nbsp;<span class="src-num">0</span><span class="src-sym">;</span></div></li>
    745. 

  745. <li><div class="src-line"><a name="a733"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$options</span><span class="src-sym">-&gt;</span><span class="src-id">overallfeedback&nbsp;</span>=&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish&nbsp;</span>&amp;&amp;&nbsp;<span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">review&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-var">$quiz_state_mask&nbsp;</span><span class="src-sym">&amp;&nbsp;</span><span class="src-id">QUIZ_REVIEW_OVERALLFEEDBACK</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    746. 

  746. <li><div class="src-line"><a name="a734"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    747. 

  747. <li><div class="src-line"><a name="a735"></a>&nbsp;</div></li>
    748. 

  748. <li><div class="src-line"><a name="a736"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$options</span><span class="src-sym">;</span></div></li>
    749. 

  749. <li><div class="src-line"><a name="a737"></a><span class="src-sym">}</span></div></li>
    750. 

  750. <li><div class="src-line"><a name="a738"></a>&nbsp;</div></li>
    751. 

  751. <li><div class="src-line"><a name="a739"></a><span class="src-doc">/**</span></div></li>
    752. 

  752. <li><div class="src-line"><a name="a740"></a><span class="src-doc">&nbsp;*&nbsp;Combines&nbsp;the&nbsp;review&nbsp;options&nbsp;from&nbsp;a&nbsp;number&nbsp;of&nbsp;different&nbsp;quiz&nbsp;attempts.</span></div></li>
    753. 

  753. <li><div class="src-line"><a name="a741"></a><span class="src-doc">&nbsp;*&nbsp;Returns&nbsp;an&nbsp;array&nbsp;of&nbsp;two&nbsp;ojects,&nbsp;so&nbsp;he&nbsp;suggested&nbsp;way&nbsp;of&nbsp;calling&nbsp;this</span></div></li>
    754. 

  754. <li><div class="src-line"><a name="a742"></a><span class="src-doc">&nbsp;*&nbsp;funciton&nbsp;is:</span></div></li>
    755. 

  755. <li><div class="src-line"><a name="a743"></a><span class="src-doc">&nbsp;*&nbsp;list($someoptions,&nbsp;$alloptions)&nbsp;=&nbsp;quiz_get_combined_reviewoptions(...)</span></div></li>
    756. 

  756. <li><div class="src-line"><a name="a744"></a><span class="src-doc">&nbsp;*</span></div></li>
    757. 

  757. <li><div class="src-line"><a name="a745"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz&nbsp;instance.</span></div></li>
    758. 

  758. <li><div class="src-line"><a name="a746"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">array&nbsp;</span><span class="src-doc-var">$attempts&nbsp;</span><span class="src-doc">an&nbsp;array&nbsp;of&nbsp;attempt&nbsp;objects.</span></div></li>
    759. 

  759. <li><div class="src-line"><a name="a747"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">$context&nbsp;</span><span class="src-doc">the&nbsp;roles&nbsp;and&nbsp;permissions&nbsp;context,</span></div></li>
    760. 

  760. <li><div class="src-line"><a name="a748"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;normally&nbsp;the&nbsp;context&nbsp;for&nbsp;the&nbsp;quiz&nbsp;module&nbsp;instance.</span></div></li>
    761. 

  761. <li><div class="src-line"><a name="a749"></a><span class="src-doc">&nbsp;*</span></div></li>
    762. 

  762. <li><div class="src-line"><a name="a750"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">array&nbsp;</span><span class="src-doc">of&nbsp;two&nbsp;options&nbsp;objects,&nbsp;one&nbsp;showing&nbsp;which&nbsp;options&nbsp;are&nbsp;true&nbsp;for</span></div></li>
    763. 

  763. <li><div class="src-line"><a name="a751"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;at&nbsp;least&nbsp;one&nbsp;of&nbsp;the&nbsp;attempts,&nbsp;the&nbsp;other&nbsp;showing&nbsp;which&nbsp;options&nbsp;are&nbsp;true</span></div></li>
    764. 

  764. <li><div class="src-line"><a name="a752"></a><span class="src-doc">&nbsp;*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for&nbsp;all&nbsp;attempts.</span></div></li>
    765. 

  765. <li><div class="src-line"><a name="a753"></a><span class="src-doc">&nbsp;*/</span></div></li>
    766. 

  766. <li><div class="src-line"><a name="a754"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_combined_reviewoptions">quiz_get_combined_reviewoptions</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempts</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span>=<span class="src-id">null</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    767. 

  767. <li><div class="src-line"><a name="a755"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$fields&nbsp;</span>=&nbsp;<span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'readonly'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'scores'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'feedback'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'correct_responses'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'solutions'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'generalfeedback'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'overallfeedback'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    768. 

  768. <li><div class="src-line"><a name="a756"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$someoptions&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    769. 

  769. <li><div class="src-line"><a name="a757"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$alloptions&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    770. 

  770. <li><div class="src-line"><a name="a758"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$fields&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$field</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    771. 

  771. <li><div class="src-line"><a name="a759"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$someoptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field&nbsp;</span>=&nbsp;<span class="src-id">false</span><span class="src-sym">;</span></div></li>
    772. 

  772. <li><div class="src-line"><a name="a760"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$alloptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    773. 

  773. <li><div class="src-line"><a name="a761"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    774. 

  774. <li><div class="src-line"><a name="a762"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$attempts&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    775. 

  775. <li><div class="src-line"><a name="a763"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$attemptoptions&nbsp;</span>=&nbsp;<a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_get_reviewoptions">quiz_get_reviewoptions</a><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    776. 

  776. <li><div class="src-line"><a name="a764"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$fields&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$field</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    777. 

  777. <li><div class="src-line"><a name="a765"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$someoptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field&nbsp;</span>=&nbsp;<span class="src-var">$someoptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field&nbsp;</span>||&nbsp;<span class="src-var">$attemptoptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field</span><span class="src-sym">;</span></div></li>
    778. 

  778. <li><div class="src-line"><a name="a766"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$alloptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field&nbsp;</span>=&nbsp;<span class="src-var">$alloptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field&nbsp;</span>&amp;&amp;&nbsp;<span class="src-var">$attemptoptions</span><span class="src-sym">-&gt;</span><span class="src-var">$field</span><span class="src-sym">;</span></div></li>
    779. 

  779. <li><div class="src-line"><a name="a767"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    780. 

  780. <li><div class="src-line"><a name="a768"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    781. 

  781. <li><div class="src-line"><a name="a769"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-var">$someoptions</span><span class="src-sym">,&nbsp;</span><span class="src-var">$alloptions</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    782. 

  782. <li><div class="src-line"><a name="a770"></a><span class="src-sym">}</span></div></li>
    783. 

  783. <li><div class="src-line"><a name="a771"></a>&nbsp;</div></li>
    784. 

  784. <li><div class="src-line"><a name="a772"></a><span class="src-comm">///&nbsp;FUNCTIONS&nbsp;FOR&nbsp;SENDING&nbsp;NOTIFICATION&nbsp;EMAILS&nbsp;///////////////////////////////</span></div></li>
    785. 

  785. <li><div class="src-line"><a name="a773"></a>&nbsp;</div></li>
    786. 

  786. <li><div class="src-line"><a name="a774"></a><span class="src-doc">/**</span></div></li>
    787. 

  787. <li><div class="src-line"><a name="a775"></a><span class="src-doc">&nbsp;*&nbsp;Sends&nbsp;confirmation&nbsp;email&nbsp;to&nbsp;the&nbsp;student&nbsp;taking&nbsp;the&nbsp;course</span></div></li>
    788. 

  788. <li><div class="src-line"><a name="a776"></a><span class="src-doc">&nbsp;*</span></div></li>
    789. 

  789. <li><div class="src-line"><a name="a777"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">stdClass&nbsp;</span><span class="src-doc-var">$a&nbsp;</span><span class="src-doc">associative&nbsp;array&nbsp;of&nbsp;replaceable&nbsp;fields&nbsp;for&nbsp;the&nbsp;templates</span></div></li>
    790. 

  790. <li><div class="src-line"><a name="a778"></a><span class="src-doc">&nbsp;*</span></div></li>
    791. 

  791. <li><div class="src-line"><a name="a779"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">bool</span><span class="src-doc">|</span><span class="src-doc-type">string</span><span class="src-doc">result&nbsp;of&nbsp;email_to_user()</span></div></li>
    792. 

  792. <li><div class="src-line"><a name="a780"></a><span class="src-doc">&nbsp;*/</span></div></li>
    793. 

  793. <li><div class="src-line"><a name="a781"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_send_confirmation">quiz_send_confirmation</a><span class="src-sym">(</span><span class="src-var">$a</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    794. 

  794. <li><div class="src-line"><a name="a782"></a>&nbsp;</div></li>
    795. 

  795. <li><div class="src-line"><a name="a783"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">;</span></div></li>
    796. 

  796. <li><div class="src-line"><a name="a784"></a>&nbsp;</div></li>
    797. 

  797. <li><div class="src-line"><a name="a785"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;recipient&nbsp;is&nbsp;self</span></div></li>
    798. 

  798. <li><div class="src-line"><a name="a786"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">useridnumber&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">idnumber</span><span class="src-sym">;</span></div></li>
    799. 

  799. <li><div class="src-line"><a name="a787"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">username&nbsp;</span>=&nbsp;<span class="src-id">fullname</span><span class="src-sym">(</span><span class="src-var">$USER</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    800. 

  800. <li><div class="src-line"><a name="a788"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">userusername&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">username</span><span class="src-sym">;</span></div></li>
    801. 

  801. <li><div class="src-line"><a name="a789"></a>&nbsp;</div></li>
    802. 

  802. <li><div class="src-line"><a name="a790"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;fetch&nbsp;the&nbsp;subject&nbsp;and&nbsp;body&nbsp;from&nbsp;strings</span></div></li>
    803. 

  803. <li><div class="src-line"><a name="a791"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$subject&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'emailconfirmsubject'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$a</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    804. 

  804. <li><div class="src-line"><a name="a792"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$body&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'emailconfirmbody'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$a</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    805. 

  805. <li><div class="src-line"><a name="a793"></a>&nbsp;</div></li>
    806. 

  806. <li><div class="src-line"><a name="a794"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;send&nbsp;email&nbsp;and&nbsp;analyse&nbsp;result</span></div></li>
    807. 

  807. <li><div class="src-line"><a name="a795"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">email_to_user</span><span class="src-sym">(</span><span class="src-var">$USER</span><span class="src-sym">,&nbsp;</span><span class="src-id">get_admin</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">,&nbsp;</span><span class="src-var">$subject</span><span class="src-sym">,&nbsp;</span><span class="src-var">$body</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    808. 

  808. <li><div class="src-line"><a name="a796"></a><span class="src-sym">}</span></div></li>
    809. 

  809. <li><div class="src-line"><a name="a797"></a>&nbsp;</div></li>
    810. 

  810. <li><div class="src-line"><a name="a798"></a><span class="src-doc">/**</span></div></li>
    811. 

  811. <li><div class="src-line"><a name="a799"></a><span class="src-doc">&nbsp;*&nbsp;Sends&nbsp;notification&nbsp;email&nbsp;to&nbsp;the&nbsp;interested&nbsp;parties&nbsp;that&nbsp;assign&nbsp;the&nbsp;role&nbsp;capability</span></div></li>
    812. 

  812. <li><div class="src-line"><a name="a800"></a><span class="src-doc">&nbsp;*</span></div></li>
    813. 

  813. <li><div class="src-line"><a name="a801"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$recipient&nbsp;</span><span class="src-doc">user&nbsp;object&nbsp;of&nbsp;the&nbsp;intended&nbsp;recipient</span></div></li>
    814. 

  814. <li><div class="src-line"><a name="a802"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">stdClass&nbsp;</span><span class="src-doc-var">$a&nbsp;</span><span class="src-doc">associative&nbsp;array&nbsp;of&nbsp;replaceable&nbsp;fields&nbsp;for&nbsp;the&nbsp;templates</span></div></li>
    815. 

  815. <li><div class="src-line"><a name="a803"></a><span class="src-doc">&nbsp;*</span></div></li>
    816. 

  816. <li><div class="src-line"><a name="a804"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">bool</span><span class="src-doc">|</span><span class="src-doc-type">string</span><span class="src-doc">result&nbsp;of&nbsp;email_to_user()</span></div></li>
    817. 

  817. <li><div class="src-line"><a name="a805"></a><span class="src-doc">&nbsp;*/</span></div></li>
    818. 

  818. <li><div class="src-line"><a name="a806"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_send_notification">quiz_send_notification</a><span class="src-sym">(</span><span class="src-var">$recipient</span><span class="src-sym">,&nbsp;</span><span class="src-var">$a</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    819. 

  819. <li><div class="src-line"><a name="a807"></a>&nbsp;</div></li>
    820. 

  820. <li><div class="src-line"><a name="a808"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">;</span></div></li>
    821. 

  821. <li><div class="src-line"><a name="a809"></a>&nbsp;</div></li>
    822. 

  822. <li><div class="src-line"><a name="a810"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;recipient&nbsp;info&nbsp;for&nbsp;template</span></div></li>
    823. 

  823. <li><div class="src-line"><a name="a811"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">username&nbsp;</span>=&nbsp;<span class="src-id">fullname</span><span class="src-sym">(</span><span class="src-var">$recipient</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    824. 

  824. <li><div class="src-line"><a name="a812"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">userusername&nbsp;</span>=&nbsp;<span class="src-var">$recipient</span><span class="src-sym">-&gt;</span><span class="src-id">username</span><span class="src-sym">;</span></div></li>
    825. 

  825. <li><div class="src-line"><a name="a813"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">userusername&nbsp;</span>=&nbsp;<span class="src-var">$recipient</span><span class="src-sym">-&gt;</span><span class="src-id">username</span><span class="src-sym">;</span></div></li>
    826. 

  826. <li><div class="src-line"><a name="a814"></a>&nbsp;</div></li>
    827. 

  827. <li><div class="src-line"><a name="a815"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;fetch&nbsp;the&nbsp;subject&nbsp;and&nbsp;body&nbsp;from&nbsp;strings</span></div></li>
    828. 

  828. <li><div class="src-line"><a name="a816"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$subject&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'emailnotifysubject'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$a</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    829. 

  829. <li><div class="src-line"><a name="a817"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$body&nbsp;</span>=&nbsp;<span class="src-id">get_string</span><span class="src-sym">(</span><span class="src-str">'emailnotifybody'</span><span class="src-sym">,&nbsp;</span><span class="src-str">'quiz'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$a</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    830. 

  830. <li><div class="src-line"><a name="a818"></a>&nbsp;</div></li>
    831. 

  831. <li><div class="src-line"><a name="a819"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;send&nbsp;email&nbsp;and&nbsp;analyse&nbsp;result</span></div></li>
    832. 

  832. <li><div class="src-line"><a name="a820"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-id">email_to_user</span><span class="src-sym">(</span><span class="src-var">$recipient</span><span class="src-sym">,&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">,&nbsp;</span><span class="src-var">$subject</span><span class="src-sym">,&nbsp;</span><span class="src-var">$body</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    833. 

  833. <li><div class="src-line"><a name="a821"></a><span class="src-sym">}</span></div></li>
    834. 

  834. <li><div class="src-line"><a name="a822"></a>&nbsp;</div></li>
    835. 

  835. <li><div class="src-line"><a name="a823"></a><span class="src-doc">/**</span></div></li>
    836. 

  836. <li><div class="src-line"><a name="a824"></a><span class="src-doc">&nbsp;*&nbsp;Takes&nbsp;a&nbsp;bunch&nbsp;of&nbsp;information&nbsp;to&nbsp;format&nbsp;into&nbsp;an&nbsp;email&nbsp;and&nbsp;send</span></div></li>
    837. 

  837. <li><div class="src-line"><a name="a825"></a><span class="src-doc">&nbsp;*&nbsp;to&nbsp;the&nbsp;specified&nbsp;recipient.</span></div></li>
    838. 

  838. <li><div class="src-line"><a name="a826"></a><span class="src-doc">&nbsp;*</span></div></li>
    839. 

  839. <li><div class="src-line"><a name="a827"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$course&nbsp;</span><span class="src-doc">the&nbsp;course</span></div></li>
    840. 

  840. <li><div class="src-line"><a name="a828"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$quiz&nbsp;</span><span class="src-doc">the&nbsp;quiz</span></div></li>
    841. 

  841. <li><div class="src-line"><a name="a829"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$attempt&nbsp;</span><span class="src-doc">this&nbsp;attempt&nbsp;just&nbsp;finished</span></div></li>
    842. 

  842. <li><div class="src-line"><a name="a830"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$context&nbsp;</span><span class="src-doc">the&nbsp;quiz&nbsp;context</span></div></li>
    843. 

  843. <li><div class="src-line"><a name="a831"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@param&nbsp;</span><span class="src-doc-type">object&nbsp;</span><span class="src-doc-var">$cm&nbsp;</span><span class="src-doc">the&nbsp;coursemodule&nbsp;for&nbsp;this&nbsp;quiz</span></div></li>
    844. 

  844. <li><div class="src-line"><a name="a832"></a><span class="src-doc">&nbsp;*</span></div></li>
    845. 

  845. <li><div class="src-line"><a name="a833"></a><span class="src-doc">&nbsp;*&nbsp;</span><span class="src-doc-coretag">@return&nbsp;</span><span class="src-doc-type">int&nbsp;</span><span class="src-doc">number&nbsp;of&nbsp;emails&nbsp;sent</span></div></li>
    846. 

  846. <li><div class="src-line"><a name="a834"></a><span class="src-doc">&nbsp;*/</span></div></li>
    847. 

  847. <li><div class="src-line"><a name="a835"></a><span class="src-key">function&nbsp;</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_send_notification_emails">quiz_send_notification_emails</a><span class="src-sym">(</span><span class="src-var">$course</span><span class="src-sym">,&nbsp;</span><span class="src-var">$quiz</span><span class="src-sym">,&nbsp;</span><span class="src-var">$attempt</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span><span class="src-sym">,&nbsp;</span><span class="src-var">$cm</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    848. 

  848. <li><div class="src-line"><a name="a836"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">global&nbsp;</span><span class="src-var">$CFG</span><span class="src-sym">,&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">;</span></div></li>
    849. 

  849. <li><div class="src-line"><a name="a837"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;we&nbsp;will&nbsp;count&nbsp;goods&nbsp;and&nbsp;bads&nbsp;for&nbsp;error&nbsp;logging</span></div></li>
    850. 

  850. <li><div class="src-line"><a name="a838"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult&nbsp;</span>=&nbsp;<span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'good'&nbsp;</span>=&gt;&nbsp;<span class="src-num">0</span><span class="src-sym">,&nbsp;</span><span class="src-str">'block'&nbsp;</span>=&gt;&nbsp;<span class="src-num">0</span><span class="src-sym">,&nbsp;</span><span class="src-str">'fail'&nbsp;</span>=&gt;&nbsp;<span class="src-num">0</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    851. 

  851. <li><div class="src-line"><a name="a839"></a>&nbsp;</div></li>
    852. 

  852. <li><div class="src-line"><a name="a840"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;do&nbsp;nothing&nbsp;if&nbsp;required&nbsp;objects&nbsp;not&nbsp;present</span></div></li>
    853. 

  853. <li><div class="src-line"><a name="a841"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$course</span><span class="src-sym">)&nbsp;</span><span class="src-key">or&nbsp;</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">)&nbsp;</span><span class="src-key">or&nbsp;</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">)&nbsp;</span><span class="src-key">or&nbsp;</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$context</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    854. 

  854. <li><div class="src-line"><a name="a842"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">debugging</span><span class="src-sym">(</span><span class="src-str">'quiz_send_notification_emails:&nbsp;Email(s)&nbsp;not&nbsp;sent&nbsp;due&nbsp;to&nbsp;program&nbsp;error.'</span><span class="src-sym">,</span></div></li>
    855. 

  855. <li><div class="src-line"><a name="a843"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">DEBUG_DEVELOPER</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    856. 

  856. <li><div class="src-line"><a name="a844"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'fail'</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
    857. 

  857. <li><div class="src-line"><a name="a845"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    858. 

  858. <li><div class="src-line"><a name="a846"></a>&nbsp;</div></li>
    859. 

  859. <li><div class="src-line"><a name="a847"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;check&nbsp;for&nbsp;confirmation&nbsp;required</span></div></li>
    860. 

  860. <li><div class="src-line"><a name="a848"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$sendconfirm&nbsp;</span>=&nbsp;<span class="src-id">false</span><span class="src-sym">;</span></div></li>
    861. 

  861. <li><div class="src-line"><a name="a849"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$notifyexcludeusers&nbsp;</span>=&nbsp;<span class="src-str">''</span><span class="src-sym">;</span></div></li>
    862. 

  862. <li><div class="src-line"><a name="a850"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-id">has_capability</span><span class="src-sym">(</span><span class="src-str">'mod/quiz:emailconfirmsubmission'</span><span class="src-sym">,&nbsp;</span><span class="src-var">$context</span><span class="src-sym">,&nbsp;</span><span class="src-id">NULL</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    863. 

  863. <li><div class="src-line"><a name="a851"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;exclude&nbsp;from&nbsp;notify&nbsp;emails&nbsp;later</span></div></li>
    864. 

  864. <li><div class="src-line"><a name="a852"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$notifyexcludeusers&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    865. 

  865. <li><div class="src-line"><a name="a853"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;send&nbsp;the&nbsp;email</span></div></li>
    866. 

  866. <li><div class="src-line"><a name="a854"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$sendconfirm&nbsp;</span>=&nbsp;<span class="src-id">true</span><span class="src-sym">;</span></div></li>
    867. 

  867. <li><div class="src-line"><a name="a855"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    868. 

  868. <li><div class="src-line"><a name="a856"></a>&nbsp;</div></li>
    869. 

  869. <li><div class="src-line"><a name="a857"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;check&nbsp;for&nbsp;notifications&nbsp;required</span></div></li>
    870. 

  870. <li><div class="src-line"><a name="a858"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$notifyfields&nbsp;</span>=&nbsp;<span class="src-str">'u.id,&nbsp;u.username,&nbsp;u.firstname,&nbsp;u.lastname,&nbsp;u.email,&nbsp;u.emailstop,&nbsp;u.lang,&nbsp;u.timezone,&nbsp;u.mailformat,&nbsp;u.maildisplay'</span><span class="src-sym">;</span></div></li>
    871. 

  871. <li><div class="src-line"><a name="a859"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$groups&nbsp;</span>=&nbsp;<span class="src-id">groups_get_all_groups</span><span class="src-sym">(</span><span class="src-var">$course</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">,&nbsp;</span><span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    872. 

  872. <li><div class="src-line"><a name="a860"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$groups</span><span class="src-sym">)&nbsp;</span>&amp;&amp;&nbsp;<a href="http://www.php.net/count">count</a><span class="src-sym">(</span><span class="src-var">$groups</span><span class="src-sym">)&nbsp;</span>&gt;&nbsp;<span class="src-num">0</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    873. 

  873. <li><div class="src-line"><a name="a861"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$groups&nbsp;</span>=&nbsp;<a href="http://www.php.net/array_keys">array_keys</a><span class="src-sym">(</span><span class="src-var">$groups</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    874. 

  874. <li><div class="src-line"><a name="a862"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-id">groups_get_activity_groupmode</span><span class="src-sym">(</span><span class="src-var">$cm</span><span class="src-sym">,&nbsp;</span><span class="src-var">$course</span><span class="src-sym">)&nbsp;</span>!=&nbsp;<span class="src-id">NOGROUPS</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    875. 

  875. <li><div class="src-line"><a name="a863"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;If&nbsp;the&nbsp;user&nbsp;is&nbsp;not&nbsp;in&nbsp;a&nbsp;group,&nbsp;and&nbsp;the&nbsp;quiz&nbsp;is&nbsp;set&nbsp;to&nbsp;group&nbsp;mode,</span></div></li>
    876. 

  876. <li><div class="src-line"><a name="a864"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;then&nbsp;set&nbsp;$gropus&nbsp;to&nbsp;a&nbsp;non-existant&nbsp;id&nbsp;so&nbsp;that&nbsp;only&nbsp;users&nbsp;with</span></div></li>
    877. 

  877. <li><div class="src-line"><a name="a865"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;'moodle/site:accessallgroups'&nbsp;get&nbsp;notified.</span></div></li>
    878. 

  878. <li><div class="src-line"><a name="a866"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$groups&nbsp;</span>=&nbsp;-<span class="src-num">1</span><span class="src-sym">;</span></div></li>
    879. 

  879. <li><div class="src-line"><a name="a867"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}&nbsp;</span><span class="src-key">else&nbsp;</span><span class="src-sym">{</span></div></li>
    880. 

  880. <li><div class="src-line"><a name="a868"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$groups&nbsp;</span>=&nbsp;<span class="src-str">''</span><span class="src-sym">;</span></div></li>
    881. 

  881. <li><div class="src-line"><a name="a869"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    882. 

  882. <li><div class="src-line"><a name="a870"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$userstonotify&nbsp;</span>=&nbsp;<span class="src-id">get_users_by_capability</span><span class="src-sym">(</span><span class="src-var">$context</span><span class="src-sym">,&nbsp;</span><span class="src-str">'mod/quiz:emailnotifysubmission'</span><span class="src-sym">,</span></div></li>
    883. 

  883. <li><div class="src-line"><a name="a871"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$notifyfields</span><span class="src-sym">,&nbsp;</span><span class="src-str">''</span><span class="src-sym">,&nbsp;</span><span class="src-str">''</span><span class="src-sym">,&nbsp;</span><span class="src-str">''</span><span class="src-sym">,&nbsp;</span><span class="src-var">$groups</span><span class="src-sym">,&nbsp;</span><span class="src-var">$notifyexcludeusers</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">,&nbsp;</span><span class="src-id">false</span><span class="src-sym">,&nbsp;</span><span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    884. 

  884. <li><div class="src-line"><a name="a872"></a>&nbsp;</div></li>
    885. 

  885. <li><div class="src-line"><a name="a873"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;if&nbsp;something&nbsp;to&nbsp;send,&nbsp;then&nbsp;build&nbsp;$a</span></div></li>
    886. 

  886. <li><div class="src-line"><a name="a874"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!&nbsp;</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$userstonotify</span><span class="src-sym">)&nbsp;</span><span class="src-key">or&nbsp;</span><span class="src-var">$sendconfirm</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    887. 

  887. <li><div class="src-line"><a name="a875"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a&nbsp;</span>=&nbsp;<span class="src-key">new&nbsp;</span><span class="src-id">stdClass</span><span class="src-sym">;</span></div></li>
    888. 

  888. <li><div class="src-line"><a name="a876"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;course&nbsp;info</span></div></li>
    889. 

  889. <li><div class="src-line"><a name="a877"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">coursename&nbsp;</span>=&nbsp;<span class="src-var">$course</span><span class="src-sym">-&gt;</span><span class="src-id">fullname</span><span class="src-sym">;</span></div></li>
    890. 

  890. <li><div class="src-line"><a name="a878"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">courseshortname&nbsp;</span>=&nbsp;<span class="src-var">$course</span><span class="src-sym">-&gt;</span><span class="src-id">shortname</span><span class="src-sym">;</span></div></li>
    891. 

  891. <li><div class="src-line"><a name="a879"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;quiz&nbsp;info</span></div></li>
    892. 

  892. <li><div class="src-line"><a name="a880"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizname&nbsp;</span>=&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">name</span><span class="src-sym">;</span></div></li>
    893. 

  893. <li><div class="src-line"><a name="a881"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizreporturl&nbsp;</span>=&nbsp;<span class="src-var">$CFG</span><span class="src-sym">-&gt;</span><span class="src-id">wwwroot&nbsp;</span>.&nbsp;<span class="src-str">'/mod/quiz/report.php?q='&nbsp;</span>.&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    894. 

  894. <li><div class="src-line"><a name="a882"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizreportlink&nbsp;</span>=&nbsp;<span class="src-str">'&lt;a&nbsp;href=&quot;'&nbsp;</span>.&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizreporturl&nbsp;</span>.&nbsp;<span class="src-str">'&quot;&gt;'&nbsp;</span>.&nbsp;<span class="src-id">format_string</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">name</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">'&nbsp;report&lt;/a&gt;'</span><span class="src-sym">;</span></div></li>
    895. 

  895. <li><div class="src-line"><a name="a883"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizreviewurl&nbsp;</span>=&nbsp;<span class="src-var">$CFG</span><span class="src-sym">-&gt;</span><span class="src-id">wwwroot&nbsp;</span>.&nbsp;<span class="src-str">'/mod/quiz/review.php?attempt='&nbsp;</span>.&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    896. 

  896. <li><div class="src-line"><a name="a884"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizreviewlink&nbsp;</span>=&nbsp;<span class="src-str">'&lt;a&nbsp;href=&quot;'&nbsp;</span>.&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizreviewurl&nbsp;</span>.&nbsp;<span class="src-str">'&quot;&gt;'&nbsp;</span>.&nbsp;<span class="src-id">format_string</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">name</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">'&nbsp;review&lt;/a&gt;'</span><span class="src-sym">;</span></div></li>
    897. 

  897. <li><div class="src-line"><a name="a885"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizurl&nbsp;</span>=&nbsp;<span class="src-var">$CFG</span><span class="src-sym">-&gt;</span><span class="src-id">wwwroot&nbsp;</span>.&nbsp;<span class="src-str">'/mod/quiz/view.php?q='&nbsp;</span>.&nbsp;<span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">id</span><span class="src-sym">;</span></div></li>
    898. 

  898. <li><div class="src-line"><a name="a886"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizlink&nbsp;</span>=&nbsp;<span class="src-str">'&lt;a&nbsp;href=&quot;'&nbsp;</span>.&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">quizurl&nbsp;</span>.&nbsp;<span class="src-str">'&quot;&gt;'&nbsp;</span>.&nbsp;<span class="src-id">format_string</span><span class="src-sym">(</span><span class="src-var">$quiz</span><span class="src-sym">-&gt;</span><span class="src-id">name</span><span class="src-sym">)&nbsp;</span>.&nbsp;<span class="src-str">'&lt;/a&gt;'</span><span class="src-sym">;</span></div></li>
    899. 

  899. <li><div class="src-line"><a name="a887"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;attempt&nbsp;info</span></div></li>
    900. 

  900. <li><div class="src-line"><a name="a888"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">submissiontime&nbsp;</span>=&nbsp;<span class="src-id">userdate</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    901. 

  901. <li><div class="src-line"><a name="a889"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">timetaken&nbsp;</span>=&nbsp;<span class="src-id">format_time</span><span class="src-sym">(</span><span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timefinish&nbsp;</span>-&nbsp;<span class="src-var">$attempt</span><span class="src-sym">-&gt;</span><span class="src-id">timestart</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    902. 

  902. <li><div class="src-line"><a name="a890"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;student&nbsp;who&nbsp;sat&nbsp;the&nbsp;quiz&nbsp;info</span></div></li>
    903. 

  903. <li><div class="src-line"><a name="a891"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">studentidnumber&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">idnumber</span><span class="src-sym">;</span></div></li>
    904. 

  904. <li><div class="src-line"><a name="a892"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">studentname&nbsp;</span>=&nbsp;<span class="src-id">fullname</span><span class="src-sym">(</span><span class="src-var">$USER</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    905. 

  905. <li><div class="src-line"><a name="a893"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$a</span><span class="src-sym">-&gt;</span><span class="src-id">studentusername&nbsp;</span>=&nbsp;<span class="src-var">$USER</span><span class="src-sym">-&gt;</span><span class="src-id">username</span><span class="src-sym">;</span></div></li>
    906. 

  906. <li><div class="src-line"><a name="a894"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    907. 

  907. <li><div class="src-line"><a name="a895"></a>&nbsp;</div></li>
    908. 

  908. <li><div class="src-line"><a name="a896"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;send&nbsp;confirmation&nbsp;if&nbsp;required</span></div></li>
    909. 

  909. <li><div class="src-line"><a name="a897"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-var">$sendconfirm</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    910. 

  910. <li><div class="src-line"><a name="a898"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;send&nbsp;the&nbsp;email&nbsp;and&nbsp;update&nbsp;stats</span></div></li>
    911. 

  911. <li><div class="src-line"><a name="a899"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">switch&nbsp;</span><span class="src-sym">(</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_send_confirmation">quiz_send_confirmation</a><span class="src-sym">(</span><span class="src-var">$a</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    912. 

  912. <li><div class="src-line"><a name="a900"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id">true</span>:</div></li>
    913. 

  913. <li><div class="src-line"><a name="a901"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'good'</span><span class="src-sym">]</span>++<span class="src-sym">;</span></div></li>
    914. 

  914. <li><div class="src-line"><a name="a902"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    915. 

  915. <li><div class="src-line"><a name="a903"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id">false</span>:</div></li>
    916. 

  916. <li><div class="src-line"><a name="a904"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'fail'</span><span class="src-sym">]</span>++<span class="src-sym">;</span></div></li>
    917. 

  917. <li><div class="src-line"><a name="a905"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    918. 

  918. <li><div class="src-line"><a name="a906"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-str">'emailstop'</span>:</div></li>
    919. 

  919. <li><div class="src-line"><a name="a907"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'block'</span><span class="src-sym">]</span>++<span class="src-sym">;</span></div></li>
    920. 

  920. <li><div class="src-line"><a name="a908"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    921. 

  921. <li><div class="src-line"><a name="a909"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    922. 

  922. <li><div class="src-line"><a name="a910"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    923. 

  923. <li><div class="src-line"><a name="a911"></a>&nbsp;</div></li>
    924. 

  924. <li><div class="src-line"><a name="a912"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;send&nbsp;notifications&nbsp;if&nbsp;required</span></div></li>
    925. 

  925. <li><div class="src-line"><a name="a913"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$userstonotify</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    926. 

  926. <li><div class="src-line"><a name="a914"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;loop&nbsp;through&nbsp;recipients&nbsp;and&nbsp;send&nbsp;an&nbsp;email&nbsp;to&nbsp;each&nbsp;and&nbsp;update&nbsp;stats</span></div></li>
    927. 

  927. <li><div class="src-line"><a name="a915"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">foreach&nbsp;</span><span class="src-sym">(</span><span class="src-var">$userstonotify&nbsp;</span><span class="src-key">as&nbsp;</span><span class="src-var">$recipient</span><span class="src-sym">)&nbsp;</span><span class="src-sym">{</span></div></li>
    928. 

  928. <li><div class="src-line"><a name="a916"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">switch&nbsp;</span><span class="src-sym">(</span><a href="../quiz/_sloodle---mod---quiz-1.0---locallib.1.9.php.html#functionquiz_send_notification">quiz_send_notification</a><span class="src-sym">(</span><span class="src-var">$recipient</span><span class="src-sym">,&nbsp;</span><span class="src-var">$a</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    929. 

  929. <li><div class="src-line"><a name="a917"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id">true</span>:</div></li>
    930. 

  930. <li><div class="src-line"><a name="a918"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'good'</span><span class="src-sym">]</span>++<span class="src-sym">;</span></div></li>
    931. 

  931. <li><div class="src-line"><a name="a919"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    932. 

  932. <li><div class="src-line"><a name="a920"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-id">false</span>:</div></li>
    933. 

  933. <li><div class="src-line"><a name="a921"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'fail'</span><span class="src-sym">]</span>++<span class="src-sym">;</span></div></li>
    934. 

  934. <li><div class="src-line"><a name="a922"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    935. 

  935. <li><div class="src-line"><a name="a923"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">case&nbsp;</span><span class="src-str">'emailstop'</span>:</div></li>
    936. 

  936. <li><div class="src-line"><a name="a924"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'block'</span><span class="src-sym">]</span>++<span class="src-sym">;</span></div></li>
    937. 

  937. <li><div class="src-line"><a name="a925"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">break</span><span class="src-sym">;</span></div></li>
    938. 

  938. <li><div class="src-line"><a name="a926"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    939. 

  939. <li><div class="src-line"><a name="a927"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    940. 

  940. <li><div class="src-line"><a name="a928"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    941. 

  941. <li><div class="src-line"><a name="a929"></a>&nbsp;</div></li>
    942. 

  942. <li><div class="src-line"><a name="a930"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;log&nbsp;errors&nbsp;sending&nbsp;emails&nbsp;if&nbsp;any</span></div></li>
    943. 

  943. <li><div class="src-line"><a name="a931"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!&nbsp;</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'fail'</span><span class="src-sym">]</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    944. 

  944. <li><div class="src-line"><a name="a932"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">debugging</span><span class="src-sym">(</span><span class="src-str">'quiz_send_notification_emails::&nbsp;'</span>.<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'fail'</span><span class="src-sym">]</span>.<span class="src-str">'&nbsp;email(s)&nbsp;failed&nbsp;to&nbsp;be&nbsp;sent.'</span><span class="src-sym">,&nbsp;</span><span class="src-id">DEBUG_DEVELOPER</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    945. 

  945. <li><div class="src-line"><a name="a933"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    946. 

  946. <li><div class="src-line"><a name="a934"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">if&nbsp;</span><span class="src-sym">(</span><span class="src-sym">!&nbsp;</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'block'</span><span class="src-sym">]</span><span class="src-sym">))&nbsp;</span><span class="src-sym">{</span></div></li>
    947. 

  947. <li><div class="src-line"><a name="a935"></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-id">debugging</span><span class="src-sym">(</span><span class="src-str">'quiz_send_notification_emails::&nbsp;'</span>.<span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'block'</span><span class="src-sym">]</span>.<span class="src-str">'&nbsp;email(s)&nbsp;were&nbsp;blocked&nbsp;by&nbsp;the&nbsp;user.'</span><span class="src-sym">,&nbsp;</span><span class="src-id">DEBUG_DEVELOPER</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
    948. 

  948. <li><div class="src-line"><a name="a936"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-sym">}</span></div></li>
    949. 

  949. <li><div class="src-line"><a name="a937"></a>&nbsp;</div></li>
    950. 

  950. <li><div class="src-line"><a name="a938"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-comm">//&nbsp;return&nbsp;the&nbsp;number&nbsp;of&nbsp;successfully&nbsp;sent&nbsp;emails</span></div></li>
    951. 

  951. <li><div class="src-line"><a name="a939"></a>&nbsp;&nbsp;&nbsp;&nbsp;<span class="src-key">return&nbsp;</span><span class="src-var">$emailresult</span><span class="src-sym">[</span><span class="src-str">'good'</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
    952. 

  952. <li><div class="src-line"><a name="a940"></a><span class="src-sym">}</span></div></li>
    953. 

  953. <li><div class="src-line"><a name="a941"></a><span class="src-php">?&gt;</span></div></li>
    954. 

  954. </ol></div>
    955. 

  955. </div>
    956. 

  956. 	<p class="notes" id="credit">
    957. 

  957. 		Documentation generated on Mon, 16 Jun 2008 15:56:38 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0</a>
    958. 

  958. 	</p>
    959. 

  959. 	</body>
    960. 

  960. </html>
    961.