Subversion Repositories wimsdev

Rev

Rev 3990 | Rev 4264 | 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,\
4004 bpr 4
        bgcolor,homepage,bgimg,theme,css,theme_icon,logo,lock,exolog,examlog,examshow,ent,option,authtype,topscores\
1384 czzmrn 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
4004 bpr 23
be damaged, grades may be modified or you may even lose your supervisor
1384 czzmrn 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
3922 bpr 36
(for instance when you are working on computers used by students),
37
you should also consider using single-use passwords (see the password page).
1384 czzmrn 38
!exit
39
 
40
:supervisor
2810 czzmrn 41
 <b>Docente</b>. Inserire il proprio nome, come si vuole che appaia.
1384 czzmrn 42
!exit
43
 
44
:email
2810 czzmrn 45
 <b>Indirizzo email docente</b>.
46
 Informazioni importanti (codici di attivazioni, avvisi di termine,
47
 ecc.) vengono spediti all'indrizzo email del docente. &Egrave; anche
48
 l'indrizzo a cui gli studenti possono rivolgersi. &Egrave; quindi
49
 necessario dare un indirizzo funzionante, altrimenti si può correre
50
 il rischio di perdere letteralmente il controllo del corso.
1384 czzmrn 51
!exit
52
 
53
:option
2810 czzmrn 54
 <b>Opzioni avanzate</b>. Si possono utilizzare le seguenti parole chiave:
1384 czzmrn 55
 <ul>
4004 bpr 56
 <li><tt class="wims_code_words">showshexpire</tt> Per mostrare nella home page studenti le
2810 czzmrn 57
  date di termine dei test di autovalutazione.</li>
4004 bpr 58
  <li><tt class="wims_code_words">showexexpire</tt> Per mostrare nella home page studenti le
2810 czzmrn 59
  date di termine dei temi d'esame.</li>
4004 bpr 60
  <li><tt class="wims_code_words">showshweight</tt> Per mostrare nella home page studenti i
2810 czzmrn 61
  pesi assegnati a ciascun compito nel calcolo del punteggio.
62
  compito nel calcolo automatico.</li>
63
          </ul>
1384 czzmrn 64
!exit
65
 
66
:lang
2711 czzmrn 67
 Lingue disponibili: <ul>
1384 czzmrn 68
 <li>cn (Cinese gb)
3569 bpr 69
 </li><li>de (Tedesco)
70
 </li><li>en (Inglese)
71
 </li><li>es (Spagnolo)
72
 </li><li>fr (Francese)
73
 </li><li>it (Italiano)
74
 </li><li>nl (Olandese)
75
 </li><li>si (Sloveno)
76
 </li><li>tw (Cinese big5)
77
</li></ul>
1384 czzmrn 78
!exit
79
 
80
:level
2810 czzmrn 81
 Significato dei livelli: <ul>
82
 <li>E1 - E6: Elementare, anni scolastici da 1 a 6.
3569 bpr 83
 </li><li>H1 - H6: Secondario, anni scolastici da 1 a 6.
84
 </li><li>U1 - U5: Università, anni da 1 a 5.
85
 </li><li>G: Università, studi post-laurea.
86
 </li><li>R: Ricerca.
87
</li></ul>
2810 czzmrn 88
<p>NOTA: come si vede i livelli <em>elementare</em> e <em>secondario</em> non
89
  combaciano esattamente con la convenzione italiana.</p>
1384 czzmrn 90
!exit
91
 
92
:limit
2810 czzmrn 93
 <b>Numero massimo di iscritti</b>. Non sarà possibile l'iscrizione di
94
 nuovo studenti una volta che questo limite viene raggiunto. Si noti
95
 che questo sito impone un massimo di $wims_class_user_limit che non
96
 può essere superato.
1384 czzmrn 97
!exit
98
 
99
:expiration
2810 czzmrn 100
 <b>Data di termine del corso</b>. Il corso sarà automaticamente
101
 chiuso e archiviato quando si arriverà alla data indicata. Il docente
102
 può incrementare la durata del corso in qualsiasi momento, ma deve
103
 inserire una data che sia distante  meno di un anno dal momento in
104
 cui effettua la modifica.
1384 czzmrn 105
<p>
2810 czzmrn 106
 Se si ha necessità di estendere la durata del corso oltre un anno, si
107
 può fare a più riprese ad intervalli regolari, oppure si puo
108
 richiedere una
109
 <a href="mailto:$wims_site_manager?subject=Estensione della durata del corso
110
 demand">al gestore del sito</a>.
1384 czzmrn 111
 <p>
2810 czzmrn 112
 La data deve essere inserita in forma di una stringa di 8 numeri (yyyymmdd).
113
 Ad esempio: 20120523 significa 23 maggio 2012.
1384 czzmrn 114
!exit
115
 
116
:bgcolor
117
 <b>Page background color and menu color</b>. These two colors can help you
118
 quickly recognize pages within your virtual class. The values of these
119
 fields must be valid html color names.
120
 <p>
2581 reyssat 121
 <b>Link color in menus and tables</b>. You may adapt the link color to the
122
    menu background color. If you choose this option, it is wise to fill in explicitely
123
    the table background color even if it is the same as the default one (in case the
124
default would change).
125
 <p>
126
 Default values are those defined for the general site pages.
1384 czzmrn 127
!exit
128
 
129
:homepage
130
 <b>Participant homepage</b>. You may put the address of a document block
4004 bpr 131
 (such as <tt class="wims_fname">c1/main</tt>) to be the home page of the class for participants.
3922 bpr 132
 The document itself need not be visible by participants.
1384 czzmrn 133
 <p>
134
 Leave this field blanck if you want to use the standard home page.
135
 <p>
4004 bpr 136
 All the links in the block should be defined using the command <tt class="wims_code_variable">\adm</tt>.
137
 You can use the following pre-defined variables:
138
 $table_header
139
 $table_tr<td><tt class="wims_code_variable">\firstname</tt></td><td>
140
Participant's first name
141
 </td></tr>
142
 $table_tr<td><tt class="wims_code_variable">\lastname</tt></td><td>
143
 Participant's last name
144
 </td></tr>
145
 $table_tr<td><tt class="wims_code_variable">\scores</tt></td><td>
146
Participants's score information. This is a list of
3921 bpr 147
numbers. Each pair of numbers corresponds to one worksheet: percentage of points
1384 czzmrn 148
and score quality.
4004 bpr 149
 </td></tr>
150
 $table_tr<td><tt class="wims_code_variable">\newmsgcnt</tt></td><td>
151
 newmsgcnt
152
 </td></tr>
153
 $table_tr<td><tt class="wims_code_variable">\today</tt></td><td>
154
 Date of today, yyyymmdd.
155
 </td></tr>
156
 $table_tr<td><tt class="wims_code_variable">\sheets</tt></td><td>
157
Number of worksheets.
158
 </td></tr>
159
 $table_tr<td><tt class="wims_code_variable">\exams</tt></td><td>
160
 Number of exam sheets
161
 </td></tr>
162
 $table_tr<td><tt class="wims_code_variable">\expiration1</tt></td><td>expiration1</td></tr>
3921 bpr 163
 Expiration date of worksheet 1, worksheet 2, exam 1, ..., yyyymmdd.
4004 bpr 164
 $table_tr<td><tt class="wims_code_variable">\status1</tt></td><td>
3921 bpr 165
 Status of worksheet 1, worksheet 2, exam 1, ... This is a non-negative integer; 0
4004 bpr 166
 = under preparation, 1 = active, 2 = expired, 3 = hidden.
167
 </td></tr>
168
 $table_tr<td><tt class="wims_code_variable">\daymessage</tt></td><td>
169
message of the day for the class
170
 </td></tr>
171
 $table_tr<td><tt class="wims_code_variable">\userdaymessage</tt></td><td>
172
individual message of the day message for each participant.
173
 </td></tr>
174
 $table_end
1384 czzmrn 175
!goto end
176
 
177
:bgimg
2810 czzmrn 178
 Immagine di sfondo per le pagine del corso. Si può inserire un
179
 qualsiasi URL o utilizzare una delle seguenti immagini disponibili
180
 inserendone il nome come riportato qui di seguito:<p>
4004 bpr 181
 <pre>$bgimgs</pre>
