Questions
A quiz must have at least one question. Write them in the questions
tab of your spreadsheet.
Multiple choice
At this point, only multiple_choice
is supported. This includes true/false. A layout variant — multiple_choice_longform
— is available in the questions spreadsheet and only triggers some small css changes to allow for longer response options. It is identical to multiple choice in every other respect.
Required configuration
value | purpose | default |
---|---|---|
type |
multiple_choice or multiple_choice_longform |
None |
question |
The text of the question. Think of this as a headline. Should be less than a tweet | 140 chars max, but ~70 chars is ideal. |
Responses (also required)
Multiple choice questions accept up to four potential responses, lettered a
through d
.
value | purpose | default |
---|---|---|
a |
The text value from which the quiztaker will choose. | None |
image_a |
An optional image, set as the background of the response button. | None |
Warning
Only one response can be the correct answer and it must be noted in the answer
column by using the letter of the column. If c
is the answer, then put the letter c
.
Optional
value | purpose | default |
---|---|---|
blurb |
An optional readout, in normal body font style. Should be complementary to the question . To keep each question view vertically concise, it's probably best not to use this with an image. This is a full HTML field, so embed codes (YouTube, Soundcloud, etc.) will work here. |
None |
question_image |
Can be a presto ID or a CDN image. Image displays underneath the question text. Requires alt text to render. | None |
question_image_alt_text |
The required alternative text for the image. The image will not render without it. If using a presto ID for the image, this field is not required. | None |
question_image_caption |
If the image needs a caption. Can be used to overwrite presto captions if using a presto ID for the image. | None |
question_image_credit |
If you want a credit for the image. Can be used to overwrite presto credits if using a presto ID for the image. | None |
hint |
If you want stumped quiztakers to get a little extra help, filling out this field will cause a hint button to appear. When clicked, the button will display this text. Hints are noted in the question response payload. | None |
For the end-of-quiz score summary scree
value | purpose | default |
---|---|---|
context |
In the summary view, this is extra information about the questions topic and answer. | |
related_link |
A recirculation link, to be displayed underneath the context, where a quiztaker can learn more about the question topic. | |
related_headline |
Link text. Defaults to "Learn more about this" |
Guess the Photo
Show the reader a blurry photo and a clue. They have five tries to guess correctly while time ticks on. After each guess, the photo unblurs a little and the reader (might) get another clue.
There are no changes to the standard spreadsheet format, but some of the columns have a different purpose.
Spreadsheet column | Purpose | Required |
---|---|---|
question |
This is the main prompt/clue for the quiztaker. It will be displayed as soon as the the "begin" button is clicked. | Yes |
blurb |
This text is displayed to the reader before they start the quiz (in a visual format identical to the question). This should include instructions for the quiztaker to understand what to do. | Yes, to offer instructions |
question_image |
This is the main image. Obviously, this is important. Can be a presto ID or CDN url. | Yes |
question_image_alt_text |
Good descriptive alt text is required, but be sure not to give away the answer. | Yes |
question_image_caption |
Optional rewrite of the photo caption. Caption will display only on the summary view. | Yes, for CDN link. |
question_image_credit |
Optional rewrite of the photo credit. | Yes, for CDN link. |
a , b , c , d |
Additional prompts/clues can be added here, up to four (obviously). The prompt in a will display after the first guess, d after the fourth guess, etc. |
- |
answer |
The correct answer as it should display in the summary. For checking responses, this is case insensitive. | Yes. |
image_a , image_b , etc. |
No function for this question type | - |
max_guesses |
Limit the number of quesses a quiztaker can make before the question reponses is deemed incorrect. This will default to 5. Let's not mess with this unless were are testing a clear hyopthesis. It is important to make sure any reference to total guesses in the blurb matches what is set here. |
Default: 5 |
hint |
Same as multiple choice, but the hint mechanism for the a - d columns might be more appropriate. Probably don't want to use both. |
- |
context |
Same as multiple choice. | - |
related_link |
Same as multiple choice. | - |
related_headline |
Same as multiple choice. | - |