Editing CIForms examples


==Basic, one column==  
  
This is the smplest 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

<pre>
{{#CI form: title = Contact form
| type = inputs
| first and last name [] *
| email [email] *
| your message [textarea]  *
}}
</pre>

which produces the following


{{#CI form: title = Contact form
| type = inputs
| submission groups = sysop
| first and last name [] *
| email [email]  *
| your message [textarea]  *
}}



==Placeholders==

Form with placeholders. The square brackets contain the placeholder and optionally the input type after the equal symbol:

<pre>
{{#CI form: title = Contact form
| [first and last name] *
| [email=email] *
| [phone=tel]
| [your message=textarea]  *
}}
</pre>


which produces the following:
 

{{#CI form: title = Contact form
| [first and last name] *
| [email=email] *
| [phone=tel]
| [your message=textarea]  *
}}



==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)


<pre>
{{#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]  *
}}
</pre>


{{#CI form: title = Contact form
| type = inputs responsive
| 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)

<pre>
{{#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 [] 
}}
</pre>


{{#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!

<pre>
{{#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 ] *
}}
</pre>


{{#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 [https://select2.org/ select2] combobox)

<pre>
{{#CI form: title = Country and city
| type = inputs
| country [select={{#replace:{{Template:Countries}}|*|,}}] *
| city [] *
}}
</pre>


{{#CI form: title = Country and city
| type = inputs
| country [select={{#replace:{{Template:Countries}}|*|,}}] *
| city [] *
}}




==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]")

<pre>
{{#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] *
}}

}}
</pre>


{{#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

{{#CI form: title = Survey example 
| email-to = abc@mail.com
| paging = 5, 10
|

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

{{#CI form section: type = input | title = What is your favorite pastime?
|[Please chose one=select=Reading,Programming,Navigating the web,All of the above,Other,No answer] *
| (if you selected "other") [text]
}}


{{#CI form section: type = multiple choice  | list-type = none | max answers = 1
| title = What is your favorite color ?
| Red
| Orange
| Yellow
| Green
| Blue
| Indigo
| Violet
| Plaid
| Other []
| No answer
}}

{{#CI form section: type = multiple choice
| title = Who is your favorite relative ?
| Father
| Mother
| Sister
| Brother
| Uncle
| Aunt
| Grandfather
| Grandmother
| No answer
}}

{{#CI form section: type = inputs | title = Why ?
| [textarea]
}}

{{#CI form section: type = inputs
| title = How much do you like these foods ?
| Broccoli [Chose one=select=Hate,Dislike,Ambivalent,Like,Love,No answer]
| Ice Cream [Chose one=select=Hate,Dislike,Ambivalent,Like,Love,No answer]
| Chocolate [Chose one=select=Hate,Dislike,Ambivalent,Like,Love,No answer]
| Steak [Chose one=select=Hate,Dislike,Ambivalent,Like,Love,No answer]
| Escargot [Chose one=select=Hate,Dislike,Ambivalent,Like,Love,No answer]
}}

{{#CI form section: type = inputs
| title = How much pain to you currently feel in the following locations?  1 = none, 10 = extreme
| Broccoli [Chose one=select=1,2,3,5,6,7,8,9,10,No answer] *
| Ice Cream [Chose one=select=1,2,3,5,6,7,8,9,10,No answer]
| Chocolate [Chose one=select=1,2,3,5,6,7,8,9,10,No answer]
| Steak [Chose one=select=1,2,3,5,6,7,8,9,10,No answer]
| Escargot [Chose one=select=1,2,3,5,6,7,8,9,10,No answer]
}}


{{#CI form section: type = inputs
| title = How much do you like the following?  (1 = not at all, 5 = extremely)
| Ballet [Chose one=select=1,2,3,5,No answer]
| Jazz [Chose one=select=1,2,3,5,No answer]
| Ballroom [Chose one=select=1,2,3,5,No answer]
| Tap [Chose one=select=1,2,3,5,No answer]
| Contemporary [Chose one=select=1,2,3,5,No answer]
| Hip Hop [Chose one=select=1,2,3,5,No answer]
}}

{{#CI form section: type = inputs
| title = How should the following change?
| Funding for education [Chose one=select=Increase, Same, Decrease,No answer]
| Funding for security (e.g. police, jails, military)  [Chose one=select=Increase, Same, Decrease,No answer]
| Availability of high quality health care  [Chose one=select=Increase, Same, Decrease,No answer]
| Compensation for teachers  [Chose one=select=Increase, Same, Decrease,No answer]
| Compensation for executives  [Chose one=select=Increase, Same, Decrease,No answer]
| Taxes on the rich  [Chose one=select=Increase, Same, Decrease,No answer]
| Taxes on you  [Chose one=select=Increase, Same, Decrease,No answer]
}}

{{#CI form section: type = inputs responsive
| title = How long should it take to fix the following?
| All bugs in LimeSurvey 1.91+ [Chose one=select=1,2,3,4,5,6,7,8,9,10] [Chose one=select=days,weeks,years]
| All items on your To Do list [Chose one=select=1,2,3,4,5,6,7,8,9,10] [Chose one=select=days,weeks,years]
| All items on your 'honey-do' list [Chose one=select=1,2,3,4,5,6,7,8,9,10] [Chose one=select=days,weeks,years]
| The economy [Chose one=select=1,2,3,4,5,6,7,8,9,10] [Chose one=select=days,weeks,years]
}}


{{#CI form section: type = cloze test | list-type = none | title = Who are your favorite characters in the following? |
<html><table id="table_test">
<tr><th></th><th>Favorite</th><th>Second most</th><th>Third most</th></tr>
<tr><td>Harry Potter</td><td>[]</td><td>[]</td><td>[]</td></tr>
<tr><td>Star Trek</td><td>[]</td><td>[]</td><td>[]</td></tr>
<tr><td>Star Wars</td><td>[]</td><td>[]</td><td>[]</td></tr>
</table></html>

}}

}}

==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.

<pre>
{{#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 ...
}}
</pre>

{{#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)

<pre>
{{#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 ?
}}
</pre>

{{#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.

<pre>
{{#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 ...
}}
</pre>

{{#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 [https://en.wikiversity.org/wiki/Help:Quiz-Simple this page]

<pre>
{{#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. 
}}
</pre>


{{#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. 
}}