Forms & quizzes

From Redazione
Jump to navigation Jump to search
Line 146: Line 146:
  
  
where the form is build using the following model:
+
where the form is built using the following model:
  
 
<pre>
 
<pre>

Revision as of 20:09, 1 February 2021

Cultura italiana offers effective tools for rapid creation of forms, fitted to various purposes, and quizzes, which have been inspired by this Wikiversity's extension and have further developed for an optimal user experience, and diverge mainly because the submitted data are sent to the provided email address, rather than used to compute a score.

A form can be created through a template like the following:

{{#CI form: 
title = Contact form
| submit = support@culturaitaliana.org
| first and last name [] *
| email [email] *
| your message [textarea] *
}}

which produces the following result


Contact form
form protected using Google recaptcha


where the double square brackets represent an input (if empty the input type is assumed to be 'text' otherwise it can be any of 'password', 'textarea', 'email', 'search', 'tel', 'file', 'number', 'url', 'time', 'date') the asterisk a mandatory field, and the pipe is of course used to separate rows.

But a CI form template (precisely a 'parser function') can be also used to display inputs with placeholders, like the following:

{{#CI form: title = Contact form
| submit = support@culturaitaliana.org
| [first name] *
| [last name] *
| [email=email] *
}}


Contact form
form protected using Google recaptcha


multiple choice questions with arbitrary input fields among answers

{{#CI form: title = Why do you want to learn Italian?
| type = multiple choice  | list-type = letters | max answers = 2
| I want to work using Italian language 
| I want to study using Italian language 
| Cultural interest / personal knowledge 
| interpersonal relationships [] *
| prospective stay in Italy 
}}
Why do you want to learn Italian?
  1. I want to work using Italian language
  2. I want to study using Italian language
  3. Cultural interest / personal knowledge
  4. interpersonal relationships *
  5. prospective stay in Italy
form protected using Google recaptcha


and even cloze (completion) test, like the following:

{{#CI form: title = Metti i verbi al futuro semplice
| type = cloze test 
| * Vedo, vedo... che tra poco [incontrare=incontrerai] l'uomo della tua vita
| Vedo, vedo... che [avere] una grande vincita al gioco
| Questa carta mi dice che [vincere] il concorso che hai appena fatto
| Quest'altra carta mi dice che [sposarsi] al massimo entro tre anni
| Ah, qui vedo che [fare] un viaggio molto interessante
| Qui vedo che [andare] ad abitare in un'altra citta'
}}


Metti i verbi al futuro semplice
  1. Vedo, vedo... che tra poco (incontrare) incontrerai l'uomo della tua vita
  2. Vedo, vedo... che (avere) una grande vincita al gioco
  3. Questa carta mi dice che (vincere) il concorso che hai appena fatto
  4. Quest'altra carta mi dice che (sposarsi) al massimo entro tre anni
  5. Ah, qui vedo che (fare) un viaggio molto interessante
  6. Qui vedo che (andare) ad abitare in un'altra citta'
form protected using Google recaptcha


where the asterisk denotes an example answer, conversely than a mandatory field in the 'inputs' type.

And they are enough flexible to allow nested form sections of different kind, like in the following example:


Enrollment test
Why do you want to learn Italian?
  1. I want to work using Italian language
  2. I want to study using Italian language
  3. Cultural interest / personal knowledge
  4. interpersonal relationships *
  5. prospective stay in Italy
What is your profession / background ?
  • I'm a student or scholar
  • I'm an employee
  • I'm a professional or manager
  • other *
Do you have any experience of learning Italian language?
  • I haven't experience yet
  • Few personal attempts
  • I have taken private lessons during *
  • I have attended classes during *
form protected using Google recaptcha


where the form is built using the following model:


{{#CI form: 
title = Enrollment test 
| submit = support@culturaitaliana.org
|

{{#CI form section: type = inputs
| first name [] *
| last name [] *
| email [email] *
}}

{{#CI form section: ... }}

... [additional 'CI form sections']

}}


List of parameters

attribute scope description
type CI form or CI section type of form or section: "inputs", "multiple choice" or "cloze test"
title CI form or CI section form or section title
submit CI form email address to which the filled-in form will be dispatched
success message CI form the message displayed after submission of the form if the form has been correctly sent
error message CI form the message displayed after submission of the form if there was any issue sending the form
suggestions CI form or CI section with type "cloze test" "inline" (suggestions are displayed along each answer) or "framed" (suggestions are displayed in a box above the answers)
list-type CI form or CI section with type "multiple choice questions" the list type of the answers, can be "none", "ordered", "unordered", "letters", "number", or whatever value listed here
max answers CI form or CI section with type "multiple choice questions" maximum number of answers