Translations of this page:

Individual Feedback for Participants

Using the functions value(), valueMean(), the participant's answers can already be evaluated during the Questionnaire session (also see Score Responses). Some questions, like for instance Implicit Association Test (IAT), deliver an evaluation directly. Additionally, with the help of statistic() function, it is possible to evaluate values of all the previously tested participants.

Presenting outcome as text

It is easy to present the evaluation outcome as text. The sprintf() function makes it easy to format decimal values. Using sprintf('%1.2f', $value) the decimal value $value is formated in such a way so that there are 2 digits after after the point (two decimal digits).

Single Values (I)

The easiest way to output single values is to use html(). Strings can be bound using a point (.) (for instance when binding fragments of HTML code and the output values that should be displayed).

$value = valueMean('AB01');
  <p>You evaluated the current TV programm on a scale from 1 to 10 
  and your average evaluation was '.sprintf('%1.1f', $value).'.
   Average evaluation for this program countrywide is 6.3</p>

Single Values (II)

Possibly, one may also want to output different lines of text depending on the outcome of the evaluation. To set this up the function Filter can be used:

// Calculating the outcome value
$value = valueMean('AB01_01', 'AB01_05', 'AB01_09');
// z-Transformation
$zValue = ($value - 5) / 2.8;
// Showing the appropriate text based on the outcome value
if ($value < 0) {
  // no valid data in $value - no output
} elseif ($zValue < -2) {
} elseif ($zValue < -1) {
} elseif ($zValue <= 1) {
} elseif ($zValue < 2) {
} else {

Multiple Values

Multiple values are commonly displayed in a table. The easiest way to do this is with text-blocks and placeholders. For instance you could save the following HTML code under Textblocks and Labels inside a new textblock results.

<table cellspacing="5" cellpadding="0" border="0">
    <th>Your value</th>
    <th>Value of comparison</th>

The placeholders can finally directly be indicated in the command text(). Alternatively, replace() can also be used.

text('result', array(
  '%val-extra%' => valueMean('AB01_01', 'AB01_05', 'AB01_09'),
  '%val-neuro%' => valueMean('AB01_02', 'AB01_06', 'AB01_10')

Visual Presentation

There are several different options available to present outcomes visually.

Single Values

For single values (for example an IAT score) an HTML code can be used to show a scale with a mark on it.

An example for visual presentation of a single value

Save the following HTML code as a text in the list fo questions (the following examples assume that it gets the ID “RS01”).

<!-- Heading for the figure -->
<div class="title" style="text-align: center">%title%</div>
<div style="position: relative">
  <!-- The scale lies in the background -->
  <div style="margin: 0 auto; width: 400px; height: 25px; background-image:url('ofb://')">
      <!-- In order to place the Marking on the scale, a unit (from 0 to 1) is placed as a block element.-->
      <div style="position: absolute; top: -2px; left: 50%; width: 65px; height: 27px">
        <!-- The actual Marking is going to be inserted at the above defined right place -->
        <img src="ofb://slider.button.rhomb" alt="" style="position: absolute; left: %zValue100%%; margin-left: -8px" />

The HTML code contains two placeholders: %title% and %zValue100%. It is designed to show a z-value between -3 and +3 and can be used as follows:

// Determine the outcome value
$value = valueMean('AB01_01', 'AB01_05', 'AB01_09');
// z-Transformation
$zValue = ($value - 5) / 2.8;
// Filter extreme values
if ($zValue < -3) {
  $zValue = -3;
if ($zValue > 3) {
  $zValue = 3;
// Use textblocks (only if $value delivered a valid value)
if ($value > 0) {
  show('RS01', array(
    '%title%' => 'Extraversion',
    '%zValue%' => (string)round($zValue * 100)

Multiple Values (I)

Using the function diagram2(), one can place desired Diagrams into the Questionnaire. To learn how to use it please refer to the documentation of the function. An optimized function chart() is going to be available in future versions of SoSci Survey.

Multiple Values (II)

As long as the Highcharts plug-in is available on the questionnaire server, you can use the Highcharts library to display nifty diagrams in your questionnaire. As long as the category labels are saved in the array $labels, the results are saved in the array $ownData, and reference data in the array $refData, you can use the following text block “chart” (DarstellungHTML_Code”) and the associated PHP code to display a bar chart. You can find clarifications and details at Highcharts Dokumentation.

Tip: The PlugIn ChartJS is available by default and offers similar possibilities as Highcharts.

<!-- Container for the diagram -->
<div id="chart" style="height: 600px"></div>
<script type="text/javascript" src="../plugins/highcharts/highcharts.js"></script>
<script type="text/javascript">
$(function () {
        chart: {
            type: 'bar'
        title: {
            text: null
        xAxis: {
            categories: %labels%,
            title: {
                text: null
        plotOptions: {
            bar: {
                dataLabels: {
                    enabled: true
        legend: {
            layout: 'horizontal',
            align: 'center',
            verticalAlign: 'bottom',
            floating: false,
            borderWidth: 0,
            backgroundColor: ((Highcharts.theme && Highcharts.theme.legendBackgroundColor) || '#FFFFFF'),
            shadow: false
        credits: {
            enabled: false
        series: [{
            name: 'Average',
            data: %refData%,
            color: '#BBBBBB',
            dataLabels: {
                enabled: false
        }, {
            name: 'Your Value',
            data: %ownData%,
            color: '#009900',
            dataLabels: {
                enabled: false
// -->
// Make jQuery library available
// Bind the textblock with the HTML code for the chart
text('chart', array(
  '%labels%' => json_encode($labels),
  '%ownData%' => json_encode($ownData),
  '%refData%' => json_encode($refData)
en/create/feedback-visual.txt · Last modified: 25.10.2021 16:17 by admin
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki