Subversion Repositories wimsdev

!set sp2=$special_parm2

!bound sp2 within secure,supervisor,email,lang,level,limit,expiration,modtoolchg,\

        bgcolor,homepage,bgimg,theme,css,theme_icon,logo,lock,exolog,examlog,examshow,ent,option,\

        authtype,topscores,external_auth\

        default $

!if $sp2=$empty

 !exit

!endif

!goto $sp2

:secure

<b>Secure hosts</b>.

Consider the possibility under which there is a leak of your supervisor

password: when you connect to the class as supervisor within a class room, a

student may look over your shoulder, or even install a keyboard scanning

software to register what you type (including the password). Believe me: if

you keep real scores in your class, the supervisor password becomes a very

coveted object.

<p>

The consequence of such a leak may be catastrophic to the class: data may

be damaged, grades may be modified or you may even lose your supervisor

access if the student changes your password.

<p>

Definition of secure hosts puts an extra security layer: sensitive

manipulations such as class configuration, password change or score

modificatoin can only be

made from pre-defined <em>secure hosts</em>, when you are sure that students

have no access to these hosts. So even if a student steals your password,

there is not much (s)he can do to the class.

<p>

!read help/hosts.phtml

<p>

By the way, if you have to type your password in a very hostile environment

(for instance when you are working on computers used by students),

you should also consider using single-use passwords (see the password page).

!exit

:supervisor

 <b>Docente</b>. Inserire il proprio nome, come si vuole che appaia.

!exit

:email

 <b>Indirizzo email docente</b>.

 Informazioni importanti (codici di attivazioni, avvisi di termine,

 ecc.) vengono spediti all'indrizzo email del docente. È anche

 l'indrizzo a cui gli studenti possono rivolgersi. È quindi

 necessario dare un indirizzo funzionante, altrimenti si può correre

 il rischio di perdere letteralmente il controllo del corso.

!exit

:option

 <b>Opzioni avanzate</b>. Si possono utilizzare le seguenti parole chiave:

 <ul>

 <li><tt class="wims_code_words">showshexpire</tt> Per mostrare nella home page studenti le

  date di termine dei test di autovalutazione.</li>

  <li><tt class="wims_code_words">showexexpire</tt> Per mostrare nella home page studenti le

  date di termine dei temi d'esame.</li>

  <li><tt class="wims_code_words">showshweight</tt> Per mostrare nella home page studenti i

  pesi assegnati a ciascun compito nel calcolo automatico del punteggio.</li>

          </ul>

!exit

:lang

 Lingue disponibili: <ul>

 <li>ca (Catalano)

 </li><li>cn (Cinese gb)

 </li><li>de (Tedesco)

 </li><li>en (Inglese)

 </li><li>es (Spagnolo)

 </li><li>fr (Francese)

 </li><li>it (Italiano)

 </li><li>nl (Olandese)

 </li><li>si (Sloveno)

 </li><li>tw (Cinese big5)

</li></ul>

!exit

:level

 Significato dei livelli: <ul>

 <li>E1 - E6: Elementare, anni scolastici da 1 a 6.

 </li><li>H1 - H6: Secondario, anni scolastici da 1 a 6.

 </li><li>U1 - U5: Università, anni da 1 a 5.

 </li><li>G: Università, studi post-laurea.

 </li><li>R: Ricerca.

</li></ul>

<p>NOTA: come si vede i livelli <em>elementare</em> e <em>secondario</em> non

  combaciano esattamente con la struttura italiana.</p>

!exit

:limit

 <b>Numero massimo di iscritti</b>. Non sarà possibile l'iscrizione di

 nuovo studenti una volta che questo limite viene raggiunto. Si noti

 che questo sito impone un massimo di $wims_class_user_limit che non

 può essere superato.

!exit

:expiration

 <b>Data di termine del corso</b>. Il corso sarà automaticamente

 chiuso e archiviato quando si arriverà alla data indicata. Il docente

 può incrementare la durata del corso in qualsiasi momento, ma deve

 inserire una data che sia distante  meno di un anno dal momento in

 cui effettua la modifica.

<p>

 Se si ha necessità di estendere la durata del corso oltre un anno, si

 può fare a più riprese ad intervalli regolari, oppure si puo

 richiedere una

 <a href="mailto:$wims_site_manager?subject=Estensione della durata del corso

 demand">al gestore del sito</a>.

 <p>

 La data deve essere inserita in forma di una stringa di 8 numeri (<tt class="wims_code_words">yyyymmdd</tt>).

 Ad esempio: 20120523 significa 23 maggio 2012.

