Subversion Repositories wimsdev

Rev

Rev 2711 | Rev 2808 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
1384 czzmrn 1
 
2
!set sp2=$special_parm2
3
!bound sp2 within secure,supervisor,email,lang,level,limit,expiration,modtoolchg,\
4
        bgcolor,homepage,bgimg,theme,css,theme_icon,logo,lock,exolog,examlog,examshow,ent,option,authtype,topscores\
5
        default $
6
 
7
!if $sp2=$empty
8
 !exit
9
!endif
10
 
11
!goto $sp2
12
 
13
:secure
14
<b>Secure hosts</b>.
15
Consider the possibility under which there is a leak of your supervisor
16
password: when you connect to the class as supervisor within a class room, a
17
student may look over your shoulder, or even install a keyboard scanning
18
software to register what you type (including the password). Believe me: if
19
you keep real scores in your class, the supervisor password becomes a very
20
coveted object.
21
<p>
22
The consequence of such a leak may be catastrophic to the class: data may
23
be damaged, grades may be modified, or even you may lose your supervisor
24
access if the student changes your password.
25
<p>
26
Definition of secure hosts puts an extra security layer: sensitive
27
manipulations such as class configuration, password change or score
28
modificatoin can only be
29
made from pre-defined <em>secure hosts</em>, when you are sure that students
30
have no access to these hosts. So even if a student steals your password,
31
there is not much (s)he can do to the class.
32
<p>
33
!read help/hosts.phtml
34
<p>
35
By the way, if you have to type your password in a very hostile environment
36
(such as in the middle of student computers), you should also consider using
37
one-time passwords (see the password page).
38
!exit
39
 
40
:supervisor
41
 <b>Supervisor name</b>. Enter here your name, in the way you like.
42
!exit
43
 
44
:email
45
 <b>Supervisor email</b>.
46
 Important notifications (secret codes, expiration notice, etc.) will be sent
47
 to this address. This is also where student will send you messages. So you
48
 MUST give your active email address, otherwise you may even lose control of
49
 your class.
50
!exit
51
 
52
:option
53
 <b>Option words of the class</b>. The following words can be used here:
54
 <ul>
55
 <li><tt>showshexpire</tt>. Show the expiration date of worksheets in the
56
  home page of participants.
57
 <li><tt>showexexpire</tt>. Show the expiration date of exam sheets in the
58
  home page of participants.
2533 bpr 59
 <li><tt>showshweight</tt>. Show sheet weight in the
60
  home page of participants.
1384 czzmrn 61
 </ul>
62
!exit
63
 
64
:lang
2711 czzmrn 65
 Lingue disponibili: <ul>
1384 czzmrn 66
 <li>cn (Cinese gb)
2711 czzmrn 67
 <li>de (Tedesco)
1384 czzmrn 68
 <li>en (Inglese)
69
 <li>es (Spagnolo)
70
 <li>fr (Francese)
71
 <li>it (Italiano)
72
 <li>nl (Olandese)
2711 czzmrn 73
 <li>si (Sloveno)
1384 czzmrn 74
 <li>tw (Cinese big5)
75
</ul>
76
!exit
77
 
78
:level
79
 Meanings of the levels: <ul>
80
 <li>E1 - E6: Elementary school, year 1 to 6.
81
 <li>H1 - H6: Secondary school, year 1 to 6.
82
 <li>U1 - U5: University, year 1 to 5.
83
 <li>G: University, Graduate study.
84
 <li>R: Research.
85
</ul>
86
!exit
87
 
88
:limit
89
 <b>Participant number limit</b>. Registration of new participants will be
90
refused if this limit is reached. This site has defined a hard limit
91
($wims_class_user_limit) that cannot be exceeded.
92
!exit
93
 
94
:expiration
95
 <b>Expiration date</b>. The class will be closed when it reaches the
96
expiration date. You may extend this date at any moment, but extensions
97
exceeding one year from the actual date will be refused.
98
<p>
99
 If you want to extend this date to more than one year, you may do it
100
 in several times at regular intervals, or
101
 <a href="mailto:$wims_site_manager?subject=Virtual class extension
102
 demand">ask the site manager</a> to do it for you.
103
 <p>
104
 This date must be entered in 8-digit form (yyyymmdd).
105
 Example: 20120523 means May 23, 2012.
106
!exit
107
 
108
:bgcolor
109
 <b>Page background color and menu color</b>. These two colors can help you
110
 quickly recognize pages within your virtual class. The values of these
111
 fields must be valid html color names.
112
 <p>
2581 reyssat 113
 <b>Link color in menus and tables</b>. You may adapt the link color to the
114
    menu background color. If you choose this option, it is wise to fill in explicitely
115
    the table background color even if it is the same as the default one (in case the
116
default would change).
117
 <p>