1384 czzmrn 182
!exit
183
 
184
:theme
2810 czzmrn 185
Il tema del corso.
1384 czzmrn 186
!exit
187
 
2810 czzmrn 188
:icon
189
Le icone che appaiono nei menu.
1384 czzmrn 190
!exit
191
 
192
:css
193
The style sheet affects almost all pages of your class.
194
<p>
4004 bpr 195
Choose <tt class="wims_code_words">----</tt> to disable style sheets.
1384 czzmrn 196
<p>
4004 bpr 197
Choose <tt class="wims_code_words">-theme-</tt> to use style sheets corresponding to your choice
1384 czzmrn 198
of the theme.
199
<p>
4004 bpr 200
Choose <tt class="wims_code_words">class</tt> to use the style sheet (css) defined by yourself
2711 czzmrn 201
(see remark below).
202
<p>
203
The other choices correspond to pre-defined styles on this WIMS site.
1384 czzmrn 204
 
2711 czzmrn 205
<p><b>Remark</b>. You may use your own style classes.
206
Please refer to css documents for the syntax.
207
If you define your own css, please test it with ALL possible browsers used by your
1384 czzmrn 208
students, for possible incompatibilities!
2711 czzmrn 209
<p>
210
The following classes, changing the style
211
of your class, may be redefined:
1384 czzmrn 212
<pre>
213
!read  wimshome/public_html/bases/sys/css_classes
214
</pre>
215
!exit
216
 
217
:logo
218
The logo of the class is a graphics file that will be shown on the top
219
of the homepage of the class, both for supervisor and for participants.
220
This logo can be put either on the top left or the top right corner.
221
<p>
4004 bpr 222
Choose <tt class="wims_code_words">none</tt> if you do not want a logo to be shown.
1384 czzmrn 223
<p>
4004 bpr 224
If you choose empty string or <tt class="wims_code_words">wims</tt>, the WIMS logo will be used.
1384 czzmrn 225
<p>
226
Otherwise, you may put the URL of any valid graphics file here.
227
!exit
228
 
229
:lock
3919 bpr 230
Connection lock helps to track users, and can help to avoid cheating. There are
1384 czzmrn 231
8 lock levels. <ul>
3569 bpr 232
<li>0: No connection lock is used.
1384 czzmrn 233
 
3569 bpr 234
</li><li>1: Cookie-tracking is activated. Connections without correct return
1384 czzmrn 235
 cookie will be refused.
236
 
3569 bpr 237
</li><li>2: Secured (https) connection is required. Connections using usual
1384 czzmrn 238
http request will be refused. You must check first whether the web server
239
on this WIMS site accepts https connections.
240
 
3569 bpr 241
</li><li>3: Host address lock is activated. Participants will have no right to
1384 czzmrn 242
change his/her host address within one session. There will be difficulties
243
when connections are made from dynamically allocated IP numbers.
244
 
3569 bpr 245
</li><li>4: Cookie-tracking + https.
246
</li><li>5: Cookie-tracking + Host lock.
247
</li><li>6: All the above methods are activated.
248
</li><li>7: The class is closed. No participant connection accepted.
249
</li></ul> <p>
1384 czzmrn 250
!exit
251
 
252
:exolog
253
Number of exercise registrations (limited to $wims_exolog_limit)
254
<p>
255
This is the maximal number of exercises for which each participant can
256
register the details.
257
<p>
258
These details allow participants and supervisor to review the action of
259
the exercise, and eventually make discussions.
260
<p>
261
The detail of an exercise is registered only if the participant gives the
262
order. When the maximal number is exceeded, the most ancient registrations
263
are erased.
264
!goto logs
265
 
266
:examlog
267
Number of exam registrations (limited to $wims_examlog_limit)
268
<p>
269
This is the maximal number of exam sessions whose details can be registered
270
for each participant.
271
<p>
272
These details allow participants and supervisor to review the action of the
273
exam, exercise by exercise.
274
<p>
275
The registration of exam sessions is automatic. When the maximal number is
276
exceeded, the most ancient registrations will be erased.
277
!exit
278
 
