CMF Questions (0.5.2)

Each Questionnaire can contain multiple questions, use the Edit Tab to add, edit, delete and reset questions. Question order cannot be changed so try and get the order right the first time. There are 6 different types of questions that can be added, Radio Buttons, Selection Box, Text Field, Text Area, Multiple Selection Box and Check Boxes. These question types correspond to the HTML tag used to display the answer options. For the text input question types there are no answer options and so this field should be ignored. Each Question also has an optional comment field, there are two different types of Comment Field, Text Area or Text Field. Users are given the option of saving and submitting their data. Saving means that they can come back later and their answers will be remembered. Once a user has submitted their answers will be verified to make sure they gave a response to every question and they cannot change their answers.

Use the Properties Tab to give the Questionnaire a description (can be HTML), Title, Thank you message text and Saved message text. These message texts are displayed to the user on saving or submitting. You can also set the Questionnaire to open or closed (which changes whether users are able to submit) and set whether to allow anonymous users. Anonymous support is done using a cookie __cmfquestions_name which stores the users name. This cookie is not persistent and so when the user exits their browser and returns their username will not be remembered and they will be able to take the questionnaire again. This can be changed by customising getSurveyId.py

Use the Review results Tab to check the results of the questionnaire. There are 3 different spreadsheets which show different degrees of detail and are in html or csv format which can be opened in Excel or SPSS as well as other Statistical packages that support this format. There is also a summary of results on this page that will show a bar chart and numbers for multiple choice questions (not the text based ones obviously).

If you place multiple Questionnaires in the same folder the user will be forwarded to the next incomplete Questionnaire on submitting. Multiple Questionnaire results are not compiled however, you will need to Review results for each Questionnaire individually. To make it easier for the user to understand what is happening with multiple Questionnaires you can use the questions portlet. Add the line here/portlet_questions/macros/portlet to a right_slots or left_slots Property in the folder using the ZMI. There is also the possibility for really large surveys to put multiple Questionnaires inside folders this way you can group types of questions and the portlet doesn't get too big. For the portlet to work properly for nested questionnaires you need to add a String property called survey_root to the base folder of the questionnaire with the value being the id of that folder.

An exit url property specifies where the user will be forwarded to on completing the survey, an alternative is to use a came_from parameter passed to a Questionnaire. Do this with a get statement, eg. http://plone.org/survey_html?came_from=http://plone.org