# Quiz Change Log

## 4.0.5 - 29th October 2025

- !71 FRAM-1069 Updated component library usages for quiz cover images for improved accessibility

## 4.0.4 - 8th October 2025

### Developer notes

- Merged upstream changes from 3.1.5

## 4.0.3 - 16th September 2025

### Developer notes

- Merged upstream changes from 3.1.4

## 4.0.2 - 3rd September 2025

### Developer notes

- Merged upstream changes from 3.1.3

## 4.0.1 - 13th August 2025

### Developer notes

- Merged upstream changes in 3.1.2

## 4.0.0 - 9th June 2025

### Developer notes

- Stable release
- Merged upstream changes from 3.1.0, 3.1.1

## 4.0.0-beta - 16th April 2025

### Developer notes

- Merged upstream changes from 3.0

## 4.0.0-alpha2 - 28th November 2024

### Developer notes

- Merged upstream changes from 3.0

## 4.0.0-alpha - 14th November 2024

### New features

- FRAM-954 Claromentis 10 compatibility

### Improvements

- !54 PPS-213 Added an option to send notifications when publishing Quizzes
- !49 PPS-177 Disco 036126 Disco 032143 Added an option to make individual survey questions mandatory
   - Added error handling design changes to survey

### Breaking changes

- !54 PPS-213 Added column `notify_users` to the `quiz` table

## 3.1.5 - 8th October 2025

### Improvement

- !76 PPS-251 Fixed single choice options dropping to next line in Polls & Surveys

## 3.1.4 - 16th September 2025

### Bug fixes

- !75 LMS-250 Fixed missing course breadcrumb when navigating from a quiz to a module

## 3.1.3 - 3rd September 2025

### Improvements

- !74 BT-5369 Disco 049372 Added test data file needed to enable Template Previews

## 3.1.2 - 13th August 2025

### Bug fixes

- !73 BT-5361 Disco 049335  Fixed a bug where creating, updating and copying surveys were audit logged more than once

## 3.1.1 - 5th June 2025

### Improvements

- !72 PPS-249 Permissions are now copied during poll or survey duplication, renamed option from `Duplicate` to `Make a copy`

## 3.1.0 - 20th May 2025

<!-- Minor release due to new features -->

### New features

- !70 PPS-247 Added contextual breadcrumbs and "Done" button in Quiz so that users can be redirected back to the LMS Course/Module that they started the Quiz from

### Developer notes

- !70 PPS-247 The breadcrumb improvement requires module LMS in version `3.3.0`

## 3.0.15 - 3rd April 2025

### Bug fixes

- !69 BT-5238 Fixed error shown when trying to add a free text question to a survey

## 3.0.14 - 4th March 2025

### Bug fixes

- !68 BT-5165 Disco 048206 Disco 048343 Disco 048332 Fixed input validation when creating new Polls and Surveys

## 3.0.13 - 10th January 2025

### Improvements

- !59 PPS-231 Added keyword filtering to the Quiz list and the Polls & Surveys list
- !66 PPS-243 - Increased maximum character limit for question and section description, options, and answer

### Developer notes

- !67 Fixed failing CI/CD for OpenAPI specification validation

## 3.0.12 - 4th December 2024

### Bug fixes

- !64 BT-4981 - Fixed number of polls and surveys displayed in pages component
- !65 PPS-240 Added missing Russian translation

## 3.0.11 - 20th November 2024

- Merged upstream changes from 2.3.14

## 3.0.10 - 7th November 2024

- !60 BT-4990 Added German notification templates

## 3.0.9 - 19th June 2024

### Improvements

- !58 BT-4696 French localisation update
- !55 BT-4684 German localisation update
- !56 BT-1689 Changed Polls component icon to legacy svg in Component Menu

### Developer notes

- Merged upstream changes from v2.3

## 3.0.8 - 2nd April 2024

- Merged upstream changes from 2.3.11, 2.3.12

## 3.0.7 - 24th July 2023

- !46 BT-4009 Disco 041178 Fixed a bug where the audit log shows blank entries for field user when creating, editing, or sending notifications for Polls and Surveys

## 3.0.6 - 6th June 2023

- Merged upstream changes from 2.3.10

## 3.0.5 - 19th April 2023

- Merged upstream changes from 2.3

## 3.0.4 - 28th February 2023

