chain simple forms / surveys into longer runs using the power of R to generate pretty feedback and complex designs
JavaScript PHP CSS
Permalink
Failed to load latest commit information.
application
bin prevent run processing in cron if it is still locked Dec 1, 2016
config_default Email queue fixes: delete item from queue after a number of tries, al… Dec 1, 2016
documentation move installation documentation to root Sep 26, 2016
sql add 'sent' flag to email_log Nov 28, 2016
tests shuffle with blocks, closes #44 Sep 5, 2015
tmp git ignore tmp assets Oct 4, 2016
webroot grunt Feb 8, 2017
.gitattributes git attributes for line endings Nov 3, 2014
.gitignore
.gitmodules - start using composer for managing php dependencies Jul 24, 2013
.htaccess add favicon Jun 8, 2015
CHANGELOG.md version bump Feb 13, 2017
CONTRIBUTING.md
INSTALLATION.md format Sep 26, 2016
LICENSE.md - start using composer for managing php dependencies Jul 24, 2013
Makefile make: Jun 18, 2015
README.md configure memory limits Oct 31, 2016
composer.json
composer.lock add gearman library dependency Aug 31, 2016
setup.php version bump Feb 13, 2017

README.md

formr survey framework

how to cite

See formr.org/public/about if you are publishing research conducted using formr.

chain simple forms & surveys into long runs, use the power of R to generate pretty feedback and complex designs

This is a framework that allows you to create simple and complex studies using items spreadsheets for the surveys and "runs" for chaining together various modules.

The creator and most users of this software work in personality and developmental psychology, but the framework can also be used for sociological panels, simple experiments or as part of an integrated toolkit.

There are three main components: surveys, runs and the R package.

Surveys

ask questions, get data

Surveys are simple or complicated forms and surveys used to gather information in a single session.

There is a wide variety of items to choose from: text and number inputs, Likert scales, sliders, geolocation, date pickers, dropdowns and many more. They are geared towards power users, so instead of dragging and dropping elements till your fingers bleed, you upload item spreadsheets that can easily be re-used, combined and shared.

Runs

control your study like a boombox

Runs enable you to link surveys and chain them together. Using a number of boombox-themed control elements to control the participant's way through your study, you can design studies of limitless complexity. You can

  • manage access to and eligibility for a study:
  • use different pathways for different users: – send email invites and reminders:
  • implement delays/pauses:
  • add external modules:
  • loop surveys and thus enable diaries and experience-sampling studies:
  • give custom feedback, through OpenCPU's R API.
  • randomise participants into groups for e.g. A-B-testing or experiments

The following designs and many more are possible:

  • simple one-shot surveys
  • complex one-shot surveys (using skipping logic, personalised text, complex feedback
  • surveys with eligibility limitations
  • diary studies including completely flexible automated email reminders
  • longitudinal studies (ie. wait 2 months after last participation or re-contact after they return from their exchange year). The items of later waves need not exist in final form at wave 1.
  • longitudinal social networks and other studies that require rating a variable number of things or persons

R package

accompanying R package

Wherever you use R in formr you can also use the functions in its R package. If you want to use the package in a different environment, you'll need to install it using these two lines of code.

install.packages("devtools")
devtools::install_github("rubenarslan/formr")

The package currently has the following feature sets

  • Connecting to formr, importing your data, correctly typing all variables, automatically aggregating scales.
  • Easily making feedback plots e.g. qplot_on_normal(0.8, "Extraversion") The package also has a function to simulate possible data, so you can make feedback plots ahead of collecting data.
  • Some shorthand functions for frequently needed operations on the site: first(cars); last(cars); current(cars); "formr." %contains% "mr."

OpenCPU + R + Knitr + Markdown

OpenCPU is a way to safely use complex R expressions on the web. We use it for all kinds of stuff.

In surveys, pauses, emails and pages you can display text to the user. This text is easily formatted using Markdown a simple syntax that formats text nicely if you simply write like you would write a plain text email. Markdown can be freely mixed with HTML, so you can e.g. insert icons from the Font Awesome library using <i class="fa fa-smile-o"></i>.

If you use knitr syntax, where Markdown can be used, the text will not just be parsed as Markdown (which is mostly static), but also be parsed (anew each time) by knitr. Knitr allows for mixing R syntax chunks and Markdown.
R is a popular open-source statistical programming language, that you can use via OpenCPU, a RESTful interface to the language that deals with the problem that R was not meant to be used as part of web apps and is insecure. R data frames with the same names as the surveys they derive from will be available in this knitr call, they contain all data that the current user has filled out so far.
Combined with norm data etc. you can tailor feedback to the user's input, e.g. show where the user lies on the bell curve etc.

Installation

If you want to test formr, you can simply clone this repository and follow the instructions.

If you need help, consult our mailing list.

Credit

See formr.org/about for funding and contact info.

See composer.json for the PHP components we use and bower.json for the Javascript and CSS components we use.