118
 Default values are those defined for the general site pages.
1384 czzmrn 119
!exit
120
 
121
:homepage
122
 <b>Participant homepage</b>. You may put the address of a document block
123
 (such as <tt>c1/main</tt>) to be the home page of the class for participants.
124
 The document itself need not be readable by participants.
125
 <p>
126
 Leave this field blanck if you want to use the standard home page.
127
 <p>
128
 All the links in the block should be defined using the command <tt>\adm</tt>.
129
 You can use the following pre-defined variables:<ul>
130
 <li><tt>\firstname</tt> Participant's first name
131
 <li><tt>\lastname</tt> Participant's last name
132
 <li><tt>\scores</tt> Participants's score information. This is a list of
133
numbers. Each pair of numbers corresponds to one sheet: percentage of points
134
and score quality.
135
 <li><tt>\newmsgcnt</tt> Unread messages in the class forum.
136
 <li><tt>\today</tt> Date of today, yyyymmdd.
137
 <li><tt>\sheets</tt> Number of work sheets.
138
 <li><tt>\exams</tt> Number of exam sheets.
139
 <li><tt>\expiration1</tt>, <tt>\expiration2</tt>, <tt>\expirationE1</tt>, ...
140
 Expiration date of sheet 1, sheet 2, exam 1, ..., yyyymmdd.
141
 <li><tt>\status1</tt>, <tt>\status2</tt>, <tt>\statusE1</tt>, ...
142
 Status of sheet 1, sheet 2, exam 1, ... This is a non-negative integer; 0
143
 = under preparation, 1 = active, 2 = expired, 3 = hidden.
144
 <li><tt>\daymessage</tt> : message du jour de la classe.</li>
145
 <li><tt>\userdaymessage</tt> : message du jour individuel de chaque participant.</li>
146
 </ul>
147
!goto end
148
 
149
:bgimg
150
 Background image file (tile) for pages in the class. You may use any valid URL.
151
 There are also prepared background image files which you can use without
152
 adding any address prefix:<p>
153
 <tt>$bgimgs</tt>
154
!exit
155
 
156
:theme
2711 czzmrn 157
Le thème de style de votre classe.
1384 czzmrn 158
!exit
159
 
160
:theme_icon
2711 czzmrn 161
Les icones qui apparaissent dans les menus
1384 czzmrn 162
!exit
163
 
