Extension:CIForms

The CIForms extension allows for rapid creation of forms, either standard forms with input fields aimed at receiving data from visitors, or forms with multiple choice questions or even Cloze tests to be used as teaching tools for current students or to engage prospective ones.

All forms include automatic validation, are protected by the latest version of Google recaptcha and have been inspired by this extension at Wikiversity and they diverge from it mainly because the submitted data are sent to the provided email address, rather than used to compute a score.

Please check Help:Extension:CIForms for detailed examples.

Installation/Download
CIForms is now marked as stable and features a lot of improvements, including
 * Cloze test with sentences, tables, dialogues and more (see here for the related examples)
 * submitted forms are now converted to pdf and then sent using phpmailer
 * form sections can now be nested (see picture on the right)
 * captcha validation can now be deactivated simply leaving  or   blank

Please download from here and then install the dependencies (phpmailer and dompdf) using composer

Usage

 * See How it works on culturaitaliana.org

Example
This is the simplest example of a form with inputs

List of parameters
Please visit this page Help:Extension:CIForms for additional examples and here for their visualization.

Configuration
First ensure that the parameter  of your wiki is set to true, and that either   is set to some value, or   (all of them to be put in the file LocalSettings.php) contains the sender email address of your forms.

Conversely,  contains the email address to which the form data will be dispatched once submitted by the visitor, which will be used all the times that the   parameter is missing from the form's template. (precisely a parser function).

The same applies form  and , they will be used as long as   and   are not specified within the form.

Known issues

 * Due to this Visual Editor's bug, if the 1st parameter after the function name is separated by a new line, Visual Editor will not recognize the template/parser function and will surround it with unwanted 'nowiki' tags. Therefore use always the following

rather than the following


 * the template is interpreted rigorously and the parser function does not try to fix little mistakes in the parameters, like missing pipes (|) or wrong parameters. This might be updated in future