!exit

:bgcolor

 <b>Colore di sfondo delle pagine e dei menu</b>. La scelta dei colori può

 facilitare un veloce riconoscimento delle pagine del corso. I valori inseriti

 devono essere validi identificativi html di colori.

 <p>

 <b>Colore dei link nei menu e nelle tabelle</b>. I colori dei link devono

    essere adattati ai colori scelti per gli sfondi. Per gararntire una corretta

    visibilità delle pagine, se si seleziona questa opzione è utile

    esplicitare i colori di sfondo nell'opzione precedente (anche se si

    confermano i valori di default, che in linea di principio potrebbero

    essere modificati dal webmaster).

 <p>

 I valori di default sono quelli utilizzati nelle pagine generali del sito.

!exit

:homepage

 <b>Participant homepage</b>. You may put the address of a document block

 (such as <tt class="wims_fname">c1/main</tt>) to be the home page of the class for participants.

 The document itself need not be visible by participants.

 <p>

 Leave this field blanck if you want to use the standard home page.

 <p>

 All the links in the block should be defined using the command <tt class="wims_code_variable">\adm</tt>.

 You can use the following pre-defined variables:

 $table_header

 $table_tr<td><tt class="wims_code_variable">\firstname</tt></td><td>

Participant's first name

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\lastname</tt></td><td>

 Participant's last name

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\scores</tt></td><td>

Participants's score information. This is a list of

numbers. Each pair of numbers corresponds to one worksheet: percentage of points

and score quality.

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\newmsgcnt</tt></td><td>

 Numero di messaggi non letti contenuti nel forum del corso.

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\today</tt></td><td>

 Date of today, yyyymmdd.

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\sheets</tt></td><td>

Number of worksheets.

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\exams</tt></td><td>

 Numero di temi d'esame

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\expiration1</tt></td><td>expiration1</td></tr>

 Expiration date of worksheet 1, worksheet 2, exam 1, ..., yyyymmdd.

 $table_tr<td><tt class="wims_code_variable">\status1</tt></td><td>

 Status of worksheet 1, worksheet 2, exam 1, ... This is a non-negative integer; 0

 = under preparation, 1 = active, 2 = expired, 3 = hidden.

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\daymessage</tt></td><td>

message of the day for the class

 </td></tr>

 $table_tr<td><tt class="wims_code_variable">\userdaymessage</tt></td><td>

individual message of the day message for each participant.

 </td></tr>

 $table_end

!goto end

:bgimg

 Immagine di sfondo per le pagine del corso. Si può inserire un

 qualsiasi URL o utilizzare una delle seguenti immagini disponibili

 inserendone il nome come riportato qui di seguito:<p>

 <pre>$bgimgs</pre>

!exit

:theme

Il tema del corso.

!exit

:icon

Le icone che appaiono nei menu.

!exit

:css

The style sheet affects almost all pages of your class.

<p>

Choose <tt class="wims_code_words">----</tt> to disable style sheets.

<p>

Choose <tt class="wims_code_words">-theme-</tt> to use style sheets corresponding to your choice

of the theme.

<p>

Choose <tt class="wims_code_words">class</tt> to use the style sheet (css) defined by yourself

(see remark below).

<p>

<p>

<span class="wims_warning">Remark</span>. You may use your own style classes.

Please refer to css documents for the syntax.

If you define your own css, please test it with ALL possible browsers used by your

students, for possible incompatibilities!

<p>

Se volete cambiare solo in parte lo stile associato al tema in uso, scegliete

<tt class="wims_code_words">-theme-</tt>

e aggiungete le modifiche nel campo a destra. Possono essere

ridefiniti le seguenti class del css:

<pre>

!read  wimshome/public_html/bases/sys/css_classes

</pre>

!exit

:logo

The logo of the class is a graphics file that will be shown on the top

of the homepage of the class, both for supervisor and for participants.

This logo can be put either on the top left or the top right corner.

<p>

Choose <tt class="wims_code_words">none</tt> if you do not want a logo to be shown.

<p>

If you choose empty string or <tt class="wims_code_words">wims</tt>, the WIMS logo will be used.

<p>

