This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilSurveyEvaluationResults:

Public Member Functions
	__construct (SurveyQuestion $a_question)

	getQuestion ()

	setUsersAnswered (int $a_value)

	getUsersAnswered ()

	setUsersSkipped (int $a_value)

	getUsersSkipped ()

	setMode ( $a_value, int $a_nr_of_selections)

	getModeValue ()

	getModeValueAsText ()

	getModeNrOfSelections ()

	setMean (float $a_mean)

	getMean ()

	setMedian ($a_value)

	getMedian ()

	getMedianAsText ()

	addVariable (ilSurveyEvaluationResultsVariable $a_variable)

	getVariables ()

	addAnswer (ilSurveyEvaluationResultsAnswer $a_answer)

	getAnswers ()

	getScaleText ( $a_value)

	getMappedTextAnswers ()

	getUserResults (int $a_active_id)

Protected Member Functions
	getCatTitle (float $a_value)

Protected Attributes
ilLanguage	$lng

SurveyQuestion	$question

int	$users_answered = 0

int	$users_skipped = 0

	$mode_value

int	$mode_nr_of_selections = 0

float	$arithmetic_mean = 0

	$median

array	$variables = array()

array	$answers = array()

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Survey evaluation answers

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 23 of file class.ilSurveyEvaluationResults.php.

Constructor & Destructor Documentation

◆ __construct()

ilSurveyEvaluationResults::__construct ( SurveyQuestion $a_question )

Definition at line 42 of file class.ilSurveyEvaluationResults.php.

References $DIC, and ILIAS\Repository\lng().

       {
         global $DIC;
 
         $this->lng = $DIC->language();
         $this->question = $a_question;
     }

Here is the call graph for this function:

Member Function Documentation

◆ addAnswer()

ilSurveyEvaluationResults::addAnswer ( ilSurveyEvaluationResultsAnswer $a_answer )

Definition at line 179 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyQuestionEvaluation\parseResults().

      : void {
         $this->answers[] = $a_answer;
     }

Here is the caller graph for this function:

◆ addVariable()

ilSurveyEvaluationResults::addVariable ( ilSurveyEvaluationResultsVariable $a_variable )

Definition at line 168 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyQuestionEvaluation\parseResults().

      : void {
         $this->variables[] = $a_variable;
     }

Here is the caller graph for this function:

◆ getAnswers()

ilSurveyEvaluationResults::getAnswers ( )

Definition at line 185 of file class.ilSurveyEvaluationResults.php.

Referenced by getUserResults().

                                 : array
     {
         return $this->answers ?? [];
     }

Here is the caller graph for this function:

◆ getCatTitle()

ilSurveyEvaluationResults::getCatTitle ( float $a_value )

protected

Definition at line 209 of file class.ilSurveyEvaluationResults.php.

      : string {
         if (!count($this->variables)) {
             return $a_value;
         } else {
             foreach ($this->variables as $var) {
                 if ($var->cat->scale == $a_value) {
                     return $var->cat->title;
                 }
             }
         }
         return "";
     }

◆ getMappedTextAnswers()

ilSurveyEvaluationResults::getMappedTextAnswers ( )

Definition at line 224 of file class.ilSurveyEvaluationResults.php.

References $res, and getScaleText().

                                           : array
     {
         $res = array();
 
         foreach ($this->answers as $answer) {
             if ($answer->text) {
                 $res[$this->getScaleText($answer->value)][] = $answer->text;
             }
         }
 
         return $res;
     }

Here is the call graph for this function:

◆ getMean()

ilSurveyEvaluationResults::getMean ( )

Definition at line 127 of file class.ilSurveyEvaluationResults.php.

References $arithmetic_mean.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ilSurveyEvaluationGUI\parseResultsToExcel().

                              : float
     {
         return $this->arithmetic_mean;
     }

Here is the caller graph for this function:

◆ getMedian()

ilSurveyEvaluationResults::getMedian ( )

Returns: array|string

Definition at line 145 of file class.ilSurveyEvaluationResults.php.

References $median.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ilSurveyEvaluationGUI\parseResultsToExcel().

     {
         return $this->median;
     }

Here is the caller graph for this function:

◆ getMedianAsText()

ilSurveyEvaluationResults::getMedianAsText ( )

Definition at line 150 of file class.ilSurveyEvaluationResults.php.

