I'm stuck on the basic usage steps found in the README:
Basic usage
- enable
- navigate to
- edit an existing webform or add a new one
- edit an existing element on the form or add a new one
- select whether or not to score the form
- assign a point value
- indicate validation method
- set display at ...
I'm stuck on the step "select whether or not to score the form". I'm not sure where to make my selection.
If you could provide a link, screenshot or some additional direction, I'd be glad to write that up and submit that to the README file as a patch.
Thank you for creating and maintaining this module!
Comments
Comment #2
bucefal91 commentedI saw you asking this question in slack too. Let me just quote my reply in there here as well, so others might have easier time finding the answer.
I believe you got into the trap of the 8.x-1.x vs 8.x-2.x versions. The current `README.txt` contains instructions for 8.x-1.x branch even through it's in 2.x branch ( I simply haven't had time to get to the documentation yet.. barely rolled out some usable code).
The 2.x branch is slightly different.. Instead of marking whether to score or not a particular webform element, you got a new category, called "Quiz".
it has 2 elements now: Radios and Textfield. These 2 guys are 'scorable' in 2.x branch.
If you are willing to put up an alternative (and correct) version of README.txt - that'd be AWESOME! :) i do struggle to find enough time for this module so I do appreciate any help.
Comment #3
ttamniwdoog commented"you got a new category, called "Quiz"."
That is exactly what I was missing. I was confused by the part where I was editing an existing form and read "edit an existing element on the form" but you can't do that. You have to create a new element in the new category called "Quiz".
Thanks @bucefal91
I would like to help with the documentation on how to use this module, so I'll attach my .patch of the README as I go along here learning how to implement this module.
The next step for me is to understand how the scoring methodologies work.
I've created two questions, two possible answers for each and set them to score one point for the correct answer. When I complete the form submission I expect to see the display or access to the score but I see none. I see there is a task to expose a token for the score that is outstanding. But is there another way that would display the score to the quiz taker?
Thanks and I look forward to contributing!
Comment #5
bucefal91 commentedHey!
At the moment the score is available on the submission view page (see the attached printscreen).
In the project where this module was used by me, we made heavy use of Views and if you build a view on top of Webform Submissions, you should have the "Score" views field there which will also display the score of a submission.
I just wonder where did you expect to see the score? (so I can possibly include it there too)
In the meantime I've committed your patch so we have improved documentation already. Thank you, man :) I really am struggling to have time for this module. Most of my effort goes into keeping Webform Views afloat.
Comment #6
mandclu commentedI experienced the same confusion about the usage of this module. Considering the 2.x branch is what shows on the project page, and is what composer will install by default, I would suggest that the "Basic Usage" on the project page reflect the description here (adding quiz-specific fields).
I would also like to chime in on the aggregate score topic. For myself, I want to use the score as the form is completed, for conditional logic. For example, if after the first page of my quiz the score is zero, I'll end the quiz and take the user to a specific page/result message. For each page of the quiz I would like to have a different threshold on the aggregate score, and a different conditional outcome.
Also, do you know if the score value provided here is compatible with the Webform Analysis module?
Comment #7
j4 commentedWould also love to know how the scores can be displayed in the submissions table (for instance have the option when we click the customize table button) and how to customize the completed message based on the score. Thank you!