compliance and bug fix release

[v0.22.0] - 18.12.2024

This is a bigger release than we've had in a while. Several smaller errors have been fixed. There have also been some small changes to the admin-facing interface. We also finally updated the documentation to reflect more of formr's feature set.
The most major additional work relates to managing an instance, so now several requirements (such as having a privacy policy or a terms of service for a study) can be set.

Fixed

• superadmin OpenCPU timing graph
• bug where (backup) server-side errors for invalid items weren't displayed
• issues with file uploads in the survey where error messages were not displayed, could be cryptic
• maxlength for textarea items was not respected
• fixed an issue where a minimum of 0 for number-type inputs was not respected

Changed

• when you upload a survey from a Google spreadsheet, the name of a survey is now automatically read from the spreadsheet file. The name set in formr has to match the Google spreadsheet name to ensure consistency
• documentation has been updated for item types, on how formr auto-enriches data in R code etc. In addition, documentation is available in more places.
• we no longer support two different "styles"/designs for surveys to reduce the amount of support and testing we need to do. If you've previously enabled material design, you can only turn it off now, it cannot be enabled anymore.

Added

• compliance work
  • added special user-facing static pages for privacy policy and terms of service
  • added an option to require that a privacy policy exists before studies go public
  • improved default footer text/imprint to include admin email address, links to privacy policy, ToS, settings, make referral tokens optional
  • added setting for extended agreements to conditions when uploading files in runs
• audio type items, including record_audio class for a recorder button
• video type items
• the submit button item now allows for negative "timeouts" — i.e. the user has to wait until they can submit

v0.21.4

• implement JS changes for material design too
• bug fix for default session code regex
• default to exporting items when exporting run JSONs
• all newly created surveys have a default field "iteration" which is simply an auto-increment number from 1 to number of responses to survey

v0.21.0 release

• make it easier to dockerise formr
• track bower_components to make it easier to collaborate on changes in CSS/JS
• improve cookie handling, so that formr works similarly, whether you use study-specific subdomains or not.

v0.20.6

Hotfix: v0.20.6

v0.19.4 hotfix release

• fix bug where emails sent via Test button were infinitely resent
• explicitly encode current unit session in run session table
• better result logging

v0.19.3 hotfix release

The update will include the following changes:

• better email queueing and logging and more informative errors (some users still reported breakage without useful error messages)
• we now default to testing email accounts after any change and don't send emails if we know an account is setup incorrectly.
• generally better logging of what happens in a run
• some users saw dupes in the user overview. these were only displayed in duplicate there, not causing any functional problems, but of course needed to be fixed.
• a lot of users found the current handling of missing values in surveys in formr counter-intuitive. two changes here:
  • if a check-type item is unchecked it defaults to 0, not NA
  • using the R function is.na(item) now also works in Javascript (formr just replaces it with the approximately correct and hard to remember JS idiom (typeof(item)==="undefined")
  • one note: is.na in javascript will not throw an error if the item name is mistyped. it's a limitation of how we set things up. I still hope this causes fewer problems than the old way.

v0.19.0 major release

Major release v0.19.0

New features

• the user detail now briefly logs the result at each step in the run, which should make it easier to trace errors
• in the same vein, formr now notifies the admin if emails stop sending (many change the password for their study email account and forget to tell formr)
• fractional pauses are now possible, so you can expire a pause after 1.5 minutes etc.

Bug fixes

• the new queueing system introduced more precise expiration times and was meant to reduce computational load on our server, however there were some hiccups and delays that we hope will be fixed by this update
• fractional numbers were rounded in the results table (but not in detailed results). this will not happen in the future, but if you collected fractional numbers or sliders in the past, work with the detailed results instead.
• several other fixes related to queueing
• it is now possible again to set a "get"-type item to required (useful for Prolific/Mturk etc)
• no more getting stuck with zero minute pauses
• some CSS classes fixed

Updates

• updated to more recent versions of phpmailer/phpspreadsheet etc

v0.18.0

Added

• A new queuing system to process run sessions
• An overview of sessions waiting in queue
• A new Run Unit called Waiting Time (see documentation)

Changed

• Optimizing the getting of results over the API
• Some minor bug fixes

Showif bug fixes

v0.17.16

showif fixes, allow more choice values, docs

v0.17.14

v0.17