QULQuestionnaire provides a drop-in solution for presenting an in-app questionnaire to the user.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Example
Pod
Screenshots
.gitignore
.travis.yml
LICENSE
QULQuestionnaire.podspec
README.md

README.md

QULQuestionnaire-iOS

CI Status Version License Platform

QULQuestionnaire provides a drop-in solution for presenting an in-app questionnaire to the user.

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

##Questionaire items & JSON format

###Single selection (radio)

{
  "key": STRING,
  "type": "radio",
  "orientation": STRING ("horizontal" | "vertical") 
  "question": STRING,        
  "instruction": STRING,
  "required": BOOL,
  "randomized": BOOL,
  "other": BOOL // optional; only available in vertical orientation
  "minLabel": STRING, // optional; only available in horizontal orientation
  "maxLabel": STRING, // optional; only available in horizontal orientation
  "decreaseIncreaseAccessory": BOOL, // optional; only available in horizontal orientation
  "options": [
    {
      "key": STRING,
      "value": STRING,
      "default": BOOL // optional
    }
  ]
}

Single selection vertical

Single selection horizontal

###Overall rating (smiley scale)

{
  "key": STRING,
  "type": "smiley",
  "question": STRING,
  "instruction": STRING, 
  "required": BOOL
}

Smiley

###Multiple selection (checkbox)

{
  "key": STRING,
  "type": "checkbox",
  "question": STRING,
  "instruction": STRING,    
  "required": BOOL,
  "randomized": BOOL,
   "maxSelectable": INT, // optional
   "options": [
     {
       "key": STRING,
       "value": STRING,
       "selected": BOOL // optional
      }
    ]
}

Multiple selection

###Value from range (slider)

{
  "key": STRING,
  "type": "slider",
  "question": STRING,
  "instruction": STRING,
  "required": BOOL,
  "minValue": FLOAT,
  "maxValue": FLOAT,
  "minLabel": STRING,
  "maxLabel": STRING,
  "showSelectedValue": BOOL, // optional
  "stepValue": INT // optional
}

Slider

###Text

{
  "key": STRING,
  "type": "text",
  "question": STRING,
  "input": STRING ("text" | "number" | "email") , // optional, defaults to text
  "instruction": STRING,
  "placeholder": STRING,
  "required": BOOL
}

Text

###Ranking

{
  "key": STRING,
  "type": "sortable",
  "question": STRING,    
  "instruction": STRING,
  "required": BOOL,
  "randomized": BOOL,
  "options": [
    {
      "key": STRING,
      "value": STRING
    }
  ]
}

Ranking

#Installation

##Manual

Copy all files from the QULQuestionnare folder to your project.

CocoaPods

platform :ios, '7.0'
pod "QULQuestionnaire", "~> 0.1"

#Requirements

  • iOS7 (will work on iOS6 without RMStepsController)
  • ARC

#Dependencies

#License

QULQuestionnaire-iOS is licensed under the terms of the Apache License, version 2.0. Please see the LICENSE file for full details.