CIForms examples
Basic, one column
This is the simplest form (type "inputs" by default, one column)
The square brackets represent an input, the square brackets contain the input type, the asterisk indicates a mandatory field
{{#CI form: title = Contact form
| type = inputs
| first and last name [] *
| email [email] *
| your message [textarea] *
}}
which produces the following
Placeholders
Form with placeholders. The square brackets contain the placeholder and optionally the input type after the equal symbol:
{{#CI form: title = Contact form
| [first and last name] *
| [email=email] *
| [phone=tel]
| [your message=textarea] *
}}
which produces the following:
Two columns
Inputs responsive (two columns), the square brackets contain the input type, the form rows can contain html (the label of the email input is bold)
{{#CI form: title = Contact form
| type = inputs responsive
| submit = abc@test.com
| first name [] *
| last name [] *
| <b>email</b> [email] *
| phone [tel]
| your message [textarea] *
}}
Multiple choice
Multiple choice with arbitrary text inputs between answers (on the last line in the example)
{{#CI form: title = Why are you applying to this job ?
| type = multiple choice
| I send bulk applications, even if I will be selected I'm not sure to confirm
| I ran out of money, I have to find whatever job quickly
| I want to learn something new
| The job fits my background and I'm very skilled, I look forward to join your team!
| Let me explain []
}}
Select
Select with placeholder and hardcoded options. An option contain a comma? Just escape it!
{{#CI form: title = Select your preferred IT course
| type = inputs
| [Please chose one=select=PHP and Mysql, Node.js\, Vue.js\, React, Mediawiki and Gerrit ] *
}}
Select with combobox
Select populated by wikitext (if the select contains more than 20 options CIForms will automatically display it as a select2 combobox)
{{#CI form: title = Country and city
| type = inputs
| country [select={{#replace:{{Template:Countries}}|*|,}}] *
| city [] *
}}
attention: in order for this example to work, $wgPFEnableStringFunctions and
$wgPFStringLengthLimit must be set respectively to true and to an high value (for instance 10000) in your LocalSettings.php, and Template:Countries must exist
Nested sections
Form with nested sections. The multiple choice accepts up to 3 answers ("max answers=3") The textarea has a maxlength attribute ("[textarea=1000]")
{{#CI form: title = Job application
| submission groups = sysop
|
{{#CI form section: type = inputs
| name [] *
| email [] *
}}
|
{{#CI form section: type = inputs
| title = What about your motivation ?
| type = multiple choice
| I send bulk application, even if I will be selected I'm not sure to confirm
| I ran out of money, I have to find whatever job quickly
| I want to learn something new
| The job fits my background and I'm very skilled, I look forward to join your team!
| Let me explain []
}}
{{#CI form section: type = multiple choice
| title = If you will be selected (on the basis of the answer above), how will you undertake your work ? (up to 3 answers allowed)
| type = multiple choice
| max answers=3
| I will work scrupulously
| I will work meticulously
| I will pretend to work
| I will delegate all my work to my sister
| I will work seriously
}}
{{#CI form section: type = inputs
|title = Please describe yourself
| [required=textarea=1000] *
}}
}}
Steps & surveys
Inspired by https://demo.limesurvey.org/index.php?r=survey/index&sid=14272
(css used Template:CIForms_examples/styles.css using the paramter css-class)
Cloze test
Cloze tests are mainly used to administer quizzes and tests.
Square brackets represent an input, a square bracket with text inside represents a suggestion. The asterisk represents an example sentence. Each row can contain an arbitrary number of inputs.
{{#CI form: type = cloze test
| title = Put the verbs between parentheses in the proper tense
| * I (to be) [have been] proud to win the match
| I (to do) [] a wonderful work
| I (to drink) [] too much at the last party
| I (to eat) [] 3 pizzas and 4 portions of french fries, and now I don't perform really well in intimate situations
| (to make) We are such stuff as dreams are [] on; and our little life ...
}}
Cloze test with suggestions
The list of suggestions is automatically shuffled and the suggestion is automatically canceled from the list. (line-through)
{{#CI form: type = cloze test
| title = Put the right word in each sentence
| suggestions = pencils, cats, dogs, car, house, pizzas
| * There are three [pencils] on my table
| My [] is pretty fast
| My [] barks a lot but welcomes thieves equipped with sausages
| I love [] because they say "meeeooow"
| I'm able to eat 4 [] at any time
| My [] has 3 swimming pools and a bowling lane, are you envious ?
}}
Cloze test with transformed suggestions
In some cases the answer has to be "transformed" with regard of the list of suggestions. In this case the relationship is expressed with the equal symbol within square brackets.
{{#CI form: type = cloze test
| title = Chose the right verb for each sentence and put it in the proper tense
| suggestions = to be, to win, to do, to drink, to make
| list-type = letters
| * I [to be=have been] proud to win the match
| I [] a wonderful work
| I [] too much at the last party
| I [] 3 pizzas and 4 portions of french fries, and now I don't perform really well in intimate situations
| We are such stuff as dreams are [] on; and our little life ...
}}
Cloze tests with html
The following is a quiz adapted from this page
{{#CI form: title = Complete the text from the Wikipedia article on [https://en.wikipedia.org/wiki/Aristotle Aristotle]
| type = cloze test
| list-type = none
| suggestions = Athens, Nicomachus, eighteen, 347, Stageira, Phaestis, Plato
| <b>Early Years</b> <br> Aristotle was born in [Stageira] in Chalcidice. His parents were [] and [], who became physician to King Amyntas of Macedon. <br> Aristotle was educated as a member of the aristocracy. At about the age of [], he went to [] to continue his education at []'s Academy for nearly twenty years, not leaving until after
Plato's death in [] BC.
}}