Table of all variables (*: if you include the defaultSettings)¶

Description

Description:

Description

Quiz or poll? 0: normal mode (quiz or poll); 1: basic poll mode (see chapter “The basic poll mode”)

Description

In the basic poll mode you can decide between 2 database tables for the poll results: “tx_myquizpoll_result” and “tx_myquizpoll_voting”. The last one is optimized for polls and will be automatically used if you use the jQuery submit.

Description

Sort questions by: sorting | uid | title | random

Description

In poll and result list mode: show which question? 0: first; 1: second; 2: third...

Description

Mix/shuffle/random selectable answers at the “select”-page? 0: no; 1: yes.

Description

Maximum answers choice able per question. See chapter “FAQ”

Description

Questions can be put back? 0: no; 1: yes, questions can be skipped

Description

No. of questions / page: 0..1000 (0: all questtions at the first page)

Description

Allow negative scores? 0: yes; 1: no, the minimum value per question is 0 scores; 2: ignore false answers = no negative scores at all; 3: every answer must be correct, otherwise the quiz taker will get 0 scores; 4: 0 scores if every answer is correct, else x scores (x=scores of the question)

Description

Disable scores: 0: show scores per question; 1: don't show any scores.

Note: 1 disables every scores-handling! No scores-calculations are made.

Description

What about questions which have not been answered by the quiz taker? 0: ignore them; 1: that are false answers (old default setting)

Description

Poll mode: what about answers with no votes? 0: show them too in the result; 1 ignore them in the result

Description

Enforce selection: 0: no; 1: yes, the user must select or insert a answer

Description

Don't show correct answers after submit: 0: show correct answers; 1: don't show questions again

Description

Do you want to show the correct answers only on the final page? If you use a multi-page-quiz you can enable this entry and disable the dontShowCorrectAnswers-entry: 0: nothing happens; 1: show all correct answers on the last page (no questions left); 2: show only the correct answered questions; 3: show only the false answered questions.Restriction: pageQuestions>0 (but not for emails).

Description

Show details for questions with text-answers when showing all answers? 0: no; 1: yes, show a details link and after clicking on it show all text-answers. advancedStatistics must be enabled! xAjax required!

Description

Show details for questions with star-answers when showing all answers? 0: no; 1: yes, but jQuery is required! Furthermore the template file must be defined at your homepage via TypoScript.

Description

Show a final page which depends on reached percentage? 0: no extra content on the final page. Else: show a page or template which depends on reached percentage. See chapter “Dynamic Template Scopes”.

Description

Show a final page which depends on reached scores? 0: no extra content on the final page. Else: show a content element or template which depends on reached scores. See chapter “Dynamic Template Scopes”.

Description

Show a final page which depends on categories? 0: no extra content on the final page. 1: show the content element of the last category. 2: show the content element of the category with the most occurrence. 3: like 2, but show the content of all “most categories”. 4: show the content elements of all - by the user - used categories. Restriction for 2,3 and 4: advanced statistics enabled and template ###TEMPLATE_CATEGORY_ELEMENT### present.

Description

Ask for user data (name and so on) at a special start page? 0: no; 1: yes

Description

Ask for the user data at the question-page? 0: no; 1: yes; 2: ves, but only once

Description

Ask for the user data at the final page? 0: no; 1: yes

Description

Show the submitted user data at the answers-page? 0: no; 1: yes

Description

Show the submitted user data at the final page? 0: no; 1: yes

Description

PID where an address should be saved into (tt_address-folder), See template template_address.html. Note: you need an additional extension for this feature.

Description

tt_address-groups (uid´s) of the new address.

Description

Email address of the admin

Description

Name of the admin

Description

Subject of the email to the admin

Description

Subject of the email to the quiz taker

Description

Email address of the sender

Description

Name of the sender

Description

Send an email to the admin? 0: no; 1: yes, on the final page; 2: yes, after the final page (highscore list, when userData.askAtFinal=1)

Description

Send an email to the quiz taker? 0: no; 1: yes, on the final page; 2: yes, after the final page (highscore list, when userData.askAtFinal=1)

Description

Send an email on specific answer? Can be set as an JSON-object:

{"question_uid":{"number_of_answer":{"email":"E-mail","name":"Name","subject":"Subject","template":"Template_postfix_name"},"number_of_answer":{"email":"E-mail","name":"Name","subject":"Subject","template":"Template_postfix_name"}}}

"email" is mandatory, "subject" is mandatory, if "template" is missing, default template below is used, if "template":"myquizpoll", template ###TEMPLATE_ANSWER_EMAIL_MYQUIZPOLL### is used. Take care to use correct quotes (")!

