lib/tests/other/completion.manualtest.txt

   1 Completion system manual test
   2 =============================
   3
   4 This text file describes a manual process which can be used to check that the
   5 completion system is working correctly. This does not exercise every possible
   6 element of the completion system but it covers most of the basic parts.
   7
   8 Site setup
   9 ----------
  10
  11 1) Make a fresh install of the Moodle version you are testing.
  12
  13 CHECK A: There is no error when installing the completion database tables.
  14
  15 2) Create users 'admin' (as part of install) and 'u1'
  16 3) Set the server debug to 'Developer' so that you spot any warnings etc.
  17 4) Create course 'CF101' (leave default except pick separate groups) and
  18    assign 'u1' as student
  19
  20
  21 Course setup
  22 ------------
  23
  24 1) Create a web page resource 'w'
  25 2) Create a forum 'f1'
  26 3) Create a forum 'f2'
  27 4) Create a quiz 'q1' with one question (e.g. true/false question)
  28 5) Create a quiz 'q2' with one question (can use same question)
  29 6) In gradebook/reports/categories and items, edit q2's grade (show advanced)
  30    to assign a 'grade to pass' of 5.0.
  31    [Note: Due to a bug in gradebook at time of writing, you may have to go into
  32    admin screens and make sure that 'Student' is included on the list of graded
  33    roles, or there will be an error at this step.]
  34 7) Create 2 groups on the course. Assign u1 to one group.
  35
  36 Completion settings
  37 -------------------
  38
  39 1) Visit the course setting screen.
  40
  41 CHECK B: The completion controls appear. Completion is enabled.
  42
  43 2) Turn off the setting (disable completion) and save.
  44 3) Visit the admin page. Find the enablecompletion setting.
  45
  46 CHECK C: The enablecompletion setting appears. Completion is enabled.
  47
  48 4) Turn off this setting and save.
  49
  50 4b) Note: At present I have not found a satisfactory way to set a default
  51   for the config option, so if necessary, please manually tick the 'Student'
  52   checkbox while on this screen.
  53
  54 5) Visit the course setting screen again.
  55
  56 CHECK D: The completion controls do not appear.
  57
  58 6) Visit the setting screen for 'w'
  59
  60 CHECK E: Completion controls do not appear
  61
  62 7) Go to admin screen and turn completion on again, then return to the 'w' settings
  63
  64 CHECK F: Completion controls still do not appear
  65
  66 8) Go to course settings and turn completion on, then return to 'w' settings
  67
  68 CHECK G: Completion controls appear. Completion is set to manual.
  69
  70 9) Go to 'f1' settings. Set completion to automatic and to 2 discussions/replies.
  71 10) Go to 'f2' settings. Set completion to automatic and to 'view'
  72 11) Go to 'q1' and 'q2' settings; set both to automatic and 'grade'. Set them
  73   to grade based on the most recent attempt rather than 'highest'.
  74
  75 Completion actions
  76 ------------------
  77
  78 Note: Icons are subject to change, so references to a 'tick' etc might not be
  79 correct.
  80
  81 1) Log in as u1 and go to CF101.
  82
  83 CHECK H: A completion tick (unticked) is visible next to 'w'.
  84
  85 2) Click the completion mark a few times.
  86
  87 CHECK I: Completion toggles successfully.
  88
  89   2b) Go to u1's profile settings and turn on/off AJAX then repeat toggling the
  90       mark. Leave it ticked.
  91   CHECK I2: Completion still toggles successfully.
  92
  93 3) Visit 'f1' and post 1 message. Return to course home.
  94
  95 CHECK J: There is no tickmark next to f1. (If examined carefully, the 'not
  96   complete' icon should be present.)
  97
  98 4) Visit 'f1' and post a reply to the message. Return to course home.
  99
 100 CHECK K: There is now a tick next to f1.
 101
 102 5) Visit 'f2' and return to the home page.
 103
 104 CHECK L: There is now a tick next to f2.
 105
 106 6) Visit 'q1' and attempt the quiz, getting it wrong and submitting answer.
 107   Return to the home page.
 108
 109 CHECK M: There is a black 'completed' tick next to q1.
 110
 111 7) Visit 'q1' again and this time get it right. Return to home page.
 112
 113 CHECK N: There is still a black 'completed' tick next to q1.
 114
 115 8) Visit 'q2' and get it right. Return to home.
 116
 117 CHECK O: There is a green 'completed-passed' tick next to q2.
 118
 119 9) Visit 'q2' and get it wrong. Return to home.
 120
 121 CHECK P: There is a red 'completed-failed' X next to q2.
 122
 123 Completion progress
 124 -------------------
 125
 126 1) Log in as admin again.
 127
 128 2) From the course admin block, click on the reports link.
 129
 130 CHECK Q: A 'completion progress' link appears.
 131
 132 3) Click on the completion progress link.
 133
 134 CHECK R:
 135   A groups dropdown should show the two groups (and 'all').
 136   The progress table should include all activities for which completion
 137     was set, across the top.
 138   The progress table should show u1 down the side.
 139   Tick and X icons should match those shown when logged in as u1.
 140
 141 4) Choose a group that does not include u1
 142
 143 CHECK S:
 144   An informational ('no users') message should display instead of the progress
 145   table.
 146
 147 5) Choose the group that does include u1
 148
 149 CHECK T:
 150   The progress table should show u1 again.
 151
 152 Backup/restore
 153 --------------
 154
 155 1) Backup the course. Choose 'course users', user data for everything except
 156   q1 ('no user data'), and default options.
 157
 158 2) Restore to a new course, accepting all defaults.
 159
 160 3) Log in as u1 again and visit the new course.
 161
 162 CHECK U:
 163   Completion should appear as it did in the previous version of the course
 164   ('w','f1','f2' complete, 'q2' complete-fail) except that q1 should show as
 165   incomplete.
 166
 167