Subversion Repositories wimsdev

Rev

Rev 8690 | Rev 11969 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 8690 Rev 10602
Line 1... Line 1...
1
!if $wims_read_parm!=$empty
1
!if $wims_read_parm!=$empty
2
 !goto $wims_read_parm
2
 !goto $wims_read_parm
3
!endif
3
!endif
4
 
4
 
5
:general
5
:general
6
!! for translation copy the part of the lang/help.phtml.fr corresponding to the record :feedback
-
 
7
!read lang/help.phtml.fr general
6
<h2 id="general">Introduction</h2>
8
 
7
 
-
 
8
<p>
-
 
9
A sheet allows to propose to students a list of WIMS exercises.
-
 
10
The student activity can then be scored and monitored.
-
 
11
</p>
-
 
12
 
-
 
13
To construct the sheets of the class, one may
-
 
14
<ul><li>
-
 
15
import sheets found through the search engine (click on
-
 
16
the title of the sheet then on the link
-
 
17
<span class="tt wims_code_words">$wims_name_import</span>)
-
 
18
and change it if necessary
-
 
19
</li><li>
-
 
20
create a new sheet using the link
-
 
21
<span class="tt wims_code_words">$wims_name_add_sheet</span>
-
 
22
then build the content of the sheet by inserting one by one
-
 
23
the exercises found from the search engine or from the classe 
-
 
24
exercises (the link
-
 
25
<span class = "tt wims_code_words"> $wims_name_add_sheet </span>
-
 
26
is visible when you go to work with the selected exercise)
-
 
27
or insert a source file from a list of exercises found for instance
-
 
28
in a wims document.
-
 
29
</li></ul>
-
 
30
The sheets are numbered in the order of creation / integration in the class.
-
 
31
It is possible to rearrange the layout sheets for students using
-
 
32
the link <span class="tt wims_code_words">$wims_name_reorder</span>.
-
 
33
 
9
!if $wims_read_parm!=$empty
34
!if $wims_read_parm!=$empty
10
 !exit
35
 !exit
11
!endif
36
!endif
12
 
37
 
13
:statut
38
:statut
-
 
39
<h2 id="statut">Status of a worksheet</h2>
-
 
40
A sheet may have four statuses :
-
 
41
<span class="wims_emph">
-
 
42
!replace internal , by ,$ $ in $(wims_name_shstatus).
-
 
43
</span>
-
 
44
<p>
-
 
45
<span class="wims_emph">$(wims_name_shstatus[1]) :</span>
-
 
46
This is the initial status of a sheet. In this status, the sheet is not
-
 
47
visible by the participants.
-
 
48
</p><p>
-
 
49
<span class="wims_emph">$(wims_name_shstatus[2]) :</span>
-
 
50
when we click on
-
 
51
<span class="tt wims_code_words">$(wims_name_actionlist[1])</span>,
-
 
52
the sheet becomes visible by the participants 
-
 
53
(they can work on the exercises if no parameter in the field
-
 
54
<span class="tt wims_code_words">$(name_shinfo[6])</span>
-
 
55
prevents it), its content
14
!! for translation copy the part of the lang/help.phtml.fr corresponding to the record :feedback
56
is no longer editable except the titles and explanatory texts of the sheet and
-
 
57
exercises, the field
-
 
58
<span class="tt wims_code_words">$(name_shinfo[6])</span> 
-
 
59
as well as the fields
-
 
60
<span class="tt wims_code_words">$wims_name_feedbackexo</span> of the exercises.
-
 
61
</p><p>
-
 
62
From the status
-
 
63
<span class="tt wims_code_words">$(wims_name_shstatus[2])</span>,
15
!read lang/help.phtml.fr statut
64
the sheet may be changed to the status
-
 
65
<span class="tt wims_code_words">$(wims_name_shstatus[3])</span>
-
 
66
by clicking on the button
-
 
67
 <span class="tt wims_code_words">$(wims_name_actionlist[2])</span>.
-
 
68
It's not possible to return to the status
-
 
69
<span class="tt wims_code_words">$(wims_name_shstatus[1])</span>.
-
 
70
</p><p>
-
 
71
<span class="wims_emph">$(wims_name_shstatus[3]) :</span>
-
 
72
the participant can work on the sheet but his work is not accounted for.
-
 
73
</p><p>
-
 
74
Once the sheet is expired, it can be made invisible to students by clicking
-
 
75
<span class="tt wims_code_words">$(wims_name_actionlist[4])</span>,
-
 
76
but its status can also be turned to
-
 
77
<span class="tt wims_code_words">$(wims_name_shstatus[2])</span>.
-
 
78
 </p>
-
 
79
!if $wims_read_parm!=$empty
-
 
80
 !exit
-
 
81
!endif
16
 
82
 
17
:dependancies
83
:dependancies
18
<h2 id="dependancies">$(name_shtab[6])</h2>
84
<h2 id="dependancies">$(name_shtab[6])</h2>
19
<p>
85
<p>
20
  means that a participant must get
86
It means that a participant must get
21
  required scores in other exercises of the worksheet before he/she can do
