Administrator Manual

Installation

The extension can be installed via Extension Manager or Composer. For a list of configuration options, go to the chapter Configuration.

Variables of a quiz

If you want to change some templates, you should know, which variables of a quiz are available. There are this sections: quiz, question, answer, evaluation, tag. That are variables, filled in the backend. And there are this user-related sections: participant and selection (answers of a participant).

A quiz has this variables: name, about, timeperiod (in seconds), media, questions, questionsSortByTag, categories, evaluations, maximum2 (maximum points for a quiz), qtype (for quiz, poll or test) and closed.

A question has this variables: title, qmode (question-mode), image, bodytext, explanation, sorting, tag, answers, selectOptions, numberOfAnswers, arrayOfAnswers, categories, categoriesArray, sortedCategoriesArray and closed. And furthermore: maximum1 (maximum points for a question), allAnswers (no. of all answers/votes - checkboxes counted once), totalAnswers (no. of all answers/votes - all checkboxes counted), textAnswers (array with entered text answers, only in the BE available).

An answer has this variables: title, titleJS, points, jokerAnswer, onwAnswer (yes/no), ownCategoryAnswer (has 2 keys: 0 the uid and 1 the title), allAnswers (total answers of all users), allPercent (total percent of all users - checkbox counted ounce), totalPercent (total percent of all users - all checkboxes counted) and categories.

An evaluation has this variables: evaluate (evaluate points (unchecked) or percentage (checked)), minimum and maximum, image, bodytext, ce (content element ID), page (page ID) and categories. Note: if a category is marked, the evaluation will seek for categories instead. The category of answers will be validated. The category which was used most be the participant will be taken.

A tag has this variables: name, timeperiod (in seconds).

A participant has this variables: name, email, homepage, user (FE-user UID), username (FE-user username), ip, session, sessionstart, quiz, points, maximum1 (maximum points for the answered questions), maximum2 (maximum points for a quiz), startdate, crdate, tstamp, datesNotEqual, timePassed, page (reached page), completed (quiz completed?), selections (all answered questions), selectionsByTag (answered questions of a tag) and sortedSelections (answered questions, well sorted).

A selection has this variables: question, answers, sorting, points, maximumPoints (maximum points for this question), entered (entered text to this question) and categories.

User results

• Currently all user results will be saved in the database. There is a session-token (not in the Ajax-version), but it would be a nice feature to use only that one instead of the database.
• User results can be deleted automatically. There is a task which can delete old user/quiz-taker results. You find the task in the Scheduler.

Final page

There are several more variables at the final page available. You find them in the FinalPage.html partial. Furthermore there is an array filled only when you use categories at the evaluation: {finalCategories}. This array contains this variables: uid, title, count and all. all is an array again and contains: title and count.

Importing myquizpoll entries

• There is a scheduler task which whom you can import simple question from the old extension myquizpoll.

Exporting participant entries

• There is a scheduler task which whom you can export participants from a single folder (pid). The csv-file will be written to fileadmin.

Security fix in version 3.5.2

Since version 3.5.2 a session-key is always required and this session-key will be checked against a participant. If you use the Ajax-version AND if you use an own HTML-template, then you must add some code to your templates! In the Show.html template you need to add this line to the hidden-fields of the first form:

<f:form.hidden name="session" value="" id="quiz-form-session" />

In the ShowAjax.html template you need to add 2 lines. This one after "$('#quiz-form'+ceuid+' #quiz-form-parti').val('{participant.uid}');":

$('#quiz-form'+ceuid+' #quiz-form-session').val('{session}');

and this one after "$('#quiz-form-parti').val('0');":

$('#quiz-form-session').val('');

That will set a session-key for every participant.

Another change was made in the settings. The default quiz-UID 1 was removed. If you use that default setting, you must set settings.defaultQuizUid again to 1.

FAQ

• Are there any APIs?

  No.

• Are there any dependencies?

  Yes, you will need jQuery.

• How can I change the translations text?

  Here an TypoScript example:

  plugin.tx_fpmasterquiz._LOCAL_LANG.de.text.yourAnswers = Deine Abstimmung:
  plugin.tx_fpmasterquiz._LOCAL_LANG.de.text.allAnswers = Bisherige Abstimmung:
  plugin.tx_fpmasterquiz._LOCAL_LANG.de.text.done = Danke für deine Teilnahme! Deine Auswertung:

  Copied!

• How can I rename or hide some fields in the Backend?

  See chapter “Configuration / Page TSConfig”.

• How can I use routing / speaking urls?

  See chapter “Configuration / Routing”.

• Does the extension uses cookies?

  Only if you enable them via settings.user.useCookie. See chapter “Configuration”.

• Is there a widget for the TYPO3 dashboard?

  Yes, of course, there are 2. They were added in version 3.2.4.

• Only the list view is shown or the quiz was not found. Whats wrong?

  There are different actions and plugins, therefore you may probably change a link. Example: you want to link from a list view to a single view where you use tags. Then you need to change the link in the list view. Instead of pluginName="show" you must set pluginName="showbytag". Furthermore you need to set the Startingpoint at every single page.