- Merged upstream changes from 2.3

### Bug fixes
- a4b20252 BT-3749 Fixed issue with placement of chart type dropdown on survey results page
- 6ef36dc3 BOOTY-626 Fixed issue in Polls where option rows aren't properly deleted when the 'x' button is clicked

## 3.0.3 - 13th December 2022

### Bug fixes

- Merged upstream changes from 2.3
- 5fef105c BT-3835 Fixed bug with quiz where the results table doesn't fill the full width of the browser

## 3.0.2 - 5th August 2022

### Improvements

- a7b4be53 BOOTY-500 BOOTY-533 Updated Polls and Surveys pages component IDs so it uses the new class structure
- !42 BOOTY-582 Replaced utility classes usages with Bootstrap 4 standard utility classes
- FRAM-838 Added application menu item registration

### Bug fixes

- 6c5db204 BT-3750 Fixed issue with localisation not being in place on the 'Individual' page of the survey results page

## 3.0.1 - 14th July 2022

### Improvements

- Merged upstream changes from 2.3
- BOOTY-502 Updated Quiz card background colour for reports module
- FRAM-657 Updated Reports Schema icon from Glyphicon to SVG
- FRAM-471 Declared support for PHP 8.1

### Developer notes

- FRAM-657 Moved `APPLICATION_SVG_URL` constant from `Claromentis\Quiz\Provider\ServiceProvider` to `Claromentis\Quiz\Plugin`

## 3.0.0 - 28th June 2022
- Stable release
- Merged upstream changes from 2.3.5

## 3.0.0-beta2 - 29th April 2022
- Merged upstream changes from 2.3.2, 2.3.3, 2.3.4

## 3.0.0-beta - 28th February 2022
* Claromentis 9 compatibility

## 2.3.14 - 19th November 2024

### Bug fixes

- !61 BT-4991 Sanitize user's name in Quiz Statistics

## 2.3.13 - 12th June 2024

### Bug fixes

- !57 BT-1689 Changed Polls component icon to legacy SVG in Component Menu

## 2.3.12 - 26th March 2024

- !51 PPS-239 Disco 043500 Increased the maximum description length for Polls and Surveys
- !52 BT-4510 Communication settings: changed application name to "Quiz, Polls & Survey"

## 2.3.11 - 24th August 2023

- !48 BT-4009 Disco 41178 Fixed a bug where the audit log shows blank user entries when creating, editing, or sending notifications for Polls and Surveys

## 2.3.10 - 6th June 2023

* !47 BT-4038 Fixed access to polls/surveys directly via URL for users without permissions

## 2.3.9 - 17th April 2023

* !44 PPS-236 Filter out invalid data when showing results charts
* !45 BT-3939 Disabling survey controls while updating

## 2.3.8 - 9th December 2022

* !43 FRAM-859 Rebuilt assets to match AngularJS 1.8.3 from core

## 2.3.7 - 15th July 2022
* !41 BT-3470 Fixed exception in the front end when parameter `is_new` has a null value

## 2.3.6 - 14th July 2022
* !40 BT-3455 Survey preview fixed the infinite request loop

## 2.3.5 - 3rd May 2022
* !39 PPS-235 Disco 036802 Improved performance for Survey results CSV exports

## 2.3.4 - 29th April 2022
* d1b973b1 Disco 036990 Fixed Quiz Reports integration erroneously including attempts from Surveys

## 2.3.3 - 8th April 2022
* !38 PPS-234 Added button `Export to CSV` to Quiz results page

## 2.3.2 - 4th March 2022
* !37 PPS-233 Fixed bug when a table in survey results are failed to generate

## 2.3.1 - 17th February 2022
* !31 BT-3205 Quiz, Poll & Surveys notifications - fixed new/edited messages, fixed wording on new/edit message, moved quiz notification to background task from the main thread

## 2.3.0 - 16th December 2021
* !30 PPS-219 Added database table indexes

