The person designing the survey gets to the screen that allows him to design a survey by clicking a link titled "Click here to access or hide survey design box" that appears under the post window whenever a person who is allowed to post a poll is posting a new topic or editing the first post of a topic. In designing the survey, a form allows the designing user to specify:
- The name of the survey (sometimes this would be an overall question or text that introduces the real questions)
- which group or groups are supposed to answer the survey
- whether users who answer the survey should be shown in the left column or left out
- whether the answers to the survey (the rows in the survey) should be shown alphabetically by the username column, alphabetically (or reverse alphabetically) by the first answer column or in the order in which users submitted the answers
- whether the users in the group answering the survey who have NOT already answered the survey should be listed as non-responders (I think of this as a 'Hall of Shame')
- the column widths for the username column and for each question column (if you leave these blank the browser will just do whatever it thinks makes sense, which usually looks pretty good)
- how the users will input the answer (small text blank, large text blank, text area, checkbox/radio buttons or drop down menu, and if checkbox/radio buttons or drop down menu the various possible selections for the user to pick from)
- whether the responses for the question should be totalled and if so, how they should be totalled (by number of users responding, by the sum of the numbers the users put in their responses or by the total number of responses that match text the designer of the survey specifies)
- the maximum number of users that can respond to a particular question before additional users are no longer asked that question
When the survey is designed and posted, it appears at the head of the topic and each user in the groups that have been designated to take the survey will see a button labeled "Fill out Survey" that he can click. When he clicks that button, a new form opens up that asks him the questions (he inputs the questions in text blanks, radio buttons, drop downs, etc as specified by the designer of the survey).
If a user has already responded, the button he sees is not longer "Fill in Survey' but instead is "Change your answers', which allows the user to change his answers.
The survey is tabulated as people answer it so that everyone can see at a glance each user who has responded (assuming the designer does not choose to hide the responders) and what his answers are (and there are totals for any questions the survey specified to be totalled).
Anyway, here's a link to a zip file containng the mod:
[link deleted because this is now in the validated mod db here: http://www.phpbb.com/phpBB/viewtopic.php?t=278888 ]
I've included screenshots in a 'screeenshots' directory inside the 'contrib' folder so you can see what this looks like in action.
And I really think 'tabulated survey at topic head' doesn't properly describe what this is...any suggestions on the name would be most welcome.