164
:css
165
The style sheet affects almost all pages of your class.
166
<p>
167
Choose `<tt>----</tt>' to disable style sheets.
168
<p>
2711 czzmrn 169
Choose `<tt>-theme-</tt>' to use style sheets corresponding to your choice
1384 czzmrn 170
of the theme.
171
<p>
2711 czzmrn 172
Choose `<tt>class</tt>' to use the style sheet (css) defined by yourself
173
(see remark below).
174
<p>
175
The other choices correspond to pre-defined styles on this WIMS site.
1384 czzmrn 176
 
2711 czzmrn 177
<p><b>Remark</b>. You may use your own style classes.
178
Please refer to css documents for the syntax.
179
If you define your own css, please test it with ALL possible browsers used by your
1384 czzmrn 180
students, for possible incompatibilities!
2711 czzmrn 181
<p>
182
The following classes, changing the style
183
of your class, may be redefined:
1384 czzmrn 184
<pre>
185
!read  wimshome/public_html/bases/sys/css_classes
186
</pre>
187
!exit
188
 
189
:logo
190
The logo of the class is a graphics file that will be shown on the top
191
of the homepage of the class, both for supervisor and for participants.
192
This logo can be put either on the top left or the top right corner.
193
<p>
194
Choose `<tt>none</tt>' if you don't want a logo to be shown.
195
<p>
196
If you choose empty string or `<tt>wims</tt>', the WIMS logo will be used.
197
<p>
198
Otherwise, you may put the URL of any valid graphics file here.
199
!exit
200
 
201
:lock
202
Connection lock helps to track users, and can help anti-cheating. There are
203
8 lock levels. <ul>
2711 czzmrn 204
<li><p>0: No connection lock is used.
1384 czzmrn 205
 
2711 czzmrn 206
<li><p>1: Cookie-tracking is activated. Connections without correct return
1384 czzmrn 207
 cookie will be refused.
208
 
2711 czzmrn 209
<li><p>2: Secured (https) connection is required. Connections using usual
1384 czzmrn 210
http request will be refused. You must check first whether the web server
211
on this WIMS site accepts https connections.
212
 
2711 czzmrn 213
<li><p>3: Host address lock is activated. Participants will have no right to
1384 czzmrn 214
change his/her host address within one session. There will be difficulties
215
when connections are made from dynamically allocated IP numbers.
216
 
2711 czzmrn 217
<li><p>4: Cookie-tracking + https.
218
<li><p>5: Cookie-tracking + Host lock.
219
<li><p>6: All the above methods are activated.
220
<li><p>7: The class is closed. No participant connection accepted.
1384 czzmrn 221
</ul> <p>
222
!exit
223
 
224
:exolog
225
Number of exercise registrations (limited to $wims_exolog_limit)
226
<p>
227
This is the maximal number of exercises for which each participant can
228
register the details.
229
<p>
230
These details allow participants and supervisor to review the action of
231
the exercise, and eventually make discussions.
232
<p>
233
The detail of an exercise is registered only if the participant gives the
234
order. When the maximal number is exceeded, the most ancient registrations
235
are erased.
236
!goto logs
237
 
238
:examlog
239
Number of exam registrations (limited to $wims_examlog_limit)
240
<p>
241
This is the maximal number of exam sessions whose details can be registered
242
for each participant.
243
<p>
244
These details allow participants and supervisor to review the action of the
245
exam, exercise by exercise.
246
<p>
247
The registration of exam sessions is automatic. When the maximal number is
248
exceeded, the most ancient registrations will be erased.
249
!exit
250
 
251
:logs
252
<p>
253
Put this number to 0 if you want to disable this registration.
254
<b>ATTENTION</b> the registration of exercises and exams may take a lot of
255
space! If you put these numbers too big, you class risks disk quota overflow.
256
!exit
257
 
258
:examshow
259
Dans le cas où cette option est mise sur <tt>Non</tt>, les élèves ne peuvent
260
pas revoir les enregistrements d'examens. Seul l'enseignant le peut.
261
!exit
262
 
263
:authtype
264
<b>Type d'authentification</b> :
265
Vous pouvez utiliser une authentification par ldap ou l'authentification par wims.
266
Dans le cas où l'authentification par ldap ne réussit pas, l'authentification
267
par la procédure interne de wims est essayée.
268
<p>
269
Exemple de paramètres pour une authentification ldap :
270
<pre>
271
ldap_host=ldap.u-psud.fr
272
ldap_port=389
273
ldap_version=3
274
ldap_base=ou=people,dc=u-psud,dc=fr
275
ldap_branch=ou=people,dc=u-psud,dc=fr
276
ldap_uid=uid
277
ldap_login=supannAliasLogin
278
</pre>
279
!exit
280
 
281
:modtoolchg
282
<b>Compte Modtool</b> :
283
Une fois que vous êtes entré dans Modtool par la classe, votre compte Modtool
284
est enregistré. Vous pouvez ici effacer cet enregistrement si vous avez besoin
285
d'utiliser un autre compte Modtool. Vous devez ensuite passer par le lien <tt>Modtool</tt>
286
sur la page d'accueil.
287
 
288
!exit
289
 
290
:ent
2711 czzmrn 291
<b>Links on another plateform</b> :
292
You may add a link on another plateform :
293
<pre> link_title,link_adress</pre>
294
For example,
295
<pre>Dokeos,http://-------</pre>
296
If you need more than one link, they must be seperate by ";".
1384 czzmrn 297
 
298
!exit
299
 
2756 bpr 300
:external_auth
301
<b>Adresse dans le cas d'une authentification externe</b> : <i>Ceci est pour experts
302
et permet d'utiliser par exemple une authentification CAS. </i>
303
Vous pouvez indiquer le lien sur une authentification externe à wims sous la forme
304
(cette adresse devra alors directement faire entrer dans la classe).
305
Vous devez mettre l'adresse complète en html :<tt>&lt;a href="http:...">Lien&lt;/a></tt>.
306
 
307
Il est par exemple possible de mettre l'adresse dans un "frame" :
308
<tt>&lt;iframe https:...." width="100%" height="400">&lt;/iframe></tt>.
309
 
310
<p>Vous pouvez désactiver cette option tout en gardant le texte en cliquant sur <tt>Non</tt>.
311
Si vous cochez <tt>$name_mix_auth</tt>, l'adresse html que vous avez donné apparaîtra mais
312
aussi l'authentification propre à wims comme une alternative.
313
 
314
Vous devez mettre un code html valide, il ne sera pas vérifié et
315
vous assurez que l'authentification externe permet d'entrer dans votre classe.
316
 
317
!exit
318
 
1384 czzmrn 319
:topscores
2581 reyssat 320
<center><b>Best scores, number and anonymity</b></center>
321
<p> If this number n is at least 1, then  when a participant asks for
322
its score, he will see also the list of n participants having the best scores
323
(with their names if anonymity=yes, with numbers only if anonymity=no).<p>
324
These means do not take into account the manual scores, hence leave n=0 if there are manual
325
scores.
1384 czzmrn 326
<p>
2581 reyssat 327
Default=0/$wims_name_yes
1384 czzmrn 328
 
329
!exit
330
 
331
:end