279
:logs
280
<p>
281
Put this number to 0 if you want to disable this registration.
4004 bpr 282
<span class="wims_warning">$wims_name_warning</span>. The registration of exercises and exams may take a lot of
1384 czzmrn 283
space! If you put these numbers too big, you class risks disk quota overflow.
284
!exit
285
 
286
:examshow
4004 bpr 287
Dans le cas où cette option est mise sur <tt class="wims_code_words">$wims_name_no</tt>, les élèves ne peuvent
1384 czzmrn 288
pas revoir les enregistrements d'examens. Seul l'enseignant le peut.
289
!exit
290
 
291
:authtype
292
<b>Type d'authentification</b> :
293
Vous pouvez utiliser une authentification par ldap ou l'authentification par wims.
294
Dans le cas où l'authentification par ldap ne réussit pas, l'authentification
295
par la procédure interne de wims est essayée.
296
<p>
297
Exemple de paramètres pour une authentification ldap :
298
<pre>
299
ldap_host=ldap.u-psud.fr
300
ldap_port=389
301
ldap_version=3
302
ldap_base=ou=people,dc=u-psud,dc=fr
303
ldap_branch=ou=people,dc=u-psud,dc=fr
304
ldap_uid=uid
305
ldap_login=supannAliasLogin
306
</pre>
307
!exit
308
 
309
:modtoolchg
310
<b>Compte Modtool</b> :
311
Une fois que vous êtes entré dans Modtool par la classe, votre compte Modtool
312
est enregistré. Vous pouvez ici effacer cet enregistrement si vous avez besoin
3990 bpr 313
d'utiliser un autre compte Modtool. Vous devez ensuite passer par le lien <span class="wims_button disabled">Modtool</span>
1384 czzmrn 314
sur la page d'accueil.
315
 
316
!exit
317
 
318
:ent
2808 czzmrn 319
<b>Link esterni</b>:
320
è possibile inserire nel menu del corso link verso altri siti (ad esempio
321
verso altre piattaforme di e-learning) nella forma:
322
<pre>titolo_link,url_del_link</pre>
323
Per esempio,
2711 czzmrn 324
<pre>Dokeos,http://-------</pre>
2808 czzmrn 325
Si possono inserire più link, separati da ";".
1384 czzmrn 326
 
327
!exit
328
 
2756 bpr 329
:external_auth
2808 czzmrn 330
<b>Indirzzo di una autenticazione esterna</b>: <i>Ceci est pour experts
2756 bpr 331
et permet d'utiliser par exemple une authentification CAS. </i>
332
Vous pouvez indiquer le lien sur une authentification externe à wims sous la forme
333
(cette adresse devra alors directement faire entrer dans la classe).
4004 bpr 334
Vous devez mettre l'adresse complète en html :<tt class="wims_address">&lt;a href="http:...">Lien&lt;/a></tt>.
2756 bpr 335
 
336
Il est par exemple possible de mettre l'adresse dans un "frame" :
4004 bpr 337
<tt class="wims_address">&lt;iframe https:...." width="100%" height="400">&lt;/iframe></tt>.
2756 bpr 338
 
3990 bpr 339
<p>Vous pouvez désactiver cette option tout en gardant le texte en cliquant sur <span class="wims_button disabled">$wims_name_no</span>.
4004 bpr 340
Si vous cochez <tt class="wims_code_words">$name_mix_auth</tt>, l'adresse html que vous avez donné apparaîtra mais
2756 bpr 341
aussi l'authentification propre à wims comme une alternative.
342
 
343
Vous devez mettre un code html valide, il ne sera pas vérifié et
344
vous assurez que l'authentification externe permet d'entrer dans votre classe.
345
 
346
!exit
347
 
1384 czzmrn 348
:topscores
2581 reyssat 349
<center><b>Best scores, number and anonymity</b></center>
350
<p> If this number n is at least 1, then  when a participant asks for
351
its score, he will see also the list of n participants having the best scores
352
(with their names if anonymity=yes, with numbers only if anonymity=no).<p>
353
These means do not take into account the manual scores, hence leave n=0 if there are manual
354
scores.
1384 czzmrn 355
<p>
2581 reyssat 356
Default=0/$wims_name_yes
1384 czzmrn 357
 
358
!exit
359
 
360
:end