87
  required scores in other exercises of the worksheet before he/she can do
22
  this one. For example,
88
  this one. For example,
23
  <span class="tt wims_code_words">1:50,2:30,3+4+5:60</span>
89
  <span class="tt wims_code_words">1:50,2:30,3+4+5:60</span>
24
  means that the
90
  means that the
25
  participant must get 50% success on exercise 1, 30% success on exercise 2,
91
  participant must get 50% success on exercise 1, 30% success on exercise 2,
26
  and an average of 60% success on exercises 3, 4, 5.
92
  and an average of 60% success on exercises 3, 4, 5.
27
 
93
 
-
 
94
</p>
-
 
95
 
-
 
96
!if $wims_read_parm!=$empty
-
 
97
 !exit
-
 
98
!endif
-
 
99
 
-
 
100
:allowtype
-
 
101
!! !read adm/title.phtml 1\
-
 
102
!! Score registration
-
 
103
<h2 id="allowtype">Information about score registration.</h2>
-
 
104
 
-
 
105
You can impose a restriction, for instance about time, on score 
-
 
106
recording. Several options are available:
-
 
107
<ul>
-
 
108
 <li><span class="tt wims_code_words">$(name_allowtype[1])</span> : 
-
 
109
the scores will be recorded.</li>
-
 
110
 <li><span class="tt wims_code_words">$(name_allowtype[2])</span> : 
-
 
111
no score will be recorded.</li>
-
 
112
 <li><span class="tt wims_code_words">$(name_allowtype[3])</span> : 
-
 
113
an input field, 
-
 
114
<span class="tt wims_code_words">$(name_shinfo[6])</span>, 
-
 
115
appears and you can specify a time range and the
-
 
116
IP addresses from which the scores will be recorded.
-
 
117
This restriction is written using three expressions (which are optional):
-
 
118
<br/>
-
 
119
 <ul>
-
 
120
  <li><span class="tt wims_code_words">&gt;aaaammjj.hh:mm</span> 
-
 
121
allows to specify a start time ;</li>
-
 
122
  <li><span class="tt wims_code_words">&lt;aaaammjj.hh:mm</span> 
-
 
123
allows to specify an end time ;</li>
-
 
124
  <li><span class="tt wims_code_words">192.168. </span> 
-
 
125
which lets you specify an IP range ;</li>
-
 
126
 </ul>
-
 
127
The dates and times must be in the SERVER local time and these  
-
 
128
three expressions must be separated from each other by spaces.
-
 
129
 <p>
-
 
130
Example :
-
 
131
<span class="tt wims_code_words">&lt;20131007.10:30 &gt;20131001.10:00 127.0.</span>
-
 
132
allows the recording of notes between two dates and only for IP 
-
 
133
numbers beginning with
-
 
134
 <span class="tt wims_code_words">127.0</span>.
28
</p>
135
</p>
-
 
136
</li>
-
 
137
 
-
 
138
<li><span class="tt wims_code_words">$(name_allowtype[4])</span> : 
-
 
139
this option may be chosen to individualize access restrictions using a
-
 
140
<span class="tt wims_code_words">technical variable</span>
-
 
141
 (this technique variable is defined for each participant either 
-
 
142
manually using the technical variables management module or using 
-
 
143
a <span class="tt wims_code_words">$wims_name_Vote</span>). 
-
 
144
When choosing this option, a menu allows you to select the technical
-
 
145
variable used as a differentiation criterion and a table allows 
-
 
146
the setting of the filter (using the same format as above) 
-
 
147
for each possible value of the variable.
-
 
148
<br/>
-
 
149
In the case of a technical variable defined using the model 
-
 
150
<span class="tt wims_code_words"> individualized access</span> 
-
 
151
of a  <span class="tt wims_code_words">$wims_name_Vote</span> 
-
 
152
specific to the time slot reservation creation,
-
 
153
the table is pre-filled with the data proposed in the
-
 
154
  creation of the vote. These data can be modified,
-
 
155
but the changes are not reflected on the vote.
-
 
156
</li>
-
 
157
</ul>
-
 
158
!if $tv_listtechvar!=$empty
-
 
159
 the technical variables currently available in your class are:
-
 
160
 !read adm/vfilter/listvar.phtml 
-
 
161
!else
-
 
162
 There is no technical variable currently defined in your class. 
-
 
163
To use this option, you should first define a technical variable.
-
 
164
!endif
-
 
165
!if $wims_read_parm!=$empty
-
 
166
 !exit
-
 
167
!endif
29
 
168
 
-
 
169
:variable
-
 
170
<p>
-
 
171
In order to individualize the access restrictions, it is possible 
-
 
172
to put a variable (in the example below, write
-
 
173
<span class="tt wims_code_words">\timelimit</span>).
-
 
174
This variable must be defined for each participant according
-
 
175
the previous rules, or manually in the properties of
-
 
176
a participant's account (technical variable).
-
 
177
</p><p>
-
 
178
Example : write
-
 
179
<span class="tt wims_code_words">timelimit=&lt;20131007.10:30 &gt;20131001.10:00</span>
-
 