## 2.2.4 - 16th December 2021
* !25 PPS-207 URLs are now presented as links properly in Poll/Survey descriptions, Survey section descriptions, question titles and descriptions, and free text question answers.
* !27 BT-3072 Now the number `0` can be used as an answer to a quiz question
* !28 PPS-216 Fixed too narrow Qualification Code field, when adding/editing quiz details (required Learning Module >= 3.4.1)
* !29 PPS-217 Quiz in Learning path is now listed if is completed with no retakes
* !30 PPS-205 Create a new poll from the existing one - added option `Duplicate`
* !26 PPS-209 Fixed performance issues on the Survey result page
* !26 Bumped PHP compatibility from >=7.0.0 to >=7.1.0 to match Claromentis Core
* !34 PPS-210 Component added option to show or hide 'Ended' P&S
* !33 PPS-222 Fixed badges on surveys with ending date
* !31 PPS-205 Create a new survey from the existing one - added option `Duplicate`
* !35 PPS-255 Fixed issue with poll and surveys component applying a large margin

## 2.2.3 - 11th June 2021

### Merged forward from 2.1.2
* !21 BT-2154 [DISCO-030842] Changed limit for the free text answers (long) in Survey to 3000 characters

## 2.2.2 - 17th May 2021
* !23 BT-2412 DISCO 32803 Fixed a rounding error that caused the pass mark to be higher than the maximum possible score in some cases

## 2.2.1 - 1st February 2021
* !22 BT-2209 Fixed privacy issues concerning Polls & Surveys submission notifications

## 2.2.0 - 9th November 2020
* !20 PPS-201 Managers can now choose to be notified of new submissions to a Poll or Survey when creating it

## 2.1.2 - 10th June 2021

### Merged forward from 2.0.3
* !21 BT-2154 [DISCO-030842] Changed limit for the free text answers (long) in Survey to 3000 characters

## 2.1.1 - 26th October 2020

### Merged forward from 2.0.2
* !18 BT-1753 Disabled `Public` in the permissions' dialog for both Polls & Surveys
* !19 BT-2046 Fixed pagination issue in poll results

## 2.1.0 - 20th August 2020
* FRAM-368 Made compatible with AngularJs 1.7 and Claroments 8.10

## 2.0.3 - 13th January 2021
* !21 BT-2154 [DISCO-030842] Changed limit for the free text answers (long) in Survey to 3000 characters

## 2.0.2 - 26th October 2020
* !18 BT-1753 Disabled `Public` in the permissions' dialog for both Polls & Surveys
* !19 BT-2046 Fixed pagination issue in poll results

## 2.0.1 - 20th August 2020
* !14 BT-1864 Removed unfinished attempts from survey results 
* !13 BT-1702 Reports module - fixed growl message `invalid column name quiz_id` when choosing the options `Blank report` or `Create from template`
* !16 BT-1912 Poll result page shows all options now, not only voted ones 
* !12 BT-1863 Fixed pagination counts for free text answers on the survey results page
* !17 BT-1867 Added a warning message in survey admin if user will try to navigate away without saving data in settings tab

## 2.0.0 - 13th July 2020
* !9 Polls and Surveys module 

## 1.4.4 - 27th November 2019
* CORE-1036 Added Hungarian translation

## 1.4.3 - 29th October 2019 ##
* Added Uzbek translation

## 1.4.2 - 24 October 2019
* BT-843 Fixed inability to submit question options containing special characters

## 1.4.1 - 23 September 2019
* !10 (BT-757) [DISCO-025440] Added validation for the cyrillic alphabet. Fixed the inability to add any question to the quiz if text contains cyrillic alphabet characters.
* !10 (BT-732) Removed option from question when input field is empty

## 1.4.0 - 6 Aug 2019
* !8 UIUX-285 Implemented multiple correct answers for Quiz Questions
  * Added tick and cross icons for answer breakdowns to indicate chosen answers
    more clearly
  * Implemented a "Show help text" Quiz setting that determines whether to show
    help text such as "Choose a single correct answer" or "Choose multiple
    correct answers"

## 1.3.5 - 5 Jul 2019
* !6 UIUX-284 Increased front-end limit of Quiz titles from 50 to 255
* !7 UIUX-286 Implemented a "shuffle answers" setting for quizzes, which randomises the display order of question options shown during Quiz attempts
* Added Russian translations and a twig template
* Fixed styling of question state indicator - it looked like an egg for longer question numbers :egg:

## 1.3.4 - 5 Dec 2018
* Added minimum image height to prevent images not being shown when creating quizzes (Jira CORE-160)
* Set image display dimensions for quizzes and questions to use sizes set as constants in the models (Jira CORE-160)

