Subversion Repositories wimsdev

Rev

Rev 17230 | Blame | Compare with Previous | Last modification | View Log | RSS feed

  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,\
  5.         option,optionex,authtype,authtype2,topscores,external_auth,cloning, sendmailteacher\
  6.         default $
  7.  
  8. !if $sp2=$empty
  9.  !exit
  10. !endif
  11.  
  12. !goto $sp2
  13.  
  14. :secure
  15. <b>Secure hosts</b>.
  16. <p>
  17. Consider the possibility under which there is a leak of your supervisor
  18. password: when you connect to the class as supervisor within a class room, a
  19. student may look over your shoulder, or even install a keyboard scanning
  20. software to register what you type (including the password). Believe me: if
  21. you keep real scores in your class, the supervisor password becomes a very
  22. coveted object.
  23. </p><p>
  24. The consequence of such a leak may be catastrophic to the class: data may
  25. be damaged, grades may be modified or you may even lose your supervisor
  26. access if the student changes your password.
  27. </p><p>
  28. Definition of secure hosts puts an extra security layer: sensitive
  29. manipulations such as class configuration, password change or score
  30. modificatoin can only be
  31. made from pre-defined <em>secure hosts</em>, when you are sure that students
  32. have no access to these hosts. So even if a student steals your password,
  33. there is not much (s)he can do to the class.
  34. </p><p>
  35. !read help/hosts.phtml
  36. </p><p>
  37. By the way, if you have to type your password in a very hostile environment
  38. (for instance when you are working on computers used by students),
  39. you should also consider using single-use passwords (see the password page).
  40. </p>
  41. !exit
  42.  
  43. :supervisor
  44.  <b>Supervisor name</b>. Enter here your name, in the way you like.
  45. !exit
  46.  
  47. :email
  48.  <b>Supervisor email</b>.
  49.  Important notifications (secret codes, expiration notice, etc.) will be sent
  50.  to this address. This is also where student will send you messages. So you
  51.  MUST give your active email address, otherwise you may even lose control of
  52.  your class.
  53. !exit
  54.  
  55. :option
  56.  <b>Option words of the class</b>. The following words can be used here:
  57.  <ul>
  58.  <li><span class="tt wims_code_words">showshexpire</span> Show the expiration date of worksheets on the
  59.   home page of participants.
  60.  </li><li><span class="tt wims_code_words">showshweight</span> Show worksheet weight on the
  61.   home page of participants.
  62.  </li></ul>
  63. !exit
  64.  
  65. :optionex
  66.  <b>Option words of the class</b>. The following words can be used here:
  67.  <ul>
  68.  <li><span class="tt wims_code_words">showexexpire</span> Show the expiration date of exam sheets on the
  69.   home page of participants.
  70.  </li><li><span class="tt wims_code_words">exrandomlist</span> List exercises in a random order in the exam page for
  71.  participants (the exercises keep their given number in all the pages for the supervisor).
  72.  </li></ul>
  73. !exit
  74.  
  75. :lang
  76. You may choose the class language among those supported
  77. by your wims site. Your class will then appear in the corresponding list of classes
  78. of the student's and teacher's areas.<br>
  79. Abbreviations used : <ul>
  80.  <li>ca (Catalan)
  81.  </li><li>cn (Chinese gb)
  82.  </li><li>de (German)
  83.  </li><li>en (English)
  84.  </li><li>es (Spanish)
  85.  </li><li>fr (French)
  86.  </li><li>it (Italian)
  87.  </li><li>nl (Dutch)
  88.  </li><li>si (Slovenian)
  89.  </li><li>tw (Chinese big5)
  90. </li></ul>
  91. !exit
  92.  
  93. :level
  94. !read help/$lang/level.phtml
  95. !exit
  96.  
  97. :limit
  98.  <b>Participant number limit</b>. Registration of new participants will be
  99. refused if this limit is reached. This site has defined a hard limit
  100. ($wims_class_user_limit) that cannot be exceeded.
  101.  <br>
  102.  L'ajout de notes manuelles ne peut être effectuée pour les classes de plus de
  103. !defof MAX_USERFORGRADES in wimshome/public_html/bases/sys/define.conf
  104. participant.
  105. !exit
  106.  
  107. :expiration
  108. <b>Expiration date</b>.
  109. <p>
  110. The class will be closed when it reaches the
  111. expiration date. You may extend this date at any moment, but extensions
  112. exceeding one year from the actual date will be refused.
  113. </p><p>
  114. If you want to extend this date to more than one year, you may do it
  115. in several times at regular intervals, or
  116. <a href="mailto:$wims_site_manager?subject=Virtual class extension
  117. demand">ask the webmaster</a> to do it for you.
  118. </p>
  119. !exit
  120.  
  121. :bgcolor
  122. <b>Page background color and menu color</b>.
  123. <p>These two colors can help you
  124. quickly recognize pages within your virtual class. The values of these
  125. fields must be valid html color names.
  126. </p><p>
  127. <b>Link color in menus and tables</b>. You may adapt the link color to the
  128.    menu background color. If you choose this option, it is wise to fill in explicitely
  129.    the table background color even if it is the same as the default one (in case the
  130. default would change).
  131. </p><p>
  132. Default values are those defined for the general site pages.
  133. </p>
  134. !exit
  135.  
  136. :homepage
  137. <b>Participant homepage</b>.
  138. <p>
  139. You may put the address of a document block
  140. (such as <span class="tt wims_fname">c1/main</span>) to be the home page of the class for participants.
  141. The document itself need not be visible by participants.
  142. </p><p>
  143. Leave this field blanck if you want to use the standard home page.
  144. </p><p>
  145. All the links in the block should be defined using the command <span class="tt wims_code_variable">\adm</span>.
  146. You can use the following pre-defined variables:
  147. </p>
  148. $table_header
  149. $table_tr<td class="tt wims_code_variable">\firstname</td><td>
  150. Participant's first name
  151.  </td></tr>
  152.  $table_tr<td class="tt wims_code_variable">\lastname</td><td>
  153.  Participant's last name
  154. </td></tr>
  155. $table_tr<td class="tt wims_code_variable">\scores</td><td>
  156. Participants's score information. This is a list of
  157. numbers. Each pair of numbers corresponds to one worksheet: percentage of points
  158. and score quality.
  159.  </td></tr>
  160.  $table_tr<td class="tt wims_code_variable">\newmsgcnt</td><td>
  161. Unread messages in the class forum.
  162.  </td></tr>
  163.  $table_tr<td class="tt wims_code_variable">\today</td><td>
  164.  Date of today, yyyymmdd.
  165.  </td></tr>
  166.  $table_tr<td class="tt wims_code_variable">\sheets</td><td>
  167. Number of worksheets.
  168.  </td></tr>
  169.  $table_tr<td class="tt wims_code_variable">\exams</td><td>
  170.  Number of exam sheets
  171.  </td></tr>
  172.  $table_tr<td class="tt wims_code_variable">\expiration1</td><td>expiration1</td></tr>
  173.  Expiration date of worksheet 1, worksheet 2, exam 1, ..., yyyymmdd.
  174.  $table_tr<td class="tt wims_code_variable">\status1</td><td>
  175.  Status of worksheet 1, worksheet 2, exam 1, ... This is a non-negative integer; 0
  176.  = under preparation, 1 = active, 2 = expired, 3 = hidden.
  177.  </td></tr>
  178.  $table_tr<td class="tt wims_code_variable">\daymessage></td><td>
  179. message of the day for the class
  180.  </td></tr>
  181.  $table_tr<td class="tt wims_code_variable">\userdaymessage></td><td>
  182. individual message of the day message for each participant.
  183.  </td></tr>
  184.  $table_end
  185. !goto end
  186.  
  187. :bgimg
  188.  Background image file (tile) for pages in the class. You may use any valid URL.
  189.  There are also prepared background image files which you can use without
  190.  adding any address prefix:
  191.  <pre>$bgimgs</pre>
  192. !exit
  193.  
  194. :theme
  195. The style theme of your class.
  196. !exit
  197.  
  198. :theme_icon
  199. The icons in the menu
  200. !exit
  201.  
  202. :css
  203. <p>
  204. The style sheet affects almost all pages of your class.
  205. </p><p>
  206. Choose <span class="tt wims_code_words">----</span> to disable style sheets.
  207. </p><p>
  208. Choose <span class="tt wims_code_words">-theme-</span> to use style sheets corresponding to your choice
  209. of the theme.
  210. </p><p>
  211. Choose <span class="tt wims_code_words">class</span> to use the style sheet (css) defined by yourself
  212. (see remark below).
  213. </p><p>
  214. The other choices correspond to pre-defined styles on this WIMS site.
  215.  
  216. </p><p>
  217. <span class="wims_warning">Remark</span>. You may use your own style classes.
  218. Please refer to css documents for the syntax.
  219. If you define your own css, please test it with ALL possible browsers used by your
  220. students, for possible incompatibilities!
  221. </p><p>
  222. Si vous désirez ne changer que quelques styles par rapport au thème, choisisissez
  223. <span class="tt wims_code_words">-theme-</span>
  224.  et ajouter quelques nouvelles définitions dans le champ à droite.
  225.  The following classes, changing the style
  226. of your class, may be redefined:
  227. </p>
  228. <pre>
  229. !read  wimshome/public_html/bases/sys/css_classes
  230. </pre>
  231. !exit
  232.  
  233. :logo
  234. <p>
  235. The logo of the class is a graphics file that will be shown on the top
  236. of the homepage of the class, both for supervisor and for participants.
  237. This logo can be put either on the top left or the top right corner.
  238. </p><p>
  239. Choose <span class="tt wims_code_words">none</span> if you do not want a logo to be shown.
  240. </p><p>
  241. If you choose empty string or <span class="tt wims_code_words">wims</span>, the WIMS logo will be used.
  242. </p><p>
  243. Otherwise, you may put the URL of any valid graphics file here.
  244. </p>
  245. !exit
  246.  
  247. :lock
  248. Connection lock helps to track users, and can help to avoid cheating. There are
  249. 8 lock levels. <ul>
  250. <li>0: No connection lock is used.
  251.  
  252. </li><li>1: Cookie-tracking is activated. Connections without correct return
  253.  cookie will be refused.
  254.  
  255. </li><li>2: Secured (https) connection is required. Connections using usual
  256. http request will be refused. You must check first whether the web server
  257. on this WIMS site accepts https connections.
  258.  
  259. </li><li>3: Host address lock is activated. Participants will have no right to
  260. change his/her host address within one session. There will be difficulties
  261. when connections are made from dynamically allocated IP numbers.
  262.  
  263. </li><li>4: Cookie-tracking + https.
  264. </li><li>5: Cookie-tracking + Host lock.
  265. </li><li>6: All the above methods are activated.
  266. </li><li>7: The class is closed. No participant connection accepted.
  267. </li></ul>
  268. !exit
  269.  
  270. :exolog
  271. <p>
  272. Number of exercise registrations (limited to $wims_exolog_limit)
  273. </p><p>
  274. This is the maximum number of exercises for which each participant can
  275. register the details.
  276. </p><p>
  277. Such registered details allow participants and supervisors to keep record of how the
  278. exercise was done and eventually discuss mistakes and errors made by the participant.
  279. </p><p>
  280. The detail of an exercise is registered only if the participant decided to do it.
  281. When the maximum number allowed is exceeded, the oldest registrations
  282. will be erased.
  283. </p>
  284. !goto logs
  285.  
  286. :examlog
  287. Number of exam registrations (limited to $wims_examlog_limit)
  288. <p>
  289. This is the maximal number of exam sessions whose details can be registered
  290. for each participant.
  291. </p><p>
  292. These details allow participants and supervisor to review the action of the
  293. exam, exercise by exercise.
  294. </p><p>
  295. The registration of exam sessions is automatic. When the maximal number is
  296. exceeded, the most ancient registrations will be erased.
  297. </p>
  298. !exit
  299.  
  300. :logs
  301. <p>
  302. set this number to 0 if you want to disable registration.
  303. </p><p>
  304. <span class="wims_warning">$wims_name_warning</span>: the registration of exercises and exams may take a lot of
  305. space! If you set these numbers too high, you class risks disk quota overflow.
  306. </p>
  307. !exit
  308.  
  309. :examshow
  310. Dans le cas où cette option est mise sur <span class="tt wims_code_words">$wims_name_no</span>, les élèves ne peuvent
  311. pas revoir les enregistrements d'examens. Seul l'enseignant le peut.
  312. !exit
  313.  
  314. :authtype
  315. !read help/$lang/authentification.phtml
  316. !exit
  317.  
  318. :authtype2
  319. <p>
  320. <span class="tt wims_code_words">class_connections</span>:
  321. If you use the standard <span class="tt">index.php</span> the variable <span class="tt">class_connections</span> should contain the value <span class="tt">+phpidp/available+</span>. Multiple values (separated by spaces) can be inserted. For a fine tuning of this variable you should refer to the <span class="bold">$wims_name_config_otherserver</span> section.
  322. </p>
  323. !exit
  324.  
  325. :modtoolchg
  326. <b>Modtool Account</b> :
  327. Once you have entered your Modtool acount via a virtual class, your Modtool account login
  328. is saved on the the class. This registration can be erased if you want to use another Modtool account.
  329. Next, please click on the link <span class="tt">Modtool</span> on the homepage.
  330.  
  331. !exit
  332.  
  333. :ent
  334. <b>Links to another plateform</b> :
  335. You may add a link to another plateform :
  336. <pre> link_title,link_adress</pre>
  337. For example,
  338. <pre>Dokeos,http://-------</pre>
  339. If you need more than one link, they must be seperated by ";".
  340.  
  341. !exit
  342.  
  343. :external_auth
  344. <b>Adresse dans le cas d'une authentification externe</b> : <i>Ceci est pour experts
  345. et permet d'utiliser par exemple une authentification CAS. </i>
  346. Vous pouvez indiquer le lien sur une authentification externe à wims sous la forme
  347. (cette adresse devra alors directement faire entrer dans la classe).
  348. Vous devez mettre l'adresse complète en html :<span class="tt wims_address">&lt;a href="http:...">Lien&lt;/a></span>.
  349. </p><p>
  350. Il est par exemple possible de mettre l'adresse dans un "frame" :
  351. <span class="tt wims_address">&lt;iframe https:...." width="100%" height="400">&lt;/iframe></span>.
  352.  
  353. <p>Vous pouvez désactiver cette option tout en gardant le texte en cliquant sur <span class="tt wims_code_words">$wims_name_no</span>
  354. Si vous cochez <span class="tt wims_code_words">$name_mix_auth</span>, l'adresse html que vous avez donné apparaîtra mais
  355. aussi l'authentification propre à wims comme une alternative.
  356. </p><p>
  357. Vous devez mettre un code html valide, il ne sera pas vérifié et
  358. vous assurer que l'authentification externe permet d'entrer dans votre classe.
  359. </p>
  360. !exit
  361.  
  362. :topscores
  363. <p class="wimscenter" style="font-weight:bold;">Best scores, number and anonymity</p>
  364. <p> If this number n is at least 1, then  when a participant asks for
  365. its score, he will see also the list of n participants having the best scores
  366. (with their names if anonymity=yes, with numbers only if anonymity=no).
  367. </p><p>
  368. These means do not take into account the manual scores, hence leave n=0 if there are manual
  369. scores.
  370. </p><p>
  371. Default=0/$wims_name_yes
  372. </p>
  373. !exit
  374.  
  375. :cloning
  376. <p>
  377. Vous pouvez autoriser la duplication de votre classe par d'autres enseignants.
  378. Votre classe sera alors référencée comme pouvant être dupliquée.
  379. Seuls les administrateurs disposant du mot de passe de duplication que vous définissez
  380. pourront copier le contenu pédagogique de votre classe (documents, feuilles, examens, séquences).
  381. Les comptes des utilisateurs (participants ou administrateurs) ne sont pas concernés par la duplication.
  382. </p><p>
  383. Une classe dupliquée fonctionne indépendamment de la classe modèle.
  384. </p>
  385. !exit
  386.  
  387. :end
  388.