180
in the "Technical variable" input field of the properties account 
-
 
181
of a student.
-
 
182
For participants for which this variable is empty,
-
 
183
the score recording is closed.
-
 
184
</p><p>
-
 
185
You can add this variable using the spreadsheet link.
-
 
186
If the restriction is choosen by a participant (registration by 
-
 
187
certain dates for example), it is possible to create and use a vote
-
 
188
in guided mode (See corresponding help).
-
 
189
</p>
30
!if $wims_read_parm!=$empty
190
!if $wims_read_parm!=$empty
31
 !exit
191
 !exit
32
!endif
192
!endif
33
 
193
 
34
:allowtype
194
:feedback
35
!read adm/title.phtml 1\
195
<h2 id="feedback">$(name_shtab[10])</h2>
36
Score registration
-
 
37
 
196
 
-
 
197
You can provide in this field a link to a WIMS document 
38
You can make restrictions to score registration, by selecting hosts from which
198
or exercise. The link to this resource appears when the score is
-
 
199
strictly less than a preset note (out of 10).
39
the tasks can be done or by determining time periods for work by writing the following code
200
The second item is the limit rating (out of 10), the first item is 
-
 
201
the address as follows (abbreviated):
-
 
202
<ul><li>
-
 
203
Exercise from a public module or document  : 
40
<span class="tt wims_code_words">
204
<span class="tt wims_address">module=xxx</span>
41
&gt;yyyymmdd.hh:mm</span>
205
(as in <span class="wims_button disabled">$wims_name_about</span>).
-
 
206
</li><li>
42
(starting time) and/or
207
Exercise in the class : 
-
 
208
<span class="tt wims_address">module=classes/fr&exo=_file_name_</span>
43
<span class="tt wims_code_words">
209
where <span class="tt">_file_name_</span> 
44
&lt;yyyymmdd.hh:mm</span>
210
is the file name of the exercise
-
 
211
(without the extension <span class="tt">.oef</span>).
45
(ending time).
212
</li><li>
46
Time must be the
213
Document in the class  :
-
 
214
<span class="tt wims_address">module=adm/doc&doc=c1&+block=_block_name_</span>
-
 
215
</li></ul>
-
 
216
 
47
SERVER's local time and items must be separated by spaces.
217
Additonal parameters may be added (see
-
 
218
<span class="wims_button disabled">$wims_name_about</span>).
-
 
219
 
-
 
220
For instance, in the example below, if the score is less than 5, 
-
 
221
the student will be led to the document 
-
 
222
<span class="tt">c2</span> of the class, more specifically
-
 
223
on the page corresponding to the block
-
 
224
<span class="tt">aaa</span> of this document.
-
 
225
 
-
 
226
<pre>module=adm/doc&doc=c2&+block=aaa,5</pre>
-
 
227
 
-
 
228
In the example below, there will be a
-
 
229
link to an exercise of the module H6/set/oefset.fr whose source is 
-
 
230
named traduction1 (the score of the student on this exercise
-
 
231
will not be recorded in the class).
-
 
232
 
-
 
233
<pre>module=H6/set/oefset.fr&cmd=new&exo=traduction1,10</pre>
48
 
234
 
-
 
235
By writing two numbers (the second of which is positive), the button
-
 
236
appears when the score is between the second number
-
 
237
and the first number: for example, if you put
-
 
238
<pre>module=H6/set/oefset.fr&cmd=new&exo=traduction1,11,10</pre>
49
For example, <span class="tt wims_code_words">
239
the button appears when the score is 10 and the word 
-
 
240
$wims_name_feedbackplus
50
175.190.50. &gt;20110421.15.15  &lt;20110421.16.15</span>
241
is writen. If the second number is 0, the behavior is the same as 
-
 
242
if it did not exist.
51
 
243
 
52
!! for translation copy the part of the lang/help.phtml.fr corresponding to the record :variable
244
You can also insert a help link in the sheet by first selecting a 
53
!read lang/help.phtml.fr variable
245
WIMS resource and following the link
-
 
246
<span  class="wims_button disabled">$wims_name_addh</span>
-
 
247
 in the left menu.
54
 
248
 
55
!if $wims_read_parm!=$empty
249
!!if $wims_read_parm!=$empty
56
 !exit
250
 !exit
57
!endif
251
!!endif
58
 
-
 
59
:feedback
-
 
60
!! for translation copy the part of the lang/help.phtml.fr corresponding to the record :feedback
-
 
61
!read lang/help.phtml.fr feedback
-
 
62
 
-
 
63
!exit
-
 
64
 
252
 
65
:series
253
:series
-
 
254
<p>
-
 
255
In general, the exercises of a series are randomly chosen
66
!! for translation copy the part of the lang/help.phtml.fr corresponding to the record :series
256
and at least one exercise for each type is proposed if the requested
67
!read lang/help.phtml.fr series
257
number allows it.
68
 
258
</p><p>
-
 
259
You asked in the expert setting for a non random order,
-
 
260
you can change here the order of exercises in a series.
69
!exit
261
</p>