state_of_art_20151115.txt

The module is quite complete. It is still in beta-version but is in use in some pilot projects.
It is completely modular (uses db/subplugins.php) and uses oop.

The module foreseen: 18 types of fields and 4 types of other items.
Everywhere I used mform.

what is in:
18+4 item type.
They are:
-- fields --
->  1) item type "age" to ask for question like: "How old were you when you learned to ride a bike?" A: 4y and 6 months
->  2) item type "autofill" to autofill a field with infos from user, course, time, date or surveypro
->  3) item type "boolean" to ask for question like: "Is this true?"
->  4) item type "character" to ask for question like: "Write down your email" or "Enter your personal web site URL" or "Enter the PIN code of your card"
->  5) item type "checkbox" to ask for question like: "What do you usually get for breakfast? milk, sugar, jam, chocolate, other..."
->  6) item type "date" to ask for question like: "When were you born?" A: October 12, 1492
->  7) item type "datetime" to ask for question like: "Please, write down date and time of your last flight to Los Angeles." A: October 12, 2008 at 14:45
->  8) item type "fileupload" to ask for question like: "Please, upload your CV in PDF format"
->  9) item type "integer" to ask for question like: "How many people are in your family without you?"
-> 10) item type "multiselect" to ask for question like: "What do you usually get for breakfast? milk, sugar, jam, chocolate, other..."
-> 11) item type "numeric" to ask for question like: "How the mean temperature of the room is supposed to be?"
-> 12) item type "radiobutton" to ask for question like: "Which summer holidays place do you prefer? sea, mountain, lake, hills, desert..."
-> 13) item type "rate" to ask for question like: "How confident are you with the following languages? EN, ES, IT, FR. Mother tongue, Very confident, Not enought, Completely unknown."
-> 14) item type "recurrence" to ask for question like: "When do you usually celebrate your name-day?" A: July 7
-> 15) item type "select" to ask for question like: "Which summer holidays place do you prefer? sea, mountain, lake, hills, desert..."
-> 16) item type "shortdate" to ask for question like: "When did you buy your current car?" A: August 2002
-> 17) item type "textarea" to ask for question like: "Write a short description of yourself"
-> 18) item type "time" to ask for question like: "At what time do you usually get up in the morning in the working days?" A: 6:45

-- formats --
-> 1) item type "fieldset" to group your question
-> 2) item type "pagebreak" to add a new page
-> 3) item type "fieldsetend" to close an opened fieldset
-> 4) item type "label" to display labels in the surveypro page

User can choose, setup and include them into search forms.
They all have a long list of features even to verify the content provided by the user.
Surveypro foreseen conditional branching, sort of fields during export, item indentation, custom number, feature to hide element, groups of users with "extended" permissions, mandatory/optional element, element limited to people with a specific permission

************
known issues
************
- long text (using html editor) as child is not disabled by the parent even if in the same page: see MDL-25067. I found it is caused by the js of the editor.
- module icons are missing from head/admin/plugins.php overview report: see MDL-45723

Pending tracker issues:
************
Fixed issues:
************
MDL-30940: multiselect mform doesn't work! Fixed by Frédéric Massart on April 19, 2013
MDL-34760, MDL-38975: How disable fields upon checkboxes sets? Fixed by Eloy Lafuente on April 8, 2013
MDL-39280: $mform->disabledIf doesn't work for 'multiselect' mform elements. Fixed by Frédéric Massart on May 10, 2013

************
Issues that are still a problem:
************
MDL-25067: mform editor element can not be disabled with mform->disabledIf method
MDL-45723: uniformize the handling of svgs in resolve_image_location() calls.

************
Issues that were not fixed but that are no longer a problem:
************
MDL-29421: Form elements editor and filepicker do not support freezing. [Fixed locally by overriding corresponding class]
MDL-31796: $mform->disabledIf doesn't work for 'filemanager' mform elements. [Fixed along the years witout any notification in this tracker issue. Today (May 2015) it seems to work as expected]
MDL-45815: filemanager mform elements are completely discarded in readonly forms. [Fixed locally by overriding corresponding class]
MDL-43704: mform multiselect element is not disabled by the grouped checkbox (as many of other mform elements do) [Fixed with the workaround described in the tracker]
MDL-28194: I am in trouble assigning syles to some mform element.
MDL-34815: Disabled mform items need to be skipped during validation (and more).
MDL-43689: With set of advanced checkboxes, if the set is disabled each single chechbox returns its default value instead of its current value
MDL-40418: A missing <label> tag in mform causes wrong display (not blocker)
MDL-44138: The height (in pixel) of the same mform element changes with the content of the other mform elements
MDL-42946: It is not possible to provide a css style for a static mform element. [Fixed locally by overriding corresponding class]