Example question: "Frage 1: Lieblingsfarbe" (question_id in the DB: 12), Answer 1: blau, Answer 2: grün, Answer 3: rot

Example JSON-object: {"12":{"2":{"email":"green@test.de","name":"Grün","subject":"Lieblingsfarbe ist grün!","template":"gruen"},"3":{"email":"red@test.de","name":"Rot","subject":"Lieblingsfarbe ist rot!"}}}

The template names would be: ###TEMPLATE_ANSWER_EMAIL_GRUEN### and the default template for Rot.

You can extend the object for every answer: {"12":{"2":{…},"3":{…}},13:{"1":{…},"5":{…}}}

Note: this works only if "advancedStatistics = 1".

Description

Cancel the quiz when the user gives a wrong answer? 0: don't cancel a quiz prematurely; 1: show the template TEMPLATE_QUIZ_END when the quiz taker gives a wrong answer.

Description

Show the final page too when a quiz was canceled (time over or cancelWhenWrong=1)? 0: no, only the template TEMPLATE_QUIZ_END; 1: yes, TEMPLATE_QUIZ_END and TEMPLATE_QUIZ_FINAL_PAGE.

Description

Percentage of questions that must be answered correctly. Integer value: 0: don't cancel a quiz prematurely; int or int1 : int2 : show the page with the UID int2 or the template TEMPLATE_QUIZ_FINISHEDMINPERCENT after reaching finishedMinPercent percent ( int or int1 ) and stop the quiz.

Description

Finish after X questions? 0: no, show all questions; >1: regular finish after “finishAfterQuestions” questions. This works only then good if you set “userSession=1”. Usefull for tests and if you set “sortBy=random”.

Description

Limited time per page. Integer value: 0: no limitation; >0: send the form automatically after “pageTimeSeconds” seconds to the server

Description

Limited time per whole quiz. Integer value: 0: no limitation; >0: cancel the quiz after “quizTimeMinutes” minutes

Description

Enable the 3 available jokers? 0: no; 1: yes, show 3 different jokers

Restriction: pageQuestions = 1.

Requirements : xajax-Extension must be installed.

Description

Unlimited jokers? 0: no; 1: yes

Description

Give only halve scores when using a joker? 0: no; 1: yes

Description

Save more data into other database-tables? 0: no, I don´t need enhanced statistics; 1: yes, save everything in the database, because I want to see enhanced statistics. Note: this generates a database- entry for each answered question! Read the FAQ for more infos.

Description

Enable user session (Cookies)?: 0: no; 1: yes, I want to avoid database-accesses (recommended!). Note: userSession ist required for some features.

Description

Require user session (cookies)?: 0: no; 1: yes, improve security and require cookies (some actions will not work without a valid cookie).

Description

Show a back-button when pageQuestions>1? 0: no; 1: yes. Note: only the advanced statistics will be updatet in back mode!

Description

Max. number of entries in the highscore list. If you don´t import the defaultSettings the default value is 0 else the default value is 10.0: show all entries; x>0: show Top X entries, e.g. Top 10.

Description

Sort highscore list by: points: reached scores; percent: percent of answered question; o_percent: percent of all questions; time: end time - start time; date: creation date; lastcat: last categorie; nextcat:next categorie.

Description

Group the highscore by something? name: quiz taker name; fe_uid: front-end-user.

Description

Show the highscore only of the logged-in user? 0: no; 1: yes.

Description

Ignore the PID and display a highscore of all folders? 0: no; 1:yes.

Description

Show highscore at the final page: 0: no; 1: yes

Description

If front-end-users (fe_users) take the quiz you can generate a link to a profile-page of that user. See FAQ for more information.

Description

Date format in the highscore list

Description

Must users be logged in? 0: no; 1: yes

Description

Check for double entries when logged in? 0: no; 1: yes, logged in user can take a quiz/poll only once. Doesn't work if you use the table “tx_myquizpoll_voting”.

Description

fe_users-field for the quiz taker name, e.g. name or username

Description

If this property is set to X>0, the same quiz or poll cannot be taken twice with the same ip-address X days long. If > 1, then the user is locked for “doubleEntryCheck” days (in version 0.2.0: seconds)

Description

Double entry check mode: 0: show an error message at the second visit; 1: continue the quiz (where it was stopped last time) at the second visit

Description

Use cookies to remember the quiz takers UID? If yes, the quiz taker can continue later with the quiz. When done, a quiz cannot be taken twice! Specifies the lifetime of a cookie in days . -1 means: session cookie