References $lng, getScaleText(), null, and ilLanguage\txt().

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ilSurveyEvaluationGUI\parseResultsToExcel().

                                      : string
     {
         $lng = $this->lng;
 
         if ($this->median === null) {
             return "";
         }
 
         if (!is_array($this->median)) {
             return $this->getScaleText($this->median);
         }
 
         return $lng->txt("median_between") . " " .
             $this->getScaleText($this->median[0]) . " " .
             $lng->txt("and") . " " .
             $this->getScaleText($this->median[1]);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getModeNrOfSelections()

ilSurveyEvaluationResults::getModeNrOfSelections ( )

Definition at line 117 of file class.ilSurveyEvaluationResults.php.

References $mode_nr_of_selections.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ilSurveyEvaluationGUI\parseResultsToExcel().

                                            : int
     {
         return $this->mode_nr_of_selections;
     }

Here is the caller graph for this function:

◆ getModeValue()

ilSurveyEvaluationResults::getModeValue ( )

Returns: array|string

Definition at line 92 of file class.ilSurveyEvaluationResults.php.

References $mode_value.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ilSurveyEvaluationGUI\parseResultsToExcel().

     {
         return $this->mode_value;
     }

Here is the caller graph for this function:

◆ getModeValueAsText()

ilSurveyEvaluationResults::getModeValueAsText ( )

Definition at line 97 of file class.ilSurveyEvaluationResults.php.

References $mode_value, $res, getScaleText(), null, and ILIAS\UI\examples\Symbol\Glyph\Sort\sort().

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ilSurveyEvaluationGUI\parseResultsToExcel().

                                         : string
     {
         if ($this->mode_value === null) {
             return "";
         }
 
         $res = array();
 
         $mvalues = $this->mode_value;
         if (!is_array($mvalues)) {
             $mvalues = array($mvalues);
         }
         sort($mvalues, SORT_NUMERIC);
         foreach ($mvalues as $value) {
             $res[] = $this->getScaleText($value);
         }
 
         return implode(", ", $res);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestion()

ilSurveyEvaluationResults::getQuestion ( )

Definition at line 51 of file class.ilSurveyEvaluationResults.php.

References $question.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard(), and ILIAS\Survey\Mode\AbstractUIModifier\getPanelText().

                                  : SurveyQuestion
     {
         return $this->question;
     }

Here is the caller graph for this function:

◆ getScaleText()

ilSurveyEvaluationResults::getScaleText ( $a_value )

Parameters

mixed $a_value

Returns: string

Definition at line 194 of file class.ilSurveyEvaluationResults.php.

Referenced by getMappedTextAnswers(), getMedianAsText(), getModeValueAsText(), and getUserResults().

      : string {
         if (!count($this->variables)) {
             return $a_value;
         } else {
             foreach ($this->variables as $var) {
                 if ($var->cat->scale == $a_value) {
                     return $var->cat->title . " [" . $a_value . "]";
                 }
             }
         }
         return "";
     }

Here is the caller graph for this function:

◆ getUserResults()

ilSurveyEvaluationResults::getUserResults ( int $a_active_id )

Definition at line 237 of file class.ilSurveyEvaluationResults.php.

References $res, getAnswers(), and getScaleText().

      : array {
         $res = array();
 
         $answers = $this->getAnswers();
         if ($answers) {
             foreach ($answers as $answer) {
                 if ($answer->active_id == $a_active_id) {
                     $res[] = array(
                         $this->getScaleText($answer->value),
                         $answer->text,
                         $answer->value,
                         $this->getCatTitle($answer->value)
                     );
                 }
             }
         }
 
         return $res;
     }

Here is the call graph for this function:

◆ getUsersAnswered()

ilSurveyEvaluationResults::getUsersAnswered ( )

Definition at line 61 of file class.ilSurveyEvaluationResults.php.

References $users_answered.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard().

                                       : int
     {
         return $this->users_answered;
     }

Here is the caller graph for this function:

◆ getUsersSkipped()

ilSurveyEvaluationResults::getUsersSkipped ( )

Definition at line 71 of file class.ilSurveyEvaluationResults.php.

References $users_skipped.

Referenced by ILIAS\Survey\Mode\AbstractUIModifier\getPanelCard().

                                      : int
     {
         return $this->users_skipped;
     }

Here is the caller graph for this function:

◆ getVariables()

ilSurveyEvaluationResults::getVariables ( )

Definition at line 174 of file class.ilSurveyEvaluationResults.php.

                                   : array
     {
         return $this->variables ?? [];
     }

◆ setMean()

ilSurveyEvaluationResults::setMean ( float $a_mean )

Definition at line 122 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyMetricQuestionEvaluation\parseResults().

                                           : void
     {
         $this->arithmetic_mean = $a_mean;
     }

Here is the caller graph for this function:

◆ setMedian()

ilSurveyEvaluationResults::setMedian ( $a_value )

Parameters

string | array $a_value

Definition at line 135 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyQuestionEvaluation\parseResults().

                                        : void
     {
         $this->median = is_array($a_value)
             ? $a_value
             : trim($a_value ?? "");
     }

Here is the caller graph for this function:

◆ setMode()

ilSurveyEvaluationResults::setMode	(		$a_value,
		int	$a_nr_of_selections
	)

Parameters

array | string $a_value

Definition at line 79 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyQuestionEvaluation\parseResults().

      : void {
         $this->mode_value = is_array($a_value)
             ? $a_value
             : trim($a_value ?? "");
         $this->mode_nr_of_selections = $a_nr_of_selections;
     }

Here is the caller graph for this function:

◆ setUsersAnswered()

ilSurveyEvaluationResults::setUsersAnswered ( int $a_value )

Definition at line 56 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyQuestionEvaluation\parseResults().

                                                   : void
     {
         $this->users_answered = $a_value;
     }

Here is the caller graph for this function:

◆ setUsersSkipped()

ilSurveyEvaluationResults::setUsersSkipped ( int $a_value )

Definition at line 66 of file class.ilSurveyEvaluationResults.php.

Referenced by SurveyQuestionEvaluation\parseResults().

                                                  : void
     {
         $this->users_skipped = $a_value;
     }

Here is the caller graph for this function:

Field Documentation

◆ $answers

array ilSurveyEvaluationResults::$answers = array()

protected

Definition at line 40 of file class.ilSurveyEvaluationResults.php.

◆ $arithmetic_mean

float ilSurveyEvaluationResults::$arithmetic_mean = 0

protected

Definition at line 34 of file class.ilSurveyEvaluationResults.php.

Referenced by getMean().

◆ $lng

ilLanguage ilSurveyEvaluationResults::$lng

protected

Definition at line 25 of file class.ilSurveyEvaluationResults.php.

Referenced by getMedianAsText().

◆ $median

ilSurveyEvaluationResults::$median

protected

Definition at line 38 of file class.ilSurveyEvaluationResults.php.

Referenced by getMedian().

◆ $mode_nr_of_selections

int ilSurveyEvaluationResults::$mode_nr_of_selections = 0

protected

Definition at line 33 of file class.ilSurveyEvaluationResults.php.

Referenced by getModeNrOfSelections().

◆ $mode_value

ilSurveyEvaluationResults::$mode_value

protected

Definition at line 32 of file class.ilSurveyEvaluationResults.php.

Referenced by getModeValue(), and getModeValueAsText().

◆ $question

SurveyQuestion ilSurveyEvaluationResults::$question

protected

Definition at line 26 of file class.ilSurveyEvaluationResults.php.

Referenced by getQuestion().

◆ $users_answered

int ilSurveyEvaluationResults::$users_answered = 0

protected

Definition at line 27 of file class.ilSurveyEvaluationResults.php.

Referenced by getUsersAnswered().

◆ $users_skipped

int ilSurveyEvaluationResults::$users_skipped = 0

protected

Definition at line 28 of file class.ilSurveyEvaluationResults.php.

Referenced by getUsersSkipped().

◆ $variables

array ilSurveyEvaluationResults::$variables = array()

protected

Definition at line 39 of file class.ilSurveyEvaluationResults.php.

The documentation for this class was generated from the following file:

components/ILIAS/Survey/Evaluation/class.ilSurveyEvaluationResults.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAnswer()

◆ addVariable()

◆ getAnswers()

◆ getCatTitle()

◆ getMappedTextAnswers()

◆ getMean()

◆ getMedian()

◆ getMedianAsText()

◆ getModeNrOfSelections()

◆ getModeValue()

◆ getModeValueAsText()

◆ getQuestion()

◆ getScaleText()

◆ getUserResults()

◆ getUsersAnswered()

◆ getUsersSkipped()

◆ getVariables()

◆ setMean()

◆ setMedian()

◆ setMode()

◆ setUsersAnswered()

◆ setUsersSkipped()

Field Documentation

◆ $answers

◆ $arithmetic_mean

◆ $lng

◆ $median

◆ $mode_nr_of_selections

◆ $mode_value

◆ $question

◆ $users_answered

◆ $users_skipped

◆ $variables