Otherwise, you may put the URL of any valid graphics file here.

!exit

:lock

Connection lock helps to track users, and can help to avoid cheating. There are

8 lock levels. <ul>

<li>0: No connection lock is used.

</li><li>1: Cookie-tracking is activated. Connections without correct return

      cookie will be refused (attualmente NON disponibile).

</li><li>2: Secured (https) connection is required. Connections using usual

http request will be refused. You must check first whether the web server

on this WIMS site accepts https connections.

</li><li>3: Host address lock is activated. Participants will have no right to

change his/her host address within one session. There will be difficulties

when connections are made from dynamically allocated IP numbers.

</li><li>4: Cookie-tracking + https.

</li><li>5: Cookie-tracking + Host lock.

</li><li>6: All the above methods are activated.

</li><li>7: The class is closed. No participant connection accepted.

</li></ul> <p>

!exit

:exolog

Number of exercise registrations (limited to $wims_exolog_limit)

<p>

This is the maximal number of exercises for which each participant can

register the details.

<p>

These details allow participants and supervisor to review the action of

the exercise, and eventually make discussions.

<p>

The detail of an exercise is registered only if the participant gives the

order. When the maximal number is exceeded, the most ancient registrations

are erased.

!goto logs

:examlog

Number of exam registrations (limited to $wims_examlog_limit)

<p>

This is the maximal number of exam sessions whose details can be registered

for each participant.

<p>

These details allow participants and supervisor to review the action of the

exam, exercise by exercise.

<p>

The registration of exam sessions is automatic. When the maximal number is

exceeded, the most ancient registrations will be erased.

!exit

:logs

<p>

Put this number to 0 if you want to disable this registration.

<span class="wims_warning">$wims_name_warning</span>. The registration of exercises and exams may take a lot of

space! If you put these numbers too big, you class risks disk quota overflow.

!exit

:examshow

Dans le cas où cette option est mise sur <tt class="wims_code_words">$wims_name_no</tt>, les élèves ne peuvent

pas revoir les enregistrements d'examens. Seul l'enseignant le peut.

!exit

:authtype

!read help/it/authentification.phtml

!exit

:modtoolchg

<b>Account Modtool</b>:

Una volta che dalle pagine del corso entrate in Modtool, i dati di

accesso a Modtool vengono registrati. Questa opzione vi permette di

cancellare i dati registrati, ad esempio per accedere a Modtool come

utente diverso. Per accedere direttamente a Modtool utilizzate

il link <span class="wims_button disabled">Modtool</span> nella

home page del corso.

!exit

:ent

<b>Link esterni</b>:

è possibile inserire nel menu del corso link verso altri siti (ad esempio

verso altre piattaforme di e-learning) nella forma:

<pre>titolo_link,url_del_link</pre>

Per esempio,

<pre>Dokeos,http://-------</pre>

Si possono inserire più link, separati da ";".

!exit

:external_auth

<b>Indirizzo di una autenticazione esterna</b>: <i>Opzione per esperti che

permette di utilizzare autenticazioni esterne, per esempio CAS.</i>

Vous pouvez indiquer le lien sur une authentification externe à wims sous la forme

(cette adresse devra alors directement faire entrer dans la classe).

Vous devez mettre l'adresse complète en html:<tt class="wims_address">&lt;a href="http:...">Lien&lt;/a></tt>.

Il est par exemple possible de mettre l'adresse dans un "frame":

<tt class="wims_address">&lt;iframe https:...." width="100%" height="400">&lt;/iframe></tt>.

<p>Vous pouvez désactiver cette option tout en gardant le texte en cliquant sur <tt class="wims_code_words">$wims_name_no</tt>.

Si vous cochez <tt class="wims_code_words">$name_mix_auth</tt>, l'adresse html que vous avez donné apparaîtra mais

aussi l'authentification propre à wims comme une alternative.

Vous devez mettre un code html valide, il ne sera pas vérifié et

vous assurez que l'authentification externe permet d'entrer dans votre classe.

!exit

:topscores

<center><b>Best scores, number and anonymity</b></center>

<p> If this number n is at least 1, then  when a participant asks for

its score, he will see also the list of n participants having the best scores

(with their names if anonymity=yes, with numbers only if anonymity=no).<p>

These means do not take into account the manual scores, hence leave n=0 if there are manual

scores.

<p>

Default=0/$wims_name_yes

!exit

:end