Description

Cookie mode: generate the name of the cookie with... 0: normal (use the results-PID); 1: combine the PID with the language-id; 2: combine the PID with the fe_users-id; 3: combine the PID with the questions- PID; 4: combine the PID with onlyCategories; 5 combine the PID with the fe_users-id and the newest question-UID (only for the poll-mode)

Description

If useCookiesInDays<>0: allow users to delete/reset the cookie? 0: no; 1: yes. You need to insert ###RESET_COOKIE### in your template too.

Description

If check for double entry is on and isPoll=1. What show at the second visit? 0: start page with error message; 1: poll result list

Description

Delete current user result data and entries older than one day at the end of the quiz? 0: no; 1: yes; 2: yes, but delete only entries with no fe_users-ID (not logged in users); 3: yes, but delete only entries with an unknown name. Note: works only if a quiz is not canceled!

Description

If deleteResults>1: delete double entries too? 0: no; 1: yes, delete entries with the same name or fe_uid and smaller percent values. This works only with entries that are stored with the myquizpoll version 1.5.3 or greater!

Description

Disable the reading of the IP-address of the quiz-taker? 0: no; 1: yes

Description

Try to get the real IP-address or take only the REMOTE_ADDR? 0: real IP; 1: REMOTE_ADDR

Description

Block some IP-addresses (e.g. from google) on the submit page? Expamples: 66.249. (to block all IPs that start with 66.249.); 66.249.,127.0.0.1

Description

Hide user answers by default? 0: no; 1: yes, hide user result

Description

If you have installed the extension 'sr_freecap' you can add a captcha to the user data by enabling it here: 0: no captcha; 1: show the captcha near the user data (user data must be enabled)

Description

If “isPoll=1” you can rate pages. ExtKey and parameter are page- parameters. For an example take a look at the “template_rating_jquery.html”

Description

See above

Description

Maximum width and height for images

Description

Your own variables for all kind of lists: questions, answers and highscore list. See chapter “Your own variables”. Reserved variables are below...

Description

Separator in the text of your private variables

Description

0: nothing; 1: give the input-fields and other fields a unique ID

Description

Wrap the answer-text and the input-field with a label? 0: no; 1: yes, but only the text of an answer; 2: yes, wrap the text and the input- field;3: like 2, but adds a class for each input-type too; 4: like 3, buts adds two classes (one for inline elements, e.g. class=”radio inline”); 5: like 3, but for Bootstrap 3; 6: like 4, but for Bootstrap 3. Note: works only with radio-buttons and check-boxes!

Description

Additional things for radio-buttons

Description

Additional things for check-boxes

Description

Additional things for input-fields with type=”text”

Description

Additional things for textareas

Description

Possibility to wrap radio-buttons and check-boxes

Description

Additional things for select-boxes

Description

Additional things for option-fields

Description

String for the marker ###QUIZ_NAME###

Description

Debug mode? 0: no; 1, 2, 3: yes, but you will need a devlog-extension (e.g. devlog) too!

Description

UID of a category. First question must have this category. Following question depends on the category of the last question.

Description

UIDs of all categories that should be shown. Can be used instead of startCategory. Categories of the answers will be ignored with this option!

Description

Try to show at every page questions with different categories? 0: no; 1: yesNote: this works only if you set “sortBY = random” too.

Description

Ignore all submits? 0: no; 1: yes. Useful, if you want to display only a result list.

Description

IDs of sysfolders with the questions (this is the startingpoint)

Description

ID of the sysfolder where to store the results. Empty = sysPID.

Description

ID for form-URLs. This is the ID for the next pages. Leave it empty, if sysPID=nextPID.

Description

ID of the final page (if pageQuestions>1). Leave it empty, if sysPID=finalPID. Hint: if you want to make a redirect to a new page without any form-parameters, you can use “showAnalysis = 100:123” (123 is the ID of your destination page).

Description

ID of the page where to show the highscore list or the poll result

Description

ID of the first page; needed for the restart link. Note: since version 1.5.8 this ID will taken from the DB, but you can override it with this value.

Description

Path and file name of your own HTML template

Description

TS wrapping possibilities for questions, answers and explanations...

Description

Use stdWrap for answers too? 0: yes; 1: no

Description

Parsing of RTE-fields. See above...

Description

Allowed values: empty: normal mode; “score”: show the highscore list; “list”: show the poll result; “allanswers”: shows all questions and (correct) answers (see template TEMPLATE_ALLANSWERS). “archive” shows you a list of old polls (only in the basic poll mode).