## 1.3.3 - 9 Nov 2018
* Allow deleting qualification codes if they are not being used elsewhere (disco 21941) (learning #467)

## 1.3.2 - 29 Aug 2018
* Removed aspect ratio lock on quiz question image.
* Updated localisation for image on question (#18)
* Widescreen / Fullscreen compatibility

## 1.3.1 - 5 Jun 2018
* Implemented question images
* Fixed a sizing issue with the maximum retakes field
* Fixed inconsistencies with the Quiz status counts on the home page

## 1.3.0 - 16 Apr 2018
* This branch has Claromentis 8.3 support and the share component

## 1.2.5 - 16 Apr 2018
* Claromentis 8.3 support will now be in the 1.3 branch
* Removed share component

## 1.2.4 - 9 Apr 2018
* Added share component (broke compatibility with Claro 8.2)

## 1.2.3 - 27 Mar 2018
* Compatibility with Claromentis 8.3
* Bugfix to suppress custom key handling when in an edit control (#2).

## 1.2.2 - 9 Mar 2018
* More German translations (disco 17837)

## 1.2.1 - 27 Feb 2018
* Translated remaining phrases to German

## 1.2.0 - 19 Feb 2018
* Added some extra localisation

## 1.2.0-rc - 27 Nov 2017
* Implemented Quiz listing pagination
* Implemented global search integration for Quizzes

## 1.1.0 (Stable) - 30 Oct 2017
* Fixed HTML encoding for Question titles and Answer titles
* Added German localisation to parts of Quiz. More to come.

## 1.1.0-rc - 6 Sep 2017

* Compatibility with Claromentis 8.2+
* Webpack bundling of all quiz scripts

## 1.0.2-alpha - 2 Aug 2017

* Added answer breakdown feature. Users can now see their results and which questions
  have got right or wrong. Optionally controlled by quiz settings.
* Fixed rendering of the Statistics Overview table.
* Fixed erroneously including incomplete attempts in the Question Breakdown statistics.

## 1.0.1 - 24 Jul 2017

* Added a call to the delete action event for the Learning module - this should
  remove the bond between a step's Action and the Quiz in question
* Removed grey progress bar and replace it with the primary colour from the
  design tool
* Fixed issues with saving or notifying the maximum attempts of a Quiz

## 1.0.0 - 2 Jun 2017

* Added missing localization and text-overflow handling for the pass/fail
  progress bar of the Statistics Overview
* Fixed an unprotected script
* Ensured that Quizzes cannot be created with a negative or non-numeric
  max-retakes value

## 1.0.0-rc (Statistics, Integrations and Fine-grained Permissions) - 17 May 2017

* Design and UX improvements across the board
* Statistics
    * Statistics Overview
        * Metrics per-Quiz based on each user's best attempt
    * Quiz Statistics
        * Each user's best attempt
        * Questions breakdown
            * Percentages bar for correct & incorrect answers, as well as skipped questions
            * Average time taken
* Reports integration
    * Initial integration with the Reports module
        * Permission checks on core tables so far
* E-Learning Courses (LMS) integrations
    * Quizzes can have Qualification Codes
    * Modules have a new Quiz type for their Learning Materials
        * Modules are marked as completed when the user completes a Quiz, or if they have
          already completed the Quiz before
* Preview mode for Quiz administrators
* Confetti easter egg for quizzes passed with a 100% score
* Keyboard navigation for quizzes
    * Arrow keys or WASD to navigate
    * Enter to submit an answer
* Fine grained permission checks
    * Admin permissions
    * Per-Quiz permissions


## 0.1.0 (Core) - 20 Mar 2017

### Features

* Quiz administration
  * 3 tabs displaying quiz info, question listings, and settings for permissions
  * Add / Edit / Delete quizzes
  * Add / Edit / Delete questions
* Quiz listings
  * Card displaying quizzes
  * Sidebar with 3 basic user metrics
  * Progress bar on active quizzes
* Quiz
  * Intro page. Description and previous attempts
  * Question page. The ability to take a quiz. Question navigation
  * Review page. See how far you are, and proceed to finish
  * Statistics page. Pass or Fail, and the users score

### Known Issues

* Finish page image is on the right
* Navigation on the listings page requires clicking the name of the quiz, not the entire card
* Add another question button in admin is too far down the page once lots of questions have been added
* Finish button on Review page is bigger than the others for some reason
