Luigi Micco homepage

vbPDF, vbPDFParser, vbQRCode, vbDataMatrix, vbPDF417, vbAztec, clsPDFCreator, vbGCalendar

Strumenti Utente

Strumenti Sito


Barra laterale

I miei progetti

Donazioni

Se quello che hai trovato in queste pagine ti e' stato in qualche modo d'aiuto, puoi contribuire con una donazione!

Donazioni

oppure puoi cliccare su uno dei banner presenti qui.

dokuwiki:quiz

  • Esporta in OpenOffice
  • Esporta in PDF
  • Agg./Rimuovi selezione
  • Strumenti:

Quiz plugin

Lets you add quizzes and test a wiki page.

Download and Installation

Download and install the plugin using the DokuWiki Plugin Manager using the URL given above. Refer to :DokuWiki Plugins on how to install plugins manually.

To see a demo online, visit here.

Note: If you do install manually the directory must be named quiz.

Version history

  • 2010-12-07 (current)
    • Removed all know bugs at this time (thanks to many users !!)
  • 2010-09-17
    • Some little bugs on language files (English and French)
  • 2010-09-14
    • Rewritten Javascript/Ajax core
    • Rewritten part of code to avoid conflit with other plugins
  • 2010-09-11
    • Bug removed on javascript
    • Add French language
  • 2010-08-26
    • First public release.
    • Italian and English language

Syntax and usage

Use this plugin to add a quiz to a wiki page. The syntax looks like this:

{{quiz>quiz_page&param1&param2&...&paramN}}

where paramX can be one or more from follow list and quiz_page is the ID of a wiki page (like this) that contain the quiz:

learning show correct answers at the end of quiz optional
showintro show quiz intro on every question optional
rndquest shuffle random of question's order optional
rndchoice shuffle random of choice's order on every question optional
highscores show a button to view the 10 best scores optional

Syntax of quiz page

To make a quiz, create a page, with a syntax looks like follow.

You can define a title (using Headline Level 1 ====== Title ======) and a intro for whole quiz

====== Title of quiz ======
Quiz intro text. Quiz intro text. Quiz intro text. Quiz intro text. Quiz 
intro text. Quiz intro text. Quiz intro text. Quiz intro text. Quiz intro 
text. Quiz intro text

For every quiz, You can define one or more questions (using bullet *):

    * Test of question

For every question, one or more optional choices (using bullet -). If no choices is defined, the question will be a free answer (text) type

      - choice 1
      - ....
      - choice N

one or more correct answers (using second level bullet and brackets, delimited with | * [a1|a2|...|aN]). If two or more correct answers is defined, the question will be multi-answers (checkbox) type. If only one is defined, the question will be single answer (radio) type.

      * [1|2]   

a optional score (using second level bullet and parenthesis * (N))

      * (5) 

and a optional explanation

      * explanation 

For every quiz, you can define one or more scores explanation (using Headline Level 2 ===== minN-maxN =====), for total score in the range [minN,maxN]. If defined, will be displayed at the end of the test, along with correct answers.

===== 1-20 =====
Explanation for score in the range [1,10]

For intro, questions, choices, explanation and scores explanation it's possibile to use wiki syntax.

Example

====== Quiz title ======
Quiz intro text. Quiz intro text. Quiz intro text. Quiz intro text. Quiz 
intro text. Quiz intro text. Quiz intro text. Quiz intro text. Quiz intro 
text. Quiz intro text. 

Quiz intro text. Quiz intro text. Quiz intro text. Quiz intro text. Quiz 
intro text. Quiz intro text. Quiz intro text. Quiz intro text. Quiz intro 
text. Quiz intro text. 


  * Question 1 description (multi answers - checkbox)
    - choice 1     <-- choice 1
    - ....
    - choice N     <-- choice N
    * [1|2]        <-- right answers (one or more, | delimited) 
    * (10)         <-- score
    * explanation  <-- optional

  * Question 2 description (single answer - radio)
    - choice 1     <-- choice 1
    - ....
    - choice M     <-- choice M
    * [2]          <-- right answer (from 1 to M)
    * (5)          <-- score
    * explanation  <-- optional

  * Question 3 description (single answer - text)
    * [Pippo]      <-- right answer
    * (20)         <-- score
    * explanation  <-- optional

===== min1-max1 ===== <-- optional
Explanation for score in the range [min1,max1]

===== min2-max2 ===== <-- optional
Explanation for score in the rangen [min2,max2]

....

===== minN-maxN ===== <-- optional
Explanation for score in the range [minN,maxN]

Other

The quiz plugin makes use of background AJAX, so you don't have to reload the whole page each time on every question.

The quiz title is converted to a md5sum. This is used as the filename in data/meta to store the highscores: md5sum.quiz - so all quiz in the whole wiki must be unique. As a result you can move your quiz around and the quiz data is accessible. If you remove the quiz you must remove the quiz data with “rm”.

dokuwiki/quiz.txt · Ultima modifica: 10/05/2012 18:39 (modifica esterna)

Strumenti Pagina